.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+
−