.TH DUMPMPEG 1 "May 2001" "dumpmpeg @VERSION@" 
.SH NAME
dumpmpeg \- A program to dump frames from an MPEG movie.

.SH SYNOPSIS
\fBdumpmpeg\fR [\fIoptions\fR] \fIfile\fR

.SH DESCRIPTION
.I dumpmpeg
is a program that allows you to dump video frames from MPEG movie files. It 
uses the SDL MPEG Player Library to accomplish this and thus requires an open
X-Window. Since it uses the SMPEG library, it can dump frames from format it
supports, which currently is MPEG-1 video files. 
.SH OPTIONS
.TP
.B \-h, \-\-help
Show short usage information
.TP
.B \-\-dump N
Only dump every Nth frame. Default behavior is to dump every frame.
.TP
.B \-\-prefix N
The file prefix of saved frames. The frame number and .bmp will be appended to
this to form the file name. Default prefix is "framedump_".
.TP
.B \-s N, \-\-start N
Skip N frames before starting to dump. 
.TP
.B \-q, \-\-quiet
Only print error messages during execution.
.TP
.B \-v, \-\-version
Print version information.
.SH AUTHORS
dumpmpeg is written by David Hedbor <david@hedbor.org>. It is based on
plaympeg from the SDL MPEG Player Library, which was written by Karl
Robillard and Sam Lantinga of Loki Entertainment Software.
.SH "RELATED SITES"
.TP
dumpmpeg homepage at Soureforge: 
.B http://www.sourceforge.net/projects/dumpmpeg/
.TP
SMPEG home page at: 
.B http://www.lokigames.com/development/smpeg.php3
.TP
SDL home page at: 
.B http://www.libsdl.org/

.SH "SEE ALSO"
.BR plaympeg (1), 
.BR gtv (1)
.RB "

.SH COPYRIGHT
Copyright (C) 2000, 2001 David Hedbor
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.
.PP   
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.