En esta página

QCamera Class

La clase QCamera proporciona una interfaz para los dispositivos de cámara del sistema. Más información...

Encabezado: #include <QCamera>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: Camera
Heredado de: QObject

Tipos públicos

enum Error { NoError, CameraError }
enum ExposureMode { ExposureAuto, ExposureManual, ExposurePortrait, ExposureNight, ExposureSports, …, ExposureBarcode }
enum class Feature { ColorTemperature, ExposureCompensation, IsoSensitivity, ManualExposureTime, CustomFocusPoint, FocusDistance }
flags Features
enum FlashMode { FlashOff, FlashOn, FlashAuto }
enum FocusMode { FocusModeAuto, FocusModeAutoNear, FocusModeAutoFar, FocusModeHyperfocal, FocusModeInfinity, FocusModeManual }
enum TorchMode { TorchOff, TorchOn, TorchAuto }
enum WhiteBalanceMode { WhiteBalanceAuto, WhiteBalanceManual, WhiteBalanceSunlight, WhiteBalanceCloudy, WhiteBalanceShade, …, WhiteBalanceSunset }

Propiedades

Funciones públicas

QCamera(QObject *parent = nullptr)
QCamera(QCameraDevice::Position position, QObject *parent = nullptr)
QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)
virtual ~QCamera() override
QCameraDevice cameraDevice() const
QCameraFormat cameraFormat() const
QMediaCaptureSession *captureSession() const
int colorTemperature() const
QPointF customFocusPoint() const
QCamera::Error error() const
QString errorString() const
float exposureCompensation() const
QCamera::ExposureMode exposureMode() const
float exposureTime() const
QCamera::FlashMode flashMode() const
float focusDistance() const
QCamera::FocusMode focusMode() const
QPointF focusPoint() const
bool isActive() const
bool isAvailable() const
bool isExposureModeSupported(QCamera::ExposureMode mode) const
bool isFlashModeSupported(QCamera::FlashMode mode) const
bool isFlashReady() const
bool isFocusModeSupported(QCamera::FocusMode mode) const
bool isTorchModeSupported(QCamera::TorchMode mode) const
bool isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const
int isoSensitivity() const
float manualExposureTime() const
int manualIsoSensitivity() const
float maximumExposureTime() const
int maximumIsoSensitivity() const
float maximumZoomFactor() const
float minimumExposureTime() const
int minimumIsoSensitivity() const
float minimumZoomFactor() const
void setCameraDevice(const QCameraDevice &cameraDevice)
void setCameraFormat(const QCameraFormat &format)
void setCustomFocusPoint(const QPointF &point)
void setFocusDistance(float d)
void setFocusMode(QCamera::FocusMode mode)
void setZoomFactor(float factor)
QCamera::Features supportedFeatures() const
QCamera::TorchMode torchMode() const
QCamera::WhiteBalanceMode whiteBalanceMode() const
float zoomFactor() const

Ranuras públicas

void setActive(bool active)
void setAutoExposureTime()
void setAutoIsoSensitivity()
void setColorTemperature(int colorTemperature)
void setExposureCompensation(float ev)
void setExposureMode(QCamera::ExposureMode mode)
void setFlashMode(QCamera::FlashMode mode)
void setManualExposureTime(float seconds)
void setManualIsoSensitivity(int iso)
void setTorchMode(QCamera::TorchMode mode)
void setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)
void start()
void stop()
void zoomTo(float factor, float rate)

Señales

void activeChanged(bool)
void cameraDeviceChanged()
void cameraFormatChanged()
void colorTemperatureChanged() const
void customFocusPointChanged()
void errorChanged()
void errorOccurred(QCamera::Error error, const QString &errorString)
void exposureCompensationChanged(float value)
void exposureModeChanged()
void exposureTimeChanged(float speed)
void flashModeChanged()
void flashReady(bool ready)
void focusDistanceChanged(float)
void focusModeChanged()
void focusPointChanged()
void isoSensitivityChanged(int value)
void manualExposureTimeChanged(float speed)
void manualIsoSensitivityChanged(int)
void maximumZoomFactorChanged(float)
void minimumZoomFactorChanged(float)
void supportedFeaturesChanged()
void torchModeChanged()
void whiteBalanceModeChanged() const
void zoomFactorChanged(float)

