home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue2 / SDL.ARC / sdlhtmldox / sdlcdplayt < prev    next >
Encoding:
Text File  |  2001-05-09  |  4.0 KB  |  317 lines
  1. <HTML
  2. ><HEAD
  3. ><TITLE
  4. >SDL_CDPlayTracks</TITLE
  5. ><META
  6. NAME="GENERATOR"
  7. CONTENT="Modular DocBook HTML Stylesheet Version 1.64
  8. "><LINK
  9. REL="HOME"
  10. TITLE="SDL Library Documentation"
  11. HREF="index.html"><LINK
  12. REL="UP"
  13. TITLE="CD-ROM"
  14. HREF="cdrom.html"><LINK
  15. REL="PREVIOUS"
  16. TITLE="SDL_CDPlay"
  17. HREF="sdlcdplay.html"><LINK
  18. REL="NEXT"
  19. TITLE="SDL_CDPause"
  20. HREF="sdlcdpause.html"></HEAD
  21. ><BODY
  22. CLASS="REFENTRY"
  23. BGCOLOR="#FFF8DC"
  24. TEXT="#000000"
  25. LINK="#0000ee"
  26. VLINK="#551a8b"
  27. ALINK="#ff0000"
  28. ><DIV
  29. CLASS="NAVHEADER"
  30. ><TABLE
  31. WIDTH="100%"
  32. BORDER="0"
  33. CELLPADDING="0"
  34. CELLSPACING="0"
  35. ><TR
  36. ><TH
  37. COLSPAN="3"
  38. ALIGN="center"
  39. >SDL Library Documentation</TH
  40. ></TR
  41. ><TR
  42. ><TD
  43. WIDTH="10%"
  44. ALIGN="left"
  45. VALIGN="bottom"
  46. ><A
  47. HREF="sdlcdplay.html"
  48. >Prev</A
  49. ></TD
  50. ><TD
  51. WIDTH="80%"
  52. ALIGN="center"
  53. VALIGN="bottom"
  54. ></TD
  55. ><TD
  56. WIDTH="10%"
  57. ALIGN="right"
  58. VALIGN="bottom"
  59. ><A
  60. HREF="sdlcdpause.html"
  61. >Next</A
  62. ></TD
  63. ></TR
  64. ></TABLE
  65. ><HR
  66. ALIGN="LEFT"
  67. WIDTH="100%"></DIV
  68. ><H1
  69. ><A
  70. NAME="SDLCDPLAYTRACKS"
  71. >SDL_CDPlayTracks</A
  72. ></H1
  73. ><DIV
  74. CLASS="REFNAMEDIV"
  75. ><A
  76. NAME="AEN6832"
  77. ></A
  78. ><H2
  79. >Name</H2
  80. >SDL_CDPlayTracks -- Play the given CD track(s)</DIV
  81. ><DIV
  82. CLASS="REFSYNOPSISDIV"
  83. ><A
  84. NAME="AEN6835"
  85. ></A
  86. ><H2
  87. >Synopsis</H2
  88. ><DIV
  89. CLASS="FUNCSYNOPSIS"
  90. ><A
  91. NAME="AEN6836"
  92. ></A
  93. ><P
  94. ></P
  95. ><PRE
  96. CLASS="FUNCSYNOPSISINFO"
  97. >#include "SDL.h"</PRE
  98. ><P
  99. ><CODE
  100. ><CODE
  101. CLASS="FUNCDEF"
  102. >int <B
  103. CLASS="FSFUNC"
  104. >SDL_CDPlayTracks</B
  105. ></CODE
  106. >(SDL_CD *cdrom, int start_track, int start_frame, int ntracks, int nframes));</CODE
  107. ></P
  108. ><P
  109. ></P
  110. ></DIV
  111. ></DIV
  112. ><DIV
  113. CLASS="REFSECT1"
  114. ><A
  115. NAME="AEN6842"
  116. ></A
  117. ><H2
  118. >Description</H2
  119. ><P
  120. ><TT
  121. CLASS="FUNCTION"
  122. >SDL_CDPlayTracks</TT
  123. > plays the given CD starting at track
  124. <TT
  125. CLASS="PARAMETER"
  126. ><I
  127. >start_track</I
  128. ></TT
  129. >, for <TT
  130. CLASS="PARAMETER"
  131. ><I
  132. >ntracks</I
  133. ></TT
  134. > tracks.  </P
  135. ><P
  136. ><TT
  137. CLASS="PARAMETER"
  138. ><I
  139. >start_frame</I
  140. ></TT
  141. > is the frame offset, from the beginning of the <TT
  142. CLASS="PARAMETER"
  143. ><I
  144. >start_track</I
  145. ></TT
  146. >, at which to start. <TT
  147. CLASS="PARAMETER"
  148. ><I
  149. >nframes</I
  150. ></TT
  151. > is the frame offset, from the beginning of the last track (<TT
  152. CLASS="PARAMETER"
  153. ><I
  154. >start_track</I
  155. ></TT
  156. >+<TT
  157. CLASS="PARAMETER"
  158. ><I
  159. >ntracks</I
  160. ></TT
  161. >), at which to end playing.</P
  162. ><P
  163. ><TT
  164. CLASS="FUNCTION"
  165. >SDL_CDPlayTracks</TT
  166. > should only be called after calling 
  167. <A
  168. HREF="sdlcdstatus.html"
  169. ><TT
  170. CLASS="FUNCTION"
  171. >SDL_CDStatus</TT
  172. ></A
  173. > 
  174. to get track information about the CD.</P
  175. ><DIV
  176. CLASS="NOTE"
  177. ><BLOCKQUOTE
  178. CLASS="NOTE"
  179. ><P
  180. ><B
  181. >Note: </B
  182. >Data tracks are ignored.</P
  183. ></BLOCKQUOTE
  184. ></DIV
  185. ></DIV
  186. ><DIV
  187. CLASS="REFSECT1"
  188. ><A
  189. NAME="AEN6860"
  190. ></A
  191. ><H2
  192. >Return Value</H2
  193. ><P
  194. >Returns <SPAN
  195. CLASS="RETURNVALUE"
  196. >0</SPAN
  197. >, or <SPAN
  198. CLASS="RETURNVALUE"
  199. >-1</SPAN
  200. > 
  201. if there was an error.</P
  202. ></DIV
  203. ><DIV
  204. CLASS="REFSECT1"
  205. ><A
  206. NAME="AEN6865"
  207. ></A
  208. ><H2
  209. >Examples</H2
  210. ><P
  211. ><PRE
  212. CLASS="PROGRAMLISTING"
  213. >/* assuming cdrom is a previously opened device */
  214. /* Play the entire CD */
  215. if(CD_INDRIVE(SDL_CDStatus(cdrom)))
  216.   SDL_CDPlayTracks(cdrom, 0, 0, 0, 0);
  217.  
  218. /* Play the first track */
  219. if(CD_INDRIVE(SDL_CDStatus(cdrom)))
  220.   SDL_CDPlayTracks(cdrom, 0, 0, 1, 0);
  221.  
  222. /* Play first 15 seconds of the 2nd track */
  223. if(CD_INDRIVE(SDL_CDStatus(cdrom)))
  224.   SDL_CDPlayTracks(cdrom, 1, 0, 0, CD_FPS*15);</PRE
  225. >
  226. </P
  227. ></DIV
  228. ><DIV
  229. CLASS="REFSECT1"
  230. ><A
  231. NAME="AEN6869"
  232. ></A
  233. ><H2
  234. >See Also</H2
  235. ><P
  236. ><A
  237. HREF="sdlcdplay.html"
  238. ><TT
  239. CLASS="FUNCTION"
  240. >SDL_CDPlay</TT
  241. ></A
  242. >,
  243. <A
  244. HREF="sdlcdstatus.html"
  245. ><TT
  246. CLASS="FUNCTION"
  247. >SDL_CDStatus</TT
  248. ></A
  249. >,
  250. <A
  251. HREF="sdlcd.html"
  252. ><TT
  253. CLASS="FUNCTION"
  254. >SDL_CD</TT
  255. ></A
  256. ></P
  257. ></DIV
  258. ><DIV
  259. CLASS="NAVFOOTER"
  260. ><HR
  261. ALIGN="LEFT"
  262. WIDTH="100%"><TABLE
  263. WIDTH="100%"
  264. BORDER="0"
  265. CELLPADDING="0"
  266. CELLSPACING="0"
  267. ><TR
  268. ><TD
  269. WIDTH="33%"
  270. ALIGN="left"
  271. VALIGN="top"
  272. ><A
  273. HREF="sdlcdplay.html"
  274. >Prev</A
  275. ></TD
  276. ><TD
  277. WIDTH="34%"
  278. ALIGN="center"
  279. VALIGN="top"
  280. ><A
  281. HREF="index.html"
  282. >Home</A
  283. ></TD
  284. ><TD
  285. WIDTH="33%"
  286. ALIGN="right"
  287. VALIGN="top"
  288. ><A
  289. HREF="sdlcdpause.html"
  290. >Next</A
  291. ></TD
  292. ></TR
  293. ><TR
  294. ><TD
  295. WIDTH="33%"
  296. ALIGN="left"
  297. VALIGN="top"
  298. >SDL_CDPlay</TD
  299. ><TD
  300. WIDTH="34%"
  301. ALIGN="center"
  302. VALIGN="top"
  303. ><A
  304. HREF="cdrom.html"
  305. >Up</A
  306. ></TD
  307. ><TD
  308. WIDTH="33%"
  309. ALIGN="right"
  310. VALIGN="top"
  311. >SDL_CDPause</TD
  312. ></TR
  313. ></TABLE
  314. ></DIV
  315. ></BODY
  316. ></HTML
  317. >