Video::Info::RIFF.3pm

Langue: en

Version: 2002-11-08 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Video::Info::RIFF - Probe DivX and AVI files for attributes like:
  -video codec
  -audio codec
  -frame height
  -frame width
  -frame count
 
 

and more!

SYNOPSIS

   use Video::Info::RIFF;
 
   my $video;
 
   $video = Video::Info::RIFF->new(-file=>$filename);                          #like this
   $video = Video::Info::RIFF->new(-file=>$filename,-headersize=>$headersize); #or this
 
   $video->vcodec;                         #video codec
   $video->acodec;                         #audio codec
   ...
 
 

DESCRIPTION

RIFF stands for Resource Interchange File Format, in case you were wondering. The morbidly curious can find out more below in REFERENCES.

METHODS

Video::Info::RIFF has one constructor, new(). It is called as:
  -file       => $filename,   #your RIFF file
  -headersize => $headersize  #optional RIFF header size to parse Returns a Video::Info::RIFF object if the file was opened successfully.

The Video::Info::RIFF object to parses the file by method probe(). This does a series of sysread()s on the file to figure out what the properties are.

Now, call one (or more) of these methods to get the low-down on your file:

  method              returns
  ---------------------------------------------------
  achans()            number of audio channels
  acodec()            audio codec
  acodecraw()         audio codec numeric ID
  arate()             audio bitrate
  afrequency()        sampling rate of audio streams, in Hertz
  astreams()          number of audio streams
  filename()          path file used to create object
  filesize()          size in bytes of filename()
  expectedsize()      expected size in bytes of filename(),
                      according to the RIFF header
  fourcc()            RIFF Four Character Code
  fps()               frames/second
  height()            frame height in pixels
  probe()             try to determine filetype
  scale()             video bitrate
  type()              type of file data.  RIFF or AVI
  vcodec()            video codec
  vframes()           number of frames
  vrate()             video bitrate
  vstreams()          number of video streams
  width()             frame width in pixels
 
 

BUGS

The default header_size() (10K) may not be large enough to successfully extract the video/audio attributes for all RIFF files. If this module fails you, increase the RIFF header size. If it still fails, let me know.

Audio codec name mapping is incomplete. If you know the name that corresponds to an audio codec ID that I don't, tell me.

AUTHOR

  Copyright (c) 2002
  Aladdin Free Public License (see LICENSE for details)
  Allen Day <allenday@ucla.edu>
 
 

REFERENCES

Transcode, a linux video stream processing tool:
  http://www.theorie.physik.uni-goettingen.de/~ostreich/transcode/

Microsoft RIFF:
  http://www.oreilly.com/centers/gff/formats/micriff/