QCameraZoomControl Class

The QCameraZoomControl class supplies control for optical and digital camera zoom. More...

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

• List of all members, including inherited members
• Obsolete members

Public Functions

virtual	~QCameraZoomControl()
virtual qreal	currentDigitalZoom() const = 0
virtual qreal	currentOpticalZoom() const = 0
virtual qreal	maximumDigitalZoom() const = 0
virtual qreal	maximumOpticalZoom() const = 0
virtual qreal	requestedDigitalZoom() const = 0
virtual qreal	requestedOpticalZoom() const = 0
virtual void	zoomTo(qreal optical, qreal digital) = 0

• 31 public functions inherited from QObject

Signals

void	currentDigitalZoomChanged(qreal zoom)
void	currentOpticalZoomChanged(qreal zoom)
void	maximumDigitalZoomChanged(qreal zoom)
void	maximumOpticalZoomChanged(qreal zoom)
void	requestedDigitalZoomChanged(qreal zoom)
void	requestedOpticalZoomChanged(qreal zoom)

• 2 signals inherited from QObject

Static Public Members

const QMetaObject

staticMetaObject

• 9 static public members inherited from QObject

Protected Functions

QCameraZoomControl(QObject *parent = nullptr)

• 9 protected functions inherited from QObject

Macros

QCameraZoomControl_iid

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject

Detailed Description

The QCameraZoomControl class supplies control for optical and digital camera zoom.

The interface name of QCameraZoomControl is org.qt-project.qt.camerazoomcontrol/5.0 as defined in QCameraZoomControl_iid.

See also QMediaService::requestControl() and QCamera.

Member Function Documentation

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

Constructs a camera zoom control object with parent.

[virtual] QCameraZoomControl::~QCameraZoomControl()

Destruct the camera zoom control object.

[pure virtual] qreal QCameraZoomControl::currentDigitalZoom() const

Return the current digital zoom value.

[signal] void QCameraZoomControl::currentDigitalZoomChanged(qreal zoom)

Signal emitted when the current digital zoom value changed.

[pure virtual] qreal QCameraZoomControl::currentOpticalZoom() const

Return the current optical zoom value.

[signal] void QCameraZoomControl::currentOpticalZoomChanged(qreal zoom)

Signal emitted when the current optical zoom value changed.

[pure virtual] qreal QCameraZoomControl::maximumDigitalZoom() const

Returns the maximum digital zoom value, or 1.0 if digital zoom is not supported.

[signal] void QCameraZoomControl::maximumDigitalZoomChanged(qreal zoom)

Signal emitted when the maximum supported digital zoom value changed.

The maximum supported zoom value can depend on other camera settings, like capture mode or resolution.

[pure virtual] qreal QCameraZoomControl::maximumOpticalZoom() const

Returns the maximum optical zoom value, or 1.0 if optical zoom is not supported.

[signal] void QCameraZoomControl::maximumOpticalZoomChanged(qreal zoom)

Signal emitted when the maximum supported optical zoom value changed.

The maximum supported zoom value can depend on other camera settings, like focusing mode.

[pure virtual] qreal QCameraZoomControl::requestedDigitalZoom() const

Return the requested digital zoom value.

[signal] void QCameraZoomControl::requestedDigitalZoomChanged(qreal zoom)

Signal emitted when the requested digital zoom value changed.

[pure virtual] qreal QCameraZoomControl::requestedOpticalZoom() const

Return the requested optical zoom value.

[signal] void QCameraZoomControl::requestedOpticalZoomChanged(qreal zoom)

Signal emitted when the requested optical zoom value changed.

[pure virtual] void QCameraZoomControl::zoomTo(qreal optical, qreal digital)

Sets optical and digital zoom values.

Zooming can be asynchronous with value changes reported with currentDigitalZoomChanged() and currentOpticalZoomChanged() signals.

The backend should expect and correctly handle frequent zoomTo() calls during zoom animations or slider movements.