Camera QML Type

Una interfaz para los ajustes de la cámara relacionados con el enfoque y el zoom. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• active : bool
• cameraDevice : cameraDevice
• cameraFormat : cameraFormat
• colorTemperature : int
• customFocusPoint : point
• error : enumeration
• errorString : string
• exposureCompensation : real
• exposureMode : enumeration
• exposureTime : real
• flashMode : enumeration
• flashReady : bool
• focusDistance : real
• focusMode : enumeration
• focusPoint : point
• isoSensitivity : int
• manualExposureTime : real
• manualIsoSensitivity : int
• maximumZoomFactor : real
• minimumZoomFactor : real
• supportedFeatures : enumeration
• torchMode : enumeration
• whiteBalanceMode : enumeration
• zoomFactor : real

Señales

• void errorOccurred(Camera::Error error, string errorString)

Métodos

• bool isExposureModeSupported(ExposureMode mode)
• bool isFlashModeSupported(FlashMode mode)
• bool isFlashReady()
• bool isFocusModeSupported(FocusMode mode)
• bool isTorchModeSupported(TorchMode mode)
• bool isWhiteBalanceModeSupported(WhiteBalanceMode mode)
• void start()
• void stop()
• void zoomTo(factor, rate)

Descripción detallada

El elemento Cámara puede utilizarse dentro de CaptureSession para la grabación de vídeo y la toma de imágenes.

Puedes utilizar MediaDevices para listar las cámaras disponibles y elegir cuál utilizar.

MediaDevices {
    id: mediaDevices
}
CaptureSession {
    camera: Camera {
        cameraDevice: mediaDevices.defaultVideoInput
    }
}

En el hardware que lo soporta, Camera permite ajustar el enfoque y el zoom. Las propiedades minimumZoomFactor y maximumZoomFactor proporcionan el rango de factores de zoom soportados. La propiedad zoomFactor permite cambiar el factor de zoom.

Camera {
    zoomFactor: maximumZoomFactor // zoom in as much as possible
}

Tras capturar los datos en bruto de un fotograma de la cámara, el hardware y el software de la cámara realizan varias tareas de procesamiento de imágenes para producir la imagen final. Esto incluye compensar el color de la luz ambiental, reducir el ruido, así como realizar otros ajustes en la imagen.

Puede controlar muchos de estos pasos de procesamiento a través de las propiedades de la cámara. Por ejemplo, puede establecer el balance de blancos (o temperatura de color) utilizado para procesar las imágenes:

Camera {
    whiteBalanceMode: Camera.WhiteBalanceManual
    colorTemperature: 5600
}

Para obtener más información sobre el procesamiento de imágenes de fotogramas de cámara, consulte Procesamiento de imágenes de cámara.

La mayoría de las plataformas requieren que el usuario final conceda permisos antes de poder activar una cámara. Por lo tanto, se recomienda encarecidamente que los desarrolladores de aplicaciones utilicen el componente CameraPermission cuando trabajen con cámaras. A continuación se muestra un breve ejemplo que solicita permisos al usuario final cuando se inicia la aplicación y, a continuación, activa la cámara si se conceden los permisos.

CameraPermission {
    id: cameraPermission
}

Camera {
    active: cameraPermission.status === Qt.PermissionStatus.Granted
}

Component.onCompleted: cameraPermission.request()

Consulte la descripción general de la cámara para obtener más información.

Documentación de propiedades

active : bool

Describe si la cámara está actualmente activa.

cameraDevice : cameraDevice

Obtiene o establece el dispositivo de cámara activo en ese momento.

Al cambiar de dispositivo de cámara, se actualizan las capacidades de Camera. Además, las propiedades de control de Camera(como focusMode, flashMode, focusDistance, zoomFactor) se actualizan del siguiente modo:

• Si una propiedad es compatible con el nuevo dispositivo, el valor de la propiedad se aplica al dispositivo de la cámara.
• Si una propiedad es compatible pero su rango de valores válidos ha cambiado, la propiedad se ajusta al nuevo rango y se aplica al dispositivo de la cámara.
• Si el nuevo dispositivo de cámara no admite una propiedad, el valor de la propiedad se restablece al valor predeterminado y no se realiza ningún cambio en el dispositivo de cámara.

cameraFormat : cameraFormat

Obtiene o establece el formato de cámara activo actualmente.

Véase también cameraDevice::videoFormats.

colorTemperature : int

Obtiene o establece la temperatura de color actual.

Establecer una temperatura de color sólo tendrá efecto si WhiteBalanceManual está soportado. En este caso, si se establece una temperatura mayor que 0, el modo de balance de blancos se establecerá automáticamente en WhiteBalanceManual. Establecer la temperatura a 0 restablecerá el modo de balance de blancos a WhiteBalanceAuto.

customFocusPoint : point

Esta propiedad contiene la posición del punto de enfoque personalizado, en coordenadas relativas del marco. Esto significa que QPointF(0,0) apunta a la esquina superior izquierda del cuadro, y QPointF(0.5,0.5) apunta al centro del cuadro.

Puede comprobar si se admiten puntos de enfoque personalizados consultando supportedFeatures() con el indicador Feature.CustomFocusPoint.

error : enumeration [read-only]

Devuelve el estado de error de la cámara.

errorString : string [read-only]

Devuelve una cadena legible por humanos que describe el estado de error de una cámara.

exposureCompensation : real

Obtiene o establece la compensación de exposición en unidades EV.

La propiedad Compensación de exposición permite ajustar la exposición calculada automáticamente.

exposureMode : enumeration

El modo de exposición utilizado.

