NAME

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

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

       and more!

SYNOPSIS

         use Video::Info::FOO;

         my $video;

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

DESCRIPTION

       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?

   METHODS
       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()         ...

BUGS

       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>.

AUTHOR

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

REFERENCES

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