comparison docs/man3/SDL_CDOpen.3 @ 0:74212992fb08

Initial revision
author Sam Lantinga <slouken@lokigames.com>
date Thu, 26 Apr 2001 16:45:43 +0000
parents
children 55f1f1b3e27d
comparison
equal deleted inserted replaced
-1:000000000000 0:74212992fb08
1 .TH "SDL_CDOpen" "3" "Mon 12 Mar 2001, 01:02" "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, Mon 12 Mar 2001, 01:02