QCamera Class

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
    if (cameraDevice.description() == "mycamera")
        camera = new QCamera(cameraDevice);
}

camera->setZoomFactor(3.0);

camera->setWhiteBalanceMode(QCamera::WhiteBalanceFluorescent);

qApp->requestPermission(
    QCameraPermission{},
    [](const QPermission &permission) {
        if (permission.status() == Qt::PermissionStatus::Granted)
            camera->setActive(true);
    });

Documentación de propiedades

active : bool

Describe si la cámara está actualmente activa.

Funciones de acceso:

Señal de aviso:

cameraDevice : QCameraDevice

Devuelve el objeto QCameraDevice asociado a esta cámara.

Al cambiar de dispositivo de cámara, se actualizan las capacidades de QCamera. Además, las propiedades de control de QCamera(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.

Funciones de acceso:

Señal del notificador:

cameraFormat : QCameraFormat

Devuelve el formato de cámara utilizado actualmente por la cámara.

Funciones de acceso:

Señal notificador:

Véase también QCameraDevice::videoFormats.

colorTemperature : int

Devuelve la temperatura de color actual si el modo de balance de blancos actual es WhiteBalanceManual. Para otros modos el valor de retorno es indefinido.

Funciones de acceso:

Señal del notificador:

customFocusPoint : QPointF

Esta propiedad representa la posición del punto de enfoque personalizado, en coordenadas relativas del cuadro: QPointF(0,0) apunta al punto superior izquierdo del cuadro, 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.

Funciones de acceso:

Señal del notificador:

[read-only] error : Error

Devuelve el estado de error de la cámara.

Funciones de acceso:

Señal de notificador:

Véase también QCamera::Error.

[read-only] errorString : QString

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

Funciones de acceso:

Señal de notificador:

exposureCompensation : float

Compensación de la exposición en unidades EV.

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

Funciones de acceso:

Señal de aviso:

exposureMode : QCamera::ExposureMode

Esta propiedad contiene el modo de exposición que se está utilizando.

Funciones de acceso:

Señal del notificador:

Véase también QCamera::isExposureModeSupported.

[read-only] exposureTime : float

Tiempo de exposición de la cámara en segundos.

Funciones de acceso:

Señal de aviso:

Véase también minimumExposureTime(), maximumExposureTime() y setManualExposureTime().

flashMode : QCamera::FlashMode

Esta propiedad contiene el modo de flash que se está utilizando.

Activa un determinado modo de flash si la cámara dispone de flash.

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

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

Funciones de acceso:

Señal notificadora:

Véase también QCamera::FlashMode, QCamera::isFlashModeSupported, y QCamera::isFlashReady.

[read-only] flashReady : bool

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

Funciones de acceso:

Señal del notificador:

focusDistance : float

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 FocusModeManual, y supportedFeatures incluye la bandera Feature::FocusDistance.

Si asigna un valor a esta propiedad mientras focusMode no está establecido en QCamera::FocusModeManual, la propiedad almacena el valor pero no afecta al dispositivo hasta que QCamera::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 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.

Funciones de acceso:

Señal de notificador:

focusMode : FocusMode

Esta propiedad contiene el modo de enfoque actual de la cámara.

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 la 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 establece la propiedad focusMode a QCamera::FocusModeManual, la lente se bloquea al enfoque según focusDistance.

Funciones de acceso:

Señal notificadora:

Véase también isFocusModeSupported().

[read-only] focusPoint : QPointF

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

Funciones de acceso:

Señal de aviso:

[read-only] isoSensitivity : int

Esta propiedad contiene la sensibilidad ISO del sensor.

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

Funciones de acceso:

Señal notificadora:

Véase también setAutoIsoSensitivity() y setManualIsoSensitivity().

manualExposureTime : float

Ajuste el tiempo de exposición manual a seconds

Funciones de acceso:

Señal de aviso:

manualIsoSensitivity : int

Describe una sensibilidad ISO ajustada manualmente

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

Funciones de acceso:

Señal de aviso:

[read-only] maximumZoomFactor : float

Devuelve el factor de zoom máximo.

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

Funciones de acceso:

Señal del notificador:

[read-only] minimumZoomFactor : float

Devuelve el factor de zoom mínimo.

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

Funciones de acceso:

Señal del notificador:

[read-only] supportedFeatures : Features

Devuelve las funciones que admite esta cámara.

Funciones de acceso:

Señal de notificador:

Véase también QCamera::Feature.

torchMode : QCamera::TorchMode

Esta propiedad contiene 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 anula cualquier modo de flash actualmente configurado.

Funciones de acceso:

Señal de aviso:

Véase también QCamera::TorchMode, QCamera::isTorchModeSupported, y QCamera::flashMode.

whiteBalanceMode : WhiteBalanceMode

Devuelve el modo de balance de blancos que se está utilizando.

Funciones de acceso:

Señal de aviso:

zoomFactor : float

Esta propiedad contiene el factor de zoom actual.

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

Funciones de acceso:

Señal del notificador: