"SDL_CD" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference"
"NAME"
SDL_CD - CDROM Drive Information
"STRUCTURE DEFINITION"
typedef struct{
int id;
CDstatus status;
int numtracks;
int cur_track;
int cur_frame;
SDL_CDtrack track[SDL_MAX_TRACKS+1];
} SDL_CD;
"STRUCTURE DATA"
20 id Private drive identifier
20 status Drive status
20 numtracks Number of tracks on the CD
20 cur_track Current track
20 cur_frame Current frame offset within the track
20 track[SDL_MAX_TRACKS+1] Array of track descriptions. (see SDL_CDtrack)
"DESCRIPTION"
An SDL_CD structure is returned by SDL_CDOpen. It represents an opened CDROM device and stores information on the layout of the tracks on the disc.
A frame is the base data unit of a CD. CD_FPS frames is equal to 1 second of music. SDL provides two macros for converting between time and frames: FRAMES_TO_MSF(f, M,S,F) and MSF_TO_FRAMES.
"EXAMPLES"
int min, sec, frame;
int frame_offset;
FRAMES_TO_MSF(cdrom->cur_frame, &min, &sec, &frame);
printf("Current Position: %d minutes, %d seconds, %d frames
", min, sec, frame);
frame_offset=MSF_TO_FRAMES(min, sec, frame);
"SEE ALSO"
SDL_CDOpen, SDL_CDtrack
created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58