mirror of
https://github.com/dhewm/dhewm3-libs.git
synced 2024-11-27 22:32:54 +00:00
c3bc09dc60
./configure --host=i686-w64-mingw32 \ --prefix=$HOME/devel/games/doom3-libs/i686-w64-mingw32
58 lines
1.5 KiB
Groff
58 lines
1.5 KiB
Groff
.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
|