Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Tree [e4a88f] svn-tags/libogg-1.1.4 /
History



File Date Author Commit
debian 2008-09-10 ivo ivo [15d496] Add RFC 5334 and skeleton.html to Makefile. Me...
doc 2009-05-27 xiphmont xiphmont [6a6276] Commit doc updates relating to async error inte...
include 2009-05-27 xiphmont xiphmont [f0dc56] DESTROY ALL TABS
macos 2002-07-13 giles giles [619bfa] rename classic mac build dir to macos/
macosx 2009-06-23 xiphmont xiphmont [e4a88f] retag
src 2009-05-27 xiphmont xiphmont [f0dc56] DESTROY ALL TABS
symbian 2004-08-11 conrad conrad [4f3639] add support for Symbian OS, from Colin Ward (CS...
win32 2009-05-01 cristianadam cristianadam [fe61d0] Removed WholeProgramOptimization setting from s...
AUTHORS 2002-07-11 xiphmont xiphmont [55d5c8]
CHANGES 2009-06-23 xiphmont xiphmont [e4a88f] retag
COPYING 2002-10-11 xiphmont xiphmont [f6f44d]
HACKING 2001-08-23 jsquyres jsquyres [8b7744] Note to self: run ispell *before* committing to...
Makefile.am 2006-01-19 giles giles [62ee2c] Remove the debian subdir from distribution tarb...
README 2008-04-14 erikd erikd [6e8794] Add explanation of Linux to windows cross compi...
autogen.sh 2008-01-18 giles giles [1983cd] Port automake 1.10 support from libtheora.
configure.in 2009-06-23 xiphmont xiphmont [fea753] Bump configure version for full release
libogg.spec.in 2007-11-08 conrad conrad [c2e58e] update doc/libogg in libogg.spec.in, as reporte...
ogg-uninstalled.pc.in 2004-07-05 thomasvs thomasvs [71c984] This patch adds an -uninstalled.pc file so othe...
ogg.m4 2008-01-18 ivo ivo [9f2f69] Applied patch to make it easier to disable use ...
ogg.pc.in 2004-07-05 thomasvs thomasvs [71c984] This patch adds an -uninstalled.pc file so othe...

Read Me

********************************************************************
*                                                                  *
* THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.   *
* USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS     *
* GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
* IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.       *
*                                                                  *
* THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2002             *
* by the Xiph.Org Foundation http://www.xiph.org/                  *
*                                                                  *
********************************************************************

WHAT'S HERE:

This source distribution includes libogg and nothing else.  Other modules 
(eg, the modules vorbis, vorbis-tools and vorbis-plugins for the Vorbis 
codec) contain the codec libraries for use with Ogg bitstreams.

Directory:

./src  		The source for libogg, a BSD-license inplementation of 
		the public domain Ogg bitstream format

./include       Library API headers and codebooks

./doc           Ogg specification documents

./win32		Win32 projects and build automation

./macosx	MacOS X project and build files

./macos		Classic MacOS 9 projects and build automation

./debian        Rules/spec files for building Debian .deb packages
		(may not be present, depending on your distribution)

WHAT IS OGG?:

Ogg project codecs use the Ogg bitstream format to arrange the raw,
compressed bitstream into a more robust, useful form.  For example,
the Ogg bitstream makes seeking, time stamping and error recovery
possible, as well as mixing several sepearate, concurrent media
streams into a single physical bitstream.

CONTACT:

The Ogg homepage is located at 'http://www.xiph.org/ogg/'.
Up to date technical documents, contact information, source code and
pre-built utilities may be found there.

BUILDING FROM REPOSITORY SOURCE:

A standard svn build should consist of nothing more than:

./autogen.sh
make 

and as root if desired :

make install

This will install the Ogg libraries (static and shared) into
/usr/local/lib, includes into /usr/local/include and API manpages
(once we write some) into /usr/local/man.

BUILDING FROM TARBALL DISTRIBUTIONS:

./configure
make

and optionally (as root):
make install

BUILDING RPMS:

RPMs may be built by:

make dist
rpm -ta libogg-<version>.tar.gz

BUILDING ON WIN32:

Use the project file in the win32 directory.  It should compile out of the box.
You can also run one of the batch files from the commandline.

E.g.: build_ogg_dynamic

CROSS COMPILING FROM LINUX TO WIN32:

It is also possible to cross compile from Linux to windows using the MinGW
cross tools and even to run the test suite under Wine, the Linux/*nix
windows emulator.

On Debian and Ubuntu systems, these cross compiler tools can be installed
by doing:

    sudo apt-get mingw32 mingw32-binutils mingw32-runtime wine

Once these tools are installed its possible to compile and test by
executing the following commands:

    ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \
         --build=i586-linux
    make
    make check

The above has been tested with the following versions of the tools on
Ubuntu's Hardy Heron release:

    mingw32             4.2.1.dfsg-1ubuntu1
    mingw32-binutils    2.17.50-20070129.1-1
    mingw32-runtime     3.13-1
    wine                0.9.59-0ubuntu4

BUILDING ON MACOS 9:

Ogg on MacOS 9 is built using CodeWarrior 5.3.  To build it, first
open ogg/mac/libogg.mcp, switch to the "Targets" pane, select
everything, and make the project.  In ogg/mac/Output you will now have
both debug and final versions of Ogg shared libraries to link your
projects against.

To build a project using Ogg, add access paths to your CodeWarrior
project for the ogg/include and ogg/mac/Output folders.  Be sure that
"interpret DOS and Unix paths" is turned on in your project; it can be
found in the "access paths" pane in your project settings.  Now simply
add the shared libraries you need to your project (OggLib at least)
and #include "ogg/ogg.h" wherever you need to acces Ogg functionality.

(Build instructions for Ogg codecs such as vorbis are similar and may
be found in those source modules' README files)

$Id$