Класс DynamicMusicPlayer

Защищенные члены
bool	IsPriotitizedCategorySelected ()
void	DetermineTrackByCategory (EDynamicMusicPlayerCategory category)
bool	IsPlaybackActive ()
void	OnProfileOptionChanged (EDayZProfilesOptions option, int value)
void	OnCategorySet (EDynamicMusicPlayerCategory category, bool forced)
void	OnTrackEnded ()
void	OnTrackStopped ()
void	OnNextTrackSelected (DynamicMusicTrackData track, float waitTime)
void	OnLocationMatched (EDynamicMusicPlayerCategory category, bool isPriorityLocation)
void	OnFadeoutFinished (EDynamicMusicPlayerCategory category)
float	GetWaitTimeForCategory (EDynamicMusicPlayerCategory category)

Защищенные данные
const float	TICK_TIME_OF_DATE_UPDATE_SECONDS = 300.0
const float	TICK_LOCATION_CACHE_UPDATE_SECONDS = 120.0
const float	TICK_LOCATION_UPDATE_SECONDS = 120.0
const float	TICK_PRIORITY_LOCATION_UPDATE_SECONDS = 30.0
const float	TICK_FADEOUT_PROCESSOR_SECONDS = 0.2
const int	TRACKS_BUFFER_HISTORY_SIZE = 2
const float	LOCATION_DISTANCE_MAX = 500
float	m_TickTimeOfDateElapsed
float	m_TickLocationCacheUpdateElapsed
float	m_TickLocationUpdateElapsed
float	m_TickPriorityLocationUpdateElapsed
float	m_TickFadeOutProcessingElapsed
EDynamicMusicPlayerCategory	m_CategorySelected
DynamicMusicTrackData	m_CurrentTrack
ref DynamicMusicPlayerRegistry	m_DynamicMusicPlayerRegistry
ref array< ref DynamicMusicTrackData >	m_TracksLocationMatchedPlayerInside
	static prio + filtered by the distance between player and center of zone
AbstractWave	m_SoundPlaying

Закрытые члены
void	DynamicMusicPlayer (DynamicMusicPlayerRegistry configuration)
void	OnUpdate (float timeslice)
void	SetCategory (EDynamicMusicPlayerCategory category, bool forced)
void	RegisterDynamicLocation (notnull Entity caller, int locationType, float locationSize)
void	UnregisterDynamicLocation (notnull Entity caller)
void	PlayTrack (DynamicMusicTrackData track)
void	StopTrack ()
void	ResetWaitingQueue ()
void	FadeoutTrack (float fadeoutSeconds)
void	ProcessFadeOut ()
bool	PlayerInsideOfLocationFilter (ref array< ref DynamicMusicTrackData > locations)
bool	PlayerInsideOfLocationFilter (ref map< int, ref DynamicMusicLocationDynamicData > locations)
bool	SetSelectedTrackFromCategory (EDynamicMusicPlayerCategory category, notnull ref array< ref DynamicMusicTrackData > tracklist, int historyLookupType=DynamicMusicPlayerTrackHistoryLookupType.ANY)
int	SelectRandomTrackIndexFromCategoryPriorityFlagFirst (EDynamicMusicPlayerCategory category, notnull array< ref DynamicMusicTrackData > tracks)
int	SelectRandomTrackIndexFromCategory (EDynamicMusicPlayerCategory category, int lookupType, notnull array< ref DynamicMusicTrackData > tracks)
void	SetTimeOfDate ()
float	GetMinWaitTimePerCategory (EDynamicMusicPlayerCategory category)
float	GetMaxWaitTimePerCategory (EDynamicMusicPlayerCategory category)
float	GetPreviousTrackFadeoutSeconds (EDynamicMusicPlayerCategory category)
void	RefreshTracksCache ()

Закрытые данные
ref array< ref DynamicMusicTrackData >	m_TracksLocationStaticCached
	map of dynamically registered locations during runtime
ref array< ref DynamicMusicTrackData >	m_TracksLocationStaticPrioritizedCached
	static + filtered by the distance between player and center of zone
bool	m_WaitingForPlayback
ref map< EDynamicMusicPlayerCategory, ref SimpleCircularBuffer< int > >	m_LastPlayedTrackBufferPerCategory
	gets the playback mode as set in sounds menu; 0 - all; 1 - menu only
vector	m_PlayerPosition
float	m_FadeoutTimeElapsed
float	m_FadeoutTimeRequested
bool	m_FadeoutInProgress
bool	m_Created

Подробное описание

Конструктор(ы)

DynamicMusicPlayer()

void DynamicMusicPlayer ( DynamicMusicPlayerRegistry configuration )

inlineprivate

