diff options
Diffstat (limited to 'distrib/sdl-1.2.15/docs/html/cdrom.html')
| -rw-r--r-- | distrib/sdl-1.2.15/docs/html/cdrom.html | 260 |
1 files changed, 260 insertions, 0 deletions
diff --git a/distrib/sdl-1.2.15/docs/html/cdrom.html b/distrib/sdl-1.2.15/docs/html/cdrom.html new file mode 100644 index 0000000..bdd6bfd --- /dev/null +++ b/distrib/sdl-1.2.15/docs/html/cdrom.html @@ -0,0 +1,260 @@ +<HTML +><HEAD +><TITLE +>CD-ROM</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"><LINK +REL="HOME" +TITLE="SDL Library Documentation" +HREF="index.html"><LINK +REL="UP" +TITLE="SDL Reference" +HREF="reference.html"><LINK +REL="PREVIOUS" +TITLE="SDL_CloseAudio" +HREF="sdlcloseaudio.html"><LINK +REL="NEXT" +TITLE="SDL_CDNumDrives" +HREF="sdlcdnumdrives.html"><META +NAME="KEYWORD" +CONTENT="cdrom"><META +NAME="KEYWORD" +CONTENT="function"></HEAD +><BODY +CLASS="CHAPTER" +BGCOLOR="#FFF8DC" +TEXT="#000000" +LINK="#0000ee" +VLINK="#551a8b" +ALINK="#ff0000" +><DIV +CLASS="NAVHEADER" +><TABLE +SUMMARY="Header navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>SDL Library Documentation</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="sdlcloseaudio.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="sdlcdnumdrives.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="CDROM" +></A +>Chapter 11. CD-ROM</H1 +><DIV +CLASS="TOC" +><DL +><DT +><B +>Table of Contents</B +></DT +><DT +><A +HREF="sdlcdnumdrives.html" +>SDL_CDNumDrives</A +> -- Returns the number of CD-ROM drives on the system.</DT +><DT +><A +HREF="sdlcdname.html" +>SDL_CDName</A +> -- Returns a human-readable, system-dependent identifier for the CD-ROM.</DT +><DT +><A +HREF="sdlcdopen.html" +>SDL_CDOpen</A +> -- Opens a CD-ROM drive for access.</DT +><DT +><A +HREF="sdlcdstatus.html" +>SDL_CDStatus</A +> -- Returns the current status of the given drive.</DT +><DT +><A +HREF="sdlcdplay.html" +>SDL_CDPlay</A +> -- Play a CD</DT +><DT +><A +HREF="sdlcdplaytracks.html" +>SDL_CDPlayTracks</A +> -- Play the given CD track(s)</DT +><DT +><A +HREF="sdlcdpause.html" +>SDL_CDPause</A +> -- Pauses a CDROM</DT +><DT +><A +HREF="sdlcdresume.html" +>SDL_CDResume</A +> -- Resumes a CDROM</DT +><DT +><A +HREF="sdlcdstop.html" +>SDL_CDStop</A +> -- Stops a CDROM</DT +><DT +><A +HREF="sdlcdeject.html" +>SDL_CDEject</A +> -- Ejects a CDROM</DT +><DT +><A +HREF="sdlcdclose.html" +>SDL_CDClose</A +> -- Closes a SDL_CD handle</DT +><DT +><A +HREF="sdlcd.html" +>SDL_CD</A +> -- CDROM Drive Information</DT +><DT +><A +HREF="sdlcdtrack.html" +>SDL_CDtrack</A +> -- CD Track Information Structure</DT +></DL +></DIV +><P +>SDL supports audio control of up to 32 local CD-ROM drives at once.</P +><P +>You use this API to perform all the basic functions of a CD player, +including listing the tracks, playing, stopping, and ejecting the CD-ROM. +(Currently, multi-changer CD drives are not supported.)</P +><P +>Before you call any of the SDL CD-ROM functions, you must first call +"<TT +CLASS="FUNCTION" +>SDL_Init(SDL_INIT_CDROM)</TT +>", which scans the system for +CD-ROM drives, and sets the program up for audio control. Check the +return code, which should be <SPAN +CLASS="RETURNVALUE" +>0</SPAN +>, to see if there +were any errors in starting up.</P +><P +>After you have initialized the library, you can find out how many drives +are available using the <TT +CLASS="FUNCTION" +>SDL_CDNumDrives()</TT +> function. +The first drive listed is the system default CD-ROM drive. After you have +chosen a drive, and have opened it with <TT +CLASS="FUNCTION" +>SDL_CDOpen()</TT +>, +you can check the status and start playing if there's a CD in the drive.</P +><P +>A CD-ROM is organized into one or more tracks, each consisting of a certain +number of "frames". Each frame is ~2K in size, and at normal playing speed, +a CD plays 75 frames per second. SDL works with the number of frames on a +CD, but this can easily be converted to the more familiar minutes/seconds +format by using the <TT +CLASS="FUNCTION" +>FRAMES_TO_MSF()</TT +> macro.</P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +SUMMARY="Footer navigation table" +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="sdlcloseaudio.html" +ACCESSKEY="P" +>Prev</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="index.html" +ACCESSKEY="H" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="sdlcdnumdrives.html" +ACCESSKEY="N" +>Next</A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>SDL_CloseAudio</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="reference.html" +ACCESSKEY="U" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>SDL_CDNumDrives</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file |