AudioSoundscapeScripts: Difference between revisions

From Civilization Modding Wiki
Jump to navigationJump to search
mNo edit summary
No edit summary
Line 1: Line 1:
{| align="left"
The '''AudioSoundscapeScripts''' file groups the 2D and 3D sounds together to form "soundscapes" which are used in various parts of the game.
|[[AudioDefines|Previous article]]
 
|}
All tags must be opened and closed; the first is the "open", the second the "close" tag. If nothing goes inside a "list tag", then it should just be the opening tag with a "/" before the closing bracket. The following tables contain all available tags, as well as their purpose and accepted values.
{|align="right"
 
|[[Civ4 XML Reference|Back to XML Reference]]
|}<br><br>
<font color=red>This page is missing information.
<font color=red>This page is missing information.
Do not remove this notice until it is complete.</font>
Do not remove this notice until it is complete.</font>
=Summary=
This file groups the 2D and 3D sounds together to form "soundscapes" which are used in various parts of the game.




=Single-Line Tags=
==Tags==
===Text Tags===
===Text===
{| border="1" cellpadding="2" cellspacing="0"
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
|-
|-
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Description
! style="background:#efefef;" | Description
|-
|-
|ScriptID || The name of the audio soundscape script prefixed with ASSS_ for easier identification.
!ScriptID
| The name of the audio soundscape script prefixed with ASSS_ for easier identification.
|}
|}




===Integer Tags===
===Integer===
{| border="1" cellpadding="2" cellspacing="0"
 
All of these tags have a numerical value.  Though it sometimes can be negative, it usually is not.
 
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
|-
|-
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Description
! style="background:#efefef;" | Description
|-
|-
|iMinVolume || Minimum volume for all sounds in this soundscape.
!iMinVolume
| Minimum volume for all sounds in this soundscape.
|-
|-
|iMaxVolume || Maximum volume for all sounds in this soundscape.
!iMaxVolume
| Maximum volume for all sounds in this soundscape.
|}
|}




=Multi-Line Tags=
===Lists (Multi-line)===
{| border="1" cellpadding="2" cellspacing="0"
 
All List tags consist of an opening/closing tag, which is shown here, and then each entry within it is another tag with the same name as the parent tag, minus the "s" (i.e. singular, rather than plural).
 
{| border="1" style="text-align:left" cellpadding="3" cellspacing="0"
|-
|-
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Tag Name
! style="background:#efefef;" | Description
! style="background:#efefef;" | Description
|-
|-
|SoundscapeElement || The audio script object and the script engine it uses. Generally this will consist of one primary screen background using the 2D script engine and multiple additional sounds using the 3D script engine.
!SoundscapeElement
| The audio script object and the script engine it uses. Generally this will consist of one primary screen background using the 2D script engine and multiple additional sounds using the 3D script engine.
|-
|-
|Text || ScriptType The audio script engine. Defined in [[AudioDefines]]. Values are 2D or 3D.
!ScriptType
| The audio script engine. Defined in [[AudioDefines]]. Values are 2D or 3D.
|-
|-
|Text || ScriptID The sound name defined in Audio2DScripts or Audio3DScripts.
!ScriptID
| The sound name defined in Audio2DScripts or Audio3DScripts.
|}
|}




=Example=
==Example==
 
In the following example of code, please note that there is a specific order of all of the tags.  You ''must'' list the tags in this order for the game to properly interpret your file.
 
  <ScriptSoundscape>
  <ScriptSoundscape>
     <ScriptID>ASSS_CITY_LATE_LARGE_SELECT_AMB</ScriptID>
     <ScriptID>ASSS_CITY_LATE_LARGE_SELECT_AMB</ScriptID>
Line 78: Line 89:
     </SoundscapeElement>
     </SoundscapeElement>
  </ScriptSoundscape>
  </ScriptSoundscape>
{| align="left"
|[[Civ4AttitudeInfos|Next article]]
|}
{|align="right"
|[[Civ4 XML Reference|Back to XML Reference]]
|}

Revision as of 23:01, 20 May 2009

The AudioSoundscapeScripts file groups the 2D and 3D sounds together to form "soundscapes" which are used in various parts of the game.

All tags must be opened and closed; the first is the "open", the second the "close" tag. If nothing goes inside a "list tag", then it should just be the opening tag with a "/" before the closing bracket. The following tables contain all available tags, as well as their purpose and accepted values.

This page is missing information. Do not remove this notice until it is complete.


Tags

Text

Tag Name Description
ScriptID The name of the audio soundscape script prefixed with ASSS_ for easier identification.


Integer

All of these tags have a numerical value. Though it sometimes can be negative, it usually is not.

Tag Name Description
iMinVolume Minimum volume for all sounds in this soundscape.
iMaxVolume Maximum volume for all sounds in this soundscape.


Lists (Multi-line)

All List tags consist of an opening/closing tag, which is shown here, and then each entry within it is another tag with the same name as the parent tag, minus the "s" (i.e. singular, rather than plural).

Tag Name Description
SoundscapeElement The audio script object and the script engine it uses. Generally this will consist of one primary screen background using the 2D script engine and multiple additional sounds using the 3D script engine.
ScriptType The audio script engine. Defined in AudioDefines. Values are 2D or 3D.
ScriptID The sound name defined in Audio2DScripts or Audio3DScripts.


Example

In the following example of code, please note that there is a specific order of all of the tags. You must list the tags in this order for the game to properly interpret your file.

<ScriptSoundscape>
   <ScriptID>ASSS_CITY_LATE_LARGE_SELECT_AMB</ScriptID>
   <iMinVolume>100</iMinVolume>
   <iMaxVolume>100</iMaxVolume>
   <SoundscapeElement>
       <ScriptType>2D</ScriptType>
       <ScriptID>AS2D_SS_CITY_LATE_LARGE_BED</ScriptID>
   </SoundscapeElement>
   <SoundscapeElement>
       <ScriptType>3D</ScriptType>
       <ScriptID>AS3D_SS_HORN</ScriptID>
   </SoundscapeElement>
   <SoundscapeElement>
       <ScriptType>3D</ScriptType>
       <ScriptID>AS3D_SS_AUTO_PASSING</ScriptID>
   </SoundscapeElement>
   <SoundscapeElement>
       <ScriptType>3D</ScriptType>
       <ScriptID>AS3D_SS_FOOTSTEPS</ScriptID>
   </SoundscapeElement>
   <SoundscapeElement>
       <ScriptType>3D</ScriptType>
       <ScriptID>AS3D_SS_HORN_DOPPLER</ScriptID>
   </SoundscapeElement>
   <SoundscapeElement>
       <ScriptType>3D</ScriptType>
       <ScriptID>AS3D_SS_SIREN</ScriptID>
   </SoundscapeElement>
</ScriptSoundscape>