Descripción detallada

QCamera se puede utilizar en un ` QMediaCaptureSession ` para grabar vídeo y capturar imágenes.

QCameraDevice permite mostrar una lista de las cámaras disponibles y seleccionar cuál se va a utilizar.

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

En los dispositivos que lo admiten, QCamera permite ajustar el enfoque y el zoom. Las propiedades minimumZoomFactor y maximumZoomFactor proporcionan el rango de factores de zoom admitidos. La propiedad zoomFactor permite cambiar el factor de zoom.

camera->setZoomFactor(camera->maximumZoomFactor()); // zoom in as much as possible

Tras capturar los datos sin procesar de un fotograma de la cámara, el hardware y el software de la cámara realizan diversas tareas de procesamiento de imágenes para generar la imagen final. Esto incluye la compensación del color de la luz ambiental, la reducción del ruido y 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) que se utiliza para procesar las imágenes:

camera->setWhiteBalanceMode(QCamera::WhiteBalanceManual);
camera->setColorTemperature(5600);

Para obtener más información sobre el procesamiento de imágenes de los fotogramas de la cámara, consulta «Procesamiento de imágenes de la cámara».

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

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

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

Nota: En la plataforma WebAssembly, debido a su naturaleza asíncrona, se emite la señal QMediaDevices::videoInputsChanged() cuando la lista de entradas de vídeo está lista. Se requieren permisos del usuario. Solo funciona en contextos https seguros.

Documentación sobre los tipos de miembros

enum QCamera::Error

Esta enumeración contiene el último código de error.

ConstanteValorDescripción
QCamera::NoError0No se ha producido ningún error.
QCamera::CameraError1Se ha producido un error.

enum QCamera::ExposureMode

ConstanteValorDescripción
QCamera::ExposureAuto0Modo automático.
QCamera::ExposureManual1Modo manual.
QCamera::ExposurePortrait2Modo de exposición «Retrato».
QCamera::ExposureNight3Modo nocturno.
QCamera::ExposureSports4Modo de exposición «Spots».
QCamera::ExposureSnow5Modo de exposición para nieve.
QCamera::ExposureBeach6Modo de exposición «Playa».
QCamera::ExposureAction7Modo Acción. A partir de la versión 5.5
QCamera::ExposureLandscape8Modo «Paisaje». A partir de la versión 5.5
QCamera::ExposureNightPortrait9Modo «Retrato nocturno». Desde la versión 5.5
QCamera::ExposureTheatre10Modo teatro. Desde la versión 5.5
QCamera::ExposureSunset11Modo «Puesta de sol». A partir de la versión 5.5
QCamera::ExposureSteadyPhoto12Modo de foto estable. Desde la versión 5.5
QCamera::ExposureFireworks13Modo «Fuegos artificiales». Desde la versión 5.5
QCamera::ExposureParty14Modo «Fiesta». Desde la versión 5.5
QCamera::ExposureCandlelight15Modo «A la luz de las velas». Desde la versión 5.5
QCamera::ExposureBarcode16Modo «Código de barras». Desde la versión 5.5

enum class QCamera::Feature
flags QCamera::Features

Describe un conjunto de funciones compatibles con la cámara. El valor devuelto puede ser una combinación de:

ConstanteValorDescripción
QCamera::Feature::ColorTemperature0x1La cámara admite la configuración de un « colorTemperature » personalizado.
QCamera::Feature::ExposureCompensation0x2La cámara admite la configuración de un « exposureCompensation » personalizado.
QCamera::Feature::IsoSensitivity0x4La cámara permite configurar un isoSensitivity personalizado.
QCamera::Feature::ManualExposureTime0x8La cámara permite configurar un manual exposure Time.
QCamera::Feature::CustomFocusPoint0x10La cámara admite la configuración de « custom focus point ».
QCamera::Feature::FocusDistance0x20La cámara admite la configuración de la propiedad « focusDistance ».

El tipo «Features» es un typedef para QFlags<Feature>. Almacena una combinación OR de valores de Feature.

enum QCamera::FlashMode

ConstanteValorDescripción
QCamera::FlashOff0El flash está desactivado.
QCamera::FlashOn1El flash está activado.
QCamera::FlashAuto2Flash automático.

