[cvs-annodex] commit (/annodex): +liboggz/trunk/release_notes/liboggz-0.9.1.txt

conrad nobody at lists.annodex.net
Fri Apr 8 21:20:09 EST 2005


Update of /annodex (new revision 1221)

Added files:
   liboggz/trunk/release_notes/liboggz-0.9.1.txt

Log Message:
add release notes for 0.9.1


Added: liboggz/trunk/release_notes/liboggz-0.9.1.txt
===================================================================
--- liboggz/trunk/release_notes/liboggz-0.9.1.txt	2005-04-08 08:47:09 UTC (rev 1220)
+++ liboggz/trunk/release_notes/liboggz-0.9.1.txt	2005-04-08 11:20:09 UTC (rev 1221)
@@ -0,0 +1,211 @@
+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  . at 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/


-- 
conrad



More information about the cvs-annodex mailing list