|
Packit |
a38265 |
.TH "oggz-sort" "1"
|
|
Packit |
a38265 |
.SH "NAME"
|
|
Packit |
a38265 |
oggz-sort \(em Sort the pages of an Ogg file in order of presentation time.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "SYNOPSIS"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-sort\fR [\-o \fBfilename\fR | \-\-output \fBfilename\fR ] filename
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-sort\fR [\-h | \-\-help ] [\-v | \-\-version ]
|
|
Packit |
a38265 |
.SH "Description"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-sort\fR sorts an Ogg file, interleaving
|
|
Packit |
a38265 |
pages in order of presentation time.
|
|
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 |
Some encoders produce files with incorrect page ordering; for example,
|
|
Packit |
a38265 |
some audio and video pages may occur out of order. Although these files
|
|
Packit |
a38265 |
are usually playable, it can be difficult to accurately seek or scrub
|
|
Packit |
a38265 |
on them, increasing the likelihood of glitches during playback.
|
|
Packit |
a38265 |
Players may also need to use more memory in order to buffer the audio
|
|
Packit |
a38265 |
and video data for synchronized playback, which can be a problem when
|
|
Packit |
a38265 |
the files are viewed on low-memory devices.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Some older Ogg encoders also produce pages which incorrectly have
|
|
Packit |
a38265 |
granulepos timestamps recorded that shouldn't be: pages which have no
|
|
Packit |
a38265 |
completed packets must have a granulepos of \-1.
|
|
Packit |
a38265 |
\fBoggz-sort\fR will correct such granulepos during the
|
|
Packit |
a38265 |
process of sorting.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
The tool \fBoggz-validate\fR can be used to check the
|
|
Packit |
a38265 |
relative ordering of packets in a file, and also to detect incorrect
|
|
Packit |
a38265 |
granulepos on pages with no completed packets. If either of these errors
|
|
Packit |
a38265 |
are reported, or use \fBoggz-sort\fR to fix the problem.
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "Options"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
\fBoggz-sort\fR accepts the following options:
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SS "Miscellaneous 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 "\-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 |
Correct the page ordering in broken.ogv:
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
.RS
|
|
Packit |
a38265 |
\f(CWoggz sort \-o fixed.ogv broken.ogv\fP
|
|
Packit |
a38265 |
.RE
|
|
Packit |
a38265 |
|
|
Packit |
a38265 |
.SH "AUTHOR"
|
|
Packit |
a38265 |
.PP
|
|
Packit |
a38265 |
Conrad Parker January 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 |
\fBoggz-diff\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
|