fadeout settings

    {
        m_DynamicMusicPlayerRegistry = configuration;
        m_RequestedPlaybackMode = g_Game.GetProfileOptionInt(EDayZProfilesOptions.AMBIENT_MUSIC_MODE);
 
        m_ActualTimeOfDay   = DynamicMusicPlayerTimeOfDay.ANY;
        m_CategorySelected  = EDynamicMusicPlayerCategory.NONE;
 
        m_LastPlayedTrackBufferPerCategory = new map<EDynamicMusicPlayerCategory, ref SimpleCircularBuffer<int>>;
        
        m_LastPlayedTrackBufferPerCategory[EDynamicMusicPlayerCategory.MENU] = new SimpleCircularBuffer<int>(TRACKS_BUFFER_HISTORY_SIZE, -1);
        m_LastPlayedTrackBufferPerCategory[EDynamicMusicPlayerCategory.TIME] = new SimpleCircularBuffer<int>(TRACKS_BUFFER_HISTORY_SIZE, -1);
 
        m_LastPlayedTrackBufferPerCategory[EDynamicMusicPlayerCategory.LOCATION_STATIC]             = new SimpleCircularBuffer<int>(TRACKS_BUFFER_HISTORY_SIZE, -1);
        m_LastPlayedTrackBufferPerCategory[EDynamicMusicPlayerCategory.LOCATION_STATIC_PRIORITY]    = new SimpleCircularBuffer<int>(TRACKS_BUFFER_HISTORY_SIZE, -1);
        m_LastPlayedTrackBufferPerCategory[EDynamicMusicPlayerCategory.LOCATION_DYNAMIC]            = new SimpleCircularBuffer<int>(TRACKS_BUFFER_HISTORY_SIZE, -1);
        
        m_LocationsDynamic = new ref map<int, ref DynamicMusicLocationDynamicData>();
        m_TracksLocationStaticCached = new array<ref DynamicMusicTrackData>();
        m_TracksLocationStaticPrioritizedCached = new array<ref DynamicMusicTrackData>();
        
        m_TracksLocationMatchedPlayerInside = new array<ref DynamicMusicTrackData>();
 
        SetTimeOfDate();
        
        m_FadeoutTimeElapsed    = 0.0;
        m_FadeoutTimeRequested  = 0.0;
        
        g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(RefreshTracksCache, 5000);
        
        DayZProfilesOptions.m_OnIntOptionChanged.Insert(OnProfileOptionChanged);
        
        m_Created = true;
    }

Перекрестные ссылки CALL_CATEGORY_SYSTEM, g_Game, m_CategorySelected, m_Created, m_DynamicMusicPlayerRegistry, m_FadeoutTimeElapsed, m_FadeoutTimeRequested, m_LastPlayedTrackBufferPerCategory, DayZProfilesOptions::m_OnIntOptionChanged, m_TracksLocationMatchedPlayerInside, m_TracksLocationStaticCached, m_TracksLocationStaticPrioritizedCached, OnProfileOptionChanged(), RefreshTracksCache(), SetTimeOfDate() и TRACKS_BUFFER_HISTORY_SIZE.

Методы

DetermineTrackByCategory()

void DetermineTrackByCategory ( EDynamicMusicPlayerCategory category )

inlineprotected

    {
        if (m_CategorySelected != EDynamicMusicPlayerCategory.MENU && m_RequestedPlaybackMode == 1)
            return;
 
        if (IsPlaybackActive())
            return;
        
        switch (category)
        {
            case EDynamicMusicPlayerCategory.MENU:
                if (SetSelectedTrackFromCategory(category, m_DynamicMusicPlayerRegistry.m_TracksMenu, DynamicMusicPlayerTrackHistoryLookupType.BUFFER))
                    break;
            
                g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(DetermineTrackByCategory, 5000, false, category);
                break;
            
            case EDynamicMusicPlayerCategory.TIME:
                if (SetSelectedTrackFromCategory(category, m_DynamicMusicPlayerRegistry.m_TracksTime, DynamicMusicPlayerTrackHistoryLookupType.BUFFER))
                    break;
 
                g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(DetermineTrackByCategory, 5000, false, category);
                break;
            case EDynamicMusicPlayerCategory.LOCATION_STATIC:
                if (SetSelectedTrackFromCategory(category, m_TracksLocationMatchedPlayerInside))
                    break;
 
                g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(DetermineTrackByCategory, 5000, false, category);
                break;
            case EDynamicMusicPlayerCategory.LOCATION_STATIC_PRIORITY:
                if (SetSelectedTrackFromCategory(category, m_TracksLocationMatchedPlayerInside))
                    break;
 
                g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(DetermineTrackByCategory, 5000, false, category);
                break;
            case EDynamicMusicPlayerCategory.LOCATION_DYNAMIC:
                if (SetSelectedTrackFromCategory(category, m_DynamicMusicPlayerRegistry.m_TracksLocationDynamic))
                    break;
            
                g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(DetermineTrackByCategory, 5000, false, category);
            
                break;
        }
    }

Перекрестные ссылки CALL_CATEGORY_SYSTEM, DetermineTrackByCategory(), g_Game, IsPlaybackActive(), m_CategorySelected, m_DynamicMusicPlayerRegistry, m_TracksLocationMatchedPlayerInside и SetSelectedTrackFromCategory().

Используется в DetermineTrackByCategory(), OnCategorySet() и OnUpdate().

FadeoutTrack()

void FadeoutTrack ( float fadeoutSeconds )

inlineprivate

    {
        if (m_FadeoutInProgress)
            return;
 
        if (m_CurrentTrack && m_SoundPlaying)
        {
            #ifdef DIAG_DEVELOPER
            DMPDebugPrint(string.Format("Stopping currently played track %1", m_CurrentTrack.m_SoundSet));
            DMPDebugPrint(string.Format("-- Setting fadeout to %1", fadeoutSeconds));
            #endif
            m_FadeoutInProgress = true;
            m_FadeoutTimeRequested = fadeoutSeconds;
        }
    }

