Mercurial > sdl-ios-xcode
annotate docs/man3/SDL_CDStatus.3 @ 1768:814f9f2c7a33
Fixed bug #80
Date: 21 Apr 2003 17:20:20 +0100
From: Alan Swanson <swanson@uklinux.net>
Subject: [SDL] New XFree 4.3 Video Mode Patch
If you look at the unsorted list of modes returned by X, here's mine;
1280 x 1024 @ 85.0 >
1024 x 768 @ 100.3 > USER
800 x 600 @ 125.5 > SET
640 x 480 @ 124.9 >
1280 x 1024 @ 75.0 ]
1280 x 1024 @ 60.0 ]
1280 x 960 @ 85.0 ] X11
1280 x 960 @ 60.0 ] AUTO
1152 x 864 @ 75.0 ]=20
1152 x 768 @ 54.8 ]
960 x 720 @ 120.0 ]
...
640 x 400 @ 85.1 ] 256k
576 x 432 @ 150.0 ] 249k PIXEL
640 x 350 @ 85.1 ] 224k COUNT
576 x 384 @ 109.6 ] 221k
...
The user set modes come first followed by X set modes which are ordered
by decreasing number of pixels and refresh.
The reason why every other library or program not using SDL working is
due to SDL scanning the modes in reverse getting X11 provided modes
modes with the lowest refresh.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Fri, 05 May 2006 05:50:26 +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_CDStatus" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference" |
| 0 | 2 .SH "NAME" |
| 3 SDL_CDStatus\- Returns the current status of the given drive\&. | |
| 4 .SH "SYNOPSIS" | |
| 5 .PP | |
| 6 \fB#include "SDL\&.h" | |
| 7 .sp | |
| 8 \fBCDstatus \fBSDL_CDStatus\fP\fR(\fBSDL_CD *cdrom\fR); | |
| 9 \fB/* Given a status, returns true if there\&'s a disk in the drive */ | |
| 10 #define CD_INDRIVE(status) ((int)status > 0) | |
| 11 .SH "DESCRIPTION" | |
| 12 .PP | |
| 13 This function returns the current status of the given drive\&. Status is described like so: | |
| 14 .PP | |
| 15 .nf | |
| 16 \f(CWtypedef enum { | |
| 17 CD_TRAYEMPTY, | |
| 18 CD_STOPPED, | |
| 19 CD_PLAYING, | |
| 20 CD_PAUSED, | |
| 21 CD_ERROR = -1 | |
| 22 } CDstatus;\fR | |
| 23 .fi | |
| 24 .PP | |
| 25 .PP | |
| 26 If the drive has a CD in it, the table of contents of the CD and current play position of the CD will be stored in the SDL_CD structure\&. | |
| 27 .PP | |
| 28 The macro \fBCD_INDRIVE\fP is provided for convenience, and given a status returns true if there\&'s a disk in the drive\&. | |
| 29 .PP | |
| 30 .RS | |
| 31 \fBNote: | |
| 32 .PP | |
| 33 \fBSDL_CDStatus\fP also updates the \fI\fBSDL_CD\fR\fR structure passed to it\&. | |
| 34 .RE | |
| 35 .SH "EXAMPLE" | |
| 36 .PP | |
| 37 .nf | |
| 38 \f(CWint playTrack(int track) | |
| 39 { | |
| 40 int playing = 0; | |
| 41 | |
| 42 if ( CD_INDRIVE(SDL_CDStatus(cdrom)) ) { | |
| 43 /* clamp to the actual number of tracks on the CD */ | |
| 44 if (track >= cdrom->numtracks) { | |
| 45 track = cdrom->numtracks-1; | |
| 46 } | |
| 47 | |
| 48 if ( SDL_CDPlayTracks(cdrom, track, 0, 1, 0) == 0 ) { | |
| 49 playing = 1; | |
| 50 } | |
| 51 } | |
| 52 return playing; | |
| 53 }\fR | |
| 54 .fi | |
| 55 .PP | |
| 56 .SH "SEE ALSO" | |
| 57 .PP | |
| 58 \fI\fBSDL_CD\fP\fR | |
|
181
e5bc29de3f0a
Updated from the SDL Documentation Project
Sam Lantinga <slouken@libsdl.org>
parents:
55
diff
changeset
|
59 ...\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58 |