enum QCamera::FocusMode

ConstanteValorDescripción
QCamera::FocusModeAuto0Modo de enfoque automático continuo.
QCamera::FocusModeAutoNear1Modo de enfoque automático continuo en objetos cercanos.
QCamera::FocusModeAutoFar2Modo de enfoque automático continuo en objetos lejanos.
QCamera::FocusModeHyperfocal3Enfoque a la distancia hiperfocal, con la máxima profundidad de campo posible. Todos los objetos situados a distancias comprendidas entre la mitad de esta distancia y el infinito quedarán aceptablemente nítidos.
QCamera::FocusModeInfinity4Enfoque estrictamente al infinito.
QCamera::FocusModeManual5La distancia de enfoque del objetivo de la cámara se fija según focusDistance.

enum QCamera::TorchMode

ConstanteValorDescripción
QCamera::TorchOff0La linterna está apagada.
QCamera::TorchOn1La antorcha está encendida.
QCamera::TorchAuto2Antorcha automática.

enum QCamera::WhiteBalanceMode

ConstanteValorDescripción
QCamera::WhiteBalanceAuto0Modo de balance de blancos automático.
QCamera::WhiteBalanceManual1Balance de blancos manual. En este modo, el balance de blancos debe ajustarse con setColorTemperature()
QCamera::WhiteBalanceSunlight2Modo de balance de blancos «Luz solar».
QCamera::WhiteBalanceCloudy3Modo de balance de blancos «Nublado».
QCamera::WhiteBalanceShade4Modo de balance de blancos «Sombra».
QCamera::WhiteBalanceTungsten5Modo de balance de blancos «Tungsteno» (incandescente).
QCamera::WhiteBalanceFluorescent6Modo de balance de blancos «Fluorescente».
QCamera::WhiteBalanceFlash7Modo de balance de blancos «Flash».
QCamera::WhiteBalanceSunset8Modo de balance de blancos «Puesta de sol».

Documentación sobre propiedades

active : bool

Indica si la cámara está activa en este momento.

Funciones de acceso:

bool isActive() const
void setActive(bool active)

Señal de notificación:

