root/liboggz/trunk/release_notes/liboggz-0.9.3.txt

Revision 1568, 4.5 kB (checked in by conrad, 3 years ago)

add 0.9.3 release notes

Line 
1 Oggz 0.9.3 Release
2 ------------------
3
4 Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
5 oggzdiff, oggzmerge, oggzrip, oggz-scan and oggz-validate.
6
7 liboggz is a C library providing a simple programming interface for reading
8 and writing Ogg files and streams. Ogg is an interleaving data container
9 developed by Monty at Xiph.Org, originally to support the Ogg Vorbis audio
10 format.
11
12 This release is available as a source tarball at:
13
14 http://www.annodex.net/software/liboggz/download/liboggz-0.9.3.tar.gz
15
16 New in this release:
17
18         * New oggz-scan tool (silvia)
19
20         oggz-scan displays timestamps of characteristic features in an Ogg
21         file. 'oggz-scan --keyframes file.ogg' displays timestamps of
22         unforced Theora keyframes, which are a useful rough approximation of
23         shot boundaries. Results can be output as plain text, CMML or HTML.
24
25         * Improvements to oggz-validate:
26           - added page-level validation, ensuring that a page that ends zero
27           packets has the correct granulepos, -1. (MikeS)
28           - added a check that any Theora bos pages come before Vorbis and
29           Speex bos pages. (ticket:156) (conrad)
30           - correct handling of chained files (ticket: 162) (conrad)
31
32         * win32 build fix for oggz tools (j^)
33
34         * Other bugfixes / closed tickets:
35
36         liboggz: replace internal typedef of oggz_off_t, use off_t instead
37           of long (ticket:161) (Grayfox)
38         examples/fix-eos: discard trailing incomplete packets from the end
39           of the stream. (MikeS)
40         remove autogenerated manpages (ticket:155) (conrad, silvia)
41
42  
43 About Oggz
44 ----------
45
46 Oggz comprises liboggz and the command-line tools oggzinfo, oggzdump,
47 oggzdiff, oggzmerge, oggzrip, oggz-scan and oggz-validate.
48
49 liboggz supports the flexibility afforded by the Ogg file format while
50 presenting the following API niceties:
51
52         * Full API documentation
53
54         * Comprehensive test suite of read, write and seeking behavior.
55         The entire test suite can be run under valgrind if available.
56
57         * Developed and tested on GNU/Linux, Darwin/MacOSX, Win32 and
58         Symbian OS. May work on other Unix-like systems via GNU autoconf.
59         For Win32: nmake Makefiles, Visual Studio .NET 2003 solution files
60         and Visual C++ 6.0 workspace files are provided in the source
61         distribution.
62
63         * Strict adherence to the formatting requirements of Ogg bitstreams,
64         to ensure that only valid bitstreams are generated; writes can fail
65         if you try to write illegally structured packets.
66
67         * A simple, callback based open/read/close or open/write/close
68         interface to raw Ogg files.
69
70         * Writing automatically interleaves with packet queuing, and provides   
71         callback based notification when this queue is empty
72
73         * A customisable seeking abstraction for seeking on multitrack Ogg
74         data. Seeking works easily and reliably on multitrack and multi-codec
75         streams, and can transparently parse Theora, Speex, Vorbis, FLAC,
76         CMML and Ogg Skeleton headers  without requiring linking to those
77         libraries. This allows efficient use on servers and other devices
78         that need to parse and seek within Ogg files, but do not need to do
79         a full media decode.
80
81 Full documentation of the liboggz API, customization and installation,
82 and mux and demux examples can be read online at:
83
84     http://www.annodex.net/software/liboggz/html/
85
86 Tools
87 -----
88
89 The Oggz source tarball also contains the following command-line tools,
90 which are useful for debugging and testing Ogg bitstreams:
91
92         * oggzinfo: Display information about one or more Ogg files and
93         their bitstreams.
94
95         * oggzdump: Hexdump packets of an Ogg file, or revert an Ogg file
96         from such a hexdump.
97
98         * oggzdiff: Hexdump the packets of two Ogg files and output
99         differences.
100
101         * oggzmerge: Merge Ogg files together, interleaving pages in order
102         of presentation time.
103
104         * oggzrip: Extract one or more logical bitstreams from an Ogg file.
105
106         * oggz-scan: Scan an Ogg file and output characteristic landmarks.
107
108         * oggz-validate: Validate the Ogg framing of one or more files.
109
110 License
111 -------
112
113 Oggz is Free Software, available under a BSD style license.
114
115 More information is available online at the Oggz homepage:
116
117     http://www.annodex.net/software/liboggz/
118
119 enjoy :)
120
121 --
122 Conrad Parker
123 Senior Software Engineer, Continuous Media Web, CSIRO Australia
124 http://www.annodex.net/   http://www.ict.csiro.au/cmweb/
Note: See TracBrowser for help on using the browser.