|
Packit |
06404a |
********************************************************************
|
|
Packit |
06404a |
* *
|
|
Packit |
06404a |
* THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE. *
|
|
Packit |
06404a |
* USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS *
|
|
Packit |
06404a |
* GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
|
|
Packit |
06404a |
* IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING. *
|
|
Packit |
06404a |
* *
|
|
Packit |
06404a |
* THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2015 *
|
|
Packit |
06404a |
* by the Xiph.org Foundation, http://www.xiph.org/ *
|
|
Packit |
06404a |
* *
|
|
Packit |
06404a |
********************************************************************
|
|
Packit |
06404a |
|
|
Packit |
06404a |
Vorbis is a general purpose audio and music encoding format
|
|
Packit |
06404a |
contemporary to MPEG-4's AAC and TwinVQ, the next generation beyond
|
|
Packit |
06404a |
MPEG audio layer 3. Unlike the MPEG sponsored formats (and other
|
|
Packit |
06404a |
proprietary formats such as RealAudio G2 and Windows' flavor of the
|
|
Packit |
06404a |
month), the Vorbis CODEC specification belongs to the public domain.
|
|
Packit |
06404a |
All the technical details are published and documented, and any
|
|
Packit |
06404a |
software entity may make full use of the format without license
|
|
Packit |
06404a |
fee, royalty or patent concerns.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
This package contains:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
* libvorbis, a BSD-style license software implementation of
|
|
Packit |
06404a |
the Vorbis specification by the Xiph.Org Foundation
|
|
Packit |
06404a |
(http://www.xiph.org/)
|
|
Packit |
06404a |
|
|
Packit |
06404a |
* libvorbisfile, a BSD-style license convenience library
|
|
Packit |
06404a |
built on Vorbis designed to simplify common uses
|
|
Packit |
06404a |
|
|
Packit |
06404a |
* libvorbisenc, a BSD-style license library that provides a simple,
|
|
Packit |
06404a |
programmatic encoding setup interface
|
|
Packit |
06404a |
|
|
Packit |
06404a |
* example code making use of libogg, libvorbis, libvorbisfile and
|
|
Packit |
06404a |
libvorbisenc
|
|
Packit |
06404a |
|
|
Packit |
06404a |
WHAT'S HERE:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
This source distribution includes libvorbis and an example
|
|
Packit |
06404a |
encoder/player to demonstrate use of libvorbis as well as
|
|
Packit |
06404a |
documentation on the Ogg Vorbis audio coding format.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
You'll need libogg (distributed separately) to compile this library.
|
|
Packit |
06404a |
A more comprehensive set of utilities is available in the vorbis-tools
|
|
Packit |
06404a |
package.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
Directory:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./lib The source for the libraries, a BSD-license implementation
|
|
Packit |
06404a |
of the public domain Ogg Vorbis audio encoding format.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./include Library API headers
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./debian Rules/spec files for building Debian .deb packages
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./doc Vorbis documentation
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./examples Example code illustrating programmatic use of libvorbis,
|
|
Packit |
06404a |
libvorbisfile and libvorbisenc
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./mac Codewarrior project files and build tweaks for MacOS.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./macosx Project files for MacOS X.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./win32 Win32 projects files and build automation
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./vq Internal utilities for training/building new LSP/residue
|
|
Packit |
06404a |
and auxiliary codebooks.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
CONTACT:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
The Ogg homepage is located at 'http://www.xiph.org/ogg/'.
|
|
Packit |
06404a |
Vorbis's homepage is located at 'http://www.xiph.org/vorbis/'.
|
|
Packit |
06404a |
Up to date technical documents, contact information, source code and
|
|
Packit |
06404a |
pre-built utilities may be found there.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
The user website for Ogg Vorbis software and audio is http://vorbis.com/
|
|
Packit |
06404a |
|
|
Packit |
06404a |
BUILDING FROM TRUNK:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
Development source is under subversion revision control at
|
|
Packit |
06404a |
https://svn.xiph.org/trunk/vorbis/. You will also need the
|
|
Packit |
06404a |
newest versions of autoconf, automake, libtool and pkg-config in
|
|
Packit |
06404a |
order to compile Vorbis from development source. A configure script
|
|
Packit |
06404a |
is provided for you in the source tarball distributions.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
[update or checkout latest source]
|
|
Packit |
06404a |
./autogen.sh
|
|
Packit |
06404a |
make
|
|
Packit |
06404a |
|
|
Packit |
06404a |
and as root if desired:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
make install
|
|
Packit |
06404a |
|
|
Packit |
06404a |
This will install the Vorbis libraries (static and shared) into
|
|
Packit |
06404a |
/usr/local/lib, includes into /usr/local/include and API manpages
|
|
Packit |
06404a |
(once we write some) into /usr/local/man.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
Documentation building requires xsltproc and pdfxmltex.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
BUILDING FROM TARBALL DISTRIBUTIONS:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
./configure
|
|
Packit |
06404a |
make
|
|
Packit |
06404a |
|
|
Packit |
06404a |
and optionally (as root):
|
|
Packit |
06404a |
make install
|
|
Packit |
06404a |
|
|
Packit |
06404a |
BUILDING RPMS:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
after normal configuring:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
make dist
|
|
Packit |
06404a |
rpm -ta libvorbis-<version>.tar.gz
|
|
Packit |
06404a |
|
|
Packit |
06404a |
BUILDING ON MACOS 9:
|
|
Packit |
06404a |
|
|
Packit |
06404a |
Vorbis on MacOS 9 is built using Metroworks CodeWarrior. To build it,
|
|
Packit |
06404a |
first verify that the Ogg libraries are already built following the
|
|
Packit |
06404a |
instructions in the Ogg module README. Open vorbis/mac/libvorbis.mcp,
|
|
Packit |
06404a |
switch to the "Targets" pane, select everything, and make the project.
|
|
Packit |
06404a |
Do the same thing to build libvorbisenc.mcp, and libvorbisfile.mcp (in
|
|
Packit |
06404a |
that order). In vorbis/mac/Output you will now have both debug and final
|
|
Packit |
06404a |
versions of Vorbis shared libraries to link your projects against.
|
|
Packit |
06404a |
|
|
Packit |
06404a |
To build a project using Ogg Vorbis, add access paths to your
|
|
Packit |
06404a |
CodeWarrior project for the ogg/include, ogg/mac/Output,
|
|
Packit |
06404a |
vorbis/include, and vorbis/mac/Output folders. Be sure that
|
|
Packit |
06404a |
"interpret DOS and Unix paths" is turned on in your project; it can
|
|
Packit |
06404a |
be found in the "access paths" pane in your project settings. Now
|
|
Packit |
06404a |
simply add the shared libraries you need to your project (OggLib and
|
|
Packit |
06404a |
VorbisLib at least) and #include "ogg/ogg.h" and "vorbis/codec.h"
|
|
Packit |
06404a |
wherever you need to access Ogg and Vorbis functionality.
|
|
Packit |
06404a |
|