void activeChanged(bool)

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` y ` zoomFactor`) se actualizan de la siguiente manera:

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

Funciones de acceso:

QCameraDevice cameraDevice() const
void setCameraDevice(const QCameraDevice &cameraDevice)

Señal de notificación:

void cameraDeviceChanged()

cameraFormat : QCameraFormat

Devuelve el formato que utiliza actualmente la cámara.

Nota: Al utilizar el backend FFMPEG en un dispositivo Android de destino, si solicitas el formato YUV420P, recibirás o bien un YUV420P 4:2:0 totalmente planar, o bien un NV12/NV21 semiplanar. Esto depende del códec implementado por el fabricante del dispositivo.

Nota: En macOS, los dispositivos de cámara se comparten entre varias aplicaciones del sistema operativo. Esto significa que otra aplicación puede anular el formato establecido por esta propiedad. Los desarrolladores de aplicaciones deben tener en cuenta que pueden recibir fotogramas de vídeo con una resolución, un formato de píxeles y una frecuencia de fotogramas diferentes a los descritos por esta propiedad. Esta propiedad no cambia cuando otra aplicación modifica el formato del dispositivo. El formato descrito por esta propiedad se puede volver a aplicar al dispositivo reactivando la propiedad « QCamera ».

Funciones de acceso:

QCameraFormat cameraFormat() const
void setCameraFormat(const QCameraFormat &format)

Señal de notificación:

void cameraFormatChanged()

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 devuelto no está definido.

Funciones de acceso:

int colorTemperature() const
void setColorTemperature(int colorTemperature)

Señal de notificación:

void colorTemperatureChanged() const

customFocusPoint : QPointF

Esta propiedad representa la posición del punto de enfoque personalizado, en coordenadas relativas del fotograma: QPointF(0,0) señala el punto superior izquierdo del fotograma, QPointF(0,5,0,5) señala el centro del fotograma.

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

Funciones de acceso:

QPointF customFocusPoint() const
void setCustomFocusPoint(const QPointF &point)

Señal de notificación:

void customFocusPointChanged()

[read-only] error : Error

Devuelve el estado de error de la cámara.

Funciones de acceso:

QCamera::Error error() const

Señal de notificación:

void errorChanged()

Véase también QCamera::Error.

[read-only] errorString : QString

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

Funciones de acceso:

QString errorString() const

Señal de notificación:

void errorChanged()

exposureCompensation : float

Compensación de exposición en unidades EV.

La función de compensación de exposición permite ajustar la exposición calculada automáticamente.

Funciones de acceso:

float exposureCompensation() const
void setExposureCompensation(float ev)

Señal de aviso:

void exposureCompensationChanged(float value)

exposureMode : QCamera::ExposureMode

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

Funciones de acceso:

QCamera::ExposureMode exposureMode() const
void setExposureMode(QCamera::ExposureMode mode)

Señal de notificación:

void exposureModeChanged()

Véase también QCamera::isExposureModeSupported.

[read-only] exposureTime : float

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

Funciones de acceso:

float exposureTime() const

Señal de notificación:

void exposureTimeChanged(float speed)

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

flashMode : QCamera::FlashMode

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

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

Asignar un modo no compatible a esta propiedad no tiene ningún efecto.

Esta propiedad solo surte efecto al capturar imágenes mediante QImageCapture

Funciones de acceso:

QCamera::FlashMode flashMode() const
void setFlashMode(QCamera::FlashMode mode)

Señal de notificación:

void flashModeChanged()

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:

bool isFlashReady() const[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Señal de notificación:

void flashReady(bool ready)

focusDistance : float

Esta propiedad define la distancia de enfoque del objetivo cuando la cámara funciona en modo de enfoque manual. Los valores válidos oscilan entre 0 y 1, donde 0 es la distancia de enfoque más cercana posible y 1, la más lejana. El punto más lejano suele estar en el infinito, aunque puede que no sea así en todos los dispositivos.

Esta propiedad se aplica al dispositivo únicamente cuando « focusMode » está establecida en « FocusModeManual » y « supportedFeatures » incluye el indicador « Feature::FocusDistance ».

Si se 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 ningún efecto sobre esta propiedad.

Si « supportedFeatures » no incluye el indicador « FocusDistance », se ignorará cualquier intento de establecer esta propiedad.

La cámara no actualizará esta propiedad cuando se encuentre en modo de enfoque automático.

El valor por defecto es 1.

Funciones de acceso:

float focusDistance() const
void setFocusDistance(float d)

Señal de notificación:

void focusDistanceChanged(float)

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 cámara. En todos los modos de enfoque automático, el dispositivo de cámara mantiene el enfoque de forma continua.

Para comprobar si el dispositivo de cámara admite un modo de enfoque concreto, pasa el valor correspondiente de « FocusMode » 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 compatible a esta propiedad no tiene ningún efecto.

Si se establece la propiedad focusMode en QCamera::FocusModeManual, el objetivo se bloquea en el enfoque según focusDistance.

Funciones de acceso:

QCamera::FocusMode focusMode() const
void setFocusMode(QCamera::FocusMode mode)

Señal de notificación:

Véase también isFocusModeSupported().

[read-only] focusPoint : QPointF

Devuelve el punto que el sistema de enfoque automático está utilizando actualmente para enfocar.

Funciones de acceso:

QPointF focusPoint() const

Señal de notificación:

void focusPointChanged()

[read-only] isoSensitivity : int

Esta propiedad contiene la sensibilidad ISO del sensor.

Describe la sensibilidad ISO que utiliza actualmente la cámara.

Funciones de acceso:

int isoSensitivity() const

Señal de notificación:

void isoSensitivityChanged(int value)

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

manualExposureTime : float

Ajusta el tiempo de exposición manual a seconds

Funciones de acceso:

float manualExposureTime() const
void setManualExposureTime(float seconds)

Señal de aviso:

void manualExposureTimeChanged(float speed)

manualIsoSensitivity : int

Describe una sensibilidad ISO ajustada manualmente

Si se establece esta propiedad en -1 (valor por defecto), la cámara ajusta automáticamente la sensibilidad ISO.

Funciones de acceso:

int manualIsoSensitivity() const
void setManualIsoSensitivity(int iso)

Señal de notificación:

void manualIsoSensitivityChanged(int)

[read-only] maximumZoomFactor : float

Devuelve el factor de zoom máximo.

En las cámaras que no admiten zoom, este valor será « 1.0 ».

Funciones de acceso:

float maximumZoomFactor() const

Señal de notificación:

void maximumZoomFactorChanged(float)

[read-only] minimumZoomFactor : float

Devuelve el factor de zoom mínimo.

En las cámaras que no admiten zoom, el valor será 1.0.

Funciones de acceso:

float minimumZoomFactor() const

Señal de notificador:

void minimumZoomFactorChanged(float)

[read-only] supportedFeatures : Features

Devuelve las funciones compatibles con esta cámara.

Funciones de acceso:

QCamera::Features supportedFeatures() const

Señal de notificación:

void supportedFeaturesChanged()

Véase también QCamera::Feature.

torchMode : QCamera::TorchMode

Esta propiedad almacena el modo de linterna que se está utilizando.

Una linterna es una fuente de luz continua. Se puede utilizar durante la grabación de vídeo en condiciones de poca luz. Al activar el modo linterna, normalmente se anula cualquier modo de flash que esté configurado en ese momento.

Funciones de acceso:

QCamera::TorchMode torchMode() const
void setTorchMode(QCamera::TorchMode mode)

Señal de notificación:

void torchModeChanged()

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:

QCamera::WhiteBalanceMode whiteBalanceMode() const
void setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

Señal de notificación:

void whiteBalanceModeChanged() const

zoomFactor : float

Esta propiedad contiene el factor de zoom actual.

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

Funciones de acceso:

float zoomFactor() const
void setZoomFactor(float factor)

Señal de notificación:

void zoomFactorChanged(float)

Documentación de funciones de miembro

[explicit] QCamera::QCamera(QObject *parent = nullptr)

Crea una QCamera con un ` parent`.

Selecciona la cámara predeterminada del sistema si hay más de una cámara disponible.

[explicit] QCamera::QCamera(QCameraDevice::Position position, QObject *parent = nullptr)

Crea una QCamera que utilice una cámara de hardware situada en la dirección especificada position.

Por ejemplo, en un teléfono móvil se puede utilizar para elegir fácilmente entre la cámara frontal y la trasera.

Si no hay ninguna cámara disponible en la dirección especificada position o si position es QCameraDevice::UnspecifiedPosition, se utiliza la cámara predeterminada.

[explicit] QCamera::QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)

Crea un objeto QCamera a partir de una descripción de cámara: cameraDevice y parent.

[override virtual noexcept] QCamera::~QCamera()

Elimina el objeto «cámara».

QMediaCaptureSession *QCamera::captureSession() const

Devuelve la sesión de captura a la que está conectada esta cámara, o un `nullptr` si la cámara no está conectada a ninguna sesión de captura.

Utiliza QMediaCaptureSession::setCamera() para conectar la cámara a una sesión.

[signal] void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

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

[signal] void QCamera::exposureCompensationChanged(float value)

Señal emitida cuando la compensación de exposición cambia a value.

Nota: Señalde notificación para la propiedad « exposureCompensation ».

float QCamera::exposureTime() const

Devuelve el tiempo de exposición actual en segundos.

Nota: Funcióngetter para la propiedad exposureTime.

[signal] void QCamera::exposureTimeChanged(float speed)

Indica que la exposición de una cámara speed ha cambiado.

Nota: Señalde notificación para la propiedad « exposureTime ».

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

Indica que el estado de « ready » del flash ha cambiado.

Nota: Señalde notificación para la propiedad flashReady.

[signal] void QCamera::focusModeChanged()

Emite una señal cuando cambia la propiedad focusMode.

Nota: Señalde notificación para la propiedad « focusMode ».

bool QCamera::isActive() const

Devuelve «true» si la cámara está activa en ese momento.

Nota: Funcióngetter para la propiedad « active ».

bool QCamera::isAvailable() const

Devuelve «true» si se puede utilizar la cámara.

[invokable] bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

Devuelve «true» si se admite la exposición mode.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

Devuelve «true» si se admite el flash mode.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QCamera::isFlashReady() const

Devuelve «true» si el flash está cargado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad flashReady.

[invokable] bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

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

Si se indica que FocusModeManual es compatible, se da por hecho que la función Feature::FocusDistance también lo es.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

Devuelve «true» si se admite la antorcha mode.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

Devuelve «true» si se admite el balance de blancos mode.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[signal] void QCamera::isoSensitivityChanged(int value)

Señal emitida cuando la sensibilidad cambia a value.

Nota: Señalde notificación para la propiedad isoSensitivity.

float QCamera::manualExposureTime() const

Devuelve el tiempo de exposición manual en segundos, o -1 si la cámara utiliza tiempos de exposición automáticos.

Nota: Funcióngetter para la propiedad manualExposureTime.

Véase también setManualExposureTime().

float QCamera::maximumExposureTime() const

El tiempo máximo de exposición en segundos.

int QCamera::maximumIsoSensitivity() const

Devuelve la sensibilidad ISO máxima que admite la cámara.

float QCamera::minimumExposureTime() const

El tiempo mínimo de exposición en segundos.

int QCamera::minimumIsoSensitivity() const

Devuelve la sensibilidad ISO mínima que admite la cámara.

[slot] void QCamera::setActive(bool active)

Activa la cámara si active es true, o la desactiva si es false.

Nota: Funciónde asignación para la propiedad active.

Véase también isActive().

[slot] void QCamera::setAutoExposureTime()

Utilizar el tiempo de exposición calculado automáticamente

[slot] void QCamera::setAutoIsoSensitivity()

Activar la sensibilidad automática

void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)

Conecta el objeto «cámara» al dispositivo de cámara físico descrito en cameraDevice. Si se utiliza un objeto ` QCameraDevice ` creado de forma predeterminada como ` cameraDevice `, la cámara se conectará al dispositivo de cámara predeterminado del sistema.

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 de la siguiente manera:

  • Si una propiedad es compatible con el nuevo dispositivo, el valor de la propiedad se aplica al dispositivo de 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 cámara.
  • Si el nuevo dispositivo de cámara no admite una propiedad, el valor de la propiedad se restablece a su valor por defecto y no se realiza ningún cambio en el dispositivo de cámara.

Nota: Funciónde configuración para la propiedad cameraDevice.

Véase también cameraDevice().

void QCamera::setCameraFormat(const QCameraFormat &format)

Indica a la cámara que utilice el formato descrito en format. Esto permite definir una resolución y una frecuencia de fotogramas específicas para la grabación y la captura de imágenes.

Nota: Al utilizar el backend FFMPEG en un dispositivo Android de destino, si se solicita el formato YUV420P, se obtendrá bien un YUV420P 4:2:0 totalmente planar, bien un NV12/NV21 semiplanar. Esto depende del códec implementado por el fabricante del dispositivo.

Nota: Funciónde configuración para la propiedad cameraFormat.

Véase también cameraFormat().

[slot] void QCamera::setColorTemperature(int colorTemperature)

Establece el balance de blancos manual en colorTemperature. Se utiliza cuando whiteBalanceMode() está configurado en WhiteBalanceManual. Las unidades son kelvin.

El ajuste de la temperatura de color solo surtirá efecto si se admite la propiedad WhiteBalanceManual. En este caso, al establecer una temperatura superior a 0, el modo de balance de blancos se ajustará automáticamente a WhiteBalanceManual. Al establecer la temperatura en 0, el modo de balance de blancos se restablecerá a WhiteBalanceAuto.

Nota: Funciónde configuración para la propiedad « colorTemperature ».

Véase también colorTemperature().

[slot] void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

Establece el balance de blancos en « mode ».

Nota: Funciónde asignación para la propiedad whiteBalanceMode.

Véase también whiteBalanceMode().

void QCamera::setZoomFactor(float factor)

Aumenta el zoom hasta un factor de factor a un ritmo de 1 factor por segundo.

Nota: Funciónde asignación para la propiedad zoomFactor.

Véase también zoomFactor().

[slot] void QCamera::start()

Inicia la cámara.

Es lo mismo que setActive(true).

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

[slot] void QCamera::stop()

Detiene la cámara. Es lo mismo que « setActive » (false).

[slot] void QCamera::zoomTo(float factor, float rate)

Realiza un zoom hasta un factor de zoom factor utilizando rate.

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

Nota: El uso de una velocidad específica no es compatible con todas las cámaras. Si no es compatible, el zoom se realizará lo más rápido posible.

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