[API function]
Plays a CD Audio track.
signed char F_API FSOUND_CD_Play(
char drive,
int track
);
Parameters
drive |
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.
|
track |
the CD track number to play. The first track starts at 1.
|
Return Value
On success, TRUE is returned.
On failure, FALSE is returned.
Remarks
See FSOUND_CD_SetPlayMode for information on how to control playback of a CD track.
FSOUND's CD Playback system, is a non intrusive, non polling system.
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.
This would be inexcusable in a game, to have the game halt or jerk every second to few seconds or so.
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.
___________________
Supported on the following platforms : Win32, Linux, Macintosh (OSX CFM only)
See Also
FSOUND_CD_GetVolume
,
FSOUND_CD_SetPlayMode
,
FSOUND_CD_SetVolume
,
FSOUND_CD_Stop
This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Thu Dec 15 17:31:28 2005
by SourceDoc v0.10, the automated source code documenter.