History: TheoraVideoPlugin Compiling

            {maketoc}

!!Dependencies
Before you can compile the plugin and demos, you'll need the following libraries compiled

!!!Ogg,Vorbis and Theora
Downloading and compiling these libraries is a straightforward process, on Windows, open up the solution file in Visual Studio and build. Be sure to build Release versions to maximize performance of the plugin.

Download the latest stable source packages from [http://xiph.org/downloads/|Xiph downloads page].

!!!ptypes
The plugin uses C++ Portable types library ([http://www.melikyan.com/ptypes/|ptypes]) for threading.
Download and compile the latest stable version (2.1.1 at the time of writing this) as a static multithreaded library.

!!!Theora Video Plugin
To obtain the latest trunk version of the plugin's source, do a SVN checkout
{MONO()}http://ogrevideo.svn.sf.net/svnroot/ogrevideo/trunk{MONO}

!!Compiling
!!!Folder organisation
To simplify dependencies on Microsoft Windows , include and lib directories, I suggest copying dependencies include folders and lib files to TheoraVideoPlugin/ __include__ and __lib__ folder:

{MONO()}~np~ libogg/include/ogg -> TheoraVideoPlugin/include/ogg
 libvorbis/include/vorbis -> TheoraVideoPlugin/include/vorbis
 libtheora/include/theora-> TheoraVideoPlugin/include/theora
 ptypes-2.1.1/include -> TheoraVideoPlugin/include/ptypes
 libogg.lib, libvorbis.lib, libtheora.lib, ptypes.lib -> TheoraVideoPlugin/lib~/np~{MONO}

!!!Compiling order
compile the libraries in the following order: ogg, vorbis, theora, ptypes, TheoraVideoPlugin, demos (optional)

!!!Prerequisites
The plugin project configuration assumes you have either the Ogre SDK or a self-compiled version. Either way, it's your job to set Ogre's include and lib directories for compilation.

!!!Optimizations
Theora library has recently introduced [http://en.wikipedia.org/wiki/Streaming_SIMD_Extensions|SSE] and [http://en.wikipedia.org/wiki/SSE2|SSE2] optimizations which improve decoding speed but is incompatible with older hardware. It's up to you to decide whether you want to use them.

!!!Windows
Open up the solution file, select a target (Debug, Release etc) and build.

!!!Linux
No official compiling scripts available yet.

!!!MacOS X
No official compiling scripts available yet.