This source file is part of the Theora Video Playback Library
For latest info, see http://libtheoraplayer.sourceforge.net/
Copyright (c) 2008-2010 Kresimir Spes (kreso@cateia.com)
This program is free software; you can redistribute it and/or modify it under
the terms of the BSD license: http://www.opensource.org/licenses/bsd-license.php

#ifndef _TheoraVideoManager_h
#define _TheoraVideoManager_h

#include <vector>
#include <string>
#include "TheoraExport.h"
#include "TheoraVideoClip.h"
#ifdef _WIN32
#pragma warning( disable: 4251 ) // MSVC++
// forward class declarations
class TheoraWorkerThread;
class TheoraMutex;
class TheoraDataSource;
class TheoraAudioInterfaceFactory;
        This is the main singleton class that handles all playback/sync operations

class TheoraPlayerExport TheoraVideoManager
        friend class TheoraWorkerThread;
        typedef std::vector<TheoraVideoClip*> ClipList;
        typedef std::vector<TheoraWorkerThread*> ThreadList;

        //! stores pointers to worker threads which are decoding video and audio
        ThreadList mWorkerThreads;
        //! stores pointers to created video clips
        ClipList mClips;
        int mDefaultNumPrecachedFrames;

        TheoraMutex* mWorkMutex;
        TheoraAudioInterfaceFactory* mAudioFactory;

        void createWorkerThreads(int n);
        void destroyWorkerThreads();

         * Called by TheoraWorkerThread to request a TheoraVideoClip instance to work on decoding

        TheoraVideoClip* requestWork(TheoraWorkerThread* caller);
        TheoraVideoManager(int num_worker_threads=1);
        virtual ~TheoraVideoManager();

        //! get the global reference to the manager instance
        static TheoraVideoManager& getSingleton();
        //! get the global pointer to the manager instance
        static TheoraVideoManager* getSingletonPtr();

        //! search registered clips by name
        TheoraVideoClip* getVideoClipByName(std::string name);

        TheoraVideoClip* createVideoClip(std::string filename,TheoraOutputMode output_mode=TH_RGB,int numPrecachedOverride=0,bool usePower2Stride=0);
        TheoraVideoClip* createVideoClip(TheoraDataSource* data_source,TheoraOutputMode output_mode=TH_RGB,int numPrecachedOverride=0,bool usePower2Stride=0);

        void update(float time_increase);

        void destroyVideoClip(TheoraVideoClip* clip);

        void setAudioInterfaceFactory(TheoraAudioInterfaceFactory* factory);
        TheoraAudioInterfaceFactory* getAudioInterfaceFactory();

        int getNumWorkerThreads();
        void setNumWorkerThreads(int n);

        void setDefaultNumPrecachedFrames(int n) { mDefaultNumPrecachedFrames=n; }
        int getDefaultNumPrecachedFrames() { return mDefaultNumPrecachedFrames; }

        //! used by libtheoraplayer functions
        void logMessage(std::string msg);

                \brief you can set your own log function to recieve theora's log calls

                This way you can integrate libtheoraplayer's log messages in your own
                logging system, prefix them, mute them or whatever you want

        static void setLogFunction(void (*fn)(std::string));

        //! get nicely formated version string
        std::string getVersionString();
            \brief get version numbers

                if c is negative, it means it's a release candidate -c

        void getVersion(int* a,int* b,int* c);