Device::Cdio::Track(3pm)				User Contributed Perl Documentation				  Device::Cdio::Track(3pm)

NAME

       Device::Cdio::Track - Class for track aspects of Device::Cdio.

SYNOPSIS

	   use Device::Cdio::Device;
	   use Device::Cdio::Track;

	   $device = Device::Cdio::Device->new(-source=>'/dev/cdrom');
	   $track  = $device->get_last_track();
	   print "track: %d, last lsn: %d
", $track->{track}, track->get_last_lsn();

	   $track = $device->get_first_track();
	   $format = $rackt->get_format();

METHODS

   new
	 new(device, track)->object

       Creates a new track object.

   get_audio_channels
	 get_audio_channels(cdio, track)->int

       Return number of channels in track: 2 or 4.  Not meaningful if track is not an audio track.  -1 is returned on error and -2 if the driver
       doesn't support the operation.

   get_copy_permit
	 get_copy_permit(cdio, track)->int

       Return copy protection status on a track. Is this meaningful not an audio track?

   get_format
	 get_format()->$format

       Get the format (e.g. 'audio', 'mode2', 'mode1') of track.

   get_last_lsn
	 get_last_lsn()->lsn

       Return the ending LSN for a track $perlcdio::INVALID_LSN is returned on error.

   get_lba
	 get_lba()->lba

       Return the starting LBA for a track $perlcdio::INVALID_LBA is returned on error.

   get_lsn
	 get_lsn()->lsn

       Return the starting LSN for a track $perlcdio::INVALID_LSN is returned on error.

   get_msf
	 get_msf()

       Return the starting MSF (minutes/secs/frames) for track number track.  Track numbers usually start at something greater than 0, usually 1.

       Returns string of the form mm:ss:ff if all good, or string 'error' on error.

   get_preemphasis
	 get_preemphasis()->result

       Get linear preemphasis status on an audio track.  This is not meaningful if not an audio track?

   get_track_sec_count
       item get_track_sec_count()->int Get the number of sectors between this track an the next.  This includes any pregap sectors before the
       start of the next track.  Track numbers usually start at something greater than 0, usually 1.

       $perlcdio::INVALID_LSN is returned on error.

   is_track_green
	 is_track_green(cdio, track) -> bool

       Return True if we have XA data (green, mode2 form1) or XA data (green, mode2 form2). That is track begins:

	 sync - header - subheader
	 12	4      -  8

   get_track_isrc
       $isrc = $track->get_track_isrc;

       Returns an empty string or the International Standard Recording Code.  Which is presented in 4 hyphen separated substrings: "CC-XXX-YY-
       NNNNN"

       "CC" two-character ISO 3166-1 alpha-2 country code "XXX" is a three character alphanumeric registrant code "YY" is the last two digits of
       the year of registration
	    (NB not necessarily the date the recording was made) "NNNNN" is a unique 5-digit number identifying the particular sound recording.

   set_track
	 set_track(track_num)

       Set a new track number.

SEE ALSO

       Device::Cdio is the top-level module, Device::Cdio::Device is a class device objects, and Device::Cdio::ISO9660 for working with ISO9660
       systems.

       perlcdio is the lower-level interface to libcdio.

       <http://www.gnu.org/software/libcdio/doxygen/track_8h.html> is documentation via doxygen of "libiso9660".

AUTHORS

       Rocky Bernstein "<rocky at cpan.org>".

COPYRIGHT

       Copyright (C) 2006 Rocky Bernstein <rocky@cpan.org>

       This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program.  If not, see <http://www.gnu.org/licenses/>.

perl v5.14.2							    2012-06-22						  Device::Cdio::Track(3pm)