diff options
author | stopiccot <alexey.petruchik@gmail.com> | 2015-05-19 14:25:05 +0300 |
---|---|---|
committer | Ralph Giles <giles@mozilla.com> | 2015-05-20 10:38:39 -0700 |
commit | 95569ebba50c9c6f2309bf9152a9a97e078cd529 (patch) | |
tree | 1b8b4d7cb2859a7fcfc9657af6cb766bdf039d1e /README.md | |
parent | 15fe47a80f7b0200c7654464ac04d002b8eb6bc3 (diff) | |
download | ogg-git-95569ebba50c9c6f2309bf9152a9a97e078cd529.tar.gz |
Switch to markdown readme
Signed-off-by: Ralph Giles <giles@thaumas.net>
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 95 |
1 files changed, 95 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..4574c6b --- /dev/null +++ b/README.md @@ -0,0 +1,95 @@ +# Ogg + +``` + 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-2015 + 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 libvorbis, vorbis-tools for the Vorbis music codec, +libtheora for the Theora video 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 + +- `doc` Ogg specification and libogg API documents + +- `win32` Win32 projects and build automation + +- `macosx` Mac OS X project and build files + +## 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 https://www.xiph.org/ogg/ . +Up to date technical documents, contact information, source code and +pre-built utilities may be found there. + +## Building ## + +#### Building from tarball distributions #### + + ./configure + make + +and optionally (as root): + + make install + +This will install the Ogg libraries (static and shared) into +/usr/local/lib, includes into /usr/local/include and API +documentation into /usr/local/share/doc. + +#### Building from repository source #### + +A standard svn build should consist of nothing more than: + + ./autogen.sh + make + +and as root if desired : + + make install + +#### Building on Windows #### + +Use the project file in the win32 directory. It should compile out of the box. + +#### Cross-compiling from Linux to Windows #### + +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, or something similar depending on +your system: + + ./configure --host=i586-mingw32msvc --target=i586-mingw32msvc --build=i586-linux + make + make check + +(Build instructions for Ogg codecs such as vorbis are similar and may +be found in those source modules' README files) |