Перекрестные ссылки m_CurrentTrack, m_FadeoutInProgress, m_FadeoutTimeRequested, m_SoundPlaying и DynamicMusicTrackData::m_SoundSet.

Используется в OnLocationMatched().

GetMaxWaitTimePerCategory()

float GetMaxWaitTimePerCategory ( EDynamicMusicPlayerCategory category )

inlineprivate

    {
        float waitTime = m_DynamicMusicPlayerRegistry.m_SettingsByCategory[category].m_MaxWaitTimeSeconds;
        #ifdef DIAG_DEVELOPER
        if (FeatureTimeAccel.GetFeatureTimeAccelEnabled(ETimeAccelCategories.DYNAMIC_MUSIC_PLAYER))
        {
            float timeAccel = FeatureTimeAccel.GetFeatureTimeAccelValue();
            if (timeAccel > 0)
                return waitTime / FeatureTimeAccel.GetFeatureTimeAccelValue();
        }
        #endif
        return waitTime;
    }

Перекрестные ссылки m_DynamicMusicPlayerRegistry.

Используется в GetWaitTimeForCategory().

GetMinWaitTimePerCategory()

float GetMinWaitTimePerCategory ( EDynamicMusicPlayerCategory category )

inlineprivate

    {
        float waitTime = m_DynamicMusicPlayerRegistry.m_SettingsByCategory[category].m_MinWaitTimeSeconds;
        #ifdef DIAG_DEVELOPER
        if (FeatureTimeAccel.GetFeatureTimeAccelEnabled(ETimeAccelCategories.DYNAMIC_MUSIC_PLAYER))
        {
            float timeAccel = FeatureTimeAccel.GetFeatureTimeAccelValue();
            if (timeAccel > 0)
                return waitTime / FeatureTimeAccel.GetFeatureTimeAccelValue();
        }
        #endif
        return waitTime;        
    }

Перекрестные ссылки m_DynamicMusicPlayerRegistry.

Используется в GetWaitTimeForCategory().

GetPreviousTrackFadeoutSeconds()

float GetPreviousTrackFadeoutSeconds ( EDynamicMusicPlayerCategory category )

inlineprivate

    {
        return m_DynamicMusicPlayerRegistry.m_SettingsByCategory[category].m_PreviousTrackFadeoutSeconds;
    }

Перекрестные ссылки m_DynamicMusicPlayerRegistry.

Используется в OnLocationMatched().

GetWaitTimeForCategory()

float GetWaitTimeForCategory ( EDynamicMusicPlayerCategory category )

inlineprotected

    {
        return Math.RandomFloatInclusive(GetMinWaitTimePerCategory(category), GetMaxWaitTimePerCategory(category));
    }

Перекрестные ссылки GetMaxWaitTimePerCategory(), GetMinWaitTimePerCategory() и Math::RandomFloatInclusive().

Используется в SetSelectedTrackFromCategory().

IsPlaybackActive()

bool IsPlaybackActive ( )

inlineprotected

    {
        return m_SoundPlaying || m_WaitingForPlayback;
    }

Перекрестные ссылки m_SoundPlaying и m_WaitingForPlayback.

Используется в DetermineTrackByCategory() и OnUpdate().

IsPriotitizedCategorySelected()

bool IsPriotitizedCategorySelected ( )

inlineprotected

    {
        return m_CategorySelected == EDynamicMusicPlayerCategory.LOCATION_STATIC_PRIORITY || m_CategorySelected == EDynamicMusicPlayerCategory.LOCATION_DYNAMIC;
    }

Перекрестные ссылки m_CategorySelected.

Используется в OnFadeoutFinished(), OnLocationMatched() и OnUpdate().

OnCategorySet()

void OnCategorySet ( EDynamicMusicPlayerCategory category, bool forced )

inlineprotected

    {
        #ifdef DIAG_DEVELOPER
        DMPDebugPrint(string.Format(
            "OnCategorySet() - category: %1, forced: %2",
            EnumTools.EnumToString(EDynamicMusicPlayerCategory, category),
            forced),
        );
        #endif
 
        DetermineTrackByCategory(category);
    }

Перекрестные ссылки DetermineTrackByCategory() и EnumTools::EnumToString().

Используется в SetCategory().

OnFadeoutFinished()

void OnFadeoutFinished ( EDynamicMusicPlayerCategory category )

inlineprotected

    {
        if (m_SoundPlaying)
            m_SoundPlaying.GetEvents().Event_OnSoundWaveEnded.Remove(OnTrackEnded);
 
        StopTrack();
        SetCategory(category, IsPriotitizedCategorySelected());
    }

Перекрестные ссылки AbstractWave::GetEvents(), IsPriotitizedCategorySelected(), m_SoundPlaying, OnTrackEnded(), SetCategory() и StopTrack().

Используется в OnUpdate().

OnLocationMatched()

void OnLocationMatched ( EDynamicMusicPlayerCategory category, bool isPriorityLocation )

inlineprotected

play prio location track (no fadeout)

play location track (no fadeout)

    {
        #ifdef DIAG_DEVELOPER
        string messagePriority;
        if (isPriorityLocation)
            messagePriority = "(with priority)";
        DMPDebugPrint(string.Format("Location matched %1", messagePriority));
        #endif
 
        if (isPriorityLocation)
        {
            if (!IsPriotitizedCategorySelected())
            {
                m_CategorySelected = category;
                FadeoutTrack(GetPreviousTrackFadeoutSeconds(category));
            }
            else
                SetCategory(category, true); 
        }
        else
            SetCategory(category, false); 
    }

