Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

mediarecorderplugininterface.h

This is the verbatim text of the mediarecorderplugininterface.h include file. It is provided only for illustration; the copyright remains with Trolltech.

/**********************************************************************
** Copyright (C) 2000-2005 Trolltech AS.  All rights reserved.
**
** This file is part of the Qtopia Environment.
**
** Licensees holding a valid license agreement from Trolltech or any of its
** authorized distributors may use this file in accordance with
** the License Agreement provided with the Licensed Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
**   information about Trolltech's Commercial License Agreements.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/
#ifndef MEDIA_RECORDER_PLUGIN_INTERFACE_H
#define MEDIA_RECORDER_PLUGIN_INTERFACE_H

#include <qtopia/qcom.h>

#ifndef QT_NO_COMPONENT
// {c0093632-b44c-4cf7-a279-d82fe8a8890d}
# ifndef IID_MediaRecorderPlugin
#  define IID_MediaRecorderPlugin QUuid( 0xc0093632, 0xb44c, 0x4cf7, 0xa2, 0x79, 0xd8, 0x2f, 0xe8, 0xa8, 0x89, 0x0d )
# endif
#endif

class MediaRecorderEncoder {

public:
    virtual ~MediaRecorderEncoder() { }

    // About Plugin 
    virtual int pluginNumFormats() const = 0;
    virtual QString pluginFormatName( int format ) const = 0;
    virtual QString pluginFormatTag( int format ) const = 0;
    virtual QString pluginComment() const = 0;
    virtual double pluginVersion() const = 0;
    virtual QString pluginMimeType() const = 0;

    // I/O device management
    virtual bool begin( QIODevice *device, const QString& formatTag ) = 0;
    virtual bool end() = 0;
    virtual bool isActive() const = 0;

    // Audio record functionality
    virtual bool setAudioChannels( int channels ) = 0;
    virtual bool setAudioFrequency( int frequency ) = 0;
    virtual bool writeAudioSamples( const short *samples, long numSamples ) = 0;

    // TODO - video recording API's

    // Add comments and other meta information
    virtual bool addComment( const QString& tag, const QString& contents ) = 0;

    // Space estimation.
    virtual long estimateAudioBps( int frequency, int channels, const QString& formatTag ) = 0;

    // Capabilities
    virtual bool supportsAudio() const = 0;
    virtual bool supportsVideo() const = 0;
    virtual bool supportsComments() const = 0;
    virtual bool requiresDirectAccess() const = 0;
};


struct MediaRecorderPluginInterface : public QUnknownInterface
{
    virtual MediaRecorderEncoder *encoder() = 0;
};


#endif