sdl_cd(3) [redhat man page]

SDL_CD(3)							 SDL API Reference							 SDL_CD(3)

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

       id		   Private drive identifier

       status		   Drive status

       numtracks	   Number of tracks on the CD

       cur_track	   Current track

       cur_frame	   Current frame offset within the track

       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

SDL
							      Tue 11 Sep 2001, 22:58							 SDL_CD(3)

SDL_CDOpen(3)							 SDL API Reference						     SDL_CDOpen(3)

NAME

       SDL_CDOpen - Opens a CD-ROM drive for access.

SYNOPSIS

       #include "SDL.h"

       SDL_CD *SDL_CDOpen(int drive);

DESCRIPTION

       Opens  a CD-ROM drive for access. It returns a SDL_CD structure on success, or NULL if the drive was invalid or busy. This newly opened CD-
       ROM becomes the default CD used when other CD functions are passed a NULL CD-ROM handle.

       Drives are numbered starting with 0. Drive 0 is the system default CD-ROM.

EXAMPLES

       SDL_CD *cdrom;
       int cur_track;
       int min, sec, frame;
       SDL_Init(SDL_INIT_CDROM);
       atexit(SDL_Quit);

       /* Check for CD drives */
       if(!SDL_CDNumDrives()){
	 /* None found */
	 fprintf(stderr, "No CDROM devices available
       ");
	 exit(-1);
       }

       /* Open the default drive */
       cdrom=SDL_CDOpen(0);

       /* Did if open? Check if cdrom is NULL */
       if(!cdrom){
	 fprintf(stderr, "Couldn't open drive: %s
       ", SDL_GetError());
	 exit(-1);
       }

       /* Print Volume info */
       printf("Name: %s
       ", SDL_CDName(0));
       printf("Tracks: %d
       ", cdrom->numtracks);
       for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){
	 FRAMES_TO_MSF(cdrom->track[cur_track].length, &min, &sec, &frame);
	 printf("     Track %d: Length %d:%d
       ", cur_track, min, sec);
       }

       SDL_CDClose(cdrom);

SEE ALSO

       SDL_CD, SDL_CDtrack, SDL_CDClose

SDL
							      Tue 11 Sep 2001, 22:58						     SDL_CDOpen(3)