.TH "SDL_CDOpen" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference"

.SH "NAME"

SDL_CDOpen \- Opens a CD-ROM drive for access\&.

.SH "SYNOPSIS"

.PP

\fB#include "SDL\&.h"

.sp

\fBSDL_CD *\fBSDL_CDOpen\fP\fR(\fBint drive\fR);

.SH "DESCRIPTION"

.PP

Opens a CD-ROM drive for access\&. It returns a \fI\fBSDL_CD\fR\fR structure on success, or \fBNULL\fP if the drive was invalid or busy\&. This newly opened CD-ROM becomes the default CD used when other CD functions are passed a \fBNULL\fP CD-ROM handle\&.

.PP

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

.SH "EXAMPLES"

.PP

.nf

\f(CWSDL_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);\fR

.fi

.PP

.SH "SEE ALSO"

.PP

\fI\fBSDL_CD\fR\fR, \fI\fBSDL_CDtrack\fR\fR, \fI\fBSDL_CDClose\fP\fR

.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58