Перекрестные ссылки FadeoutTrack(), GetPreviousTrackFadeoutSeconds(), IsPriotitizedCategorySelected(), m_CategorySelected и SetCategory().

Используется в OnUpdate().

OnNextTrackSelected()

void OnNextTrackSelected ( DynamicMusicTrackData track, float waitTime )

inlineprotected

    {
        m_WaitingForPlayback = true;
        m_CurrentTrack = track;
        
        if (m_Created)
            m_Created = false;
 
        #ifdef DIAG_DEVELOPER
        DMPDebugPrint(string.Format(
            "WaitTime set to %1s, deferring playback of \"%2\"",
            (int)waitTime,
            track.m_SoundSet),
        );
        m_DebugWaitTime = waitTime;
        #endif
 
        g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).CallLater(PlayTrack, (int)waitTime * 1000, false, track);
    }

Перекрестные ссылки CALL_CATEGORY_SYSTEM, g_Game, m_Created, m_CurrentTrack, m_WaitingForPlayback и PlayTrack().

Используется в SetSelectedTrackFromCategory().

OnProfileOptionChanged()

void OnProfileOptionChanged ( EDayZProfilesOptions option, int value )

inlineprotected

Events

    {
        if (option == EDayZProfilesOptions.AMBIENT_MUSIC_MODE)
        {
            m_RequestedPlaybackMode = value;
            
            if (value == 1 && m_CategorySelected != EDynamicMusicPlayerCategory.MENU)
            {
                StopTrack();
                ResetWaitingQueue();
            }
        }
    }

Перекрестные ссылки m_CategorySelected, ResetWaitingQueue() и StopTrack().

Используется в DynamicMusicPlayer().

OnTrackEnded()

void OnTrackEnded ( )

inlineprotected

    {
        #ifdef DIAG_DEVELOPER
        if (m_CurrentTrack)
            DMPDebugPrint(string.Format("Track END - %1", m_CurrentTrack.m_SoundSet));
        #endif
 
        m_SoundPlaying = null;
        m_CurrentTrack = null;
        m_WaitingForPlayback = false;
    }

Перекрестные ссылки m_CurrentTrack, m_SoundPlaying, DynamicMusicTrackData::m_SoundSet и m_WaitingForPlayback.

Используется в OnFadeoutFinished() и PlayTrack().

OnTrackStopped()

void OnTrackStopped ( )

inlineprotected

stopped only by fadeouts

    {
        #ifdef DIAG_DEVELOPER
        if (m_CurrentTrack)
            DMPDebugPrint(string.Format("Track STOP - %1", m_CurrentTrack.m_SoundSet));
        #endif
 
        m_SoundPlaying = null;
        m_CurrentTrack = null;
        m_WaitingForPlayback = false;
    }

Перекрестные ссылки m_CurrentTrack, m_SoundPlaying, DynamicMusicTrackData::m_SoundSet и m_WaitingForPlayback.

Используется в PlayTrack().

OnUpdate()

void OnUpdate ( float timeslice )

inlineprivate

handle fadeouts

caching of locations based on distance from player (<= LOCATION_DISTANCE_MAX)

no playback at all OR playback of non-prioritized category

works as default category selector

menu only

    {
        if (m_DynamicMusicPlayerRegistry == null)
            return;
 
        m_TickTimeOfDateElapsed                 += timeslice;
        m_TickLocationCacheUpdateElapsed        += timeslice;
        m_TickLocationUpdateElapsed             += timeslice;
        m_TickPriorityLocationUpdateElapsed     += timeslice;
        m_TickFadeOutProcessingElapsed          += timeslice;
        
        if (m_FadeoutInProgress && m_TickFadeOutProcessingElapsed >= TICK_FADEOUT_PROCESSOR_SECONDS)
        {
            m_FadeoutTimeElapsed += TICK_FADEOUT_PROCESSOR_SECONDS;
            m_TickFadeOutProcessingElapsed = 0.0;
            if (m_FadeoutTimeElapsed >= m_FadeoutTimeRequested)
            {
                m_FadeoutTimeElapsed = 0.0;
                m_FadeoutTimeRequested = 0.0;
                m_FadeoutInProgress = false;
                OnFadeoutFinished(m_CategorySelected);
            }
            else
                ProcessFadeOut();
        }
        else
        {
            if (m_CategorySelected != EDynamicMusicPlayerCategory.MENU)
            {
                if (m_TickLocationCacheUpdateElapsed >= TICK_LOCATION_CACHE_UPDATE_SECONDS)
                {
                    m_TickLocationCacheUpdateElapsed = 0.0;
                    RefreshTracksCache();
                }
    
                if (m_TickPriorityLocationUpdateElapsed >= TICK_PRIORITY_LOCATION_UPDATE_SECONDS)
                {
                    if (g_Game.GetPlayer())
                    {
                        m_PlayerPosition = g_Game.GetPlayer().GetPosition();
                        m_PlayerPosition[1] = 0.0;
                    }
 
                    m_TickPriorityLocationUpdateElapsed = 0.0;
                    
                    if (!IsPlaybackActive() || (IsPlaybackActive() && !IsPriotitizedCategorySelected()))
                    {
                        if (PlayerInsideOfLocationFilter(m_LocationsDynamic))
                            OnLocationMatched(EDynamicMusicPlayerCategory.LOCATION_DYNAMIC, true);
                        else if (PlayerInsideOfLocationFilter(m_TracksLocationStaticPrioritizedCached))
                            OnLocationMatched(EDynamicMusicPlayerCategory.LOCATION_STATIC_PRIORITY, true);
                    }
                }
 
                if (m_TickLocationUpdateElapsed >= TICK_LOCATION_UPDATE_SECONDS)
                {
                    m_TickLocationUpdateElapsed = 0.0;
                    
                    if (!IsPlaybackActive())
                    {
                        if (PlayerInsideOfLocationFilter(m_TracksLocationStaticCached))
                            OnLocationMatched(EDynamicMusicPlayerCategory.LOCATION_STATIC, false);
                    }
                }
                
                if (m_TickTimeOfDateElapsed >= TICK_TIME_OF_DATE_UPDATE_SECONDS)
                {
                    m_TickTimeOfDateElapsed = 0.0;
                    SetTimeOfDate();
                    
                    if (!IsPlaybackActive() || !IsPriotitizedCategorySelected())
                        SetCategory(EDynamicMusicPlayerCategory.TIME, false);
                }
            }
            else 
            {
                if (!IsPlaybackActive())
                    DetermineTrackByCategory(m_CategorySelected);
            }
        
        }
 
        #ifdef DIAG_DEVELOPER
        if (DiagMenu.GetBool(DiagMenuIDs.SOUNDS_DYNAMIC_MUSIC_PLAYER_STATS))
        {
            DisplayDebugStats(true);
            DisplayStaticLocations(true);
        }
        #endif
    }

