Previous Topic Index Next Topic
[API function]

FSOUND_CD_Play

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 0Ppu usage.
___________________
Supported on the following platforms : Win32, Linux, Macintosh (OSX Codewarrior 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 Fri Dec 20 16:31:08 2002 by SourceDoc v0.10, the automated source code documenter.