MediaHandler.h

Go to the documentation of this file.

// MediaHandler.h: Base class for media handlers
// 
//   Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012
//   Free Software Foundation, Inc.
// 
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 3 of the License, or
// (at your option) any later version.
// 
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA


#ifndef GNASH_MEDIAHANDLER_H
#define GNASH_MEDIAHANDLER_H

#include "dsodefs.h" // DSOEXPORT
#include "VideoConverter.h"

#include <vector>
#include <memory>
#include <string>

#include "GnashFactory.h"

// Forward declarations
namespace gnash {
    class IOChannel;
    namespace media {
        class VideoDecoder;
        class AudioDecoder;
        class AudioInfo;
        class VideoInfo;
        class VideoInput;
        class AudioInput;
        class MediaHandler;
        class MediaParser;
    }
}

namespace gnash {

//
namespace media {

struct DSOEXPORT RegisterAllHandlers
{
    RegisterAllHandlers();
};

typedef GnashFactory<MediaHandler, RegisterAllHandlers, std::string> MediaFactory;

class DSOEXPORT MediaHandler
{
public:

    virtual ~MediaHandler() {}

    virtual std::string description() const = 0;

    //
    virtual std::unique_ptr<MediaParser>
        createMediaParser(std::unique_ptr<IOChannel> stream);

    //
    virtual std::unique_ptr<VideoDecoder>
        createVideoDecoder(const VideoInfo& info)=0;

    //
    virtual std::unique_ptr<AudioDecoder>
        createAudioDecoder(const AudioInfo& info)=0;

    //
    virtual std::unique_ptr<VideoConverter>
        createVideoConverter(ImgBuf::Type4CC srcFormat,
                ImgBuf::Type4CC dstFormat)=0;

    //
    //
    virtual VideoInput* getVideoInput(size_t index) = 0;

    virtual AudioInput* getAudioInput(size_t index) = 0;

    //
    virtual void cameraNames(std::vector<std::string>& names) const = 0;

    //
    virtual size_t getInputPaddingSize() const { return 0; }

protected:

    //
    MediaHandler() {}

    //
    std::unique_ptr<AudioDecoder> createFlashAudioDecoder(const AudioInfo& info);

    //
    bool isFLV(IOChannel& stream);

};


} // gnash.media namespace 

// In order for GnashFactory to work correctly, there must be only a single
// instantiation of MediaFactory. Therefore, we declare its type as extern,
// which we can now that its dependent types are fully specified.
extern template class GnashFactory<media::MediaHandler,
    media::RegisterAllHandlers, std::string>; // I.e., typedef MediaFactory.

} // namespace gnash

#endif