QImageEncoderSettings Class

The QImageEncoderSettings class provides a set of image encoder settings. More...

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

Public Functions

QImageEncoderSettings()
QImageEncoderSettings(const QImageEncoderSettings &other)
~QImageEncoderSettings()
QString codec() const
QVariant encodingOption(const QString &option) const
QVariantMap encodingOptions() const
bool isNull() const
QMultimedia::EncodingQuality quality() const
QSize resolution() const
void setCodec(const QString &codec)
void setEncodingOption(const QString &option, const QVariant &value)
void setEncodingOptions(const QVariantMap &options)
void setQuality(QMultimedia::EncodingQuality quality)
void setResolution(const QSize &resolution)
void setResolution(int width, int height)
bool operator!=(const QImageEncoderSettings &other) const
QImageEncoderSettings &operator=(const QImageEncoderSettings &other)
bool operator==(const QImageEncoderSettings &other) const

Detailed Description

The QImageEncoderSettings class provides a set of image encoder settings.

A image encoder settings object is used to specify the image encoder settings used by QCameraImageCapture. Image encoder settings are selected by constructing a QImageEncoderSettings object, setting the desired properties and then passing it to a QCameraImageCapture instance using the QCameraImageCapture::setImageSettings() function.


  QImageEncoderSettings imageSettings;
  imageSettings.setCodec("image/jpeg");
  imageSettings.setResolution(1600, 1200);

  imageCapture->setEncodingSettings(imageSettings);

See also QImageEncoderControl.

Member Function Documentation

QImageEncoderSettings::QImageEncoderSettings()

Constructs a null image encoder settings object.

QImageEncoderSettings::QImageEncoderSettings(const QImageEncoderSettings &other)

Constructs a copy of the image encoder settings object other.

QImageEncoderSettings::~QImageEncoderSettings()

Destroys a image encoder settings object.

QString QImageEncoderSettings::codec() const

Returns the image codec.

See also setCodec().

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

Returns the value of encoding option.

See also setEncodingOption() and encodingOptions().

QVariantMap QImageEncoderSettings::encodingOptions() const

Returns the all the encoding options as QVariantMap.

See also encodingOption() and setEncodingOptions().

bool QImageEncoderSettings::isNull() const

Identifies if a image encoder settings object is uninitalized.

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

QMultimedia::EncodingQuality QImageEncoderSettings::quality() const

Returns the image encoding quality.

See also setQuality().

QSize QImageEncoderSettings::resolution() const

Returns the resolution of the encoded image.

See also setResolution().

void QImageEncoderSettings::setCodec(const QString &codec)

Sets the image codec.

See also codec().

void QImageEncoderSettings::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 QImageEncoderSettings::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 QImageEncoderSettings::setQuality(QMultimedia::EncodingQuality quality)

Sets the image encoding quality.

See also quality().

void QImageEncoderSettings::setResolution(const QSize &resolution)

Sets the resolution of the encoded image.

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

See also resolution().

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

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

This is an overloaded function.

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

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

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

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

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

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

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

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