3 <h3 id="TOP">Index</h3>
5 <ul><li><a href="#NAME">NAME</a></li>
6 <li><a href="#CATEGORY">CATEGORY</a></li>
7 <li><a href="#SYNOPSIS">SYNOPSIS</a></li>
8 <li><a href="#CONSTANTS">CONSTANTS</a></li>
9 <li><a href="#METHOD">METHOD</a>
10 <ul><li><a href="#new">new</a></li>
11 <li><a href="#status">status</a></li>
12 <li><a href="#play_tracks">play_tracks</a></li>
13 <li><a href="#play">play</a></li>
14 <li><a href="#pause">pause </a></li>
15 <li><a href="#resume">resume</a></li>
16 <li><a href="#stop">stop</a></li>
17 <li><a href="#eject">eject</a></li>
18 <li><a href="#id">id</a></li>
19 <li><a href="#num_tracks">num_tracks</a></li>
20 <li><a href="#cur_track">cur_track </a></li>
21 <li><a href="#track">track</a></li>
22 <li><a href="#FRAMES_TO_MSF">FRAMES_TO_MSF</a></li>
23 <li><a href="#MSF_TO_FRAMES">MSF_TO_FRAMES</a></li>
26 <li><a href="#SEE_ALSO">SEE ALSO</a></li>
27 <li><a href="#AUTHORS">AUTHORS</a>
32 <h1 id="NAME">NAME</h1><p><a href="#TOP" class="toplink">Top</a></p>
33 <div id="NAME_CONTENT">
34 <p>SDL::CD -- SDL Bindings for structure SDL_CD</p>
37 <h1 id="CATEGORY">CATEGORY</h1><p><a href="#TOP" class="toplink">Top</a></p>
38 <div id="CATEGORY_CONTENT">
39 <p>Core, CDROM, Structure</p>
42 <h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p>
43 <div id="SYNOPSIS_CONTENT">
48 SDL::init(SDL_INIT_CDROM);
50 my $drives = SDL::CDROM::num_drives;
54 my $CD = SDL::CD->new( 0 );
66 <h1 id="CONSTANTS">CONSTANTS</h1><p><a href="#TOP" class="toplink">Top</a></p>
67 <div id="CONSTANTS_CONTENT">
68 <p>The constants are exported by default. You can avoid this by doing:</p>
72 <p>and access them directly:</p>
73 <pre> SDL::CD::CD_TRAYEMPTY;
76 <p>or by choosing the export tags below:</p>
77 <p>Export tag: ':status'</p>
85 <p>Export tag: ':defaults'</p>
92 <h1 id="METHOD">METHOD</h1><p><a href="#TOP" class="toplink">Top</a></p>
93 <div id="METHOD_CONTENT">
97 <div id="new_CONTENT">
98 <pre> my $CD = SDL::CD->new($drive)
101 <p>Makes a new SDL::CD object. Returns <code>undef</code> if the drive is busy or inaccessible. </p>
104 <h2 id="status">status</h2>
105 <div id="status_CONTENT">
106 <pre> my $status = $CD->status();
109 <p>Returns the current status of the CD tray </p>
110 <p>Returns on of the following constants:</p>
112 <li>CD_TRAYEMPTY </li>
121 <h2 id="play_tracks">play_tracks</h2>
122 <div id="play_tracks_CONTENT">
123 <pre> $CD->play_tracks($start_track, $start_frame, $ntracks, $nframes)
126 <p>Plays the given SDL::CD starting at track $start_track, for $ntracks tracks. </p>
127 <p>$start_frame is the frame offset, from the beginning of the $start_track, at which to start. $nframes is the frame offset, from the
128 beginning of the last track ($start_track+$ntracks), at which to end playing.</p>
129 <p>play_tracks() should only be called after calling <a href="#status">status</a> to get information about the CD.</p>
130 <p><strong>Note: Data tracks are ignored.</strong></p>
131 <p>Returns <code>0</code>, or <code>-1</code> if there was an error. </p>
134 <h2 id="play">play</h2>
135 <div id="play_CONTENT">
136 <pre> $CD->play($start, $length);
139 <p>Plays the given SDL::CD , starting a frame $start for $length frames. </p>
140 <p>Returns <code>0</code> on success, <code>-1</code> on error</p>
143 <h2 id="pause">pause </h2>
144 <div id="pause_CONTENT">
145 <pre> $CD->pause();
148 <p>Pauses play on CD</p>
149 <p>Returns <code>0</code> on success, or <code>-1</code> on an error. </p>
152 <h2 id="resume">resume</h2>
153 <div id="resume_CONTENT">
154 <pre> $CD->resume();
157 <p>Returns <code>0</code> on success, or <code>-1</code> on an error. </p>
160 <h2 id="stop">stop</h2>
161 <div id="stop_CONTENT">
162 <pre> $CD->stop();
165 <p>Stops play on the CD. </p>
166 <p>Returns <code>0</code> on success, or <code>-1</code> on an error. </p>
169 <h2 id="eject">eject</h2>
170 <div id="eject_CONTENT">
171 <pre> $CD->eject();
174 <p>Ejects the CD.</p>
175 <p>Returns <code>0</code> on success, or <code>-1</code> on an error. </p>
179 <div id="id_CONTENT">
183 <p>Private drive identifier</p>
186 <h2 id="num_tracks">num_tracks</h2>
187 <div id="num_tracks_CONTENT">
188 <pre> $CD->num_tracks();
191 <p>Number of tracks on the CD</p>
194 <h2 id="cur_track">cur_track </h2>
195 <div id="cur_track_CONTENT">
196 <pre> $CD->cur_track();
199 <p>Current track on the CD;</p>
202 <h2 id="track">track</h2>
203 <div id="track_CONTENT">
204 <pre> my $track = $CD->track($number);
207 <p>Retrives track description of track $number in CD. See <a href="SDL-CDTrack.html">SDL::CDTrack</a>.</p>
210 <h2 id="FRAMES_TO_MSF">FRAMES_TO_MSF</h2>
211 <div id="FRAMES_TO_MSF_CONTENT">
212 <pre> my ($min, $sec, $fra) = FRAMES_TO_MSF($frames);
215 <p>Conversion functions from frames to Minute/Second/Frames</p>
218 <h2 id="MSF_TO_FRAMES">MSF_TO_FRAMES</h2>
219 <div id="MSF_TO_FRAMES_CONTENT">
220 <pre> my $frames = MSF_TO_FRAMES($min, $sec, $fra);
225 <h1 id="SEE_ALSO">SEE ALSO</h1><p><a href="#TOP" class="toplink">Top</a></p>
226 <div id="SEE_ALSO_CONTENT">
227 <p><a href="SDL-CDROM.html">SDL::CDROM</a>, <a href="SDL-CDTrack.html">SDL::CDTrack</a></p>
230 <h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p>
231 <div id="AUTHORS_CONTENT">
232 <p>See <b>AUTHORS</b> in <cite>SDL</cite>.</p>