Véase también isExposureModeSupported().

exposureTime : real [read-only]

Devuelve el tiempo de exposición de la cámara en segundos.

Véase también manualExposureTime.

flashMode : enumeration

Obtiene o establece un determinado modo de flash si la cámara tiene flash.

Asignar un modo no soportado a esta propiedad no tiene efecto.

Esta propiedad sólo tiene efecto cuando se capturan imágenes utilizando ImageCapture

Véase también isFlashModeSupported(), isFlashReady() y flashReady.

flashReady : bool [read-only]

Indica si el flash está cargado y listo para su uso.

focusDistance : real

Esta propiedad define la distancia de enfoque del objetivo cuando el dispositivo de la cámara funciona en modo de enfoque manual. Los valores válidos van de 0 a 1, donde 0 es la distancia de enfoque más cercana posible y 1 es la más lejana. El punto más lejano suele estar en el infinito, pero puede no ser el caso para todos los dispositivos.

Esta propiedad se aplica al dispositivo sólo cuando focusMode se establece en Camera.FocusModeManual, y supportedFeatures incluye la bandera Camera.FocusDistance.

Si asigna un valor a esta propiedad mientras focusMode no está establecido en Camera.FocusModeManual, la propiedad almacena el valor pero no afecta al dispositivo hasta que Camera.FocusModeManual esté activo.

Asignar un valor fuera del rango válido [0, 1] no tiene efecto sobre esta propiedad.

Si supportedFeatures no incluye la bandera Camera.FocusDistance, cualquier intento de establecer esta propiedad es ignorado.

Esta propiedad no será actualizada por la cámara cuando esté en modo de enfoque automático.

El valor por defecto es 1.

focusMode : enumeration

Esta propiedad contiene el valor que controla el modo de enfoque del dispositivo de la cámara. En todos los modos de enfoque automático, el dispositivo de cámara sigue enfocando continuamente.

Para comprobar si el dispositivo de la cámara admite un modo de enfoque concreto, pase el valor focusMode correspondiente a la función isFocusModeSupported() como parámetro. La función devuelve false si el valor del modo de enfoque no es compatible. Asignar un modo no soportado a esta propiedad no tiene ningún efecto.

Si asigna a la propiedad focusMode el valor Camera.FocusModeManual, el objetivo se bloquea al enfoque según focusDistance.

Véase también isFocusModeSupported().

focusPoint : point [read-only]

Devuelve el punto utilizado actualmente por el sistema de enfoque automático para enfocar.

isoSensitivity : int [read-only]

Describe la sensibilidad ISO utilizada actualmente por la cámara.

manualExposureTime : real

Obtiene o establece un tiempo de exposición manual.

Establecer esta propiedad a -1 (por defecto) significa que la cámara determina automáticamente el tiempo de exposición.

manualIsoSensitivity : int

Describe una sensibilidad ISO ajustada manualmente

Establecer esta propiedad a -1 (el valor por defecto), implica que la cámara ajusta automáticamente la sensibilidad ISO.

maximumZoomFactor : real [read-only]

Esta propiedad contiene el factor de zoom máximo soportado.

Será 1.0 en las cámaras que no admitan zoom.

minimumZoomFactor : real [read-only]

Esta propiedad contiene el factor de zoom mínimo soportado.

Será 1.0 en las cámaras que no admitan zoom.

supportedFeatures : enumeration [read-only]

Devuelve las características soportadas por esta cámara. El valor es una máscara de bits que puede contener cualquiera de los siguientes indicadores. Almacena una combinación OR de valores de Características.

torchMode : enumeration

Obtiene o establece el modo de antorcha que se está utilizando.

Una linterna es una fuente continua de luz. Se puede utilizar durante la grabación de vídeo en condiciones de poca luz. Activar el modo antorcha normalmente anulará cualquier modo de flash actualmente configurado.

Véase también isTorchModeSupported() y flashMode.

whiteBalanceMode : enumeration

Obtiene o establece el modo de balance de blancos que se está utilizando.

Véase también isWhiteBalanceModeSupported().

zoomFactor : real

Obtiene o establece el factor de zoom actual. Los valores se fijarán entre minimumZoomFactor y maximumZoomFactor.

Documentación de señales

void errorOccurred(Camera::Error error, string errorString)

Esta señal se emite cuando el estado de error cambia a error. Se proporciona una descripción del error en errorString.

Documentación del método

bool isExposureModeSupported(ExposureMode mode)

Devuelve true si se admite la exposición mode.

bool isFlashModeSupported(FlashMode mode)

Devuelve true si el flash mode es compatible.

bool isFlashReady()

Devuelve true si el flash está cargado.

bool isFocusModeSupported(FocusMode mode)

Devuelve true si la cámara admite el enfoque mode.

Si se informa de que Camera.FocusModeManual es compatible, se da a entender que la función Camera.FocusDistance también lo es.

bool isTorchModeSupported(TorchMode mode)

Devuelve true si la antorcha mode es compatible.

bool isWhiteBalanceModeSupported(WhiteBalanceMode mode)

Devuelve true si se admite el balance de blancos mode.

void start()

Inicia la cámara.

Es lo mismo que poner la propiedad active a true.

Si la cámara no puede iniciarse por algún motivo, se emite la señal errorOccurred().

void stop()

Detiene la cámara. Igual que establecer la propiedad active a false.

void zoomTo(factor, rate)

Aumenta a un factor de zoom factor utilizando rate.

El rate se especifica en potencias de dos por segundo. Con una velocidad de 1, se tardaría 2 segundos en pasar de un factor de zoom de 1 a 4.