En esta página

Descripción general de la cámara

La API de « Qt Multimedia » proporciona varias clases relacionadas con la cámara, lo que te permite acceder a imágenes y vídeos desde las cámaras de dispositivos móviles o cámaras web. Existen API tanto en C++ como en QML para las tareas más habituales.

Funciones de la cámara

Para utilizar las clases de cámara, es necesario tener una visión general del funcionamiento de una cámara. Si ya estás familiarizado con este tema, puedes pasar directamente a los detalles de implementación de la cámara. Para obtener una explicación más detallada sobre cómo funciona una cámara, consulta el siguiente vídeo de YouTube.

El conjunto de la lente

En un extremo del conjunto de la cámara se encuentra el conjunto de lentes (una o más lentes, dispuestas para enfocar la luz hacia el sensor). Las propias lentes a veces se pueden mover para ajustar aspectos como el enfoque y el zoom. También pueden estar fijas en una disposición que ofrezca un buen equilibrio entre mantener el enfoque y el coste.

Una animación que muestra cómo funciona la atención

Algunos conjuntos de lentes pueden ajustarse automáticamente para mantener enfocado un objeto situado a diferentes distancias de la cámara. Esto suele hacerse midiendo la nitidez de una zona concreta del encuadre y, a continuación, ajustando el conjunto de lentes para encontrar el punto de máxima nitidez. En algunos casos, la cámara utilizará siempre el centro del encuadre para ello. En otros casos, la cámara también puede permitir especificar esta zona de enfoque objetivo. Algunos ejemplos de esta función son:

  • Zoom facial: uso de la visión artificial para detectar y utilizar uno o más rostros como objetivo.
  • Zoom táctil: permite al usuario seleccionar manualmente un área a través de la pantalla de vista previa.

El sensor

Una vez que la luz llega al sensor, se convierte en píxeles digitales. Este proceso puede depender de varios factores, pero, en última instancia, se reduce a dos aspectos:

  • El tiempo que se permite que dure la conversión. También conocido como tiempo de exposición.
  • La intensidad de la luz.

Cuanto más tiempo se permita que dure la conversión, mejor será la calidad de la imagen resultante. El uso de un flash puede ayudar a que llegue más luz al sensor, lo que permite que este convierta los píxeles más rápidamente y ofrezca una mejor calidad en el mismo tiempo. Por el contrario, permitir un tiempo de conversión más largo te permite hacer fotos en entornos más oscuros, siempre y cuando la cámara esté fija. Si la cámara se mueve mientras el sensor está grabando, la imagen resultante sale borrosa.

Procesamiento de imágenes

Una vez que el sensor ha capturado la imagen, el firmware de la cámara realiza diversas tareas de procesamiento de la misma para compensar las distintas características del sensor, la iluminación actual y las propiedades deseadas de la imagen. Unos tiempos de conversión de píxeles del sensor más rápidos pueden introducir ruido digital, por lo que se puede aplicar cierto grado de procesamiento de la imagen para eliminarlo, en función de los ajustes del sensor de la cámara.

El color de la imagen también se puede ajustar en esta fase para compensar las diferentes fuentes de luz: las luces fluorescentes y la luz solar confieren un aspecto muy diferente al mismo objeto, por lo que la imagen se puede ajustar en función del balance de blancos de la fotografía (debido a las diferentes temperaturas de color de las fuentes de luz).

5 ejemplos de diversas técnicas de procesamiento de imágenes.

En esta fase también se pueden aplicar algunos «efectos especiales». Se pueden crear imágenes en blanco y negro, en sepia o con estilo «negativo».

Grabación para la posteridad

Por último, una vez creada una imagen perfectamente enfocada, expuesta y procesada, se le puede dar un buen uso. Las imágenes de la cámara pueden procesarse aún más mediante código de aplicación (por ejemplo, para detectar códigos de barras o para unir una imagen panorámica), guardarse en un formato común como JPEG o utilizarse para crear un vídeo. Muchas de estas tareas cuentan con clases que facilitan su realización.

Detalles de la implementación de la cámara

Detección y selección de una cámara

Antes de utilizar las API de la cámara, debes comprobar que haya una cámara disponible en tiempo de ejecución. Si no hay ninguna disponible, puedes desactivar las funciones relacionadas con la cámara en tu aplicación. Para realizar esta comprobación en C++, utiliza la función ` QMediaDevices::videoInputs()` ( ), tal y como se muestra en el ejemplo siguiente:

bool checkCameraAvailability()
{
    return !QMediaDevices::videoInputs().isEmpty();
}

Accede a una cámara mediante la clase ` QCamera ` en C++ o el tipo ` Camera ` en QML.

Cuando hay varios dispositivos de cámara disponibles, puedes especificar cuál quieres utilizar.

En C++:

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

En QML, puedes seleccionar la cámara configurando la propiedad « Camera::cameraDevice ». En C++, también puedes seleccionar un dispositivo de cámara por su orientación física en lugar de por la información de la cámara. Esto resulta útil en dispositivos móviles, que suelen tener una cámara frontal y otra trasera.

En C++:

camera = new QCamera(QCameraDevice::FrontFace);

Si no se especifica ningún ` QCameraDevice `, se utilizará el dispositivo predeterminado. El dispositivo predeterminado se elige en función de la información proporcionada por el sistema operativo. En plataformas de escritorio, la cámara predeterminada suele ser la configurada por el usuario final en los ajustes del sistema. En un dispositivo móvil, la cámara trasera suele ser el dispositivo de cámara predeterminado. Puedes obtener el dispositivo de cámara predeterminado con ` QMediaDevices::defaultVideoInput()` en C++, o con ` MediaDevices.defaultVideoInput ` en QML.

El dispositivo de cámara predeterminado puede cambiar con el tiempo, por ejemplo, si el usuario final desconecta el dispositivo de cámara predeterminado actual. Los desarrolladores de aplicaciones pueden realizar un seguimiento de este cambio consultando de nuevo el dispositivo de cámara predeterminado cuando se emita la señal « QMediaDevices::videoInputsChanged ».

Vista previa

Aunque no es estrictamente necesario, a menudo resulta útil poder ver hacia dónde apunta la cámara. Esto se conoce como «vista previa».

Dependiendo de si utilizas QML o C++, puedes hacerlo de varias maneras. En QML, puedes utilizar « Camera » y «videoOutput» conjuntamente para supervisar una «captureSession».

Item {
    VideoOutput {
        id: output
        anchors.fill: parent
    }
    CaptureSession {
        videoOutput: output

        Camera {
            // You can adjust various settings in here
        }
    }
}

En C++, la elección depende de si se utilizan widgets o « QGraphicsView ». En el caso de los widgets, se utiliza la clase « QVideoWidget », mientras que « QGraphicsVideoItem » resulta útil para « QGraphicsView ».

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);
viewfinder = new QVideoWidget;
captureSession.setVideoOutput(viewfinder);
viewfinder->show();

camera->start(); // to start the camera

Para un uso avanzado (como procesar los fotogramas de vista previa a medida que se reciben, lo que permite la detección de objetos o patrones), también puedes utilizar tu propio ` QVideoSink ` y configurarlo como `videoOutput` para ` QMediaCaptureSession`. En este caso, tendrás que renderizar la imagen de vista previa tú mismo procesando los datos recibidos de la señal `videoFrameChanged()`.

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);
mySink = new QVideoSink;
captureSession.setVideoOutput(mySink);

camera->start();
// MyVideoSink::setVideoFrame(..) will be called with video frames

En los dispositivos móviles, la imagen de vista previa se orienta, por defecto, de la misma forma que el dispositivo. Por lo tanto, a medida que el usuario gire el dispositivo, la imagen de vista previa alternará entre el modo vertical y el horizontal. Una vez que comiences a grabar, la orientación quedará bloqueada. Para evitar una mala experiencia de usuario, también debes bloquear la orientación de la interfaz de usuario de la aplicación durante la grabación. Esto se puede conseguir utilizando la propiedad « contentOrientation » de ` QWindow`.

Imágenes fijas

Tras configurar el visor y encontrar algo fotogénico, para capturar una imagen debemos inicializar un nuevo objeto ` QImageCapture `. A continuación, solo hay que poner en marcha la cámara y capturar la imagen.

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);
imageCapture = new QImageCapture;
captureSession.setImageCapture(imageCapture);

camera->start(); // Viewfinder frames start flowing

