NAME

Audio::Mad - Perl interface to the mad MPEG decoder library

SYNOPSIS

use Audio::Mad qw(:all);

my $stream   = new Audio::Mad::Stream();
my $frame    = new Audio::Mad::Frame();
my $synth    = new Audio::Mad::Synth();
my $timer    = new Audio::Mad::Timer();
my $resample = new Audio::Mad::Resample(44100, 22050);
my $dither   = new Audio::Mad::Dither();

my $buffer = join('', <STDIN>);
$stream->buffer($buffer);

FRAME: {
	if ($frame->decode($stream) == -1) {
		last FRAME unless ($stream->err_ok());

		warn "decoding error: " . $stream->error();
		next FRAME;
	}

	$synth->synth($frame);
	my $pcm = $dither->dither($resample->resample($synth->samples()));

	print $pcm;
	next FRAME;
}
                           

DESCRIPTION

This module is an attempt to provide a perl interface to the MAD
(MPEG Audio Decoder) library,  written by Robert Leslie.  It has
been designed to be 100% object oriented,  and to follow the MAD
interface as closely as possible.

So far,  most of the MAD library,  plus two companion modules
are provided as part of the interface.  Seperate documentation 
is provided in perldoc for all of the modules in the
Audio::Mad framework.

EXPORT

None by default.

EXPORT_OK

• :dither

  MAD_DITHER_S8	  	  MAD_DITHER_U8
  MAD_DITHER_S16_LE	  MAD_DITHER_S16_BE
  MAD_DITHER_S24_LE	  MAD_DITHER_S24_BE
  MAD_DITHER_S32_LE	  MAD_DITHER_S32_BE

• :error

  MAD_ERROR_BADHUFFDATA     MAD_ERROR_LOSTSYNC       
  MAD_ERROR_BADCRC          MAD_ERROR_BADBITALLOC  
  MAD_ERROR_BADBITRATE      MAD_ERROR_BADSAMPLERATE
  MAD_ERROR_BADBLOCKTYPE    MAD_ERROR_BADHUFFTABLE   
  MAD_ERROR_BADSCFSI        MAD_ERROR_NOMEM        
  MAD_ERROR_BUFLEN          MAD_ERROR_BADFRAMELEN
  MAD_ERROR_BADPART3LEN     MAD_ERROR_BADSTEREO
  MAD_ERROR_BUFPTR          MAD_ERROR_BADLAYER
  MAD_ERROR_BADSCALEFACTOR  MAD_ERROR_BADDATAPTR
  MAD_ERROR_BADEMPHASIS     MAD_ERROR_BADBIGVALUES

• :flag

  MAD_FLAG_COPYRIGHT        MAD_FLAG_FREEFORMAT
  MAD_FLAG_INCOMPLETE       MAD_FLAG_I_STEREO
  MAD_FLAG_LSF_EXT          MAD_FLAG_MS_STEREO
  MAD_FLAG_MC_EXT           MAD_FLAG_MPEG_2_5_EXT
  MAD_FLAG_NPRIVATE_III     MAD_FLAG_ORIGINAL
  MAD_FLAG_PROTECTION       MAD_FLAG_PADDING

• :f

  MAD_F_ONE                 MAD_F_MAX
  MAD_F_FRACBITS            MAD_F_MIN 

• :layer

  MAD_LAYER_I               MAD_LAYER_III
  MAD_LAYER_II

• :mode

  MAD_MODE_SINGLE_CHANNEL   MAD_MODE_STEREO
  MAD_MODE_DUAL_CHANNEL     MAD_MODE_JOINT_STEREO

• :timer

  MAD_TIMER_RESOLUTION

• :units

  MAD_UNITS_8000_HZ         MAD_UNITS_MILLISECONDS
  MAD_UNITS_11025_HZ        MAD_UNITS_CENTISECONDS
  MAD_UNITS_12000_HZ        MAD_UNITS_DECISECONDS
  MAD_UNITS_16000_HZ        MAD_UNITS_SECONDS
  MAD_UNITS_22050_HZ        MAD_UNITS_MINUTES
  MAD_UNITS_24000_HZ        MAD_UNITS_HOURS
  MAD_UNITS_32000_HZ
  MAD_UNITS_44100_HZ
  MAD_UNITS_48000_HZ

AUTHOR

Mark McConnell <mischke@cpan.org>

SEE ALSO

perl(1)

Audio::Mad::Stream(3) Audio::Mad::Frame(3) Audio::Mad::Synth(3) Audio::Mad::Resample(3) Audio::Mad::Dither(3) Audio::Mad::Timer(3)