View source for Psychonauts ISB

== ISB == 

* ''' Format Type ''':    Archive <br> 
* ''' [http://en.wikipedia.org/wiki/Endianness Endian Order] ''': Little Endian <br> 


=== Format Specifications ===
<tt><b>
<font color="blue"> ''' // ARCHIVE HEADER ''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(ZPKG)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Version <font color="purple">(1)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - First File Offset <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(RIFF)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - File Size <font color="purple">(- 8)</font> <br> 
: char {8}&nbsp;&nbsp;&nbsp;&nbsp;   - <font color="purple">(isbftitl)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Size of Text Block<br>  
: byte {X}&nbsp;&nbsp;&nbsp;&nbsp;   -  Text Block<br>
<br>
<font color="blue"> ''' // Repeated throughout file ''' </font> <br>  
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;  - Block Name<br>
: uint32 {4}&nbsp;&nbsp; - Block Size <font color="purple">(not including 8 bytes for block name and size)</font> <br> 
: byte {X}&nbsp;&nbsp;&nbsp;&nbsp; - Block Data <br><br>

Seek through the blocks unless the block is one of those below:<br><br>

<font color="blue"> ''' // LIST Block''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(LIST)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Block Size <font color="purple">(Including all sub-blocks)</font> <br> 
: char {8}&nbsp;&nbsp;&nbsp;&nbsp; - Dummy Title?  - <font color="purple">(Usually 'sampltitl')</font><br> 
: uint32 {4}&nbsp;&nbsp; - Size of Filename<br>  
: byte {X}&nbsp;&nbsp;&nbsp;&nbsp;   -  Filename <font color="purple"><font color="purple">(Each letter is separated by a 0 byte)</font>)</font><br><br>

The filename sometimes has the incorrect file extension so you'll want to remote this and replace it with the correct one. However sometimes the file extension has '-loop' tagged on the end eg 'AsylumExt.aif-Loop' - if you remove the file extension then this file would become 'AsylumExt' - but there is already a file with this name so you'd need to add 'loop' back to the filename somehow to make it a unique name eg 'AsylumExt-Loop'.<br><br> 

<font color="blue"> ''' // SINF Block''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(SINF)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Block Size<br>
: uint32 {8}&nbsp;&nbsp; - ?<br>  
: uint32 {4}&nbsp;&nbsp; - Samplerate<br>  
: uint32 {8}&nbsp;&nbsp; - ?<br><br>  

<font color="blue"> ''' // CHNK Block''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(CHNK)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Block Size<br>
: uint32 {4}&nbsp;&nbsp; - Number of Channels<br><br>  

<font color="blue"> ''' // CMPI Block''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(CMPI)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Block Size<br>
: uint32 {20}&nbsp;&nbsp; - ?<br>  
: uint32 {4}&nbsp;&nbsp; - Wav Identifier <font color="purple">(If = 1053609165 then its a normal pcm wav, otherwise its xbox adpcm)</font><br><br>

<font color="blue"> ''' // DATA Block''' </font> <br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp;   - Header <font color="purple">(DATA)</font> <br> 
: uint32 {4}&nbsp;&nbsp; - Block Size <font color="purple">(Sometimes has 1 byte padding so: if blocksize mod 2 <> 0 then blocksize:=blocksize + 1 )</font> <br>
: byte {X}&nbsp;&nbsp;&nbsp;&nbsp;    - File Data<br><br>

Dump the file data then continue on to next LIST block. Repeat until you reach end of file.<br><br> 


<font color="blue"> ''' // DUMPING FILES''' </font> <br> 
If first 4 bytes of file data='OggS' then its an ogg file. Otherwise its always an xbox or normal pcm wav.<br>
If its an ogg file then just copy out 'Block Size' bytes.<br>
If its a wav file though you need to write the .wav header first:<br><br>

You need to write the following:<br> 
: char {4}&nbsp;&nbsp;&nbsp;&nbsp; - RIFF Header <font color="purple">('RIFF')</font><br> 
: uint32 {4}&nbsp;&nbsp; - Block Size + 40 <br>
: char {4}&nbsp;&nbsp;&nbsp;&nbsp; - WAVE Header <font color="purple">('WAVE')</font><br>
: char {4}&nbsp;&nbsp;&nbsp;&nbsp; - fmt Header <font color="purple">('fmt ')</font><br> 
: uint32 {4}&nbsp;&nbsp; - Size of fmt block <font color="purple">(20)</font><br>
: byte {2}&nbsp;&nbsp;&nbsp;&nbsp; - PCM Code <font color="purple">(If its normal pcm then = 1. If its xbox adpcm then = 105)</font><br>
: byte {2}&nbsp;&nbsp;&nbsp;&nbsp; - Number of Channels <br>
: uint32 {4}&nbsp;&nbsp; - Samplerate <br>
: uint32 {4}&nbsp;&nbsp; - Byterate <font color="purple">(If its normal pcm then = (SampleRate * No Channels * 16) div 8 . If its xbox adpcm then = No Channels * 24806)</font><br>
: byte {2}&nbsp;&nbsp;&nbsp;&nbsp; - Block Align <font color="purple">(If its normal pcm then = 16. If its xbox adpcm then = 4)</font><br>
: byte {2}&nbsp;&nbsp;&nbsp;&nbsp; - Bits Per Sample <font color="purple">(If its normal pcm then = (No Channels * 16) div 8. If its xbox adpcm then = No Channels * 36 )</font><br>
: uint32 {4}&nbsp;&nbsp; - Extra Data <font color="purple">(If its normal pcm then = 16. If its xbox adpcm then = 4194306)</font><br>
: char {4}&nbsp;&nbsp;&nbsp;&nbsp; - DATA Header <font color="purple">('DATA')</font><br> 
: uint32 {4}&nbsp;&nbsp; - Data Block Size <font color="purple">(Size of data block in archive)</font><br><br>

Extra Checks:<br> 
Sometimes the Number of Channels=0 so change this to 1.<br><br>
</b></tt>

=== Notes and Comments === 

ISB files contain the audio data and are only used in the pc version, the xbox and ps2 versions store audio differently. ISB files contain 3 types of audio:<br>
: Ogg - Standard Ogg Audio<br>
: PCM - Standard Wave PCM<br>
: Xbox ADPCM - As used by many Xbox games<br><br>

The OGG and PCM audio can be played easily, to play the Xbox ADPCM however you either need to pass it through a decoder (there's one in [http://quick.mixnmojo.com/software.php#psychonautsexplorer Psychonauts Explorer]) or install the Xbox ADPCM codec.<br><br>

=== Supported Programs === 

* [http://quick.mixnmojo.com/software.php#psychonautsexplorer Psychonauts Explorer]<br>