Home | History | Annotate | only in /external/libvorbis
Up to higher level directory
NameDateSize
aclocal.m413-Nov-2012310K
Android.mk13-Nov-20121.1K
AUTHORS13-Nov-201265
autogen.sh13-Nov-20123.8K
CHANGES13-Nov-20123.7K
compile13-Nov-20123.6K
config.guess13-Nov-201243.2K
config.h.in13-Nov-20122.6K
config.sub13-Nov-201231.7K
configure13-Nov-2012445.6K
configure.ac13-Nov-20129.3K
COPYING13-Nov-20121.4K
depcomp13-Nov-201215.6K
doc/13-Nov-2012
examples/13-Nov-2012
include/13-Nov-2012
install-sh13-Nov-20129K
lib/13-Nov-2012
libvorbis.spec13-Nov-20123.2K
libvorbis.spec.in13-Nov-20123.2K
ltmain.sh13-Nov-2012237.7K
m4/13-Nov-2012
macos/13-Nov-2012
macosx/13-Nov-2012
Makefile.am13-Nov-2012960
Makefile.in13-Nov-201224.4K
missing13-Nov-201210.8K
README13-Nov-20124.8K
symbian/13-Nov-2012
test/13-Nov-2012
todo.txt13-Nov-2012490
vorbis-uninstalled.pc.in13-Nov-2012308
vorbis.m413-Nov-20124.7K
vorbis.pc.in13-Nov-2012285
vorbisenc-uninstalled.pc.in13-Nov-2012374
vorbisenc.pc.in13-Nov-2012361
vorbisfile-uninstalled.pc.in13-Nov-2012400
vorbisfile.pc.in13-Nov-2012387
vq/13-Nov-2012
win32/13-Nov-2012

README

      1 ********************************************************************
      2 *                                                                  *
      3 * THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.   *
      4 * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS     *
      5 * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
      6 * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.       *
      7 *                                                                  *
      8 * THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2007             *
      9 * by the Xiph.org Foundation, http://www.xiph.org/                 *
     10 *                                                                  *
     11 ********************************************************************
     12 
     13 Vorbis is a general purpose audio and music encoding format
     14 contemporary to MPEG-4's AAC and TwinVQ, the next generation beyond
     15 MPEG audio layer 3. Unlike the MPEG sponsored formats (and other
     16 proprietary formats such as RealAudio G2 and Windows' flavor of the
     17 month), the Vorbis CODEC specification belongs to the public domain.
     18 All the technical details are published and documented, and any
     19 software entity may make full use of the format without license 
     20 fee, royalty or patent concerns.
     21 
     22 This package contains:
     23 
     24 * libvorbis, a BSD-style license software implementation of
     25   the Vorbis specification by the Xiph.Org Foundation 
     26   (http://www.xiph.org/) 
     27 
     28 * libvorbisfile, a BSD-style license convenience library
     29   built on Vorbis designed to simplify common uses
     30 
     31 * libvorbisenc, a BSD-style license library that provides a simple,
     32   programmatic encoding setup interface 
     33 
     34 * example code making use of libogg, libvorbis, libvorbisfile and
     35   libvorbisenc
     36 
     37 WHAT'S HERE:
     38 
     39 This source distribution includes libvorbis and an example
     40 encoder/player to demonstrate use of libvorbis as well as
     41 documentation on the Ogg Vorbis audio coding format.
     42 
     43 You'll need libogg (distributed separately) to compile this library.
     44 A more comprehensive set of utilities is available in the vorbis-tools
     45 package.
     46 
     47 Directory:
     48 
     49 ./lib  		The source for the libraries, a BSD-license implementation
     50 		of the public domain Ogg Vorbis audio encoding format.
     51 
     52 ./include       Library API headers
     53 
     54 ./debian        Rules/spec files for building Debian .deb packages
     55 
     56 ./doc           Vorbis documentation
     57 
     58 ./examples	Example code illustrating programmatic use of libvorbis, 
     59 		libvorbisfile and libvorbisenc
     60 
     61 ./mac 		Codewarrior project files and build tweaks for MacOS.
     62 
     63 ./macosx 	Project files for MacOS X.
     64 
     65 ./win32		Win32 projects files and build automation
     66 
     67 ./vq 		Internal utilities for training/building new LSP/residue 
     68 		and auxiliary codebooks.
     69 
     70 CONTACT:
     71 
     72 The Ogg homepage is located at 'http://www.xiph.org/ogg/'.
     73 Vorbis's homepage is located at 'http://www.xiph.org/vorbis/'.
     74 Up to date technical documents, contact information, source code and
     75 pre-built utilities may be found there.
     76 
     77 The user website for Ogg Vorbis software and audio is http://vorbis.com/
     78 
     79 BUILDING FROM TRUNK:
     80 
     81 Development source is under subversion revision control at 
     82 https://svn.xiph.org/trunk/vorbis/. You will also need the 
     83 newest versions of autoconf, automake, libtool and pkg-config in
     84 order to compile Vorbis from development source. A configure script
     85 is provided for you in the source tarball distributions.
     86 
     87   [update or checkout latest source]
     88   ./autogen.sh
     89   make
     90 
     91 and as root if desired:
     92 
     93   make install
     94 
     95 This will install the Vorbis libraries (static and shared) into
     96 /usr/local/lib, includes into /usr/local/include and API manpages
     97 (once we write some) into /usr/local/man.
     98 
     99 Documentation building requires xsltproc and pdfxmltex.
    100 
    101 BUILDING FROM TARBALL DISTRIBUTIONS:
    102 
    103   ./configure
    104   make
    105 
    106 and optionally (as root):
    107   make install
    108 
    109 BUILDING RPMS:
    110 
    111 after normal configuring:
    112 
    113   make dist
    114   rpm -ta libvorbis-<version>.tar.gz
    115 
    116 BUILDING ON MACOS 9:
    117 
    118 Vorbis on MacOS 9 is built using Metroworks CodeWarrior.  To build it, 
    119 first verify that the Ogg libraries are already built following the
    120 instructions in the Ogg module README.  Open vorbis/mac/libvorbis.mcp,
    121 switch to the "Targets" pane, select everything, and make the project.
    122 Do the same thing to build libvorbisenc.mcp, and libvorbisfile.mcp (in
    123 that order).  In vorbis/mac/Output you will now have both debug and final
    124 versions of Vorbis shared libraries to link your projects against.
    125 
    126 To build a project using Ogg Vorbis, add access paths to your
    127 CodeWarrior project for the ogg/include, ogg/mac/Output,
    128 vorbis/include, and vorbis/mac/Output folders.  Be sure that
    129 "interpret DOS and Unix paths" is turned on in your project; it can
    130 be found in the "access paths" pane in your project settings.  Now
    131 simply add the shared libraries you need to your project (OggLib and
    132 VorbisLib at least) and #include "ogg/ogg.h" and "vorbis/codec.h"
    133 wherever you need to access Ogg and Vorbis functionality.
    134 
    135