DV2SUB(1)DV2SUB(1)NAME
dv2sub - extract info or subtitles from DV stream
SYNOPSIS
dv2sub {-i | -s} [dv-file]
dv2sub --subtitles-out sub-file [dv-file]
DESCRIPTION
Utility dv2sub reads raw DV stream from file argument dv-file or
standard input if absent. It can generate a parametr log about every
input DV frame or create MicroDVD subtitles with the recording date &
time.
Memory mapped I/O is used for seekable input when available. It is
faster than sequential access.
dv2sub uses GPL codec for DV video LibDV, see
http://libdv.sourceforge.net/.
OPTIONS-i, --info
Generate a simple information about every input DV frame. Reported
are: frame number (counting from 0), video norm PAL/NTSC, aspect
ratio normal (4:3) or wide (16:9), interlaced or progressive
material, number of audio channels, audio sampling frequency, number
of audio samples, timestamp, recording date & time.
--ssyb-dump
Dump SSYB packets in hexadecimal form. (implies -i)
--vaux-dump
Dump VAUX packets in hexadecimal form. (implies -i)
--info-out info-file
Generate info (like with option -i, --info) and write output into
file info-file.
-s, --subtitles
Generate MicroDVD subtitles with the recording date & time.
--subtitles-out sub-file
Generate subtitles (like -s, --subtitles) and write output into file
sub-file.
-f, --time-format fmt
Use the format specification fmt by strftime() to output a subtitle
line. The default format value is `%F|%T'.
-b, --boundary time
Don't output subtitles with time above a boundary. The option
argument syntax is YYYY[-mm[-dd [HH:MM[:SS]]]]. Default values for
missing parts are the minimal ones. E.g. 2007 sets boundary to
2007-01-01 00:00:00.
Suppose you recorded a video. You grabbed video into a computer and
edit it with non-linear editor like kino latter. Video transitions
between scenes have date and time set to time of editing. You can
use this option to filter out date and time subtitles of edited
parts.
-n, --max-frames num
Don't process more than num frames.
-d, --date1
Output one line with the recording date & time from the 3rd frame.
--no-mmap
Don't use mmap().
-p, --pass-through
Pass an input DV stream to stdout (implies --no-mmap). This option
is usable mainly if you need to extract subtitles and encode the DV
in one pass. You can avoid reading huge DV file twice by passing
stdout through pipe to an encoder (ffmpeg, mpeg2enc,...).
-h, --help
Output a brief help message.
-V, --version
Output a version number.
AUTHORS
Miguel Sahagun
Author.
Vaclav Ovsik
Author.
01/13/2008 DV2SUB(1)