######################################################################
    Video::FrameGrab 0.01
######################################################################

NAME
    Video::FrameGrab - Grab a frame from a video

SYNOPSIS
        use Video::FrameGrab;

        my $grabber = Video::FrameGrab->new();

        my $jpg_data = $grabber->frame_grab( $avi_file, "00:00:10" );

        $grabber->jpeg_save("snapshot.jpg");

DESCRIPTION
    Video::FrameGrab grabs a frame at the specified point in time from the
    specified video file and returns its JPEG data.

    It uses mplayer for the heavy lifting behind the scenes and therefore
    requires it to be installed somewhere in the PATH. If mplayer is
    somewhere else, its location can be provided to the constructor:

        my $grabber = Video::FrameGrab->new( mplayer => "/path/to/mplayer" );

  METHODS
    frame_grab( $file, $time )
        Grabs a frame from the movie at time $time. Time is given as
        HH::MM::SS, just as mplayer likes it. Returns the raw jpeg data of
        the captured frame on success and undef if an error occurs.

    jpeg_save( $file )
        Save a grabbed frame as a jpeg image in $file on disk.

LEGALESE
    Copyright 2009 by Mike Schilli, all rights reserved. This program is
    free software, you can redistribute it and/or modify it under the same
    terms as Perl itself.

AUTHOR
    2009, Mike Schilli <cpan@perlmeister.com>

