1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>THPPlayerInit</title>
10</head>
11
12<body>
13
14<h1>THPPlayerInit</h1>
15<h2>C Specification</h2>
16
17<dl>
18<dd><pre><code>#include &quot;THPPlayer.h&quot;</code></pre>
19  </dd>
20<dd><pre><CODE>BOOL THPPlayerInit(s32 audioSystem);</CODE></pre>
21  </dd>
22</dl>
23
24<h2>Arguments</h2>
25<table border="1" cellpadding="3" cellspacing="0.1">
26  <tr>
27<td width="120" bgcolor="#ffffe8"><strong><em>audioSystem</em></strong></td>
28<td width="520">Flag indicating the audio library for simultaneous use.</td>
29  </tr>
30</table>
31
32<h2>Return Values</h2>
33<p>Returns <CODE>TRUE</CODE> if successful; <CODE>FALSE</CODE> otherwise.</p>
34
35<H2>Description</H2>
36<p>This function initializes the player's control structure (the <code>THPPlayer</code> structure), enables a locked cache, and calls <a href="../low/THPInit.html"><code>THPInit</code></a>--a THP library low level API function. In addition, this function registers a callback function in the Revolution audio interface to play THP audio data. </p>
37
38<p>This function must be called before any other player functions are called. </p>
39
40<p>The argument specifies the audio library for simultaneous use. When using AX simultaneously, specify <CODE>THP_MODE_WITH_AX</CODE>. If there is no audio library for simultaneous use, specify <CODE>THP_MODE_ALONE</CODE>. </p>
41
42<p>When using the player simultaneously with the audio library, call an initialization function (<code>AXInit</code>, etc.) for the audio library to be used before calling this function. When using the AX library at the same time, call the <code>THPPlayerInit</code> function when the AX sound output is silent. </p>
43
44<H2>See Also</H2>
45<P><a href="../low/THPInit.html"><code>THPInit</code></a></P>
46
47<H2>Revision History</H2>
48<P>03/01/2006 Initial version.</P>
49</body>
50</html>
51