|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | - | - |
| doc/ | | 22-Nov-2023 | - | 8,511 | 6,584 |
| include/ | | 22-Nov-2023 | - | 1,317 | 1,056 |
| macos/ | | 22-Nov-2023 | - | 116 | 82 |
| macosx/ | | 22-Nov-2023 | - | 273 | 256 |
| src/ | | 22-Nov-2023 | - | 3,469 | 2,646 |
| win32/ | | 22-Nov-2023 | - | 2,997 | 2,792 |
| .git | D | 01-Jan-1970 | 0 | | |
| .gitignore | D | 22-Nov-2023 | 263 | 32 | 30 |
| AUTHORS | D | 22-Nov-2023 | 66 | 5 | 2 |
| Android.mk | D | 22-Nov-2023 | 276 | 13 | 9 |
| CHANGES | D | 22-Nov-2023 | 1.5 KiB | 50 | 35 |
| COPYING | D | 22-Nov-2023 | 1.4 KiB | 29 | 23 |
| MODULE_LICENSE_BSD | D | 22-Nov-2023 | 0 | | |
| Makefile.am | D | 22-Nov-2023 | 673 | 31 | 22 |
| Makefile.in | D | 22-Nov-2023 | 22.1 KiB | 718 | 637 |
| NOTICE | D | 22-Nov-2023 | 1.4 KiB | 29 | 23 |
| README | D | 22-Nov-2023 | 4.3 KiB | 134 | 91 |
| aclocal.m4 | D | 22-Nov-2023 | 308.3 KiB | 8,885 | 7,959 |
| compile | D | 22-Nov-2023 | 3.6 KiB | 143 | 79 |
| config.guess | D | 22-Nov-2023 | 43.2 KiB | 1,501 | 1,289 |
| config.h.in | D | 22-Nov-2023 | 2 KiB | 78 | 52 |
| config.sub | D | 22-Nov-2023 | 31.7 KiB | 1,609 | 1,465 |
| configure | D | 22-Nov-2023 | 445.4 KiB | 15,998 | 12,737 |
| configure.in | D | 22-Nov-2023 | 7 KiB | 311 | 278 |
| depcomp | D | 22-Nov-2023 | 15.6 KiB | 531 | 330 |
| install-sh | D | 22-Nov-2023 | 9 KiB | 324 | 189 |
| libogg.spec | D | 22-Nov-2023 | 2.9 KiB | 110 | 82 |
| libogg.spec.in | D | 22-Nov-2023 | 2.9 KiB | 110 | 88 |
| ltmain.sh | D | 22-Nov-2023 | 237.7 KiB | 8,414 | 6,482 |
| missing | D | 22-Nov-2023 | 10.8 KiB | 361 | 268 |
| ogg-uninstalled.pc.in | D | 22-Nov-2023 | 291 | 15 | 12 |
| ogg.m4 | D | 22-Nov-2023 | 3.9 KiB | 117 | 106 |
| ogg.pc.in | D | 22-Nov-2023 | 266 | 15 | 12 |
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-2002 *
9* by the Xiph.Org Foundation http://www.xiph.org/ *
10* *
11********************************************************************
12
13WHAT'S HERE:
14
15This source distribution includes libogg and nothing else. Other modules
16(eg, the modules vorbis, vorbis-tools and vorbis-plugins for the Vorbis
17codec) contain the codec libraries for use with Ogg bitstreams.
18
19Directory:
20
21./src The source for libogg, a BSD-license inplementation of
22 the public domain Ogg bitstream format
23
24./include Library API headers and codebooks
25
26./doc Ogg specification documents
27
28./win32 Win32 projects and build automation
29
30./macosx MacOS X project and build files
31
32./macos Classic MacOS 9 projects and build automation
33
34./debian Rules/spec files for building Debian .deb packages
35 (may not be present, depending on your distribution)
36
37WHAT IS OGG?:
38
39Ogg project codecs use the Ogg bitstream format to arrange the raw,
40compressed bitstream into a more robust, useful form. For example,
41the Ogg bitstream makes seeking, time stamping and error recovery
42possible, as well as mixing several sepearate, concurrent media
43streams into a single physical bitstream.
44
45CONTACT:
46
47The Ogg homepage is located at 'http://www.xiph.org/ogg/'.
48Up to date technical documents, contact information, source code and
49pre-built utilities may be found there.
50
51BUILDING FROM REPOSITORY SOURCE:
52
53A standard svn build should consist of nothing more than:
54
55./autogen.sh
56make
57
58and as root if desired :
59
60make install
61
62This will install the Ogg libraries (static and shared) into
63/usr/local/lib, includes into /usr/local/include and API manpages
64(once we write some) into /usr/local/man.
65
66BUILDING FROM TARBALL DISTRIBUTIONS:
67
68./configure
69make
70
71and optionally (as root):
72make install
73
74BUILDING RPMS:
75
76RPMs may be built by:
77
78make dist
79rpm -ta libogg-<version>.tar.gz
80
81BUILDING ON WIN32:
82
83Use the project file in the win32 directory. It should compile out of the box.
84You can also run one of the batch files from the commandline.
85
86E.g.: build_ogg_dynamic
87
88CROSS COMPILING FROM LINUX TO WIN32:
89
90It is also possible to cross compile from Linux to windows using the MinGW
91cross tools and even to run the test suite under Wine, the Linux/*nix
92windows emulator.
93
94On Debian and Ubuntu systems, these cross compiler tools can be installed
95by doing:
96
97 sudo apt-get mingw32 mingw32-binutils mingw32-runtime wine
98
99Once these tools are installed its possible to compile and test by
100executing the following commands:
101
102 ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc \
103 --build=i586-linux
104 make
105 make check
106
107The above has been tested with the following versions of the tools on
108Ubuntu's Hardy Heron release:
109
110 mingw32 4.2.1.dfsg-1ubuntu1
111 mingw32-binutils 2.17.50-20070129.1-1
112 mingw32-runtime 3.13-1
113 wine 0.9.59-0ubuntu4
114
115BUILDING ON MACOS 9:
116
117Ogg on MacOS 9 is built using CodeWarrior 5.3. To build it, first
118open ogg/mac/libogg.mcp, switch to the "Targets" pane, select
119everything, and make the project. In ogg/mac/Output you will now have
120both debug and final versions of Ogg shared libraries to link your
121projects against.
122
123To build a project using Ogg, add access paths to your CodeWarrior
124project for the ogg/include and ogg/mac/Output folders. Be sure that
125"interpret DOS and Unix paths" is turned on in your project; it can be
126found in the "access paths" pane in your project settings. Now simply
127add the shared libraries you need to your project (OggLib at least)
128and #include "ogg/ogg.h" wherever you need to acces Ogg functionality.
129
130(Build instructions for Ogg codecs such as vorbis are similar and may
131be found in those source modules' README files)
132
133$Id: README 14726 2008-04-14 08:40:46Z erikd $
134