XML:SNDD

This page is unfinished. Can you fill in any missing information? If it is not clear which part of the page is unfinished, ask on the talk page.

(More OSBD .grp / .amb information could be good and .imp is completly left out so far.)

How do I get sounds into Oni?

Source file requirements

First of, your sound files must meet these features:

PC retail	MAC
.wav mono / stereo 22.05KHz / 44.1KHz uncompressed (PCM) / compressed (MS-ADPCM)	.aif / .aifc / .afc mono / stereo 22.05KHz compressed (ima4)

Helpful conversion tools

for PC

To create suitable files you could use this tool: River Past Audio Converter 7.8. (Also mirrored here.) The trail version let you convert sounds that are up to 4 minutes long.

In order to make your sounds available on both sides - pc and mac - you need to create them twice (one time from a wav source and another time from an aif/aifc/afc source).

When you're done you can use Onisplit GUI to convert SNDDyourfile.aif/.wav, OSBDyourfile.grp.xml and OSBDyourfile.amb.xml to the .oni-file formate. Use the "manual command input":

-create output_directory input_directory/*.aif

-create output_directory input_directory/*.wav (don't overwrite the first created SNDD, save it somewhere)

-create output_directory input_directory/*.xml

Make it that way they all have the same name:

• SNDDyourfile.oni
• OSBDyourfile.grp.oni
• OSBDyourfile.amb.oni

Music tracks can be split into several parts. However, I'd say do that only if you know what you are doing. If you are going to split music track look here.

for MAC

?

OSBD information

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

OSBD_newmusic.grp.oni (Contain 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 (The individual music files - Its best to break up the music into segments of perhaps 30 secs to a minute each - Oni may crash or become sluggish if you use a single file for the music -- EdT) (Can someone doublecheck this? --Paradox-01 19:54, 23 April 2011 (UTC))

OSBDfile.grp.xml

In case you want to create a simple sound file you can basically copy the code and change the red marked stuff.

• <Oni Version=" "> - self-explanatory, isn't it?
• <NumberOfChannels> - here you tell Oni if your sound file is mono (1) or stereo (2), if you set the wrong value the music will sound distorted
• <Sound> - this is the sound file (for example: SNDDnyan.oni), file prefix and suffix aren't used

(sample file)

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.52.0">
   <SoundGroup>
       <Volume>1</Volume>
       <Pitch>1</Pitch>
       <PreventRepeats>1</PreventRepeats>
       <LastSelectedPermutation>0</LastSelectedPermutation>
       <NumberOfChannels>2</NumberOfChannels>
       <Permutations>
           <Permutation>
               <Weight>10</Weight>
               <Volume>
                   <Min>1</Min>
                   <Max>1</Max>
               </Volume>
               <Pitch>
                   <Min>1</Min>
                   <Max>1</Max>
               </Pitch>
               <Sound>nyan</Sound>
           </Permutation>
       </Permutations>
   </SoundGroup>
</Oni>

OSBDfile.amb.xml

This file use the .grp file(s).
This file is used by area-fixed sounds. (See level-specific file BINACJBOSound.xml.)

• <Flags> - use "PlayOnce" if you don't want your sound to be repeated automatically
• <BaseTrack1> - this is the grp sound file (for example: SNDDnyan.grp.oni), file prefix and suffix aren't used

(sample file)

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.52.0">
   <AmbientSound>
       <Priority>Normal</Priority>
       <Flags>InterruptTracksOnStop</Flags>
       <DetailTrackProperties>
           <SphereRadius>10</SphereRadius>
           <ElapsedTime>
               <Min>0</Min>
               <Max>0</Max>
           </ElapsedTime>
       </DetailTrackProperties>
       <Volume>
           <Distance>
               <Min>10</Min>
               <Max>50</Max>
           </Distance>
       </Volume>
       <DetailTrack></DetailTrack>
       <BaseTrack1>nyan</BaseTrack1>
       <BaseTrack2></BaseTrack2>
       <InSound></InSound>
       <OutSound></OutSound>
       <Treshold>3</Treshold>
       <MinOcclusion>0</MinOcclusion>
   </AmbientSound>
</Oni>

BINACJBOSound.xml

This is for area fixed-sounds.

• <Class> - this is the amb sound file (for example: SNDDnyan.amb.oni), file prefix and suffix aren't used
• <MinRadius> - between min radius and sound origin (<Position>) is the sound volume equally strong
• <MaxRadius> - between max and min radius is a transition of the sound volume

(A block ("object") of sample code.)

       <Object Id="8805" Type="SNDG">
           <Header>
               <Flags>0</Flags>
               <Position>125 10 2231</Position>
               <Rotation>0 0 0</Rotation>
           </Header>
           <OSD>
               <Class>nyan</BaseTrack1></Class>
               <Sphere>
                   <MinRadius>7</MinRadius>
                   <MaxRadius>21</MaxRadius>
               </Sphere>
               <Volume>1</Volume>
               <Pitch>1</Pitch>
           </OSD>
       </Object>

sound-related BSL commands

• on this wiki
• on ssg's website

OCF thread about new music

^