audio::flac::decoder(3pm) [debian man page]

Decoder(3pm)						User Contributed Perl Documentation					      Decoder(3pm)

NAME

       Audio::FLAC::Decoder - An object-oriented FLAC decoder

SYNOPSIS

	 use Audio::FLAC::Decoder;
	 my $decoder = Audio::FLAC::Decoder->open("song.flac");
	 my $buffer;
	 while ((my $len = $decoder->sysread($buffer) > 0) {
	   # do something with the PCM stream
	 }

	 OR

	 open FLAC, "song.flac" or die $!;
	 my $decoder = Audio::FLAC::Decoder->open(*FLAC);

	 OR

	 # can also be IO::Socket or any other IO::Handle subclass.
	 my $fh = IO::Handle->new("song.flac");
	 my $decoder = Audio::FLAC::Decoder->open($fh);

DESCRIPTION

       This module provides users with Decoder objects for FLAC files.	One can read data in PCM format from the stream, seek by pcm samples, or
       time.

CONSTRUCTOR

   "open ($filename)"
       Opens an FLAC file for decoding. It opens a handle to the file or uses an existing handle and initializes all of the internal FLAC decoding
       structures.  Note that the object will maintain open file descriptors until the object is collected by the garbage handler. Returns "undef"
       on failure.

INSTANCE METHODS

   "sysread ($buffer, [$size])"
       Reads PCM data from the FLAC stream into $buffer.  Returns the number of bytes read, 0 when it reaches the end of the stream, or a value
       less than 0 on error.  The optional size can specify how many bytes to read.

   "raw_seek ($pos)"
       Seeks through the compressed bitstream to the offset specified by $pos in raw bytes.  Returns 0 on success.

   "sample_seek ($pos)"
       Seeks through the bitstream to the offset specified by $pos in pcm samples. Returns 0 on success.

   "time_seek ($pos, [$page])"
       Seeks through the bitstream to the offset specified by $pos in seconds. Returns 0 on success.

   "bitrate ([$stream])"
       Returns the average bitrate for the specified logical bitstream.  If $stream is left out or set to -1, the average bitrate for the entire
       stream will be reported.

   "time_total ([$stream])"
       Returns the total number of seconds in the bitstream.

   "raw_tell ()"
       Returns the current offset in bytes.

   "time_tell ()"
       Returns the current offset in seconds. - NOT YET IMPLEMENTED

REQUIRES

       libFLAC

COPYRIGHT

       Copyright (c) 2004-2008, Dan Sully.  All Rights Reserved.

       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 2 of the License, or (at your option) any later version.

SEE ALSO

       Audio::FLAC::Header

perl v5.14.2							    2008-11-24							      Decoder(3pm)

GNUPOD_ADDSONG(1)						   User Commands						 GNUPOD_ADDSONG(1)

NAME

       gnupod_addsong - upload music to the iPod

SYNOPSIS

       gnupod_addsong [OPTION]...

DESCRIPTION

       Upload  Music  to  the  iPod.   This  Version  can  read  MP3  AAC/ALAC	(no DRM) and PCM (aka .wav) files.  It can even read FLAC files if
       Audio::FLAC is aviable and the --decode switch was used. (Note: The iPod can't play FLAC files, in this case, gnupod_addsong  converts  the
       FLAC files 'on-the-fly' using 'flac')

       --help display this help and exit

       --version
	      output version information and exit

       -m, --mount=DIRECTORY
	      iPod mountpoint. Default is $IPOD_MOUNTPOINT

       -r, --restore
	      Restore the iPod. Use this if your iPod is messed up. You will lose all playlists

       -d, --duplicate
	      Allow duplicate files. Per default, gnupod_addsong checks for duplicate files.  Use this switch to disable the check.

       -p, --playlist=NAME
	      Add songs to this playlist

       --disable-v1
	      Do not read ID3v1 Tags

       --disable-v2
	      Do not read ID3v2 Tags

       --decode=mp3|pcm|aac|aacbm
	      Convert  FLAC  and  OGG files On-The-Fly into choosen format and add them.  You need the Perl modules 'Audio::FLAC::Header' for FLAC
	      files and 'Ogg::Vorbis::Header::PurePerl' for OGG files. Lame is needed for MP3 Output and FAAC (>= 1.24) is needed for AAC  output.
	      Btw: 'aacbm' means a Bookmark-AAC File (M4B) See --reencode to specify the quality of the output file.

       -e, --reencode=INT
	      Re-encode while adding Files. 0=God / 9=Bad Quality. Lame is needed for MP3, FAAC for AAC (m4a).

       --set-title=STRING
	      Force Title

       --set-artist=STRING
	      Force Artist

       --set-album=STRING
	      Force Album

       --set-genre=STRING
	      Force Genre

       --set-rating=INT
	      Force Rating: 0 = 0 starts / 20 = 1 star / 40 = 2 stars / 60 = 3 stars / 80 = 4 stars / 100 = 5 stars

       --set-playcount=INT
	      Force Playcount

       --set-songnum
	      Order songs on the iPod in the same order as they were added (= Overwrite songnum tag)

       --set-bookmarkable
	      Set this song as bookmarkable (= Remember position)

       --set-shuffleskip
	      Exclude this file in shuffle-mode

       --set-compilation
	      Mark songs as being part of a compilation

       --min-vol-adj=INT
	      Minimum volume adjustment done if ID3v2.4 RVA2 tags are found. Default is 0 (= Do nothing)

       --max-vol-adj=INT
	      Maximum  volume  adjustment  done if ID3v2.4 RVA2 tags are found. Default is 0 (= Do nothing) Using this two options, you can adjust
	      the volume in the range -100% to +100%.

AUTHOR

       Written by Adrian Ulrich

REPORTING BUGS

       Report bugs to <bug-gnupod@nongnu.org>

COPYRIGHT

       Copyright (C) Adrian Ulrich
       This is free software; see the source for copying conditions.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICU-
       LAR PURPOSE.

SEE ALSO

       The  full  documentation for gnupod is maintained as a Texinfo manual.  If the info program and GNUpod are properly installed at your site,
       the command

	      info gnupod

       should give you access to the complete manual.

gnupod_addsong 1.00						    April 2007							 GNUPOD_ADDSONG(1)