mirror of
https://github.com/ENSL/NS.git
synced 2024-12-03 09:42:00 +00:00
74 lines
3 KiB
HTML
74 lines
3 KiB
HTML
<HTML>
|
||
<HEAD>
|
||
<META NAME="GENERATOR" Content="SOURCEDOC.EXE">
|
||
<META HTTP-EQUIV="Content-Type" content="text/html; charset=iso-8859-1">
|
||
<TITLE>FSOUND_CD_Play</TITLE>
|
||
<STYLE>
|
||
#flush {margin-left: -10p; margin-right: -0p}
|
||
#buttonbar {color: white}
|
||
</STYLE>
|
||
</HEAD>
|
||
<BODY TOPMARGIN=0 BGPROPERTIES="FIXED" BGCOLOR="white">
|
||
<FONT FACE="ARIAL">
|
||
<SPAN ID="flush">
|
||
<A NAME="SEE ALSO">
|
||
<TABLE WIDTH="100%" COLS=2 BORDER=0 BGCOLOR="#000000">
|
||
<TR ALIGN=RIGHT>
|
||
<TD ALIGN=LEFT>
|
||
<IMG SRC="banner03.gif" WIDTH="88" HEIGHT="31" BORDER=0>
|
||
</TD>
|
||
<TD ALIGN=RIGHT VALIGN=TOP>
|
||
<FONT FACE="ARIAL" SIZE="2">
|
||
<A ID=buttonbar HREF="FSOUND_CD_OpenTray.html">
|
||
<IMG SRC="u_prev.gif" WIDTH="71" HEIGHT="16" BORDER=0 ALT="Previous Topic">
|
||
</A>
|
||
<A ID=buttonbar HREF="FSOUND.html">
|
||
<IMG SRC="u_index.gif" WIDTH="47" HEIGHT="16" BORDER=0 ALT="Index">
|
||
</A>
|
||
<A ID=buttonbar HREF="FSOUND_CD_SetPaused.html">
|
||
<IMG SRC="u_next.gif" WIDTH="48" HEIGHT="16" BORDER=0 ALT="Next Topic">
|
||
</A>
|
||
</FONT></TD><TD WIDTH=15></TD>
|
||
</TR>
|
||
</TABLE>
|
||
</A>
|
||
</SPAN>
|
||
<A HREF="FSOUND.html#Functions"><H5>[API function]</A></H5>
|
||
<H2><A NAME="FSOUND_CD_Play">FSOUND_CD_Play</A></H2>
|
||
Plays a CD Audio track. <BR>
|
||
<P>
|
||
<B>signed char F_API </B><B> </B><B>FSOUND_CD_Play</B><B>(</B><BR>
|
||
<B>char </B><B> </B><I>drive</I><B>,</B><BR>
|
||
<B>int </B><B> </B><I>track</I><BR>
|
||
<B>);</B><BR>
|
||
<H3>Parameters</H3>
|
||
<TABLE>
|
||
<TR VALIGN=top><TD><I>drive</I></TD>
|
||
<TD>the drive ID to use. 0 is the default CD drive. Using D or E in single quotes would be D: or E: for example. <BR>
|
||
</TD><TR VALIGN=top><TD><I>track</I></TD>
|
||
<TD>the CD track number to play. The first track starts at 1.<BR>
|
||
</TD></TABLE>
|
||
<H3>Return Value</H3>
|
||
On success, TRUE is returned.<BR>
|
||
On failure, FALSE is returned.<BR>
|
||
<H3>Remarks</H3>
|
||
See FSOUND_CD_SetPlayMode for information on how to control playback of a CD track.<BR>
|
||
FSOUND's CD Playback system, is a non intrusive, non polling system. <BR>
|
||
This may not mean much to a lot of people, but a polling player (take the windows default CD player) will consistantly poll the CD device to update its status, which causes other applications to jerk, or pause consistantly. <BR>
|
||
This would be inexcusable in a game, to have the game halt or jerk every second to few seconds or so. <BR>
|
||
FSOUND uses timing and prediction to loop tracks and update the status of the CD, and never touches the CD device during playback, for TRUE 0 pu usage.<BR>
|
||
___________________<BR>
|
||
Supported on the following platforms : Win32, Linux, Macintosh (OSX CFM only)<BR>
|
||
<H3>See Also</H3>
|
||
<A HREF="FSOUND_CD_GetVolume.html">FSOUND_CD_GetVolume</A>
|
||
,
|
||
<A HREF="FSOUND_CD_SetPlayMode.html">FSOUND_CD_SetPlayMode</A>
|
||
,
|
||
<A HREF="FSOUND_CD_SetVolume.html">FSOUND_CD_SetVolume</A>
|
||
,
|
||
<A HREF="FSOUND_CD_Stop.html">FSOUND_CD_Stop</A>
|
||
<HR><BR><FONT SIZE="-2">This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.</FONT><BR>
|
||
<FONT SIZE="-2">Generated Thu Dec 15 17:31:28 2005
|
||
by SourceDoc v0.10, the automated source code documenter.</FONT><BR>
|
||
</BODY>
|
||
</HTML>
|