Oggz 0.9.1 Release
------------------
Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
oggzdiff, oggzmerge, oggzrip and oggz-validate.
liboggz is a C library providing a simple programming interface for reading
and writing Ogg files and streams. Ogg is an interleaving data container
developed by Monty at Xiph.Org, originally to support the Ogg Vorbis audio
format.
This release is available as a source tarball at:
http://www.annodex.net/software/liboggz/download/liboggz-0.9.1.tar.gz
New in this release:
* Added new oggzinfo tool
-------------------------
oggzinfo displays information about the contents of Ogg files.
By default it displays basic information such as audio samplerate
and video dimensions:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
$ oggzinfo 2004-12-04-cc-theora.ogg
Content-Duration: 00:01:54.748
Theora: serialno 1648191042
3442 packets in 251 pages, 13.7 packets/page
Video-Framerate: 29.970 fps
Video-Width: 160
Video-Height: 128
Vorbis: serialno 0317964026
4935 packets in 138 pages, 35.8 packets/page
Audio-Samplerate: 22000 Hz
Audio-Channels: 2
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
oggzinfo also has options to display the following information for
the entire file, and also for each logical bitstream:
- length in bytes, kB, MB, GB
- average bitrate in bps, kbps, Mbps, Gbps
- statistics on page lengths (maximum and standard deviation)
- statistics on packet lengths (maximum and standard deviation)
The man page for oggzinfo(1) can be read online at:
http://www.annodex.net/cgi-bin/man/man2html?query=oggzinfo
* Added new oggz-validate tool
------------------------------
oggz-validate checks the ordering of packets within an Ogg file, and
also checks that it complies with the Ogg bitstream mapping
restrictions.
The man page for oggz-validate(1) can be read online at:
http://www.annodex.net/cgi-bin/man/man2html?query=oggz-validate
* improved oggzdump tool
------------------------
oggzdump now displays packet lengths (in bytes, kB, MB, GB ;-)
and timestamps (rather than just byte offsets). It now interprets
theora granulepos as a split of keyframe|pframe:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
00:00:07.733: serialno 0539503247, granulepos 89|27, packetno 119: 277 bytes
0000: 506c a908 120e 3d0b 88d7 73e9 7227 227c Pl....= ..s.r'"|
0010: 9f40 7463 f789 87c1 8b79 043b 183c 946f .@tc.....y.;.<.o
0020: d1e3 3e47 0798 9fcd 61a9 f113 e261 d1ec ..>G....a....a..
...
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
oggzdump now also has a --content-type (or -c) option for
specifying the name of a particular bitstream to dump:
oggzdump --content-type theora file.ogg
will dump only the packets in the theora logical bitstream.
The man page for oggzdump(1) can be read online at:
http://www.annodex.net/cgi-bin/man/man2html?query=oggzdump
* bugfix in oggzdiff tool
-------------------------
r1176: fix some typos in oggzdiff which prevented multiple hide
options from being specified
The man page for oggzdiff(1) can be read online at:
http://www.annodex.net/cgi-bin/man/man2html?query=oggzdiff
* liboggz: bugfix in raw seeking
--------------------------------
liboggz provides seeking by time or byte offsets in multitrack Ogg
files. It automatically handles time offsets for files containing
Theora, Speex, Vorbis, FLAC and CMML.
r1092: fix a bug in raw seeking, where doing a raw seek by bytes
and back again by time (to the original time point) hadn't
invalidated the cached time offset, hence the second seek was
considered unnecessary and skipped. This change correctly
invalidates the cached time offset when doing a raw byte seek.
* unnecessary optimisations in oggzrip tool
-------------------------------------------
Optimised packet filtering: filtering decisions are now made at the
start of each logical bitstream, not at every packet. Additionally,
the hardcoded limit of extracting no more than 64 logical bitstreams
from the input file was removed.
The man page for oggzrip(1) can be read online at:
http://www.annodex.net/cgi-bin/man/man2html?query=oggzrip
About Oggz
----------
Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
oggzdiff, oggzmerge, oggzrip and oggz-validate.
liboggz supports the flexibility afforded by the Ogg file format while
presenting the following API niceties:
* Full API documentation
* Comprehensive test suite of read, write and seeking behavior.
The entire test suite can be run under valgrind if available.
* Developed and tested on GNU/Linux, Darwin/MacOSX, Win32 and
Symbian OS. May work on other Unix-like systems via GNU autoconf.
For Win32: nmake Makefiles, Visual Studio .NET 2003 solution files
and Visual C++ 6.0 workspace files are provided in the source
distribution.
* Strict adherence to the formatting requirements of Ogg bitstreams,
to ensure that only valid bitstreams are generated; writes can fail
if you try to write illegally structured packets.
* A simple, callback based open/read/close or open/write/close
interface to raw Ogg files.
* Writing automatically interleaves with packet queuing, and provides
callback based notification when this queue is empty
* A customisable seeking abstraction for seeking on multitrack Ogg
data. Seeking works easily and reliably on multitrack and multi-codec
streams, and can transparently parse Theora, Speex, Vorbis, FLAC,
CMML and Ogg Skeleton headers without requiring linking to those
libraries. This allows efficient use on servers and other devices
that need to parse and seek within Ogg files, but do not need to do
a full media decode.
Full documentation of the liboggz API, customization and installation,
and mux and demux examples can be read online at:
http://www.annodex.net/software/liboggz/html/
Tools
-----
The Oggz source tarball also contains the following command-line tools,
which are useful for debugging and testing Ogg bitstreams:
* oggzinfo: Display information about one or more Ogg files and
their bitstreams.
* oggzdump: Hexdump packets of an Ogg file, or revert an Ogg file
from such a hexdump.
* oggzdiff: Hexdump the packets of two Ogg files and output
differences Oggz is Free Software, available under a BSD-style
license.
* oggzmerge: Merge Ogg files together, interleaving pages in order
of presentation time.
* oggzrip: Extract one or more logical bitstreams from an Ogg file.
* oggz-validate: Validate the Ogg framing of one or more files.
License
-------
Oggz is Free Software, available under a BSD style license.
More information is available online at the Oggz homepage:
http://www.annodex.net/software/liboggz/
enjoy :)
--
Conrad Parker
Senior Software Engineer, Continuous Media Web, CSIRO Australia
http://www.annodex.net/ http://www.ict.csiro.au/cmweb/
