diff --git a/release_notes/liboggz-0.9.3.txt b/release_notes/liboggz-0.9.3.txt new file mode 100644 index 0000000000000000000000000000000000000000..dca43c8987dd33874bba2e2df000423a64a696cb --- /dev/null +++ b/release_notes/liboggz-0.9.3.txt @@ -0,0 +1,124 @@ +Oggz 0.9.3 Release +------------------ + +Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump, +oggzdiff, oggzmerge, oggzrip, oggz-scan 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.3.tar.gz + +New in this release: + + * New oggz-scan tool (silvia) + + oggz-scan displays timestamps of characteristic features in an Ogg + file. 'oggz-scan --keyframes file.ogg' displays timestamps of + unforced Theora keyframes, which are a useful rough approximation of + shot boundaries. Results can be output as plain text, CMML or HTML. + + * Improvements to oggz-validate: + - added page-level validation, ensuring that a page that ends zero + packets has the correct granulepos, -1. (MikeS) + - added a check that any Theora bos pages come before Vorbis and + Speex bos pages. (ticket:156) (conrad) + - correct handling of chained files (ticket: 162) (conrad) + + * win32 build fix for oggz tools (j^) + + * Other bugfixes / closed tickets: + + liboggz: replace internal typedef of oggz_off_t, use off_t instead + of long (ticket:161) (Grayfox) + examples/fix-eos: discard trailing incomplete packets from the end + of the stream. (MikeS) + remove autogenerated manpages (ticket:155) (conrad, silvia) + + +About Oggz +---------- + +Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump, +oggzdiff, oggzmerge, oggzrip, oggz-scan 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. + + * oggzmerge: Merge Ogg files together, interleaving pages in order + of presentation time. + + * oggzrip: Extract one or more logical bitstreams from an Ogg file. + + * oggz-scan: Scan an Ogg file and output characteristic landmarks. + + * 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/