QVideoEncoderSettings Class

The QVideoEncoderSettings class provides a set of video encoder settings. More...

Header: #include <QVideoEncoderSettings>
qmake: QT += multimedia

Public Functions

QVideoEncoderSettings(const QVideoEncoderSettings &other)
QVideoEncoderSettings()
QVideoEncoderSettings &operator=(const QVideoEncoderSettings &other)
~QVideoEncoderSettings()
int bitRate() const
QString codec() const
QMultimedia::EncodingMode encodingMode() const
QVariant encodingOption(const QString &option) const
QVariantMap encodingOptions() const
qreal frameRate() const
bool isNull() const
QMultimedia::EncodingQuality quality() const
QSize resolution() const
void setBitRate(int value)
void setCodec(const QString &codec)
void setEncodingMode(QMultimedia::EncodingMode mode)
void setEncodingOption(const QString &option, const QVariant &value)
void setEncodingOptions(const QVariantMap &options)
void setFrameRate(qreal rate)
void setQuality(QMultimedia::EncodingQuality quality)
void setResolution(const QSize &resolution)
void setResolution(int width, int height)
bool operator!=(const QVideoEncoderSettings &other) const
bool operator==(const QVideoEncoderSettings &other) const

Detailed Description

A video encoder settings object is used to specify the video encoder settings used by QMediaRecorder. Video encoder settings are selected by constructing a QVideoEncoderSettings object, setting the desired properties and then passing it to a QMediaRecorder instance using the QMediaRecorder::setEncodingSettings() function.

QVideoEncoderSettings videoSettings;
videoSettings.setCodec("video/mpeg2");
videoSettings.setResolution(640, 480);

recorder->setVideoSettings(videoSettings);

See also QMediaRecorder and QVideoEncoderSettingsControl.

Member Function Documentation

QVideoEncoderSettings::QVideoEncoderSettings(const QVideoEncoderSettings &other)

Constructs a copy of the video encoder settings object other.

QVideoEncoderSettings::QVideoEncoderSettings()

Constructs a null video encoder settings object.

QVideoEncoderSettings &QVideoEncoderSettings::operator=(const QVideoEncoderSettings &other)

Assigns the value of other to a video encoder settings object.

QVideoEncoderSettings::~QVideoEncoderSettings()

Destroys a video encoder settings object.

int QVideoEncoderSettings::bitRate() const

Returns bit rate of the encoded video stream in bits per second.

See also setBitRate().

QString QVideoEncoderSettings::codec() const

Returns the video codec.

See also setCodec().

QMultimedia::EncodingMode QVideoEncoderSettings::encodingMode() const

Returns the video encoding mode.

See also setEncodingMode() and QMultimedia::EncodingMode.

QVariant QVideoEncoderSettings::encodingOption(const QString &option) const

Returns the value of encoding option.

See also setEncodingOption() and encodingOptions().

QVariantMap QVideoEncoderSettings::encodingOptions() const

Returns the all the encoding options as QVariantMap.

See also encodingOption() and setEncodingOptions().

qreal QVideoEncoderSettings::frameRate() const

Returns the video frame rate.

See also setFrameRate().

bool QVideoEncoderSettings::isNull() const

Identifies if a video encoder settings object is uninitalized.

Returns true if the settings are null, and false if they are not.

QMultimedia::EncodingQuality QVideoEncoderSettings::quality() const

Returns the video encoding quality.

See also setQuality().

QSize QVideoEncoderSettings::resolution() const

Returns the resolution of the encoded video.

See also setResolution().

void QVideoEncoderSettings::setBitRate(int value)

Sets the bit rate of the encoded video stream to value.

See also bitRate().

void QVideoEncoderSettings::setCodec(const QString &codec)

Sets the video codec.

See also codec().

void QVideoEncoderSettings::setEncodingMode(QMultimedia::EncodingMode mode)

Sets the video encoding mode.

If QMultimedia::ConstantQualityEncoding is set, the quality encoding parameter is used and bit rate is ignored, otherwise the bitrate is used.

The rest of encoding settings are respected regardless of encoding mode.

See also encodingMode() and QMultimedia::EncodingMode.

void QVideoEncoderSettings::setEncodingOption(const QString &option, const QVariant &value)

Set the encoding option value.

The supported set and meaning of encoding options are system and selected codec specific.

See also encodingOption() and setEncodingOptions().

void QVideoEncoderSettings::setEncodingOptions(const QVariantMap &options)

Replace all the encoding options with options.

The supported set and meaning of encoding options are system and selected codec specific.

See also encodingOptions(), encodingOption(), and setEncodingOption().

void QVideoEncoderSettings::setFrameRate(qreal rate)

Sets the video frame rate.

A value of 0 indicates the encoder should make an optimal choice based on what is available from the video source and the limitations of the codec.

See also frameRate().

void QVideoEncoderSettings::setQuality(QMultimedia::EncodingQuality quality)

Sets the video encoding quality.

Setting the video quality parameter allows backend to choose the balanced set of encoding parameters to achieve the desired quality level.

The quality settings parameter is only used in the constant quality encoding mode. The quality settings parameter is only used in the constant quality encoding mode.

See also quality().

void QVideoEncoderSettings::setResolution(const QSize &resolution)

Sets the resolution of the encoded video.

An empty QSize indicates the encoder should make an optimal choice based on what is available from the video source and the limitations of the codec.

See also resolution().

void QVideoEncoderSettings::setResolution(int width, int height)

Sets the width and height of the resolution of the encoded video.

This is an overloaded function.

bool QVideoEncoderSettings::operator!=(const QVideoEncoderSettings &other) const

Determines if other is of equal value to a video encoder settings object.

Returns true if the settings objects are not of equal value, and false if they are of equal value.

bool QVideoEncoderSettings::operator==(const QVideoEncoderSettings &other) const

Determines if other is of equal value to a video encoder settings object.

Returns true if the settings objects are of equal value, and false if they are not of equal value.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.