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 0pu 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.