// on shutter button pressed
imageCapture->capture();

Vídeos

Anteriormente vimos un código que permitía capturar una imagen fija. Para grabar vídeo es necesario utilizar un objeto ` QMediaRecorder `.

Para grabar vídeo, tenemos que crear un objeto «camera» como antes, pero esta vez, además de crear un visor, también inicializaremos un objeto «media recorder».

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);
recorder = new QMediaRecorder;
captureSession.setRecorder(recorder);

camera->start();

// setup output format for the recorder
QMediaFormat format(QMediaFormat::MPEG4);
format.setVideoCodec(QMediaFormat::VideoCodec::H264);
format.setAudioCodec(QMediaFormat::AudioCodec::MP3);
recorder->setMediaFormat(format);

// on shutter button pressed
recorder->record();

// sometime later, or on another press
recorder->stop();

Las señales de ` QMediaRecorder` se pueden conectar a ranuras para reaccionar ante cambios en el estado del proceso de codificación o ante eventos de error. La grabación comienza cuando se llama a ` QMediaRecorder::record()`. Esto provoca que se emita la señal ` recorderStateChanged()`. La grabación se controla mediante las ranuras `record()`, `stop()` y `pause()` de ` QMediaRecorder`.

Control del proceso de generación de imágenes

Ahora que ya se han visto los conceptos básicos de la captura de imágenes y vídeos, existen varias formas de controlar el proceso de generación de imágenes para implementar algunas técnicas interesantes. Como se ha explicado anteriormente, varios elementos físicos y electrónicos se combinan para determinar las imágenes finales, y puedes controlarlos mediante diferentes clases.

Enfoque y zoom

QCamera te permite establecer la política general de enfoque mediante las enumeraciones de ` FocusMode`. ` FocusMode ` se ocupa de ajustes como ` QCamera::FocusModeAuto` y ` QCamera::FocusModeInfinity`.

En el caso de los dispositivos de cámara que lo admiten, la opción « QCamera::FocusModeAutoNear » permite capturar imágenes de objetos que se encuentran cerca del sensor. Esto resulta útil en aplicaciones como el reconocimiento de códigos de barras o el escaneo de tarjetas de visita.

Además del enfoque, QCamera permite controlar cualquier función de zoom disponible mediante setZoomFactor() o zoomTo(). El rango de zoom disponible puede estar limitado o fijado por completo en la unidad (1:1). El rango permitido se puede comprobar con minimumZoomFactor() y maximumZoomFactor().

Exposición, velocidad de obturación y flash

Hay una serie de ajustes que influyen en la cantidad de luz que incide sobre el sensor de la cámara y, por lo tanto, en la calidad de la imagen resultante.

Los ajustes principales para la captura automática de imágenes son el modo automático ( exposure mode ) y el modo manual ( flash mode). Otros ajustes (como el valor ISO y el tiempo de exposición) suelen gestionarse automáticamente, pero también pueden modificarse manualmente si se desea.

Por último, puedes controlar el flash (si lo hay) mediante esta clase. En algunos casos, el flash también puede funcionar como linterna.

Procesamiento de imágenes

La clase ` QCamera ` te permite ajustar la parte del proceso dedicada al procesamiento de imágenes. Estos ajustes incluyen:

La mayoría de las cámaras admiten ajustes automáticos para todos estos parámetros, por lo que no debería ser necesario modificarlos a menos que el usuario desee una configuración específica.

Ejemplos

Hay ejemplos disponibles tanto en C++ como en QML.

Ejemplos en C++

Camera Example

Muestran cómo capturar una imagen fija o grabar un vídeo.

Ejemplos de QML

QML Camera Application

Esta aplicación basada en Qt Quick muestra cómo utilizar la API para capturar una imagen fija o grabar un vídeo.

QML Video Recorder

Grabación de audio y vídeo con Qt Quick.

Documentación de referencia

Clases de C++

QCamera

Interfaz para dispositivos de cámara del sistema

QCameraDevice

Información general sobre dispositivos de cámara

QCameraFormat

Describe un formato de vídeo compatible con un dispositivo de cámara

QImageCapture

Se utiliza para la grabación de contenido multimedia

Tipos QML

Camera

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

ImageCapture

Una interfaz para la captura de imágenes de la cámara

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