• Home
  • History
  • Annotate
  • current directory
Name Date Size #Lines LOC

..16-Aug-2019-

doc/H16-Aug-2019-

include/H16-Aug-2019-

macosx/H12-Jun-2017-

src/H16-Aug-2019-

win32/H01-Nov-2017-

AUTHORSH A D12-Jun-2017198 86

CHANGESH A D07-Nov-20172.8 KiB9568

COPYINGH A D12-Jun-20171.4 KiB2923

Makefile.amH A D12-Jun-2017721 3322

Makefile.inH A D16-Aug-201929.4 KiB933830

README.mdH A D12-Jun-20174.1 KiB13282

aclocal.m4H A D07-Nov-2017365.4 KiB10,2219,240

compileH A D07-Nov-20177.2 KiB348258

config.guessH A D07-Nov-201742.9 KiB1,4631,270

config.h.inH A D07-Nov-20172.5 KiB9865

config.subH A D07-Nov-201735.5 KiB1,8241,686

configureH A D16-Aug-2019445 KiB15,23212,719

configure.acH A D07-Nov-20174.5 KiB186159

depcompH A D07-Nov-201723 KiB792502

install-shH A D07-Nov-201714.3 KiB502327

libogg.specH A D07-Nov-20172.9 KiB11082

libogg.spec.inH A D12-Jun-20172.9 KiB11088

ltmain.shH A D07-Nov-2017316.5 KiB11,1487,979

missingH A D07-Nov-20176.7 KiB216143

ogg-uninstalled.pc.inH A D12-Jun-2017296 1512

ogg.m4H A D12-Jun-20173.9 KiB117106

ogg.pc.inH A D12-Jun-2017266 1512

README.md

1# Ogg
2
3[![Travis Build Status](https://travis-ci.org/xiph/ogg.svg?branch=master)](https://travis-ci.org/xiph/ogg)
4[![Jenkins Build Status](https://mf4.xiph.org/jenkins/job/libogg/badge/icon)](https://mf4.xiph.org/jenkins/job/libogg/)
5[![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/xiph/ogg?branch=master&svg=true)](https://ci.appveyor.com/project/rillian/ogg)
6
7Ogg project codecs use the Ogg bitstream format to arrange the raw,
8compressed bitstream into a more robust, useful form. For example,
9the Ogg bitstream makes seeking, time stamping and error recovery
10possible, as well as mixing several sepearate, concurrent media
11streams into a single physical bitstream.
12
13## What's here ##
14This source distribution includes libogg and nothing else. Other modules
15(eg, the modules libvorbis, vorbis-tools for the Vorbis music codec,
16libtheora for the Theora video codec) contain the codec libraries for
17use with Ogg bitstreams.
18
19Directory:
20
21- `src` The source for libogg, a BSD-license inplementation of the public domain Ogg bitstream format
22
23- `include` Library API headers
24
25- `doc` Ogg specification and libogg API documents
26
27- `win32` Win32 projects and build automation
28
29- `macosx` Mac OS X project and build files
30
31## Contact ##
32
33The Ogg homepage is located at https://www.xiph.org/ogg/ .
34Up to date technical documents, contact information, source code and
35pre-built utilities may be found there.
36
37## Building ##
38
39#### Building from tarball distributions ####
40
41    ./configure
42    make
43
44and optionally (as root):
45
46    make install
47
48This will install the Ogg libraries (static and shared) into
49/usr/local/lib, includes into /usr/local/include and API
50documentation into /usr/local/share/doc.
51
52#### Building from repository source ####
53
54A standard svn build should consist of nothing more than:
55
56    ./autogen.sh
57    ./configure
58    make
59
60and as root if desired :
61
62    make install
63
64#### Building on Windows ####
65
66Use the project file in the win32 directory. It should compile out of the box.
67
68#### Cross-compiling from Linux to Windows ####
69
70It is also possible to cross compile from Linux to windows using the MinGW
71cross tools and even to run the test suite under Wine, the Linux/*nix
72windows emulator.
73
74On Debian and Ubuntu systems, these cross compiler tools can be installed
75by doing:
76
77    sudo apt-get mingw32 mingw32-binutils mingw32-runtime wine
78
79Once these tools are installed its possible to compile and test by
80executing the following commands, or something similar depending on
81your system:
82
83    ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc --build=i586-linux
84    make
85    make check
86
87(Build instructions for Ogg codecs such as vorbis are similar and may
88be found in those source modules' README files)
89
90## Building with CMake ##
91
92Ogg supports building using [CMake](http://www.cmake.org/). CMake is a meta build system that generates native projects for each platform.
93To generate projects just run cmake replacing `YOUR-PROJECT-GENERATOR` with a proper generator from a list [here](http://www.cmake.org/cmake/help/v3.2/manual/cmake-generators.7.html):
94
95    cmake -G YOUR-PROJECT-GENERATOR .
96
97Note that by default cmake generates projects that will build static libraries.
98To generate projects that will build dynamic library use `BUILD_SHARED_LIBS` option like this:
99
100    cmake -G YOUR-PROJECT-GENERATOR -DBUILD_SHARED_LIBS=1 .
101
102After projects are generated use them as usual
103
104#### Building on Windows ####
105
106Use proper generator for your Visual Studio version like:
107
108    cmake -G "Visual Studio 12 2013" .
109
110#### Building on Mac OS X ####
111
112Use Xcode generator. To build framework run:
113
114    cmake -G Xcode -DBUILD_FRAMEWORK=1 .
115
116#### Building on Linux ####
117
118Use Makefile generator which is default one.
119
120    cmake .
121    make
122
123## License ##
124
125THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.
126USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS
127GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE
128IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.
129
130THE OggVorbis SOURCE CODE IS COPYRIGHT (C) 1994-2015
131by the Xiph.Org Foundation https://www.xiph.org/
132