XML:SNDD: Difference between revisions

The order of arguments is critical: the rate and encoding are being applied to the outputted file, whereas if they came before the input file's name they would be instructions on how to read the input sound. Here is a simple Unix shell script for converting a folder of sounds from WAV to the AIFF format suitable for importing:

When you are replacing existing Oni sounds, note that all of Oni's SNDD resources possess a ".aif" suffix as part of their <u>actual resource names</u> (yes, even the WAV-encoded sounds in Windows Oni). So if you import them with a name like "SNDDgears.aif", the file suffix gets changed to ".oni" upon import by OniSplit, and you end up with a resource simply titled "SNDDgears" in-game. Existing resources in Oni link to a sound titled "SNDDgears.aif", thus nothing will play. If you supply an AIFF file called "SNDDgears.aif.aif" or a WAV file called "SNDDgears.aif.wav", OniSplit will create the file "SNDDgears.aif.oni", and upon importing it, Oni will find the resource named "SNDDgears.aif" that it's seeking.

: OniSplit.exe -create output_directory_'''Mac''' input_directory/'''*.aif'''

: OniSplit.exe -create output_directory_'''Win''' input_directory/'''*.wav'''

: OniSplit.exe -create output_directory input_directory/*.xml

** music (call the OSBD from BSL)

** dialogue (call the OSBD from BSL)

: OSBD_newmusic.amb.oni (the main file — links to the group, intro and ending files)

: OSBD_newmusic.grp.oni (links to the music files)

: OSBD_newmusic_in.grp.oni (links to intro part of the music — optional)

: OSBD_newmusic_out.grp.oni (links to the ending of the music — optional)

: SNDD_newmusic1.oni, SNDD_newmusic2.oni… (the individual music files)

Breaking the main loop of the music into parts allows Oni to more quickly transition to the ending part when the music is commanded to stop playing. The shorter segments you can break the music into, the better – both for the sake of reaching the outro sooner, and because long segments can be taxing on the game. Oni's music averages 9 seconds per segment, and a segment rarely goes above 20 seconds.

The parts of the music between intro and outro are played in a randomized order to add more variety to the playback. Note that .grp files have a <Weight> tag under each <Permutation>. As with TRAC's <Weight> field, this can be used to set the relative probability that a music segment will be picked. Each permutation's weight is figured in relation to the total weight of all segments, so if a piece of music has four permutations and the first one has a <Weight> of 30 and the other three have <Weight>s of 10, the first segment has a 50% chance of being played. This feature is effectively unused in Oni's music, as all music OSBDs assign a weight of 10 to all <Permutation>s.

This is for sounds anchored to a certain area.

==How to register sounds for characters==