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>THPPlayerPrepare</title> 10</head> 11 12<body> 13 14<h1>THPPlayerPrepare</h1> 15<h2>C Specification</h2> 16 17<dl> 18<dd><pre><code>#include "THPPlayer.h"</code></pre> 19 </dd> 20<dd><pre><CODE>BOOL THPPlayerPrepare(s32 frameNum, s32 playFlag, s32 audioTrack);</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><FONT face="Courier New">frameNum</FONT></em></strong></td> 28<td width="520">Frame number to start playing back THP movie data from. </td> 29 </tr> 30 <tr> 31<td width="120" bgcolor="#ffffe8"><strong><em><FONT face="Courier New">playFlag</FONT></em></strong></td> 32<td width="520">Playback flag. </td> 33 </tr> 34 <tr> 35<td width="120" bgcolor="#ffffe8"><strong><em><FONT face="Courier New">audioTrack</FONT></em></strong></td> 36<td width="520">Audio track number to play. </td> 37 </tr> 38</table> 39 40<h2>Return Values</h2> 41<p>Returns <CODE>TRUE</CODE> if successful; <CODE>FALSE</CODE> otherwise.</p> 42 43<H2>Description</H2> 44<p>This function prepares THP movie data for playback. Video decoding, audio decoding, and read threads are created based on the existing THP audio data and the playback method (streaming or on memory). The data is preloaded and the starting frame is decoded. This function also registers a VI post callback to control playback. (The first registered VI post callback is called internally.) </p> 45 46<p>The first argument specifies the frame number to start THP movie playback from, the second argument specifies the playback flag, and the third argument specifies the audio track number ( ≥ 0) for playback. The third argument is ignored If the THP movie data does not have audio data. </p> 47 48<p>If the THP movie data does not have offset data for each frame, the playback start frame can only be set to zero. </p> 49 50<p>The playback flag is set to one of the following values. </p> 51 52<table border="1" cellpadding="3" cellspacing="0.1"> 53 <tbody> 54 <tr ALIGN="center"> 55<td>Flag</td> 56<td width=50>Value</td> 57<td>Description</td> 58 </tr> 59 <tr> 60<td><FONT face="Courier New"><CODE>THP_PLAY_ONESHOT</CODE></FONT></td> 61 <td align="center">0</td> 62<td>Plays back the THP movie data in one shot.</td> 63 </tr> 64 <tr> 65<td><FONT face="Courier New"><CODE>THP_PLAY_LOOP</CODE></FONT></td> 66 <td align="center">1</td> 67<td>Plays back the THP movie data in a loop.</td> 68 </tr> 69 </tbody> 70</table> 71 72 73<H2>See Also</H2> 74 75<H2>Revision History</H2> 76<P>2006/03/01 Initial version.</P> 77 78<hr> 79<P>CONFIDENTIAL</p> 80</BODY> 81</HTML> 82