'\" t
.TH "movie-to-dvd" 1 videotrans "" videotrans
.SH NAME
\fBmovie-to-dvd\fR \- Convert a movie into a DVD compatible format
.SH SYNOPSIS
.HP
.B movie-to-dvd
.I [\-r\ resolution] [\-d\ display] [\-f\ method] [\-a\ aspect] [\-A\ src_aspect] [\-m\ mode]
[\-c\ audio_codec] [\-q\ quality] [\-Q\ bitrate] [\-o\ output_dir] [\-M] [\-b] [\-O options]
movie
.I [movie ...]
.SH DESCRIPTION
This program takes one or more movie files in any format that \fImplayer\fR
understands and converts them into a DVD compatible format.
.
This program automatically scales the movies so that they will appear
full-screen when viewed on a television set in combination with a standalone
DVD player.
.
Normally, the program produces two files for each input file, one for video and
one for audio, but there is an option to make the program produce finished
(multiplexed) VOB files for you.
.
The program takes care of framerate changes and audio adjustment.
.PP
Nearly everything is done automatically: the program can determine the value of
all the needed parameters automatically, except for the destination video type,
which is either NTSC or PAL.
.
Therefore, the only option that you usually specify is the \fB\-m\fR option.
.
.SH OPTIONS
The following options are available:
.TP
.B \-r resolution
Specify the DVD resolution.
.
Possibilities are:
.br
PAL: \fB720x576\fR, \fB704x576\fR, \fB352x576\fR and \fB352x288\fR
.br
NTSC: \fB720x480\fR, \fB704x480\fR, \fB352x480\fR and \fB352x240\fR
.IP
You may specify \fBauto\fR (which is the default for this option) for
automatic selection.
.
If you leave out this option or specify the value \fBauto\fR, you \fImust\fR
supply a \fB\-m\fR option to tell the system whether you want PAL or NTSC.
.
If you specify a value other than \fBauto\fR, you may leave out the
\fB\-m\fR option, as the system will infer which mode you want automatically.
.
.IP
The value that you specify may not conflict with a specific mode that
you might set using the \fB\-m\fR option; for example, you cannot specify \fB\-r
720x576\fR and then later specify \fB\-m ntsc\fR.
.
.TP
.B \-d display
Specify how the video is to be fitted into the available screen size,
either \fBletterbox\fR (which is the default for this option), which loses no
information but may introduce black borders on either the top and the bottom or
the left and the right sides of the screen, or \fBpanscan\fR, which fills the
entire screen but possibly chops off edges of the video image.
.TP
.B \-f method
Specify how to change the movie to adjust its framerate if necessary.
.
You may specify either \fBauto\fR, \fBvideo\fR, \fBaudio\fR.
.
.IP
\fBvideo\fR will duplicate or drop frames to adjust the framerate (which will
make the movie jerky in some situations), and will keep the audio as it is.
.
.IP
\fBaudio\fR will adjust the pitch of the audio track so that it runs
synchronized with the movie if the movie would be played slightly faster or
slower than normal because it's new framerate is different from the original.
.
.IP
\fBauto\fR will make the choice for you.
.
The choice that is made depends on the source video and the destination
parameters that you are encoding to.
.
.TP
.B \-a aspect
Specify either \fB16:9\fR (widescreen), \fB4:3\fR (traditional TV set) or
\fBauto\fR (which is the default for this option), which chooses the correct
value from the source video automatically.
.
.TP
.B \-A src_aspect
Specify the aspect ratio of the source if it is not encoded correctly in the
source.
.
The format is \fBX:Y\fR, for example \fB4:3\fR or \fB41:18\fR.
.
The numbers used may be floating point, so that you may also use aspect
ratios like \fB1.25:1\fR or \fB1.77:1\fR.
.
Or you may specify \fBauto\fR (default) for automatic detection from the
source.
.
.TP
.B \-m mode
Specify either \fBpal\fR (European and other non-US regions), \fBntsc\fR
(United States) or \fBauto\fR (which is the default for this option).
.
\fBauto\fR is only allowed if you specify a specific resolution using the
\fB\-r\fR option, otherwise the system will not be able to infer which mode you
want.
.
.IP
The value that you specify may not conflict with a specific resolution that
you might set using the \fB\-r\fR option; for example, you cannot specify \fB\-r
720x576\fR and then later specify \fB\-m ntsc\fR.
.
.TP
.B \-c audio_codec
Specify either \fBmp2\fR (two channel audio, supported by PAL DVD players),
\fBac3\fR (Dolby Digital sound, supported by all DVD players) or \fBauto\fR
(which is the default for this option and currently always chooses \fBac3\fR).
.
.IP
According to the DVD standard, NTSC DVD players are required to support AC3,
but not MP2.
.
PAL DVD players are required to support MP2 and AC3.
.
.TP
.B \-q quality
Select either \fBlow\fR, \fBnormal\fR (which is the default for this option)
\fBhigh\fR or a numeric bitrate (in kilobits per second).
.
.IP
\fBlow\fR encodes the video using a maximum bitrate of 3500 kilobits per
second, \fBnormal\fR uses a maximum of 6000 kilobits per second and \fBhigh\fR
uses a maximum of 8000 kilobits per second.
.
Specifying a number uses that number as the maximum bitrate in kilobits per
second.
.TP
.B \-Q bitrate
Select either \fBauto\fR (which is the default for this option) or a numeric
bitrate (in kilobits per second).
.
.IP
\fBauto\fR automatically chooses an appropriate bitrate for the audio
output, depending on the audio output format and the number of channels.
.
You may also specify a numeric bitrate in kilobits per second, such as 224,
384 or 448.
.
If you choose to override the audio bitrate, you should probably combine
this option with the \fB\-c\fR option to override the audio output format
as well, to avoid unexpected results.
.
.TP
.B \-o\ output_dir
Writes the results of the conversion into the specified directory instead
of in the same directory as where the sources are located.
.
If you use this option and the sources include directory names, those
directories will be removed from the source name before using the name
to determine what to call the result in the output directory.
.
.TP
.B \-M
Multiplex the output audio and video together, which means that each source
file will be converted into a DVD-compatible \fB.vob\fR file.
.
If you do not specify this, a \fB.m2v\fR (which contains the video part) and a
\fB.mp2\fR (for stereo audio) or \fB.ac3\fR (for AC3 surround audio) file will
be generated for each input movie.
.
.IP
The program \fBmovie-title\fR(1) (which is used to create DVDs with menus) can
use both the \fB.vob\fR and the \fB.m2v\fR format, although the default (two
generated files per source) is faster because less disk I/O is involved.
.
.TP
.B \-b
This tells \fImplayer\fR that any AVI headers that are encountered are broken
and that they should be ignored when determining the audio-video sync delay.
.
This activates \fImplayer\fR's \fB\-nobps\fR option (see \fImplayer\fR's manual
for details).
.
.TP
.B \-O\ options
You may specify any options for \fImplayer\fR that are needed to decode the
movie(s) that you are converting correctly.
.
You normally don't need to use this option unless the source movie is broken
in some respect.
.
Be sure to quote the options correctly so that they will appear as one string
to this option.
.
Type the options as you would normally do to play the movie correctly on an
\fBmplayer\fR command line.
.
.SH DIAGNOSTICS
If this program is called with a incorrect set of parameters, it will print a
diagnostic message telling the user what went wrong.
.
Also, it will then print its usage information, listing all the options and
their meanings.
.PP
If the program tells you "\fIERROR: Cannot find video size for\fR \fBfile\fR",
this means that \fImplayer\fR was unable to read the file or the file is
stored in a format that it does not understand.
.
In this case, \fBmovie-to-dvd\fR will not be able to transcode the movie file
for you.
.TP
For each source file, the following information is printed:
* Source size: \fBwidth\fRx\fBheight\fR
.br
* Source crop area: \fBwidth\fRx\fBheight\fR
.br
* Destination size: \fBwidth\fRx\fBheight\fR
.br
* Final screen size: \fBwidth\fRx\fBheight\fR
.br
* Destination aspect: \fBwidth\fR:\fBheight\fR
.PP
This small table shows you what will be done to the source file to get to the
destination.
.
The \fBsource size\fR is the frame size of the original video source.
.
The \fBsource crop area\fR is the size of the frame that will be cut out
of the original frame (usually the same size as the source, except when
\fBpanscan\fR mode is used instead of \fBletterbox\fR mode).
.
The \fBdestination size\fR is the size of the zoomed/shrunk image that
calculated from the image that was cut out of the original source image.
.
The \fBfinal screen size\fR is the size of the MPEG-2 frame that will be
created (that is, the destination size including any black borders).
.
The \fBdestination aspect\fR is the aspect ratio of the destination video,
which is either 4:3 (traditional TV set) or 16:9 (widescreen).
.
.PP
While encoding the movie for you, the program will display its progress:
it will tell you how much of the movie it has already encoded (a percentage)
and it will tell you how long it will probably take to finish the encode
(this is, of course, an estimate).
.
.SH EXAMPLE
.TP
The command line that I use most often is:
.IP
\fBmovie-to-dvd\fR \-m pal \fIinput_file.avi\fR
.PP
This command line simply takes the input file (in AVI format in this case) and
converts it into two files, \fIinput_file.mp2\fR (if the source has stereo
audio) or \fIinput_file.ac3\fR (for surround sound) and \fIinput_file.m2v\fR.
.
All the necessary conversions will be automatically done, such as framerate
adjustment, audio adjustment, frame size, etcetera.
.
.PP
Later, I usually combine two or more of these movies into one DVD with a
nice selection menu using \fBmovie-title\fR, usually in combination with
\fBmovie-make-title\fR.
.
.SH "SEE ALSO"
\fBvideotrans\fR(1), \fBmovie-title\fR(1), \fBmovie-make-title\fR(1),
\fBmovie-make-title-simple\fR(1),
\fBmovie-compare-dvd\fR(1), \fBmovie-rip-epg.data\fR(1)
.
.SH AUTHOR
The author is Sven Berkvens-Matthijsse (sven@berkvens.net).
.
Please send any project related e-mail to \fBvideotrans@berkvens.net\fR.
.
.SH SHORTCOMINGS
Currently, the program does not handle subtitles at all.
.
That is to say, it does not support real subtitles that can be turned on and
off in the DVD version of the movie.
.
If a subtitle file is present in the directory where your input movie exists,
and mplayer shows these subtitles when you play the movie on your computer's
display, then the subtitles will be rendered into the DVD version as well, but
you will not be able to turn them on or off.
.
They will then be a fixed part of the image.
.
.PP
Perhaps a future version of Videotrans will support proper subtitling.
.
.SH BUGS
None known. Please report any bugs to \fBvideotrans@berkvens.net\fR!
.
.\" vim:ai:tw=78