Перекрестные ссылки DetermineTrackByCategory(), g_Game, DiagMenu::GetBool(), IsPlaybackActive(), IsPriotitizedCategorySelected(), m_CategorySelected, m_DynamicMusicPlayerRegistry, m_FadeoutInProgress, m_FadeoutTimeElapsed, m_FadeoutTimeRequested, m_PlayerPosition, m_TickFadeOutProcessingElapsed, m_TickLocationCacheUpdateElapsed, m_TickLocationUpdateElapsed, m_TickPriorityLocationUpdateElapsed, m_TickTimeOfDateElapsed, m_TracksLocationStaticCached, m_TracksLocationStaticPrioritizedCached, OnFadeoutFinished(), OnLocationMatched(), PlayerInsideOfLocationFilter(), ProcessFadeOut(), RefreshTracksCache(), SetCategory(), SetTimeOfDate(), TICK_FADEOUT_PROCESSOR_SECONDS, TICK_LOCATION_CACHE_UPDATE_SECONDS, TICK_LOCATION_UPDATE_SECONDS, TICK_PRIORITY_LOCATION_UPDATE_SECONDS и TICK_TIME_OF_DATE_UPDATE_SECONDS.

PlayerInsideOfLocationFilter() [1/2]

bool PlayerInsideOfLocationFilter ( ref array< ref DynamicMusicTrackData > locations )

inlineprivate

    {
        m_TracksLocationMatchedPlayerInside.Clear();
 
        if (locations.Count() > 0)
        {
            foreach (DynamicMusicTrackData track : locations)
            {
                foreach (int locationId, array<vector> bounds : track.locationBoundaries)
                {
                    if (Math.IsPointInRectangle(bounds[0], bounds[1], m_PlayerPosition))
                    {
                        if (m_TracksLocationMatchedPlayerInside.Find(track) == INDEX_NOT_FOUND)
                            m_TracksLocationMatchedPlayerInside.Insert(track);
    
                        #ifdef DIAG_DEVELOPER
                        DMPDebugPrint(string.Format("Player inside location <%1, %2>", bounds[0], bounds[1]));
                        #endif
                    }
                }
            }
        }
        
        return m_TracksLocationMatchedPlayerInside.Count() > 0;
    }

Перекрестные ссылки INDEX_NOT_FOUND, Math::IsPointInRectangle(), m_PlayerPosition и m_TracksLocationMatchedPlayerInside.

Используется в OnUpdate().

PlayerInsideOfLocationFilter() [2/2]

bool PlayerInsideOfLocationFilter ( ref map< int, ref DynamicMusicLocationDynamicData > locations )

inlineprivate

    {
        if (locations.Count() > 0)
        {
            foreach (int locationId, DynamicMusicLocationDynamicData location : locations)
            {
                if (Math.IsPointInRectangle(location.m_Min, location.m_Max, m_PlayerPosition))
                {
                    #ifdef DIAG_DEVELOPER
                    DMPDebugPrint(string.Format("Player inside location <%1, %2>", location.m_Min, location.m_Max));
                    #endif
                    return true;
                }
            }
        }
 
        return false;
    }

Перекрестные ссылки Math::IsPointInRectangle() и m_PlayerPosition.

PlayTrack()

void PlayTrack ( DynamicMusicTrackData track )

inlineprivate

---

register callbacks

invalid sound set is used

    {
        SoundParams soundParams         = new SoundParams(track.m_SoundSet);
        if (soundParams.IsValid())
        {
            SoundObjectBuilder soundBuilder = new SoundObjectBuilder(soundParams);
            SoundObject soundObject         = soundBuilder.BuildSoundObject();
            soundObject.SetKind(WaveKind.WAVEMUSIC);
    
            m_SoundPlaying = GetGame().GetSoundScene().Play2D(soundObject, soundBuilder);
            if (m_SoundPlaying)
            {
                m_SoundPlaying.Loop(false);
                m_SoundPlaying.Play();
    
                m_SoundPlaying.GetEvents().Event_OnSoundWaveEnded.Insert(OnTrackEnded);
                m_SoundPlaying.GetEvents().Event_OnSoundWaveStopped.Insert(OnTrackStopped);
                
                m_WaitingForPlayback = false;
            }
        }
        else 
        {
            m_WaitingForPlayback = false;
            m_CurrentTrack       = null;
        }
        
    }

Перекрестные ссылки AbstractWave::GetEvents(), GetGame(), AbstractWave::Loop(), m_CurrentTrack, m_SoundPlaying, m_WaitingForPlayback, OnTrackEnded(), OnTrackStopped(), AbstractWave::Play(), SoundObject() и SoundObjectBuilder().

Используется в OnNextTrackSelected() и ResetWaitingQueue().

ProcessFadeOut()

void ProcessFadeOut ( )

inlineprivate

    {
        if (m_SoundPlaying)
        {
            float volume = 1 - (m_FadeoutTimeElapsed / m_FadeoutTimeRequested);
            m_SoundPlaying.SetFadeOutFactor(volume);
        }
    }

Перекрестные ссылки m_FadeoutTimeElapsed, m_FadeoutTimeRequested, m_SoundPlaying и AbstractWave::SetFadeOutFactor().

Используется в OnUpdate().

RefreshTracksCache()

void RefreshTracksCache ( )

inlineprivate

    {
        if (m_DynamicMusicPlayerRegistry)
        {
            m_TracksLocationStaticCached.Clear();
            foreach (DynamicMusicTrackData track : m_DynamicMusicPlayerRegistry.m_TracksLocationStatic)
            {
                foreach (array<vector> bounds : track.locationBoundaries)
                {
                    if (vector.Distance(m_PlayerPosition, Math.CenterOfRectangle(bounds[0], bounds[1])) > LOCATION_DISTANCE_MAX)
                        continue;
                }
    
                m_TracksLocationStaticCached.Insert(track);
            }
    
            m_TracksLocationStaticPrioritizedCached.Clear();
            foreach (DynamicMusicTrackData trackPrio : m_DynamicMusicPlayerRegistry.m_TracksLocationStaticPrioritized)
            {
                foreach (array<vector> boundsPrio : trackPrio.locationBoundaries)
                {
                    if (vector.Distance(m_PlayerPosition, Math.CenterOfRectangle(boundsPrio[0], boundsPrio[1])) > LOCATION_DISTANCE_MAX)
                        continue;
                }
                
                m_TracksLocationStaticPrioritizedCached.Insert(trackPrio);
            }
        }
    }

Перекрестные ссылки Math::CenterOfRectangle(), vector::Distance(), LOCATION_DISTANCE_MAX, m_DynamicMusicPlayerRegistry, m_PlayerPosition, m_TracksLocationStaticCached и m_TracksLocationStaticPrioritizedCached.

Используется в DynamicMusicPlayer() и OnUpdate().

RegisterDynamicLocation()

void RegisterDynamicLocation ( notnull Entity caller, int locationType, float locationSize )

inlineprivate

    {
        int id = caller.GetID();
        if (!m_LocationsDynamic.Contains(id))
        {
            array<vector> minMax = DynamicMusicLocationDynamicData.GetRectangularCoordsFromSize(caller.GetPosition(), locationSize);
            DynamicMusicLocationDynamicData location = new DynamicMusicLocationDynamicData();
            location.m_Type = locationType;
            location.m_Min = minMax[0];
            location.m_Max = minMax[1];
            m_LocationsDynamic.Insert(id, location);
        }
    }

ResetWaitingQueue()

void ResetWaitingQueue ( )

inlineprivate

    {       
        if (m_WaitingForPlayback)
        {
            g_Game.GetCallQueue(CALL_CATEGORY_SYSTEM).Remove(PlayTrack);
            m_WaitingForPlayback = false;
            m_CurrentTrack = null;
        }
    }

Перекрестные ссылки CALL_CATEGORY_SYSTEM, g_Game, m_CurrentTrack, m_WaitingForPlayback и PlayTrack().

Используется в OnProfileOptionChanged().

SelectRandomTrackIndexFromCategory()

int SelectRandomTrackIndexFromCategory ( EDynamicMusicPlayerCategory category, int lookupType, notnull array< ref DynamicMusicTrackData > tracks )

inlineprivate

    {
        int count = tracks.Count();
        if (count > 0)
        {
            int index = Math.RandomInt(0, count);
 
            switch (lookupType)
            {
                case DynamicMusicPlayerTrackHistoryLookupType.ANY:
                    return index;
 
                case DynamicMusicPlayerTrackHistoryLookupType.BUFFER:
                    // fallback - num of track is smaller than actual history size;
                    if (count <= TRACKS_BUFFER_HISTORY_SIZE)
                        return index;
 
                    if (m_LastPlayedTrackBufferPerCategory[category].GetValues().Find(index) == INDEX_NOT_FOUND)
                        return index;
                
                    return INDEX_NOT_FOUND;
            }
        }
        
        return INDEX_NOT_FOUND;
    }

Перекрестные ссылки INDEX_NOT_FOUND, m_LastPlayedTrackBufferPerCategory, Math::RandomInt() и TRACKS_BUFFER_HISTORY_SIZE.

