Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_CDOpen.3 @ 1795:398ac0f88e4d
Fixed bug #220
The AltiVec blitters don't compile, since they require __VEC__ to be enabled in
order for the compiler to understand "vector" and friends (i.e. do AltiVec)
But you don't want to turn AltiVec on globally, since then the code would only
run on a G4 (there are already runtime tests, before using the AltiVec
variants)
The solution here is to enable AltiVec locally, for the actual AltiVec code.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Tue, 09 May 2006 15:09:47 +0000 |
| parents | e5bc29de3f0a |
| children | 546f7c1eb755 |
| 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" |
| 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 | |
|
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 |