Файл DynamicMusicPlayer.c

См. исходные тексты.

Структуры данных
class	DynamicMusicLocationTypes
class	DynamicMusicPlayerSettings
class	DynamicMusicPlayerTrackHistoryLookupType
class	DynamicMusicPlayerTimeOfDay
	for backward compatibility Подробнее...

Функции
static array< vector >	GetRectangularCoordsFromSize (vector origin, float size)
void	InsertLocation (vector min, vector max)
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	OnGameEvent (EventType eventTypeId, Param params)
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)
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	GetWaitTimeForCategory (EDynamicMusicPlayerCategory category)
float	GetMinWaitTimePerCategory (EDynamicMusicPlayerCategory category)
float	GetMaxWaitTimePerCategory (EDynamicMusicPlayerCategory category)
float	GetPreviousTrackFadeoutSeconds (EDynamicMusicPlayerCategory category)
void	RefreshTracksCache ()

Переменные
class DynamicMusicLocationTypes	m_Type = DynamicMusicLocationTypes.NONE
vector	m_Min = vector.Zero
	rectangle coords (2d only)
vector	m_Max = vector.Zero
class DynamicMusicPlayerSettings	m_HasPriority = false
int	m_TimeOfDay = -1
int	m_LocationType = DynamicMusicLocationTypes.NONE
string	m_SoundSet
EDynamicMusicPlayerCategory	m_Category
ref array< ref array< vector > >	locationBoundaries = new ref array<ref array<vector>>()
class DynamicMusicPlayerTrackHistoryLookupType	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_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
ref array< ref DynamicMusicTrackData >	m_TracksLocationMatchedPlayerInside
	static prio + filtered by the distance between player and center of zone
AbstractWave	m_SoundPlaying
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

Функции

DetermineTrackByCategory()

void DetermineTrackByCategory ( EDynamicMusicPlayerCategory category )

protected

    {
        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;
        }
    }

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

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

DynamicMusicPlayer()

void DynamicMusicPlayer ( DynamicMusicPlayerRegistry configuration )

private

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;
    }

Перекрестные ссылки WorldDataDaytime::ANY, 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.

Используется в MissionBaseWorld::MissionBase().

FadeoutTrack()

void FadeoutTrack ( float fadeoutSeconds )

