|
Packit |
a38265 |
.TH "oggz-chop" "1"
|
|
Packit |
a38265 |
.SH "NAME"
|
|
Packit |
a38265 |
oggz-chop \(em Extract the part of an Ogg file between given start and/or end times.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "SYNOPSIS"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-chop\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] [\-s \fBstart_time\fR | \-\-start \fBstart_time\fR ] [\-e \fBend_time\fR | \-\-end \fBend_time\fR ] [\-k | \-\-no-skeleton ] filename
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-chop\fR [\-h | \-\-help ] [\-v | \-\-version ]
|
|
Packit |
a38265 |
.SH "Description"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-chop\fR chops a section of an Ogg file.
|
|
Packit |
a38265 |
It correctly interprets the granulepos timestamps of
|
|
Packit |
a38265 |
Ogg CELT, CMML, Dirac, FLAC, Kate, PCM, Speex, Theora and Vorbis
|
|
Packit |
a38265 |
bitstreams.
|
|
Packit |
a38265 |
Run \fBoggz-known-codecs\fP\fB(1)\fP for a full list
|
|
Packit |
a38265 |
of codecs known by the installed version of oggz.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
The output file contains copies of the headers of the input file, and
|
|
Packit |
a38265 |
all the codec data required to correctly decode the content between the
|
|
Packit |
a38265 |
start and end times specified on the commandline. For codecs with data
|
|
Packit |
a38265 |
dependencies like video keyframes, the keyframe prior to the starting
|
|
Packit |
a38265 |
time will be included in the output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Note that \fBoggz-chop\fR operates by copying pages of
|
|
Packit |
a38265 |
Ogg data; it does not strip partial packets from the first or last
|
|
Packit |
a38265 |
data page included in the output. It does however ensure to set the
|
|
Packit |
a38265 |
end of stream flag on the last page of each logical bitstream.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Skeleton handling: By default, the output will contain a Skeleton track
|
|
Packit |
a38265 |
specifying the start of the chop as presentation time.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "Options"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-chop\fR accepts the following options:
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SS "Output options"
|
|
Packit |
a38265 |
.IP "\-o \fBfilename\fR, \-\-output \fBfilename\fR" 10
|
|
Packit |
a38265 |
Write output to the specified
|
|
Packit |
a38265 |
\fBfilename\fR instead of printing it to
|
|
Packit |
a38265 |
standard output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.IP "\-s \fBstart_time\fR, \-\-start \fBstart_time\fR" 10
|
|
Packit |
a38265 |
Specify the start time of the chopped section to output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.IP "\-e \fBend_time\fR, \-\-end \fBend_time\fR" 10
|
|
Packit |
a38265 |
Specify the end time of the chopped section to output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.IP "\-k , \-\-no-skeleton" 10
|
|
Packit |
a38265 |
Do NOT include a Skeleton bitstream in the output.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.IP "\-h, \-\-help" 10
|
|
Packit |
a38265 |
Display usage information and exit.
|
|
Packit |
a38265 |
.IP "\-v, \-\-version" 10
|
|
Packit |
a38265 |
Output version information and exit.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH EXAMPLES
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Extract the first minute of file.ogx:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
.RS
|
|
Packit |
a38265 |
\f(CWoggz chop \-e 1:00 file.ogx\fP
|
|
Packit |
a38265 |
.RE
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Extract from the second to the fifth minute of file.ogx:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
.RS
|
|
Packit |
a38265 |
\f(CWoggz chop \-s 2:00 \-e 5:00 \-o output.ogx file.ogx\fP
|
|
Packit |
a38265 |
.RE
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Extract, specifying SMPTE-25 frame offsets:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
.RS
|
|
Packit |
a38265 |
\f(CWoggz chop \-s smpte\-25:00:02:03::12 \-e smpte\-25:00:05:02::04 \-o output.ogv file.ogv\fP
|
|
Packit |
a38265 |
.RE
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "Server configuration"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
The following configuration for Apache httpd will enable oggz-chop. As with
|
|
Packit |
a38265 |
most Apache directives, this may of course be restricted to particular
|
|
Packit |
a38265 |
Directories or Locations:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
ScriptAlias /oggz-chop /usr/bin/oggz-chop
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Action application/ogg /oggz-chop
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SS "HTTP/1.1 Cacheability"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
oggz-chop generates Last-Modified HTTP headers, and
|
|
Packit |
a38265 |
responds correctly to If-Modified-Since conditional GET requests.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "AUTHOR"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Conrad Parker February 25, 2008;
|
|
Packit |
a38265 |
.SH "COPYRIGHT"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Copyright \(co 2008 Annodex Association
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "SEE ALSO"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-validate\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBoggz-merge\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBoggz-dump\fP\fB(1)\fP,
|
|
Packit |
a38265 |
\fBhogg\fP\fB(1)\fP
|
|
Packit |
a38265 |
.\" created by instant / docbook-to-man, Mon 23 Feb 2009, 12:35
|