MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QVideoEncoderControl Class Reference

The QVideoEncoderControl class provides access to the settings of a media service that performs video encoding. More...

 #include <QVideoEncoderControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

virtual ~QVideoEncoderControl ()
virtual QVariant encodingOption ( const QString & codec, const QString & option ) const = 0
virtual void setEncodingOption ( const QString & codec, const QString & option, const QVariant & value ) = 0
virtual void setVideoSettings ( const QVideoEncoderSettings & settings ) = 0
virtual QStringList supportedEncodingOptions ( const QString & codec ) const = 0
virtual QList<qreal> supportedFrameRates ( const QVideoEncoderSettings & settings, bool * continuous = 0 ) const = 0
virtual QList<QSize> supportedResolutions ( const QVideoEncoderSettings & settings, bool * continuous = 0 ) const = 0
virtual QStringList supportedVideoCodecs () const = 0
virtual QString videoCodecDescription ( const QString & codec ) const = 0
virtual QVideoEncoderSettings videoSettings () const = 0
  • 29 public functions inherited from QObject

Protected Functions

QVideoEncoderControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QVideoEncoderControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 signal inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QVideoEncoderControl class provides access to the settings of a media service that performs video encoding.

If a QMediaService supports encoding video data it will implement QVideoEncoderControl. This control provides information about the limits of restricted video encoder options and allows the selection of a set of video encoder settings as specified in a QVideoEncoderSettings object.

The functionality provided by this control is exposed to application code through the QMediaRecorder class.

The interface name of QVideoEncoderControl is com.nokia.Qt.QVideoEncoderControl/1.0 as defined in QVideoEncoderControl_iid.

See also QMediaRecorder, QVideoEncoderSettings, and QMediaService::requestControl().

Member Function Documentation

QVideoEncoderControl::QVideoEncoderControl ( QObject * parent = 0 ) [protected]

Create a new video encoder control object with the given parent.

QVideoEncoderControl::~QVideoEncoderControl () [virtual]

Destroys a video encoder control.

QVariant QVideoEncoderControl::encodingOption ( const QString & codec, const QString & option ) const [pure virtual]

Returns the value of a video codec option.

This function was introduced in Qt Mobility 1.0.

See also setEncodingOption().

void QVideoEncoderControl::setEncodingOption ( const QString & codec, const QString & option, const QVariant & value ) [pure virtual]

Sets the value of a codec specific option.

This function was introduced in Qt Mobility 1.0.

See also encodingOption().

void QVideoEncoderControl::setVideoSettings ( const QVideoEncoderSettings & settings ) [pure virtual]

Sets the selected video encoder settings.

This function was introduced in Qt Mobility 1.0.

See also videoSettings().

QStringList QVideoEncoderControl::supportedEncodingOptions ( const QString & codec ) const [pure virtual]

Returns a list of supported encoding options for a video codec.

The names and types of the options in the list is system dependent.

This function was introduced in Qt Mobility 1.0.

QList<qreal> QVideoEncoderControl::supportedFrameRates ( const QVideoEncoderSettings & settings, bool * continuous = 0 ) const [pure virtual]

Returns a list of supported frame rates.

If non null video settings parameter is passed, the returned list is reduced to frame rates supported with partial settings like video codec or video resolution applied.

If the encoder supports arbitrary frame rates within the supported range, *continuous is set to true, otherwise *continuous is set to false.

This function was introduced in Qt Mobility 1.0.

See also QVideoEncoderSettings::frameRate().

QList<QSize> QVideoEncoderControl::supportedResolutions ( const QVideoEncoderSettings & settings, bool * continuous = 0 ) const [pure virtual]

Returns a list of supported resolutions.

If non null video settings parameter is passed, the returned list is reduced to resolution supported with partial settings like video codec or frame rate applied.

If the encoder supports arbitrary resolutions within the supported resolutions range, *continuous is set to true, otherwise *continuous is set to false.

This function was introduced in Qt Mobility 1.0.

See also QVideoEncoderSettings::resolution().

QStringList QVideoEncoderControl::supportedVideoCodecs () const [pure virtual]

Returns the list of supported video codecs.

This function was introduced in Qt Mobility 1.0.

QString QVideoEncoderControl::videoCodecDescription ( const QString & codec ) const [pure virtual]

Returns a description of a video codec.

This function was introduced in Qt Mobility 1.0.

QVideoEncoderSettings QVideoEncoderControl::videoSettings () const [pure virtual]

Returns the video encoder settings.

The returned value may be different tha passed to QVideoEncoderControl::setVideoSettings() if the settings contains the default or undefined parameters. In this case if the undefined parameters are already resolved, they should be returned.

This function was introduced in Qt Mobility 1.0.

See also setVideoSettings().

Macro Documentation

QVideoEncoderControl_iid

com.nokia.Qt.QVideoEncoderControl/1.0

Defines the interface name of the QVideoEncoderControl class.