]> git.xonotic.org Git - xonotic/xonotic.git/blobdiff - misc/builddeps/win64/sdl/share/man/man3/SDL_CD.3
Move libraries into subdirectories for better selectivity when building.
[xonotic/xonotic.git] / misc / builddeps / win64 / sdl / share / man / man3 / SDL_CD.3
diff --git a/misc/builddeps/win64/sdl/share/man/man3/SDL_CD.3 b/misc/builddeps/win64/sdl/share/man/man3/SDL_CD.3
new file mode 100644 (file)
index 0000000..ea21818
--- /dev/null
@@ -0,0 +1,57 @@
+.TH "SDL_CD" "3" "Tue 11 Sep 2001, 22:58" "SDL" "SDL API Reference" 
+.SH "NAME"
+SDL_CD \- CDROM Drive Information
+.SH "STRUCTURE DEFINITION"
+.PP
+.nf
+\f(CWtypedef struct{
+  int id;
+  CDstatus status;
+  int numtracks;
+  int cur_track;
+  int cur_frame;
+  SDL_CDtrack track[SDL_MAX_TRACKS+1];
+} SDL_CD;\fR
+.fi
+.PP
+.SH "STRUCTURE DATA"
+.TP 20
+\fBid\fR
+Private drive identifier
+.TP 20
+\fBstatus\fR
+Drive \fIstatus\fR
+.TP 20
+\fBnumtracks\fR
+Number of tracks on the CD
+.TP 20
+\fBcur_track\fR
+Current track
+.TP 20
+\fBcur_frame\fR
+Current frame offset within the track
+.TP 20
+\fBtrack\fR[SDL_MAX_TRACKS+1]
+Array of track descriptions\&. (see \fI\fBSDL_CDtrack\fR\fR)
+.SH "DESCRIPTION"
+.PP
+An \fBSDL_CD\fR structure is returned by \fI\fBSDL_CDOpen\fP\fR\&. It represents an opened CDROM device and stores information on the layout of the tracks on the disc\&.
+.PP
+A frame is the base data unit of a CD\&. \fBCD_FPS\fP frames is equal to 1 second of music\&. SDL provides two macros for converting between time and frames: \fBFRAMES_TO_MSF(f, M,S,F)\fP and \fBMSF_TO_FRAMES\fP\&.
+.SH "EXAMPLES"
+.PP
+.nf
+\f(CWint min, sec, frame;
+int frame_offset;
+
+FRAMES_TO_MSF(cdrom->cur_frame, &min, &sec, &frame);
+printf("Current Position: %d minutes, %d seconds, %d frames
+", min, sec, frame);
+
+frame_offset=MSF_TO_FRAMES(min, sec, frame);\fR
+.fi
+.PP
+.SH "SEE ALSO"
+.PP
+\fI\fBSDL_CDOpen\fP\fR, \fI\fBSDL_CDtrack\fR\fR
+.\" created by instant / docbook-to-man, Tue 11 Sep 2001, 22:58