Frictional Game Wiki

<h2>helper_audio.hps</h2> <div class="level2"> <p> Helper functions for handling sound, music and dialogue </p> </div> <h5>_Sound_Global_EntryAffected</h5> <div class="level5"> <pre class="code c++">bool _Sound_Global_EntryAffected<span class="br0">(</span><span class="kw4">int</span> alIdx<span class="sy0">,</span> eSoundEntryType aAffectedTypes<span class="br0">)</span> </pre><p> </p> <hr /> </div> <h5>Sound_SetGlobalSpeed</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_SetGlobalSpeed<span class="br0">(</span><span class="kw4">float</span> afFreq<span class="sy0">,</span> eSoundEntryType aAffectedTypes<span class="sy0">=</span>eSoundEntryType_WorldAll<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Sets the relative frequency of all sounds. </p> <ul> <li class="level1"> <b>afFreq</b>: the relative frequency to use. 1= normal, 2=doubled, 0.5=half as fast, etc</li> <li class="level1"> <b>aAffectedTypes</b>: The kind of sounds affected, possible values: eSoundEntryType_World, eSoundEntryType_WorldClean, eSoundEntryType_WorldAll, eSoundEntryType_Gui or eSoundEntryType_All</li> </ul> <hr /> </div> <h5>Sound_FadeGlobalSpeed</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_FadeGlobalSpeed<span class="br0">(</span><span class="kw4">float</span> afFreq<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="sy0">,</span> eSoundEntryType aAffectedTypes<span class="sy0">=</span>eSoundEntryType_WorldAll<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Fade the relative frequency of all sounds. </p> <ul> <li class="level1"> <b>afFreq</b>: the relative frequency to use. 1= normal, 2=doubled, 0.5=half as fast, etc</li> <li class="level1"> <b>afTime</b>: the time which the fade takes</li> <li class="level1"> <b>aAffectedTypes</b>: The kind of sounds affected, possible values: eSoundEntryType_World, eSoundEntryType_WorldClean, eSoundEntryType_WorldAll, eSoundEntryType_Gui or eSoundEntryType_All</li> </ul> <hr /> </div> <h5>Sound_SetGlobalVolume</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_SetGlobalVolume<span class="br0">(</span><span class="kw4">float</span> afVolume<span class="sy0">,</span> eSoundEntryType aAffectedTypes<span class="sy0">=</span>eSoundEntryType_WorldAll<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Set the relative volume of all sounds. </p> <ul> <li class="level1"> <b>afVolume</b>: the relative volume to use. possible values: 0 - 1</li> <li class="level1"> <b>aAffectedTypes</b>: The kind of sounds affected, possible values: eSoundEntryType_World, eSoundEntryType_WorldClean, eSoundEntryType_WorldAll, eSoundEntryType_Gui or eSoundEntryType_All</li> </ul> <hr /> </div> <h5>Sound_FadeGlobalVolume</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_FadeGlobalVolume<span class="br0">(</span><span class="kw4">float</span> afVolume<span class="sy0">,</span> <span class="kw4">float</span> afTime<span class="sy0">,</span> eSoundEntryType aAffectedTypes<span class="sy0">=</span>eSoundEntryType_WorldAll<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Fade the relative volume of all sounds. </p> <ul> <li class="level1"> <b>afVolume</b>: the relative volume to use. possible values: 0 - 1</li> <li class="level1"> <b>afTime</b>: the time which the fade takes</li> <li class="level1"> <b>aAffectedTypes</b>: The kind of sounds affected, possible values: eSoundEntryType_World, eSoundEntryType_WorldClean, eSoundEntryType_WorldAll, eSoundEntryType_Gui, , eSoundEntryType_GuiWorld or eSoundEntryType_All</li> </ul> <hr /> </div> <h5>Sound_CreateAIEventAtEntity</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_CreateAIEventAtEntity<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asEntity<span class="sy0">,</span> <span class="kw4">float</span> afRadius<span class="sy0">,</span> <span class="kw4">int</span> alPrio<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Creates an event that is heard by any entity with the Listener component </p> <ul> <li class="level1"> <b>asEntity</b>: Name of the entity to create it at. Wildcardds (*) possible.</li> <li class="level1"> <b>afRadius</b>: How big the event's sphere of influence will be.</li> <li class="level1"> <b>alPrio</b>: The prio of the event. Some listener sort out certain prios.</li> </ul> <hr /> </div> <h5>Sound_CreateAtEntity</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_CreateAtEntity<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSoundName<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asSoundFile<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asEntity<span class="sy0">,</span> <span class="kw4">float</span> afFadeTime<span class="sy0">=</span><span class="nu17">0.0f</span><span class="sy0">,</span> bool abSaveSound<span class="sy0">=</span><span class="kw2">false</span><span class="sy0">,</span> <span class="kw4">float</span> afTargetVolume<span class="sy0">=</span><span class="nu17">1.0f</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Create and play a sound (.snt) file at the position of an entity or player. </p> <ul> <li class="level1"> <b>asSoundName</b>: name of the sound that is used when you like to, for example, stop it.</li> <li class="level1"> <b>asSoundFile</b>: name of the FMOD event or .snt sound file to play. FMOD always needs to be full path ie "project/event_group(s)/event".</li> <li class="level1"> <b>asEntity</b>: name of the entity to play the sound at, can also be "player".</li> <li class="level1"> <b>afFadeTime</b>: fade in the sound during this many seconds, 0 = no fade.</li> <li class="level1"> <b>abSaveSound</b>: if the sound should be saved, ie if sound loops and the sound should play on exit and enter of the level.</li> <li class="level1"> <b>afTargetVolume</b>: the volume (0.0 - 1.0) the sound should be played at. Defaults to 1.0f.</li> </ul> <hr /> </div> <h5>Sound_CreateAtEntity_UsePrefix</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Sound_CreateAtEntity_UsePrefix<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSoundName<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asSoundFile<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asEntity<span class="sy0">,</span> <span class="kw4">float</span> afFadeTime<span class="sy0">,</span> bool abSaveSound<span class="sy0">,</span> <span class="kw4">float</span> afTargetVolume<span class="sy0">=</span><span class="nu17">1.0f</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Create and play a sound (.snt) file at the position of an entity or player. If a Soundscape area SoundPrefix is set, then that will be used as a parent folder for the sound. </p> <ul> <li class="level1"> <b>asSoundName</b>: name of the sound that is used when you like to, for example, stop it.</li> <li class="level1"> <b>asSoundFile</b>: name of the FMOD event or .snt sound file to play. FMOD always needs to be full path ie "project/event_group(s)/event". If the prefix is not _ckgedit_QUOT<u>ckgedit>, then the path is "project/event_group(s)/prefix/event". * <b>asEntity</b>: name of the entity to play the sound at, can also be "player". * <b>afFadeTime</b>: fade in the sound during this many seconds, 0 = no fade. * <b>abSaveSound</b>: if the sound should be saved, ie if sound loops and the sound should play on exit and enter of the level. * <b>afTargetVolume</b>: the volume (0.0 - 1.0) the sound should be played at. Defaults to 1.0f. —- == Sound_Play == <code c++> void Sound_Play(const tString &in asSoundName, float afFadeTime, bool abResetVolMul=false) </code> <span class='np_break'> </span> Play a sound that exists in the level editor, attached to an entity, or previously created that has been stopped and now should be played again. * <b>asSoundName</b>: name of the sounds that you would like to play. Wildcard(s) * are supported. * <b>afFadeTime</b>: fade in the sound during this many seconds, 0 = no fade. * <b>abResetVolMul</b>: reset the FadeVolumeMul set when using Sound_Fade. —- == Sound_Stop == <code c++> void Sound_Stop(const tString &in asSoundName, float afFadeTime) </code> <span class='np_break'> </span> Stop a sound that is currently playing. Can be sound entities or Gui sounds. * <b>asSoundName</b>: name of the sound that you would like to stop. Wildcard(s) * are supported. * <b>afFadeTime</b>: fade out the sound during this many seconds, 0 = no fade. Must be 0 if using a FMOD sound event with Sustain Point. —- == Sound_Fade == <code c++> void Sound_Fade(const tString &in asSoundName, float afVolumeDest, float afFadeTime) </code> <span class='np_break'> </span> Fade/Change the volume of a sound entity. * <b>asSoundName</b>: the sound file to fade. Wildcard(s) * are supported. * <b>afVolumeDest</b>: at what relative volume to fade the sound to. 1 = default volume of entity, can't go over 1. * <b>afFadeTime</b>: how long in seconds the fade should take. —- == Sound_PlayGui == <code c++> void Sound_PlayGui(const tString &in asSoundFile, float afVolume, eSoundEntryType aEntryType=eSoundEntryType_Gui) </code> <span class='np_break'> </span> Play a sound without any world position, either .snt files or any of the supported formats (.wav, .ogg etc) without the need of a .snt file. * <b>asSoundFile</b>: the sound file to play. * <b>afVolume</b>: at what volume to play the sound. * <b>aEntryType</b>: the entry type of the sound. —- == Sound_FadeInGui == <code c++> void Sound_FadeInGui(const tString &in asSoundFile, float afVolume, float afFadeTime) </code> <span class='np_break'> </span> Fades in a GUI sound. This is can called directly after Sound_PlayGui or in case the sound doesn't exist, start it. * <b>asSoundFile</b>: the sound file for the sound that is playing * <b>afVolume</b>: volume to fade in to. * <b>afFadeTime</b>: Time it takes to fade it out —- == Sound_StopGui == <code c++> void Sound_StopGui(const tString &in asSoundFile, float afFadeTime, bool abPlayEnd=true) </code> <span class='np_break'> </span> Stops a GUI sounds * <b>asSoundFile</b>: the sound file for the sound that is playing * <b>afFadeTime</b>: Time it takes to fade it out * <b>abPlayEnd</b>: If the end (setup in the event) should be played. Only applicable is afFadeTime is 0 —- == Sound_FadeGuiVolume == <code c++> void Sound_FadeGuiVolume(const tString &in asSoundFile, float afVolumeDest, float afFadeTime) </code> <span class='np_break'> </span> Fades a GUI sound volume to another * <b>asSoundFile</b>: the sound file for the sound that is playing * <b>afVolumeDest</b>: The new volume (note, if 0 it will not stop!) * <b>afFadeTime</b>: Time the fade takes —- == Sound_FadeGuiSpeed == <code c++> void Sound_FadeGuiSpeed(const tString &in asSoundFile, float afSpeedDest, float afFadeTime) </code> <span class='np_break'> </span> Fades a GUI sound speed to another * <b>asSoundFile</b>: the sound file for the sound that is playing * <b>afSpeedDest</b>: The new speed (note, if 0 it will not stop!) * <b>afFadeTime</b>: Time the fade takes —- == Sound_SetGuiParam == <code c++> void Sound_SetGuiParam(const tString &in asSoundFile, const tString &in asParam, float afValue) </code> <span class='np_break'> </span> Sets the param of a gui sound * <b>asSoundFile</b>: the sound file for the sound that is playing * <b>asParam</b>: The param variable name * <b>afValue</b>: The new value to give it. —- == Sound_GuiIsPlaying == <code c++> bool Sound_GuiIsPlaying(const tString &in asSoundFile) </code> <span class='np_break'> </span> Checks if a gui sound is playing. * <b>asSoundFile</b>: the sound file for the sound that is playing —- == Sound_PreloadGroup == <code c++> void Sound_PreloadGroup(const tString &in asInternalPath, bool abSubGroups) </code> <span class='np_break'> </span> Preloads a group of sounds and its subgroups if selected Preloading removes lag spikes that can occur when loading a sound from the hdd * <b>asInternalPath</b>: path of the sound eg. "physics/metal" * <b>abSubGroups</b>: if the subgroups should be loaded —- == Sound_PreloadProject == <code c++> void Sound_PreloadProject(const tString &in asName) </code> <span class='np_break'> </span> Preloads a whole sound project and all sounds within it Preloading removes lag spikes that can occur when loading a sound from the hdd * <b>asName</b>: name of the sound project file —- == Sound_PreloadCoreSounds == <code c++> void Sound_PreloadCoreSounds() </code> <span class='np_break'> </span> Preloads all the basic sounds —- == Sound_PreloadCoreUWSounds == <code c++> void Sound_PreloadCoreUWSounds() </code> <span class='np_break'> </span> —- == Sound_PreloadCoreInteractions == <code c++> void Sound_PreloadCoreInteractions() </code> <span class='np_break'> </span> —- == Sound_PreloadCoreUWInteractions == <code c++> void Sound_PreloadCoreUWInteractions() </code> <span class='np_break'> </span> —- == Sound_Exists == <code c++> bool Sound_Exists(const tString &in asSoundName) </code> <span class='np_break'> </span> Returns true or false if a given sound entity exists * <b>asSoundName</b>: name of the sound entity. Can contain wildcards. —- == Music_PlayExt == <code c++> void Music_PlayExt(const tString &in asFile, bool abLoop, float afVolume, float afFreq, float afVolumeFadeTime, float afFreqFadeTime, eMusicPrio alPrio, bool abResume) </code> <span class='np_break'> </span> Play music with extended options. * <b>asFile</b>: name (opt: path) of the music file to play. * <b>abLoop</b>: if the music should loop when it reaches the end. * <b>afVolume</b>: at what volume to play the music at (0.0 - 1.0). * <b>afFreq</b>: at what frequency to play the music, 1 = standard freq. * <b>afVolumeFadeTime</b>: how many seconds to fade in the music, 0 = no fade. * <b>afFreqFadeTime</b>: how many seconds to fade in the frequence change. * <b>alPrio</b>: priority of the music track. A higher priority will stop a lower priority track. * <b>abResume</b>: if the music should be resumed if it is stopped and played again. —- == Music_Play == <code c++> void Music_Play(const tString &in asFile, float afVolume, bool abLoop, eMusicPrio alPrio) </code> <span class='np_break'> </span> Play music at standard frequency with a default fade time of 0.3 seconds. * <b>asFile</b>: name (opt: path) of the music file to play. * <b>afVolume</b>: at what volume to play the music at (0.0 - 1.0). * <b>abLoop</b>: if the music should loop when it reaches the end. * <b>alPrio</b>: priority of the music track. A higher priority will stop a lower priority track. —- == Music_PlayOverlay == <code c++> void Music_PlayOverlay(const tString &in asFile, float afVolume) </code> <span class='np_break'> </span> Plays a piece of music over the currently running music TODO: Needs to have proper code! * <b>asFile</b>: name (opt: path) of the music file to play. * <b>afVolume</b>: at what volume to play the music at (0.0 - 1.0). —- == Music_Stop == <code c++> void Music_Stop(float afFadeTime, eMusicPrio alPrio) </code> <span class='np_break'> </span> Stop a music track for a certain priority from playing. * <b>afFadeTime</b>: how many seconds it takes to fade the volume to 0. * <b>alPrio</b>: priority of the music track that should be stopped. —- == Music_StopAll == <code c++> void Music_StopAll(float afFadeTime) </code> <span class='np_break'> </span> Stop a music tracks for all priorities * <b>afFadeTime</b>: how many seconds it takes to fade the volume to 0. —- == Music_AddDynamicTrack == <code c++> void Music_AddDynamicTrack(tID a_idEntity, int alTrackPrio, eMusicPrio alMusicPrio, const tString &in asFile, float afVolume, float afFadeInTime, float afFadeOutTime) </code> <span class='np_break'> </span> This adds music that is meant to only be played during a certain occurance, eg when an creature is hunting the player. * <b>a_idEntity</b>: Id of the entity that cause the occurance to happen * <b>alTrackPrio</b>: priority of this track instnace, in case there are many. If two tracks have the same prio, music prio is compared. * <b>alMusicPrio</b>: The prio of the music to be played. * <b>asFile</b>: File of the music to play. * <b>afVolume</b>: volume of the music to play * <b>afFadeInTime</b>: time it takes for the music to fade in * <b>afFadeOutTime</b>: time it takes for the music to fade out. Not used if there is a swithc to another dynamic track. —- == Music_RemoveDynamicTrack == <code c++> void Music_RemoveDynamicTrack(tID a_idEntity) </code> <span class='np_break'> </span> This removes the dynamic track for certain entity and, if playing, fades out the music associated with it. * <b>a_idEntity</b>: Id of the entity that cause the occurance to happen —- == Music_FadeVolumeMul == <code c++> void Music_FadeVolumeMul(float afMul, float afTime) </code> <span class='np_break'> </span> Fades the volume multiplier for music. * <b>afMul</b>: target volume multiplier. Default is 1. * <b>afTime</b>: time to fade to the target multiplier. —- == Voice_Play == <code c++> bool Voice_Play(const tString &in asSubject, int alSpecificLineIdx=-1, const tString &in asCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>, int alPrio=0) </code> <span class='np_break'> </span> Starts playing a voice * <b>asSubject</b>: The name of the subject to play. * <b>alSpecificLineIdx</b>: if 0 or higher then a specific line index will be played. Set as -1 to play as stated in the data. * <b>asCallback</b>: called when subject is done playing. Syntax: void Func(const tString&in asScene, const tString&in asSubject) * <b>alPrio</b>: The priority of the voice, if higher than the currently playing, the current gets stopped and replaced, else this voice is not played. —- == Voice_PlayWhenPossible == <code c++> void Voice_PlayWhenPossible(const tString &in asSubject, const tString &in asConditionCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>, float afMaxCheckTime=30.0f, float afMinQuietTime=5.0f, const tString &in asVoiceCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>, int alPrio=0) </code> <span class='np_break'> </span> Starts playing a voice, but if another one is already playing it queues it until no other sound is playing and some custom conditions are met. * <b>asSubject</b>: The name of the subject to play. * <b>asConditionCallback</b>: if not _ckgedit_QUOT</u>ckgedit>, this callback will be called to check if the subject can be played. Syntax bool f(const tString& in asSubject)</li> <li class="level1"> <b>afMaxCheckTime</b>: the max amount of time that it wil check if the conditions are met. If time runs out, the subject is never played. If below 0, then time never runs out.</li> <li class="level1"> <b>afMinQuietTime</b>: the minimum amount of time there should have been no other voices playing for it is possible to play the subject. If below 0, then voice playing check is skipped.</li> <li class="level1"> <b>asVoiceCallback</b>: called when subject is done playing. Syntax: void Func(const tString&in asScene, const tString&in asSubject)</li> <li class="level1"> <b>alPrio</b>: The priority of the voice, if higher than the currently playing, the current gets stopped and replaced, else this voice is not played.</li> </ul> <hr /> </div> <h5>_Voice_PlayWhenPossible_CheckTimer</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> _Voice_PlayWhenPossible_CheckTimer<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asTimer<span class="br0">)</span> </pre><p> </p> <hr /> </div> <h5>Voice_AbortIfQueued</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_AbortIfQueued<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> If a subject is queued (still not played) after started with Voice_PlayWhenPossible, use this to remove it and make sure it never plays </p> <ul> <li class="level1"> <b>asSubject</b>: The name of the subject that is queued.</li> </ul> <hr /> </div> <h5>Voice_ClearQueued</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_ClearQueued<span class="br0">(</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Clears all queued subjects. </p> <hr /> </div> <h5>Voice_IsQueued</h5> <div class="level5"> <pre class="code c++">bool Voice_IsQueued<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> If a subject is queued with Voice_PlayWhenPossible, return true </p> <ul> <li class="level1"> <b>asSubject</b>: The name of the subject that is queued.</li> </ul> <hr /> </div> <h5>Voice_SubjectExists</h5> <div class="level5"> <pre class="code c++">bool Voice_SubjectExists<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Checks if the specified subject exists. </p> <ul> <li class="level1"> <b>asSubject</b>: The name of the subject</li> </ul> <hr /> </div> <h5>Voice_GetSubjectLineNumber</h5> <div class="level5"> <pre class="code c++"><span class="kw4">int</span> Voice_GetSubjectLineNumber<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Gets the number of subject lines in a subject. Returns 0 if the subject does not exist. </p> <ul> <li class="level1"> <b>asSubject</b>: The name of the subject</li> </ul> <hr /> </div> <h5>Voice_GetSubjectSceneName</h5> <div class="level5"> <pre class="code c++">tString Voice_GetSubjectSceneName<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Gets the name of the scene that the specified subject belongs to. </p> <ul> <li class="level1"> <b>asSubject</b>: The name of the subject</li> </ul> <p> <b>Returns</b>: tString , The scene the subject belongs to. </p> <hr /> </div> <h5>Voice_SetSource</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SetSource<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asCharacter<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asEntityName<span class="sy0">,</span> <span class="kw4">float</span> afMinDistance<span class="sy0">,</span> <span class="kw4">float</span> afMaxDistance<span class="sy0">,</span> bool abUse3D<span class="sy0">,</span> <span class="kw4">float</span> afMaxPlayerListeningRange<span class="sy0">=-</span><span class="nu0">1</span><span class="sy0">,</span> <span class="kw4">float</span> afMinFreq<span class="sy0">=</span><span class="nu0">22000</span><span class="sy0">,</span> <span class="kw4">float</span> afMaxFreq<span class="sy0">=</span><span class="nu0">22000</span><span class="sy0">,</span> eLuxVoiceSourceFreqencyFlag aFrequencyFlags<span class="sy0">=</span>eLuxVoiceSourceFreqencyFlag_None<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Sets the source of voice. Note that this can be a moving entity. </p> <ul> <li class="level1"> <b>asCharacter</b>: The name of the character (as defined in voice file)</li> <li class="level1"> <b>asEntityName</b>: The entity the sound will be attached to</li> <li class="level1"> <b>afMinDistance</b>: The distance when the volume of the voice start getting lower.</li> <li class="level1"> <b>afMaxDistance</b>: Max distance the voice can be heard.</li> <li class="level1"> <b>abUse3D</b>: If 3D effects (panning) are used for the voice.</li> <li class="level1"> <b>afMaxPlayerListeningRange</b>: The maximum range that the player is considered listening.</li> <li class="level1"> <b>afMinFreq</b>: The cutoff freqeuncy at min distance 0 - 22000 hz</li> <li class="level1"> <b>afMaxFreq</b>: The cutoff freqeuncy at max distance 0 - 22000 hz</li> <li class="level1"> <b>aFrequencyFlags</b>: Which pass the frequency should affect. eLuxVoiceSourceFreqencyFlag, 0 = none, 1 = low pass, 2 = high pass, 3 = both</li> </ul> <hr /> </div> <h5>Voice_StopAll</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_StopAll<span class="br0">(</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Stops all voices playing </p> <hr /> </div> <h5>Voice_Stop</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_Stop<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Stops all voices in a scene. </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file)</li> </ul> <hr /> </div> <h5>Voice_SkipCurrentLine</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SkipCurrentLine<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Skips the current line (same as stop but response triggers are used) </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file)</li> </ul> <hr /> </div> <h5>Voice_SkipCurrentSound</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SkipCurrentSound<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Skips the current sound and jumps to next (if any) </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file)</li> </ul> <hr /> </div> <h5>Voice_AdvanceFromCurrentSound</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_AdvanceFromCurrentSound<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Like SkipCurrentSound, but if there is subtitle it makes sure it is displayed first. </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file)</li> </ul> <hr /> </div> <h5>Voice_SetPaused</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SetPaused<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="sy0">,</span> bool abX<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Stops all voices in a scene. </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file)</li> <li class="level1"> <b>abX</b>: If the scene is to be paused or resumed</li> </ul> <hr /> </div> <h5>Voice_SetPausedAll</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SetPausedAll<span class="br0">(</span>bool abX<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Stops all active voice scenes </p> <ul> <li class="level1"> <b>abX</b>: If all active scenes is to be paused or resumed</li> </ul> <hr /> </div> <h5>Voice_SetFocusScene</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Voice_SetFocusScene<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asScene<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Sets the focus for a scene even if a scene with higher focusprio is playing. This makes the voices in the scene show subtitles and voices from other scenes lower. This will stay in effect until another scene is set. Note that a new subject in a scene with higher focus prio will override this. </p> <ul> <li class="level1"> <b>asScene</b>: Name of the scene (as defined in the voice file). _ckgedit_QUOT<u>ckgedit> sets focus to no scene. —- == Voice_FadeSceneVolumeTo == <code c++> void Voice_FadeSceneVolumeTo(const tString &in asScene, float afVolume, float afTime) </code> <span class='np_break'> </span> Fades the volume of the voices from a specfic scene * <b>asScene</b>: Name of the scene (as defined in the voice file) * <b>afVolume</b>: Volume to fade to, * <b>afTime</b>: The amount of time the fade takes. —- == Voice_CharacterIsSpeaking == <code c++> bool Voice_CharacterIsSpeaking(const tString &in asCharacter) </code> <span class='np_break'> </span> If a character is currently speaking (i.e their voice is played). * <b>asCharacter</b>: Name of the character (as defined in the voice file) —- == Voice_SceneIsActive == <code c++> bool Voice_SceneIsActive(const tString &in asScene) </code> <span class='np_break'> </span> If the specified scene is currently active. * <b>asScene</b>: Name of the scene (as defined in the voice file) <b>Returns</b>: bool, true if scene is currently active. —- == Voice_SubjectIsPlaying == <code c++> bool Voice_SubjectIsPlaying(const tString &in asSubject) </code> <span class='np_break'> </span> If the specified subject is currently being played. * <b>asSubject</b>: Name of the subject (as defined in the voice file) <b>Returns</b>: bool, true if subject is currently active. —- == Voice_AnySceneIsActive == <code c++> bool Voice_AnySceneIsActive() </code> <span class='np_break'> </span> If any scene is currently active. <b>Returns</b>: bool, true if any scene is currently active. —- == Voice_SceneInvolvingCharacterIsActive == <code c++> bool Voice_SceneInvolvingCharacterIsActive(const tString &in asCharacter) </code> <span class='np_break'> </span> True if a scene involving this character is currently active. * <b>asCharacter</b>: Name of the character (as defined in the voice file) <b>Returns</b>: bool, true if any scene involving the character is currently active. —- == Voice_SetCharacterSpeakingCallback == <code c++> void Voice_SetCharacterSpeakingCallback(const tString &in asCharacter, const tString &in asCallback) </code> <span class='np_break'> </span> Sets a callback that is called when a character starts and stops speaking. If character callback exists, the callback func is replaced with the latest one. * <b>asCharacter</b>: Name of the character * <b>asCallback</b>: Callbackfunction. Syntax: bool func(const tString &in asCharacter, bool abStartedTalking), if false is returned the callback is removed. —- == Voice_RemoveCharacterSpeakingCallback == <code c++> void Voice_RemoveCharacterSpeakingCallback(const tString &in asCharacter) </code> <span class='np_break'> </span> Removes a callback that is called when a character starts and stops speaking * <b>asCharacter</b>: Name of the character —- == Dialog_Begin == <code c++> void Dialog_Begin(const tString &in asName=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Begins the declaration of a dialog. Must be called before any other dialog creation is done. * <b>asName</b>: Name of the dialog —- == Dialog_End == <code c++> void Dialog_End(const tString &in asStartBranch=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Ends the declaration of a dialog and starts the dialog. After this no more dialog creation funcs can be called without calling Dialog_Begin again. * <b>asStartBranch</b>: Name of the branch to start playing. If empty first declared branch is started —- == Dialog_SetCallbackFunc == <code c++> void Dialog_SetCallbackFunc(const tString &in asFunc) </code> <span class='np_break'> </span> Sets a callback function for the dialog. NOTE: Currently not used! —- == Dialog_AddBranch == <code c++> void Dialog_AddBranch(const tString &in asName, const tString &in asNextBranch=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Adds a branch (a list of subjects) to the dialog. Dialog_Begin must be called before this is used! * <b>asName</b>: Name of the branch. * <b>asNextBranch</b>: The branch to start playing when this has ended. If empty, no new branch is played after this is over. —- == Dialog_AddBranchAndSubject == <code c++> void Dialog_AddBranchAndSubject(const tString &in asSubjectAndBranchName, const tString &in asNextBranch=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>, const tString &in asCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Adds a branch with a single subject to the dialog. The branch gets the same name as the subject. Dialog_Begin must be called before this is used! * <b>asSubjectAndBranchName</b>: Shared name of both subject and branch. * <b>asNextBranch</b>: The branch to start playing when this has ended. If empty, no new branch is played after this is over. * <b>asCallback</b>: Callback function run at the start and end of subject. Syntax: "void asCallback(const tString&in asSubject, bool abStartOfSubject) —- == Dialog_AddSubject == <code c++> void Dialog_AddSubject(const tString &in asSubject, const tString &in asCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Adds a subject to the latest added branch. The subjects will be played in order they are added. Dialog_AddBranch must be called before this is used! * <b>asSubject</b>: The name of the subject. This is [scene]_[subject], e.g. AdamAndEve_HowAboutEmApples * <b>asCallback</b>: Callback function run at the start and end of subject. Syntax: "void asCallback(const tString&in asSubject, bool abStartOfSubject) —- == Dialog_AddPause == <code c++> void Dialog_AddPause(float afTime, const tString &in asCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Adds a pause to the latest added branch. This pause will come after Dialog_AddBranch must be called before this is used! * <b>afTime</b>: The length of the pause in seconds. * <b>asCallback</b>: Callback function run at the start and end of pause. Syntax: "void asCallback(const tString&in asSubject, bool abStartOfSubject) —- == Dialog_SetResponseTimeLimit == <code c++> void Dialog_SetResponseTimeLimit(float afTime) </code> <span class='np_break'> </span> Set the response time for the response options. This is how long the player has to pick. Dialog_AddSubject must be called before this is used! * <b>afTime</b>: The time before the selection ends. 0=forever, this is default if not set. —- == Dialog_AddResponseOption == <code c++> void Dialog_AddResponseOption(const tString &in asEntry, const tString &in asBranch, int alOptionId=-1, const tString &in asCallback=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>) </code> <span class='np_break'> </span> Adds a response option that is shown after the subject is over. Max number is 4, +1 default (this actually depends on the game implementation, but this the default max). Important: The defauly subject must be added last! Dialog_AddSubject must be called before this is used! * <b>asEntry</b>: This is the entry in the lang file, the category is the level name. If _ckgedit_QUOT</u>ckgedit> this option is used if time runs out. If needed, it must be added last!</li> <li class="level1"> <b>asBranch</b>: Branch that will be switched to if chosen. If _ckgedit_QUOT<u>ckgedit>, no new branch is played after this is over. * <b>alOptionId</b>: Used in callback to see which option was picked (index is not good to use, becuase it is not always the same) * <b>asCallback</b>: Called when the option has been chosen. Syntax: void asCallback(const tString&in asBranch, const tString&in asBranchSubject, int alOptionId) —- == Dialog_AddResponseCondition_VarIsSet == <code c++> void Dialog_AddResponseCondition_VarIsSet(const tString &in asVar) </code> <span class='np_break'> </span> Adds a condition that must be true for the option reponse option to be added. This checks if var is greater than 0. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. —- == Dialog_AddResponseCondition_VarNotSet == <code c++> void Dialog_AddResponseCondition_VarNotSet(const tString &in asVar) </code> <span class='np_break'> </span> Adds a condition that must be true for the option reponse option to be added. This checks if var is less than 1 Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. —- == Dialog_AddResponseCondition_VarEqual == <code c++> void Dialog_AddResponseCondition_VarEqual(const tString &in asVar, int alVal) </code> <span class='np_break'> </span> Adds a condition that must be true for the option reponse option to be added. This checks if var is equal to a value. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. * <b>alVal</b>: Value check is made against. —- == Dialog_AddResponseCondition_VarLesser == <code c++> void Dialog_AddResponseCondition_VarLesser(const tString &in asVar, int alVal) </code> <span class='np_break'> </span> Adds a condition that must be true for the option reponse option to be added. This checks if var is lesser than a value. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. * <b>alVal</b>: Value check is made against. —- == Dialog_AddResponseCondition_VarGreater == <code c++> void Dialog_AddResponseCondition_VarGreater(const tString &in asVar, int alVal) </code> <span class='np_break'> </span> Adds a condition that must be true for the option reponse option to be added. This checks if var is greater than a value. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. * <b>alVal</b>: Value check is made against. —- == Dialog_AddResponseEvent_SetVar == <code c++> void Dialog_AddResponseEvent_SetVar(const tString &in asVar, int alVal=1) </code> <span class='np_break'> </span> Event that happens after option is picked. This sets the value of a variable. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. * <b>alVal</b>: Value that is set —- == Dialog_AddResponseEvent_IncVar == <code c++> void Dialog_AddResponseEvent_IncVar(const tString &in asVar, int alVal=1) </code> <span class='np_break'> </span> Event that happens after option is picked. This increments the value of a variable. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable. * <b>alVal</b>: Value that is added to the variabel. —- == Dialog_AddResponse_OneTimeCheck == <code c++> void Dialog_AddResponse_OneTimeCheck(const tString &in asVar) </code> <span class='np_break'> </span> This makes sure that the option is only shown once. Dialog_AddResponseOption must be called before this is used! * <b>asVar</b>: Name of the variable to keep track of this. —- == Dialog_AddEndEvent_SetVar == <code c++> void Dialog_AddEndEvent_SetVar(const tString &in asVar, int alValue=1) </code> <span class='np_break'> </span> Sets the value of an internal Dialog variableafter a subject is over. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>alValue</b>: The value to set the var. —- == Dialog_AddEndEvent_IncVar == <code c++> void Dialog_AddEndEvent_IncVar(const tString &in asVar, int alValue=1) </code> <span class='np_break'> </span> Increments the value of an internal Dialog variable after a subject is over. If var was not set priorly, it will start with 0. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>alValue</b>: The value to set the var. —- == Dialog_AddEndEvent_VarIsSet == <code c++> void Dialog_AddEndEvent_VarIsSet(const tString &in asVar, const tString &in asNewBranch) </code> <span class='np_break'> </span> Checks if a variable as a value greater than 0 and exists. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_VarEquals == <code c++> void Dialog_AddEndEvent_VarEquals(const tString &in asVar, int alValue, const tString &in asNewBranch) </code> <span class='np_break'> </span> Checks if a variable is equal to a value. If a variable does not exist it will assume to have value 0. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>alValue</b>: value the variable is checked against * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_VarGreater == <code c++> void Dialog_AddEndEvent_VarGreater(const tString &in asVar, int alValue, const tString &in asNewBranch) </code> <span class='np_break'> </span> Checks if a variable is greater than a value. If a variable does not exist it will assume to have value 0. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>alValue</b>: value the variable is checked against * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_VarLesser == <code c++> void Dialog_AddEndEvent_VarLesser(const tString &in asVar, int alValue, const tString &in asNewBranch) </code> <span class='np_break'> </span> Checks if a variable is lesser than a value. If a variable does not exist it will assume to have value 0. Dialog_AddSubject must be called before this is used! * <b>asVar</b>: The name of the var * <b>alValue</b>: value the variable is checked against * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddLineEvent_OutOfRange == <code c++> void Dialog_AddLineEvent_OutOfRange(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of every line. This event checks if player is out of range from all characters in the dialog, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_OutOfRange == <code c++> void Dialog_AddEndEvent_OutOfRange(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of the subject. This event checks if player is out of range from all characters in the dialog, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddLineEvent_PlayerNotLooking == <code c++> void Dialog_AddLineEvent_PlayerNotLooking(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of every line. This event checks if is not looking at any character in the dialog, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_PlayerNotLooking == <code c++> void Dialog_AddEndEvent_PlayerNotLooking(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of the subject. This event checks if is not looking at any character in the dialog, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddLineEvent_PlayerNotLookingOrOutOfRange == <code c++> void Dialog_AddLineEvent_PlayerNotLookingOrOutOfRange(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of every line. This event checks if is not looking at any character any character or is out of range, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_PlayerNotLookingOrOutOfRange == <code c++> void Dialog_AddEndEvent_PlayerNotLookingOrOutOfRange(const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of subject. This event checks if is not looking at any character any character or is out of range, and if so branches. Dialog_AddSubject must be called before this is used! * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddLineEvent_Callback == <code c++> void Dialog_AddLineEvent_Callback(const tString &in asCallbackFunc, const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of every line. This event checks if a custom callback returns true and if so branches. Dialog_AddSubject must be called before this is used! * <b>asCallbackFunc</b>: The callback function name. Syntax: bool asCallbackFunc(const tString&in asBranch, const tString&in asBranchSubject, int alLineIndex, const tString&in asNewBranch)" * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_AddEndEvent_Callback == <code c++> void Dialog_AddEndEvent_Callback(const tString &in asCallbackFunc, const tString &in asNewBranch) </code> <span class='np_break'> </span> Adds a branching event to the latest added subject. Checked at end of the subject. This event checks if a custom callback returns true and if so branches. Dialog_AddSubject must be called before this is used! * <b>asCallbackFunc</b>: The callback function name. Syntax: "bool asCallbackFunc(const tString&in asBranch, const tString&in asBranchSubject, int alLineIndex, const tString&in asNewBranch)" * <b>asNewBranch</b>: The name of the dialog to branch to. If empty, the dialog just ends. —- == Dialog_CharacterIsActive == <code c++> bool Dialog_CharacterIsActive(const tString &in asName) </code> <span class='np_break'> </span> Checks if a character is currently taking part in a dialog. * <b>asName</b>: Name of the character. —- == Dialog_Stop == <code c++> void Dialog_Stop(const tString &in asName) </code> <span class='np_break'> </span> Stops a dialog * <b>asName</b>: Name of the dialog —- == Dialog_StopAll == <code c++> void Dialog_StopAll() </code> <span class='np_break'> </span> Stops all dialog —- == Dialog_StartConversation_CharMover == <code c++> void Dialog_StartConversation_CharMover(const tString &in asVoiceCharacter, const tString &in asFocusEntityName, int alHeadBoneIndex, cLuxCharMover @apCharMover, float afMinTurnAngle, float afMaxMoveDist=0.5f) </code> <span class='np_break'> </span> Starts a dialog with an entity that has a CharMover. Should only be used internally by entities. —- == Dialog_StartConversation_PosBased == <code c++> void Dialog_StartConversation_PosBased(const tString &in asVoiceCharacter, const tString &in asFocusEntity, const tString &in asPositionArea, const tString &in asHeadBone=</u>GESHI_QUOT<u></u>GESHI_QUOT<u>, float afMaxMoveDist=0.5f, cVector3f avFocusOffset=cVector3f_Zero) </code> <span class='np_break'> </span> Starts a dialog with an entity, moving the player to a position to have the conversation. * <b>asVoiceCharacter</b>: the character with wich the player will have the dialog. * <b>asFocusEntity</b>: the entity the player will look at during the dialog. * <b>asPositionArea</b>: the area the player will be moved to at the start of the conversation (centre base of area = foot position) * <b>asHeadBone</b>: if non-_ckgedit_QUOT</u>ckgedit>, the bone of asFocusEntity that should be focused on during the conversation (e.g. "head")</li> <li class="level1"> <b>afMaxMoveDist</b>: the max distance that can be moved from where the player is standing when the dialog starts.</li> <li class="level1"> <b>avFocusOffset</b>: any offset that should be added to the focus position (origin of focusEntity, or head bone position if specified)</li> </ul> <hr /> </div> <h5>Dialog_StartConversation</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Dialog_StartConversation<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asVoiceCharacter<span class="sy0">,</span> <span class="kw4">const</span> tString <span class="sy0">&</span>in asFocusEntityName<span class="sy0">,</span> <span class="kw4">float</span> afMaxMoveDist<span class="sy0">=</span><span class="nu17">0.5f</span><span class="sy0">,</span> cVector3f avFocusOffset<span class="sy0">=</span>cVector3f_Zero<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Starts a dialog with an entity. </p> <ul> <li class="level1"> <b>asVoiceCharacter</b>: the character with wich the player will have the dialog.</li> <li class="level1"> <b>asFocusEntityName</b>: the entity the player will look at during the dialog.</li> <li class="level1"> <b>afMaxMoveDist</b>: the max distance that can be moved from where the player is standing when the dialog starts.</li> <li class="level1"> <b>avFocusOffset</b>: any offset that should be added to the focus position (origin of focusEntity, or head bone position if specified)</li> </ul> <hr /> </div> <h5>Dialog_GetCharacterScene</h5> <div class="level5"> <pre class="code c++">tString Dialog_GetCharacterScene<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asCharacter<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Gets the scene the character is currently in. </p> <ul> <li class="level1"> <b>asCharacter</b>: Name of the character (as defined in the voice file)</li> </ul> <hr /> </div> <h5>Dialog_SetVar</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Dialog_SetVar<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asVar<span class="sy0">,</span> <span class="kw4">int</span> alValue<span class="sy0">=</span><span class="nu0">1</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Sets the value of an internal Dialog variable </p> <ul> <li class="level1"> <b>asVar</b>: The name of the var</li> <li class="level1"> <b>alValue</b>: The value to set the var to.</li> </ul> <hr /> </div> <h5>Dialog_IncVar</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Dialog_IncVar<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asVar<span class="sy0">,</span> <span class="kw4">int</span> alValue<span class="sy0">=</span><span class="nu0">1</span><span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Incremements the value of an internal Dialog variable. If var was not set priorly, it will start with 0. </p> <ul> <li class="level1"> <b>asVar</b>: The name of the var</li> <li class="level1"> <b>alValue</b>: The value to add to the var.</li> </ul> <hr /> </div> <h5>Dialog_GetVar</h5> <div class="level5"> <pre class="code c++"><span class="kw4">int</span> Dialog_GetVar<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asVar<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Gets the value of an internal Dialog variable. If it does not exist, 0 is returned. </p> <ul> <li class="level1"> <b>asVar</b>: The name of the var</li> <li class="level1"> <b>alValue</b>: The value to set the var.</li> </ul> <hr /> </div> <h5>Dialog_GetCharactersInSubject</h5> <div class="level5"> <pre class="code c++"><span class="kw4">void</span> Dialog_GetCharactersInSubject<span class="br0">(</span><span class="kw4">const</span> tString <span class="sy0">&</span>in asSubject<span class="sy0">,</span> array<span class="sy0"><</span> tString <span class="sy0">></span> <span class="sy0">&</span>out avOutCharacters<span class="br0">)</span> </pre><p> </p> <p> <span class='np_break'> </span> Returns a list of the characters who speak in a particular dialog subject. </p> <ul> <li class="level1"> <b>asSubject</b>: name of subject</li> <li class="level1"> <b>avOutCharacters</b>: array&lt;tString> to hold the resulting list</li> </ul> <hr /> </div>