CameraFlash QML Type | Qt Multimedia 5.9

Qt 5.9 | Qt Multimedia | QML Types | CameraFlash QML Type

Qt 5.9.3 Reference Documentation

# CameraFlash QML Type

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

Import Statement: | import QtMultimedia 5.8

- List of all members, including inherited members

## Properties

- mode : enumeration
- ready : bool
- supportedModes : list<FlashMode>

## Signals

- flashModeChanged(int)
- flashReady(bool)

## 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 QML 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`.