QCameraFlashControl Class

The QCameraFlashControl class allows controlling a camera's flash. More...

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

Public Functions

virtual QCameraExposure::FlashModes flashMode() const = 0
virtual bool isFlashModeSupported(QCameraExposure::FlashModes mode) const = 0
virtual bool isFlashReady() const = 0
virtual void setFlashMode(QCameraExposure::FlashModes mode) = 0
  • 31 public functions inherited from QObject


void flashReady(bool ready)

Protected Functions

QCameraFlashControl(QObject *parent = Q_NULLPTR)
  • 9 protected functions inherited from QObject


Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 11 static public members inherited from QObject

Detailed Description

The QCameraFlashControl class allows controlling a camera's flash.

You can set the type of flash effect used when an image is captured, and test to see if the flash hardware is ready to fire.

You can retrieve this control from the camera object in the usual way:

Some camera devices may not have flash hardware, or may not be configurable. In that case, there will be no QCameraFlashControl available.

The interface name of QCameraFlashControl is org.qt-project.qt.cameraflashcontrol/5.0 as defined in QCameraFlashControl_iid.

See also QCamera.

Member Function Documentation

[protected] QCameraFlashControl::QCameraFlashControl(QObject *parent = Q_NULLPTR)

Constructs a camera flash control object with parent.


Destroys the camera control object.

[pure virtual] QCameraExposure::FlashModes QCameraFlashControl::flashMode() const

Returns the current flash mode.

See also setFlashMode().

[signal] void QCameraFlashControl::flashReady(bool ready)

Signal emitted when flash state changes to ready.

[pure virtual] bool QCameraFlashControl::isFlashModeSupported(QCameraExposure::FlashModes mode) const

Return true if the reqested flash mode is supported. Some QCameraExposure::FlashMode values can be combined, for example QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain

[pure virtual] bool QCameraFlashControl::isFlashReady() const

Returns true if flash is charged.

[pure virtual] void QCameraFlashControl::setFlashMode(QCameraExposure::FlashModes mode)

Set the current flash mode.

Usually a single QCameraExposure::FlashMode flag is used, but some non conflicting flags combination are also allowed, like QCameraExposure::FlashManual | QCameraExposure::FlashSlowSyncRearCurtain.

See also flashMode().

Macro Documentation



Defines the interface name of the QCameraFlashControl class.

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