Используется в SetSelectedTrackFromCategory().

SelectRandomTrackIndexFromCategoryPriorityFlagFirst()

int SelectRandomTrackIndexFromCategoryPriorityFlagFirst ( EDynamicMusicPlayerCategory category, notnull array< ref DynamicMusicTrackData > tracks )

inlineprivate

main menu priority tracks first

fallback in case there is no priority track

    {
        if (category == EDynamicMusicPlayerCategory.MENU)
        {
            array<int> priorityFlagIndices = new array<int>();
            
            foreach (int i, DynamicMusicTrackData track : tracks)
            {
 
                if (!track.m_HasPriority)
                    continue;
 
                priorityFlagIndices.Insert(i);
            }
 
            if (priorityFlagIndices.Count() > 0)
                return priorityFlagIndices[priorityFlagIndices.GetRandomIndex()];
 
            return tracks.GetRandomIndex();
        }
 
        return INDEX_NOT_FOUND;
    }

Перекрестные ссылки INDEX_NOT_FOUND.

Используется в SetSelectedTrackFromCategory().

SetCategory()

void SetCategory ( EDynamicMusicPlayerCategory category, bool forced )

inlineprivate

    {
        if (m_DynamicMusicPlayerRegistry == null)
            return;
 
        m_CategorySelected = category;
        
        OnCategorySet(category, forced);
    }

Перекрестные ссылки m_CategorySelected, m_DynamicMusicPlayerRegistry и OnCategorySet().

Используется в OnFadeoutFinished(), OnLocationMatched() и OnUpdate().

SetSelectedTrackFromCategory()

bool SetSelectedTrackFromCategory ( EDynamicMusicPlayerCategory category, notnull ref array< ref DynamicMusicTrackData > tracklist, int historyLookupType = DynamicMusicPlayerTrackHistoryLookupType.ANY )

inlineprivate

currently prioritize main menu track on DMP start

    {
        if (tracklist.Count() == 0)
            return true;
 
        array<ref DynamicMusicTrackData> filteredTracks = new array<ref DynamicMusicTrackData>();
        foreach (DynamicMusicTrackData filteredTrack : tracklist)
        {
            if (filteredTrack.m_TimeOfDay == m_ActualTimeOfDay || filteredTrack.m_TimeOfDay == DynamicMusicPlayerTimeOfDay.ANY)
                filteredTracks.Insert(filteredTrack);
        }
 
        float trackIndex;
        if (m_Created && category == EDynamicMusicPlayerCategory.MENU)
            trackIndex = SelectRandomTrackIndexFromCategoryPriorityFlagFirst(category, filteredTracks);
        else
            trackIndex = SelectRandomTrackIndexFromCategory(category, historyLookupType, filteredTracks);
 
        if (trackIndex > INDEX_NOT_FOUND)
        {
            m_LastPlayedTrackBufferPerCategory[category].Add(trackIndex);
            OnNextTrackSelected(filteredTracks[trackIndex], GetWaitTimeForCategory(category));
 
            return true;
        }
        
        return false;
    }

Перекрестные ссылки GetWaitTimeForCategory(), INDEX_NOT_FOUND, m_Created, m_LastPlayedTrackBufferPerCategory, OnNextTrackSelected(), SelectRandomTrackIndexFromCategory() и SelectRandomTrackIndexFromCategoryPriorityFlagFirst().

Используется в DetermineTrackByCategory().

SetTimeOfDate()

void SetTimeOfDate ( )

inlineprivate

    {
        if (g_Game.GetMission())
        {
            int year, month, day, hour, minute;
            GetGame().GetWorld().GetDate(year, month, day, hour, minute);
 
            float sunriseTimeStart = g_Game.GetMission().GetWorldData().GetApproxSunriseTime(month);
            float sunsetTimeStart = g_Game.GetMission().GetWorldData().GetApproxSunsetTime(month);
            if (hour >= sunriseTimeStart && hour < (sunriseTimeStart + 2))
            {
                m_ActualTimeOfDay = DynamicMusicPlayerTimeOfDay.DAWN;
                return;
            }
            
            if (hour >= sunsetTimeStart && hour < (sunsetTimeStart + 2))
            {
                m_ActualTimeOfDay = DynamicMusicPlayerTimeOfDay.DUSK;
                return;
            }
            
        }
        
        m_ActualTimeOfDay = g_Game.GetWorld().GetSunOrMoon();
    }

Перекрестные ссылки g_Game и GetGame().

Используется в DynamicMusicPlayer() и OnUpdate().

StopTrack()

void StopTrack ( )

inlineprivate

    {
        if (m_SoundPlaying)
            m_SoundPlaying.Stop();
    }

Перекрестные ссылки m_SoundPlaying и AbstractWave::Stop().

Используется в OnFadeoutFinished() и OnProfileOptionChanged().

UnregisterDynamicLocation()

void UnregisterDynamicLocation ( notnull Entity caller )

inlineprivate

    {
        m_LocationsDynamic.Remove(caller.GetID());
    }

Поля

LOCATION_DISTANCE_MAX

const float LOCATION_DISTANCE_MAX = 500

protected

Используется в RefreshTracksCache().

m_CategorySelected

EDynamicMusicPlayerCategory m_CategorySelected

protected

