NS/main/source/includes/fmodapi375linux/documentation/Tutorials/gc.htm
2014-12-16 14:36:27 +01:00

136 lines
No EOL
4.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE>GameCube - Firelight Technologies Pty, Ltd.</TITLE>
</HEAD>
<BODY class="fmod" bgcolor="#FFFFFF" leftmargin="10" topmargin="0" marginwidth="0" marginheight="0">
<center>
<IMG src="fmod.jpg">
<BR>
<BR>
<BR>
<H1>GAMECUBE SPECIFIC ISSUES / FEATURES</H1>
</center>
<font color="#00005F" face="Arial, Helvetica" size="2">
<table border="1" cellpadding="0" cellspacing="0" width="100%" bgcolor="#506080">
<tr>
<td width="100%"><font color="#FFFF80" face="Arial, Helvetica" size="2">Introduction&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <small></small></font></td>
</tr>
</table>
<UL>
This section describes how to get started with FMOD for Gamecube<br>
</UL>
<table border="1" cellpadding="0" cellspacing="0" width="100%" bgcolor="#506080">
<tr>
<td width="100%"><font color="#FFFF80" face="Arial, Helvetica" size="2">Compiling and linking&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <small></small></font></td>
</tr>
</table>
<UL>
Include <b>fmod.h</b> in your project, this is found in api/inc.<br>
<br>
To link FMOD to your project, there are the following files.<br>
<li><b>/api/lib/fmodgc.lib</b> - Link to this file if you are using <b>SN Systems</b> compiler.
<li><b>/api/lib/fmodgcD.lib</b> - This is the debug version of fmodgc.lib and outputs a log of FMOD's progress and any error messages (in plain english) to the TTY.
<li><b>/api/lib/fmodgc_cw.a</b> - Link to this file if you are using the <b>Metrowerks Codewarrior</b> compiler.
<li><b>/api/lib/fmodgc_cwD.a</b> - This is the debug version of fmodgc_cw.lib and outputs a log of FMOD's progress and any error messages (in plain english) to the TTY.
<br>
</UL>
<table border="1" cellpadding="0" cellspacing="0" width="100%" bgcolor="#506080">
<tr>
<td width="100%"><font color="#FFFF80" face="Arial, Helvetica" size="2">Running the examples&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <small></small></font></td>
</tr>
</table>
<UL>
Simply load their .dsp files into Dev Studio and hit F7.<br>
<br>
<b>NOTE</b>: You will need to copy all files in the media directory to <br>
<ul>
$DVDROOT/fmod. For example: <br>
<br>
copy media\*.* c:\DolphinSDK1.0\dvddata\fmod
</ul>
<br>
</UL>
<table border="1" cellpadding="0" cellspacing="0" width="100%" bgcolor="#506080">
<tr>
<td width="100%"><font color="#FFFF80" face="Arial, Helvetica" size="2">Conversion tools&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <small></small></font></td>
</tr>
</table>
<UL>
<b>dspadpcm.exe</b>
<br>
<br>
FMOD supports the Nintendo DSPADPCM format as output by the Nintendo tool "dspadpcm.exe".
FMOD expects the file extension ".dsp" on these files.<br>
For clarity and consistency, FMOD refers to this format as FSOUND_GCADPCM. <br>
<b>NOTE</b>: dspadpcm.exe can only convert MONO samples!<br>
<br>
<b>fsbank.exe</b><br>
<br>
This is a Windows app that creates .fsb files - FMOD's native sample bank format.<br>
Use it to create sample banks of either MONO or STEREO ADPCM samples suitable for playing or streaming using the GameCube ADPCM hardware. <br>
<br>
</UL>
<table border="1" cellpadding="0" cellspacing="0" width="100%" bgcolor="#506080">
<tr>
<td width="100%"><font color="#FFFF80" face="Arial, Helvetica" size="2">Performance issues and Gamecube specific FMOD features.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <small></small></font></td>
</tr>
</table>
<UL>
<b>Hardware voice dropping</b><br>
<br>
Due to a design issue with the Gamecube hardware, the processor will drop hardware voices if it's DSP chip gets overloaded.<br>
Call <b><a href="../HTML/FSOUND_Update.html">FSOUND_Update</a></b> each game cycle and FMOD will automatically reacquire voices that get dropped. <br>
FMOD's priority system has been linked into this, so it is likely to drop lower priority sounds that have their priority set with <b><a href="../HTML/FSOUND_Sample_Defaults.html">FSOUND_Sample_Defaults</a></b>.<br>
<br>
<b>Direct DVD streaming</b>
<br>
Use FMOD's stream API to play streams using the GameCube's DVD audio streaming capability. <br>
When opening a stream, simply specify a file with a .adp extension and FMOD will stream it using the GameCube's hardware straight from the DVD to the AI, completely bypassing both ARAM and MRAM.<br>
<br>
<b>Gamecube extras</b><br>
<br>
Look in <b>fmodgc.h</b> for GameCube-specific functions relating to such things as DVD status callbacks, AUX effects, specifying a block of ARAM for FMOD to use and accessing IPL sound settings.<br>
</UL>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<BR>
</BODY>
</HTML>