private

    {
        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.

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

GetMaxWaitTimePerCategory()

float GetMaxWaitTimePerCategory ( EDynamicMusicPlayerCategory category )

private

    {
        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 )

private

    {
        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 )

private

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

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

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

GetRectangularCoordsFromSize()

static array< vector > GetRectangularCoordsFromSize ( vector origin, float size )

static

    {
        vector min = Vector(origin[0] - size, origin[1], origin[2] - size);
        vector max = Vector(origin[0] + size, origin[1], origin[2] + size);
        
        return {min, max};
    }

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

GetWaitTimeForCategory()

float GetWaitTimeForCategory ( EDynamicMusicPlayerCategory category )

protected

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

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

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

InsertLocation()

void InsertLocation	(	vector	min,
		vector	max )

    {
        locationBoundaries.Insert({min, max});
    }

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

IsPlaybackActive()

bool IsPlaybackActive ( )

protected

    {
        return m_SoundPlaying || m_WaitingForPlayback;
    }

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

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

IsPriotitizedCategorySelected()

bool IsPriotitizedCategorySelected ( )

protected

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

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

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

OnCategorySet()

void OnCategorySet ( EDynamicMusicPlayerCategory category, bool forced )

protected

    {
        #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 )

protected

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

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

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

OnGameEvent()

void OnGameEvent ( EventType eventTypeId, Param params )

private

    {
        if (eventTypeId == MPSessionPlayerReadyEventTypeID)
        {
            SetTimeOfDate();
            SetCategory(EDynamicMusicPlayerCategory.TIME, false);
        }
    }

Перекрестные ссылки MPSessionPlayerReadyEventTypeID, SetCategory() и SetTimeOfDate().

OnLocationMatched()

void OnLocationMatched ( EDynamicMusicPlayerCategory category, bool isPriorityLocation )

protected

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 )

protected

    {
        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 )

protected

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 ( )

protected

    {
        #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 и m_WaitingForPlayback.

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

OnTrackStopped()

void OnTrackStopped ( )

protected

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 и m_WaitingForPlayback.

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

OnUpdate()

void OnUpdate ( float timeslice )

private

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 )

private

    {
        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 )

private

    {
        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 )

private

---

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 ( )

private

    {
        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 ( )

private

    {
        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 )

private

    {
        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 ( )

private

    {       
        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 )

private

    {
        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;
    }

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

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

SelectRandomTrackIndexFromCategoryPriorityFlagFirst()

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

private

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 )

private

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

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

Используется в BIOSErrorModule::BIOSErrorModule(), ClientKickedModule::ClientKickedModule(), ConnectErrorClientModule::ConnectErrorClientModule(), ConnectErrorServerModule::ConnectErrorServerModule(), OnFadeoutFinished(), OnGameEvent(), OnLocationMatched() и OnUpdate().

SetSelectedTrackFromCategory()

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

private

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;
    }

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

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

SetTimeOfDate()

void SetTimeOfDate ( )

private

    {
        if (g_Game.GetMission())
        {
            m_ActualTimeOfDay = g_Game.GetMission().GetWorldData().GetDaytime();
            return;
        }
 
        m_ActualTimeOfDay = DynamicMusicPlayerTimeOfDay.DAY;
    }

Перекрестные ссылки WorldDataDaytime::DAY и g_Game.

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

StopTrack()

void StopTrack ( )

private

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

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

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

UnregisterDynamicLocation()

void UnregisterDynamicLocation ( notnull Entity caller )

private

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

Переменные

LOCATION_DISTANCE_MAX

const float LOCATION_DISTANCE_MAX = 500

protected

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

locationBoundaries

ref array<ref array<vector> > locationBoundaries = new ref array<ref array<vector>>()

Используется в InsertLocation() и DynamicMusicPlayerRegistry::RegisterTrackLocationStaticMultiRectangle().

m_Category

EDynamicMusicPlayerCategory m_Category

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(), MissionBaseWorld::InitialiseWorldData(), MissionBaseWorld::MissionBase(), 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_HasPriority

class DynamicMusicPlayerSettings m_HasPriority = false

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_LocationType

int m_LocationType = DynamicMusicLocationTypes.NONE

m_Max

vector m_Max = vector.Zero

m_Min

vector m_Min = vector.Zero

rectangle coords (2d only)

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_SoundSet

string m_SoundSet

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_TimeOfDay

int m_TimeOfDay = -1

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_Type

class DynamicMusicLocationTypes m_Type = DynamicMusicLocationTypes.NONE

Используется в MindStateSoundEventBase::AlertedMoveSoundEvent(), DisplayElementBadge::BadgeBleeding(), DisplayElementBadge::BadgeFracture(), DisplayElementBadge::BadgeHeartbeat(), DisplayElementBadge::BadgeLegs(), DisplayElementBadge::BadgePills(), DisplayElementBadge::BadgePoisoned(), DisplayElementBadge::BadgeSick(), DisplayElementBadge::BadgeStuffed(), DisplayElementBadge::BadgeWet(), BotStateBase::Bot_TestSpawnOpen(), BotStateBase::BotSpawnEntityInHands(), MindStateSoundEventBase::CalmMoveSoundEvent(), CalmMoveSoundEvent(), CanPlay(), MindStateSoundEventBase::ChaseMoveSoundEvent(), ChaseMoveSoundEvent(), PlayerSoundEventBase::DamageSoundEvents(), PlayerSoundEventBase::DrowningEvents(), ContaminatedArea_Dynamic::EEInit(), DisplayElementBase::ElementStance(), HoldBreathSoundEventBase::ExhaustedBreathSoundEvent(), ExhaustedBreathSoundEvent(), PlayerSoundEventBase::ForceConsumeSoundEvent(), Managed::GameplayEffectsData(), GetType(), MessageReceiverBase::GetType(), Managed::GetWidgetSetType(), HasPriorityOverCurrent(), PlayerSoundEventBase::HeatComfortEventsBase(), HoldBreathSoundEventBase(), InfectedSoundEventBase(), AgentBase::Init(), Managed::Init(), Init(), Init(), UndergroundBunkerTrigger::Init(), PlayerSoundEventBase::InjurySoundEvents(), PlayerSoundEventBase::MeleeAttackSoundEvents(), BotStateBase::OnEntry(), OnRPC(), OnUpdateServer(), PlayerSoundEventBase::PickupHeavySoundEvent(), PickupHeavySoundEvent(), PlayerSoundEventBase(), HandEventBase::ReadFromContext(), SetType(), StaminaModifier(), StaminaSoundEventBase::StaminaNormalDummy(), PlayerSoundEventBase::StaminaSoundEventBase(), PlayerSoundEventBase::SymptomSoundEventBase(), DisplayElementTendency::TendencyBacteria(), DisplayElementTendency::TendencyBlood(), DisplayElementTendency::TendencyHealth(), DisplayElementTendency::TendencyHunger(), DisplayElementTendency::TendencyTemperature(), DisplayElementTendency::TendencyThirst() и HandEventBase::WriteToContext().

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

class DynamicMusicPlayerTrackHistoryLookupType TICK_TIME_OF_DATE_UPDATE_SECONDS = 300.0

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

TRACKS_BUFFER_HISTORY_SIZE

const int TRACKS_BUFFER_HISTORY_SIZE = 2

protected

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