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="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>THPSimpleDecode</title>
10</head>
11
12<body>
13
14<h1>THPSimpleDecode</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18#include &quot;THPSimple.h&quot;
19
20s32 THPSimpleDecode(s32 audioTrack);
21</pre></dd></dl>
22
23<h2>Arguments</h2>
24<TABLE class="arguments" border="1" >
25  <tr>
26<th>audioTrack</th>
27<td>Audio track number to decode.</td>
28  </tr>
29</table>
30
31<h2>Return Values</h2>
32<p>Returns oneof the following values.</p>
33
34<TABLE class="arguments" border="1" >
35  <tbody>
36    <tr ALIGN="center">
37<td bgcolor="#CCCCCC">Definitions</td>
38<td bgcolor="#CCCCCC" width=50>Value</td>
39<td bgcolor="#CCCCCC">Description</td>
40    </tr>
41    <tr>
42<th>THP_DECODE_OK</th>
43      <td align="center">0</td>
44<td>The decode was successful.</td>
45    </tr>
46    <tr>
47<th>THP_VIDEO_DECODE_FAIL</th>
48      <td align="center">1</td>
49<td>Failed to decode THP video data.</td>
50    </tr>
51    <tr>
52<th>THP_NO_READ_BUFFER</th>
53      <td align="center">2</td>
54<td>Data read was not in time.</td>
55    </tr>
56    <tr>
57<th>THP_NO_AUDIO_BUFFER</th>
58      <td align="center">3</td>
59<td>There is no empty audio buffer.</td>
60    </tr>
61    <tr>
62<th>THP_INVALID_AUDIO_TRACK</th>
63      <td align="center">4</td>
64<td>The THP movie data does not have the specified audio track.</td>
65    </tr>
66  </tbody>
67</table>
68
69<H2>Description</H2>
70<p>The <code>THPSimpleDecode</code> function extracts the THP video data by calling  <a href="../low/THPVideoDecode.html"><code>THPVideoDecode</code></a>, a low-level API in the THP library. If audio data is interleaved in the THP movie data, this function extracts the THP audio data by calling <a href="../low/THPAudioDecode.html"><code>THPAudioDecode</code></a>, another low-level API.</p>
71
72<p>The extracted data is stored inside the simple player.</p>
73
74<p>The argument of the <code>THPSimpleDecode</code> function specifies the audio track number to decode. (Track numbers start at 0.) This argument Indicates the audio track number to automatically play. If the THP movie data does not have audio data, the argument is ignored.</p>
75
76<p><B>Note:</B>The CPU extracts the THP audio data. </p>
77
78<H2>See Also</H2>
79<P class="reference">
80<a href="../low/THPVideoDecode.html">THPVideoDecode</a>,
81<a href="../low/THPAudioDecode.html">THPAudioDecode</a>
82</P>
83
84<H2>Revision History</H2>
85<P>
862006/03/01 Initial version.<br>
87</P>
88
89<hr><p>CONFIDENTIAL</p></body>
90</html>