CDAudio (eCDAudioFunction, int param)
This function allows you to play and control an audio CD in your game.
Different tasks are performed, depending on the value of the AudioFunction
parameter. If there is no CD-ROM drive on the system, the function does
nothing.
The PARAM parameter is used by some of the functions for various reasons; if
it is not needed for the particular function you are calling, pass zero
instead.
The tasks performed are as follows depending on the COMMAND parameter:
eCDIsDriverPresent - checks if there is a CD-ROM driver available on
the system. Returns 1 if there is, and 0 if there is not.
eCDGetPlayingStatus - checks whether the CD drive is currently playing
an audio track. Returns 1 if it is, and 0 if it is not.
eCDPlayTrack - starts playback from track PARAM on the CD. If the track
does not exist, or if it is a data track, nothing happens.
eCDPausePlayback - pauses the currently playing audio track.
eCDResumePlayback - continues from where the track was paused.
eCDGetNumTracks - returns the number of tracks on the CD
currently in the drive. If the drive is empty, returns 0.
eCDEject - ejects the drive tray if the drive has the ability. This is
a feature you'll play with to start off because it's neat, and then
realize that it has no real use in your game.
Your script does not continue until the drive is fully ejected.
eCDCloseTray - the reverse of Eject. This will pull the drive tray back
in again. Your script does not continue until the drive has been
fully closed.
eCDGetCDDriveCount - returns the number of CD drives in the
system, normally 1.
eCDSelectActiveCDDrive - changes the current CD drive to PARAM,
where PARAM ranges from 1 to (number of CD drives). All the other
CD Audio functions operate on the current CD drive.
NOTE: These CD Audio functions are slow compared to all the other script
functions. This will not be noticeable if you call them from most scripts,
but using CDAudio in a repeatedly_execute script will noticeably slow down
the game.
Cross-Platform Support
Windows: Yes, but supports 1 CD-ROM drive only
MS-DOS: Yes, if CD-ROM device driver loaded
Linux: Yes, but supports 1 CD-ROM drive only
MacOS: No
Example:
CDAudio(eCDPlayTrack, 3);
will play track 3 of the CD that's in the CD ROM drive.
|