QImageEncoderControl Class

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

Header: #include <QImageEncoderControl>
qmake: QT += multimedia
Inherits: QMediaControl

This class is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

Public Functions

virtual ~QImageEncoderControl()
virtual QString imageCodecDescription(const QString &codec) const = 0
virtual QImageEncoderSettings imageSettings() const = 0
virtual void setImageSettings(const QImageEncoderSettings &settings) = 0
virtual QStringList supportedImageCodecs() const = 0
virtual QList<QSize> supportedResolutions(const QImageEncoderSettings &settings, bool *continuous = nullptr) const = 0

Protected Functions

QImageEncoderControl(QObject *parent = nullptr)


Detailed Description

If a QMediaService supports encoding image data it will implement QImageEncoderControl. This control allows to set image encoding settings and provides functions for quering supported image codecs and resolutions.

The interface name of QImageEncoderControl is org.qt-project.qt.imageencodercontrol/5.0 as defined in QImageEncoderControl_iid.

See also QImageEncoderSettings and QMediaService::requestControl().

Member Function Documentation

[protected] QImageEncoderControl::QImageEncoderControl(QObject *parent = nullptr)

Constructs a new image encoder control object with the given parent

[virtual] QImageEncoderControl::~QImageEncoderControl()

Destroys the image encoder control.

[pure virtual] QString QImageEncoderControl::imageCodecDescription(const QString &codec) const

Returns a description of an image codec.

[pure virtual] QImageEncoderSettings QImageEncoderControl::imageSettings() const

Returns the currently used image encoder settings.

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

See also setImageSettings().

[pure virtual] void QImageEncoderControl::setImageSettings(const QImageEncoderSettings &settings)

Sets the selected image encoder settings.

See also imageSettings().

[pure virtual] QStringList QImageEncoderControl::supportedImageCodecs() const

Returns a list of supported image codecs.

[pure virtual] QList<QSize> QImageEncoderControl::supportedResolutions(const QImageEncoderSettings &settings, bool *continuous = nullptr) const

Returns a list of supported resolutions.

If non null image settings parameter is passed, the returned list is reduced to resolutions supported with partial settings applied. It can be used to query the list of resolutions, supported by specific image codec.

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

Macro Documentation



Defines the interface name of the QImageEncoderControl class.

© 2024 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.