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