CameraFlash QML Type

An interface for flash related camera settings. More...

Import Statement: import QtMultimedia 5.12

Properties

Signals

Detailed Description

This type allows you to operate the camera flash hardware and control the flash mode used. Not all cameras have flash hardware (and in some cases it is shared with the torch hardware).

It should not be constructed separately, instead the flash property of a Camera should be used.

Camera {
    id: camera

    exposure.exposureCompensation: -1.0
    flash.mode: Camera.FlashRedEyeReduction
}

Property Documentation

mode : enumeration

This property holds the camera flash mode.

The mode can be one of the following:

Value Description
Camera.FlashOff Flash is Off.
Camera.FlashOn Flash is On.
Camera.FlashAuto Automatic flash.
Camera.FlashRedEyeReduction Red eye reduction flash.
Camera.FlashFill Use flash to fillin shadows.
Camera.FlashTorch Constant light source. If supported, torch can be enabled without loading the camera.
Camera.FlashVideoLight Constant light source, useful for video capture. The light is turned on only while the camera is active.
Camera.FlashSlowSyncFrontCurtain Use the flash in conjunction with a slow shutter speed. This mode allows better exposure of distant objects and/or motion blur effect.
Camera.FlashSlowSyncRearCurtain The similar mode to FlashSlowSyncFrontCurtain but flash is fired at the end of exposure.
Camera.FlashManual Flash power is manually set.

ready : bool

This property indicates whether the flash is charged.

supportedModes : list<FlashMode>

This property holds the supported flash modes of the camera. If the list only contains Camera.FlashOff, no flash is supported.

Camera {
    id: camera
    flash {
        onSupportedModesChanged {
            if (flash.supportedModes.length == 1) {
                // no flash supported
            } else {
                // some flash is supported
            }
        }
    }
}

This property was introduced in Qt 5.9.

See also mode.

Signal Documentation

flashModeChanged(int)

This signal is emitted when the flashMode property is changed. The corresponding handler is onFlashModeChanged.

flashReady(bool)

This signal is emitted when QCameraExposure indicates that the flash is ready to use. The corresponding handler is onFlashReadyChanged.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qml-qtmultimedia-cameraflash.html