Fix potential integer overflow.
[liboggz.git] / release_notes / liboggz-0.8.3.txt
1 Oggz 0.8.3 Release
2 ------------------
3
4 liboggz is a C library providing a simple programming interface for reading
5 and writing Ogg files and streams. Ogg is an interleaving data container
6 developed by Monty at Xiph.Org, originally to support the Ogg Vorbis audio
7 format.
8
9 This release is available as a source tarball at:
10
11 http://www.annodex.net/software/liboggz/download/liboggz-0.8.3.tar.gz
12
13 New in this release:
14
15         * Theora header parsing updated for Theora alpha3
16         * fixes for win32 build procedure
17         * improved API documentation for seeking, OGGZ_AUTO and OggzIO
18
19 About Oggz
20 ----------
21
22 Oggz comprises liboggz and the command-line tools oggzdump and oggzdiff.
23
24 liboggz supports the flexibility afforded by the Ogg file format while
25 presenting the following API niceties:
26
27         * Full API documentation.
28
29         * Comprehensive test suite of read, write and seeking behavior.
30
31         * Developed and tested on GNU/Linux, Darwin/MacOSX and Win32. May
32         work on other Unix-like systems via GNU autoconf. For Win32: nmake
33         Makefiles, Visual Studio .NET 2003 solution files and Visual C++ 6.0
34         workspace files are provided in the source distribution.
35
36         * Strict adherence to the formatting requirements of Ogg bitstreams,
37         to ensure that only valid bitstreams are generated; writes can fail
38         if you try to write illegally structured packets.
39
40         * A simple, callback based open/read/close or open/write/close
41         interface to raw Ogg files.
42
43         * Writing automatically interleaves with packet queuing, and provides   
44         callback based notification when this queue is empty
45
46         * A customisable seeking abstraction for seeking on multitrack Ogg
47         data. Seeking works easily and reliably on multitrack and multi-codec
48         streams, and can transparently parse Theora, Speex, Vorbis and Annodex
49         headers  without requiring linking to those libraries. This allows
50         efficient use on servers and other devices that need to parse and
51         seek within Ogg files, but do not need to do a full media decode.
52
53 Full documentation of the liboggz API, customization and installation,
54 and mux and demux examples can be read online at:
55
56     http://www.annodex.net/software/liboggz/html/
57
58 Tools
59 -----
60
61 The Oggz source tarball also contains the following command-line tools,
62 which are useful for debugging and testing Ogg bitstreams:
63
64         * oggzdump: Hexdump packets of an Ogg file, or revert an Ogg file
65         from such a hexdump.
66
67         * oggzdiff: Hexdump the packets of two Ogg files and output
68         differences Oggz is Free Software, available under a BSD-style
69         license.
70
71 License
72 -------
73
74 Oggz is Free Software, available under a BSD style license.
75
76 More information is available online at the Oggz homepage:
77
78     http://www.annodex.net/software/liboggz/
79
80 enjoy :)
81
82 --
83 Conrad Parker
84 Senior Software Engineer, Continuous Media Web, CSIRO Australia
85 http://www.annodex.net/   http://www.ict.csiro.au/cmweb/