Video::Info::FOO - what is it useful for? an example list:

 -video codec
 -audio codec
 -frame height
 -frame width
 -frame count

and more!

  use Video::Info::FOO;

  my $video;

  $video->vcodec;                         #video codec
  $video->acodec;                         #audio codec
  ...

What does the module do? What are it's limitations? Is it built on top of other code? If so, what are the details and where can I get it?

Video::Info::FOO 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::FOO object if the file was opened successfully.

The Video::Info::FOO 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()
 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
 ...                 ...
 and_so_on()         ...

Audio codec name mapping is incomplete. If you know the name that corresponds to an audio codec ID that I don't, tell the Video::Info::Magic author, Allen Day <allenday@ucla.edu>.

 Copyright (c) 2002
 Aladdin Free Public License (see LICENSE for details)
 Your Name <your.name@email.address>

 List any references that were used to write Video::Info::FOO,
 preferrably with URLs.