Используется в DetermineTrackByCategory(), DynamicMusicPlayer(), IsPriotitizedCategorySelected(), OnLocationMatched(), OnProfileOptionChanged(), OnUpdate() и SetCategory().

m_Created

bool m_Created

private

Используется в DynamicMusicPlayer(), OnNextTrackSelected() и SetSelectedTrackFromCategory().

m_CurrentTrack

DynamicMusicTrackData m_CurrentTrack

protected

Используется в FadeoutTrack(), OnNextTrackSelected(), OnTrackEnded(), OnTrackStopped(), PlayTrack() и ResetWaitingQueue().

m_DynamicMusicPlayerRegistry

ref DynamicMusicPlayerRegistry m_DynamicMusicPlayerRegistry

protected

Используется в DetermineTrackByCategory(), DynamicMusicPlayer(), GetMaxWaitTimePerCategory(), GetMinWaitTimePerCategory(), GetPreviousTrackFadeoutSeconds(), OnUpdate(), RefreshTracksCache() и SetCategory().

m_FadeoutInProgress

bool m_FadeoutInProgress

private

Используется в FadeoutTrack() и OnUpdate().

m_FadeoutTimeElapsed

float m_FadeoutTimeElapsed

private

Используется в DynamicMusicPlayer(), OnUpdate() и ProcessFadeOut().

m_FadeoutTimeRequested

float m_FadeoutTimeRequested

private

Используется в DynamicMusicPlayer(), FadeoutTrack(), OnUpdate() и ProcessFadeOut().

m_LastPlayedTrackBufferPerCategory

ref map<EDynamicMusicPlayerCategory, ref SimpleCircularBuffer<int> > m_LastPlayedTrackBufferPerCategory

private

gets the playback mode as set in sounds menu; 0 - all; 1 - menu only

Используется в DynamicMusicPlayer(), SelectRandomTrackIndexFromCategory() и SetSelectedTrackFromCategory().

m_PlayerPosition

vector m_PlayerPosition

private

Используется в OnUpdate(), PlayerInsideOfLocationFilter(), PlayerInsideOfLocationFilter() и RefreshTracksCache().

m_SoundPlaying

AbstractWave m_SoundPlaying

protected

Используется в FadeoutTrack(), IsPlaybackActive(), OnFadeoutFinished(), OnTrackEnded(), OnTrackStopped(), PlayTrack(), ProcessFadeOut() и StopTrack().

m_TickFadeOutProcessingElapsed

float m_TickFadeOutProcessingElapsed

protected

Используется в OnUpdate().

m_TickLocationCacheUpdateElapsed

float m_TickLocationCacheUpdateElapsed

protected

Используется в OnUpdate().

m_TickLocationUpdateElapsed

float m_TickLocationUpdateElapsed

protected

Используется в OnUpdate().

m_TickPriorityLocationUpdateElapsed

float m_TickPriorityLocationUpdateElapsed

protected

Используется в OnUpdate().

m_TickTimeOfDateElapsed

float m_TickTimeOfDateElapsed

protected

Используется в OnUpdate().

m_TracksLocationMatchedPlayerInside

ref array<ref DynamicMusicTrackData> m_TracksLocationMatchedPlayerInside

protected

static prio + filtered by the distance between player and center of zone

Используется в DetermineTrackByCategory(), DynamicMusicPlayer() и PlayerInsideOfLocationFilter().

m_TracksLocationStaticCached

ref array<ref DynamicMusicTrackData> m_TracksLocationStaticCached

private

map of dynamically registered locations during runtime

Используется в DynamicMusicPlayer(), OnUpdate() и RefreshTracksCache().

m_TracksLocationStaticPrioritizedCached

ref array<ref DynamicMusicTrackData> m_TracksLocationStaticPrioritizedCached

private

static + filtered by the distance between player and center of zone

Используется в DynamicMusicPlayer(), OnUpdate() и RefreshTracksCache().

m_WaitingForPlayback

bool m_WaitingForPlayback

private

Используется в IsPlaybackActive(), OnNextTrackSelected(), OnTrackEnded(), OnTrackStopped(), PlayTrack() и ResetWaitingQueue().

TICK_FADEOUT_PROCESSOR_SECONDS

const float TICK_FADEOUT_PROCESSOR_SECONDS = 0.2

protected

Используется в OnUpdate().

TICK_LOCATION_CACHE_UPDATE_SECONDS

const float TICK_LOCATION_CACHE_UPDATE_SECONDS = 120.0

protected

Используется в OnUpdate().

TICK_LOCATION_UPDATE_SECONDS

const float TICK_LOCATION_UPDATE_SECONDS = 120.0

protected

Используется в OnUpdate().

TICK_PRIORITY_LOCATION_UPDATE_SECONDS

const float TICK_PRIORITY_LOCATION_UPDATE_SECONDS = 30.0

protected

Используется в OnUpdate().

TICK_TIME_OF_DATE_UPDATE_SECONDS

const float TICK_TIME_OF_DATE_UPDATE_SECONDS = 300.0

protected

Используется в OnUpdate().

TRACKS_BUFFER_HISTORY_SIZE

const int TRACKS_BUFFER_HISTORY_SIZE = 2

protected

Используется в DynamicMusicPlayer() и SelectRandomTrackIndexFromCategory().

---

Объявления и описания членов класса находятся в файле:

• D:/Ishodniki/scripts/3_Game/Systems/DynamicMusicPlayer/DynamicMusicPlayer.c