misc/builddeps/win64/sdl/share/man/man3/SDL_CDOpen.3

   1 .TH "SDL_CDOpen" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference"
   2 .SH "NAME"
   3 SDL_CDOpen \- Opens a CD-ROM drive for access\&.
   4 .SH "SYNOPSIS"
   5 .PP
   6 \fB#include "SDL\&.h"
   7 .sp
   8 \fBSDL_CD *\fBSDL_CDOpen\fP\fR(\fBint drive\fR);
   9 .SH "DESCRIPTION"
  10 .PP
  11 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\&.
  12 .PP
  13 Drives are numbered starting with 0\&. Drive 0 is the system default CD-ROM\&.
  14 .SH "EXAMPLES"
  15 .PP
  16 .nf
  17 \f(CWSDL_CD *cdrom;
  18 int cur_track;
  19 int min, sec, frame;
  20 SDL_Init(SDL_INIT_CDROM);
  21 atexit(SDL_Quit);
  22
  23 /* Check for CD drives */
  24 if(!SDL_CDNumDrives()){
  25   /* None found */
  26   fprintf(stderr, "No CDROM devices available
  27 ");
  28   exit(-1);
  29 }
  30
  31 /* Open the default drive */
  32 cdrom=SDL_CDOpen(0);
  33
  34 /* Did if open? Check if cdrom is NULL */
  35 if(!cdrom){
  36   fprintf(stderr, "Couldn\&'t open drive: %s
  37 ", SDL_GetError());
  38   exit(-1);
  39 }
  40
  41 /* Print Volume info */
  42 printf("Name: %s
  43 ", SDL_CDName(0));
  44 printf("Tracks: %d
  45 ", cdrom->numtracks);
  46 for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){
  47   FRAMES_TO_MSF(cdrom->track[cur_track]\&.length, &min, &sec, &frame);
  48   printf("      Track %d: Length %d:%d
  49 ", cur_track, min, sec);
  50 }
  51
  52 SDL_CDClose(cdrom);\fR
  53 .fi
  54 .PP
  55 .SH "SEE ALSO"
  56 .PP
  57 \fI\fBSDL_CD\fR\fR, \fI\fBSDL_CDtrack\fR\fR, \fI\fBSDL_CDClose\fP\fR
  58 .\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58