Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_CDOpen.3 @ 4135:cd98d1dc385c SDL-1.2
Damien Carbery fixed bug #542
In SDL 1.2.13 sdl.m4 the AM_PATH_SDL function looks for sdl-config.
It sets the PATH:
PATH="$prefix/bin:$prefix/usr/bin:$PATH"
but does not save the current PATH or restore the current PATH at the end.
This breaks the build on Solaris because we have GNU tools in another dir
(listed at the top of PATH) but non-GNU tools with the same names in
$prefix/bin. Later configure tests finds the non-GNU tools and quits in error
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Thu, 24 Jan 2008 15:50:20 +0000 |
| parents | 4e3b250c950e |
| children | 1238da4a7112 |
| rev | line source |
|---|---|
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
1 .TH "SDL_CDOpen" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference" |
| 0 | 2 .SH "NAME" |
|
4107
4e3b250c950e
Erik Heckers fixed bug #493
Sam Lantinga <slouken@libsdl.org>
parents:
181
diff
changeset
|
3 SDL_CDOpen \- Opens a CD-ROM drive for access\&. |
| 0 | 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 | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
58 ...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58 |