+++ /dev/null
-.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