ImageCapture QML Type
Una interfaz para capturar imágenes de la cámara. Más...
| Import Statement: | import QtMultimedia |
Propiedades
- error : enumeration
- errorString : string
- fileFormat : enumeration
- metaData : mediaMetaData
- preview : string
- quality : enumeration
- readyForCapture : bool
- supportedFormats : list<FileFormat>
(since 6.10)
Señales
- errorOccurred(id, error, errorString)
- imageCaptured(requestId, preview)
- imageMetadataAvailable(id, metaData)
- imageSaved(id, fileName)
Métodos
- int capture()
- int captureToFile(location)
- void saveToFile(location)
Descripción detallada
Este tipo te permite capturar imágenes fijas y recibir una notificación cuando estén disponibles o se guarden en el disco.
Item {
width: 640
height: 360
CaptureSession {
imageCapture : ImageCapture {
id: imageCapture
}
camera: Camera {
id: camera
}
videoOutput: videoOutput
}
VideoOutput {
id: videoOutput
anchors.fill: parent
MouseArea {
anchors.fill: parent;
onClicked: imageCapture.capture();
}
}
Image {
id: photoPreview
source: imageCapture.preview // always shows the last captured image
}
}Documentación de propiedades
error : enumeration [read-only]
Esta propiedad contiene el tipo del último error que se ha producido. Puede ser uno de los siguientes.
| Constante | Descripción |
|---|---|
ImageCapture.NoError | No hay errores. |
ImageCapture.NotReadyError | El servicio aún no está listo para la captura. |
ImageCapture.ResourceError | El dispositivo no está listo o no está disponible. |
ImageCapture.OutOfSpaceError | No queda espacio libre en el dispositivo. |
ImageCapture.NotSupportedFeatureError | El dispositivo no admite la captura de imágenes fijas. |
ImageCapture.FormatError | El formato actual no es compatible. |
Véase también errorString.
errorString : string [read-only]
Esta propiedad contiene el último mensaje de error que se ha producido.
Véase también error.
fileFormat : enumeration
Esta propiedad indica el formato de archivo en el que se guardará la imagen. Puede ser uno de los siguientes.
| Constante | Descripción |
|---|---|
UnspecifiedFormat | Sin formato especificado |
JPEG | .jpg o formato « .jpeg » |
PNG | .png formato |
WebP | .webp formato |
Tiff | .tiff formato |
metaData : mediaMetaData
Esta propiedad contiene los metadatos que se incrustarán en la imagen.
preview : string [read-only]
Esta propiedad contiene una URL que apunta a la última imagen capturada. Se puede vincular a la propiedad «source» de un elemento Image para mostrar la última imagen capturada.
CaptureSession {
camera: Camera {}
imageCapture: ImageCapture {
id: capture
}
}
Image {
source: capture.preview
}Véase también saveToFile.
quality : enumeration
Esta propiedad almacena la información sobre la calidad al guardar la imagen capturada. Puede adoptar uno de los siguientes valores.
| Constante | Descripción |
|---|---|
VeryLowQuality | Muy baja |
LowQuality | Bajo |
NormalQuality | Normal |
HighQuality | Alto |
VeryHighQuality | Muy alto |
readyForCapture : bool [read-only]
Esta propiedad contiene un valor booleano que indica si la cámara está lista para hacer fotos o no.
No está permitido llamar a ` capture()` o ` captureToFile()` cuando `ready` es ` false `, y ello da lugar a un error.
supportedFormats : list<FileFormat> [read-only, since 6.10]
Contiene una lista de los formatos de archivo compatibles.
Esta propiedad se introdujo en Qt 6.10.
Véase también fileFormat.
Documentación sobre señales
errorOccurred(id, error, errorString)
Esta señal se emite cuando se produce un error durante la captura con id. error es una enumeración de tipo ImageCapture::Error. Hay un mensaje descriptivo disponible en errorString.
Nota: El controlador correspondiente es ` onErrorOccurred`.
Véase también error y errorString.
imageCaptured(requestId, preview)
Esta señal se emite cuando se ha capturado una imagen con el identificador solicitado requestId, pero aún no se ha guardado en el sistema de archivos. El parámetro preview es la imagen capturada.
Nota: El controlador correspondiente es onImageCaptured.
Véase también imageSaved y preview.
imageMetadataAvailable(id, metaData)
Esta señal se emite cuando la imagen con el id solicitado tiene un nuevo metaData.
Nota: El controlador correspondiente es onImageMetadataAvailable.
Véase también imageCaptured.
imageSaved(id, fileName)
Esta señal se emite una vez que la imagen con la dirección id solicitada se ha guardado en el sistema de archivos. La dirección fileName es una ruta de archivo local, no una URL.
Nota: El controlador correspondiente es onImageSaved.
Véase también imageCaptured.
Documentación del método
int capture()
Iniciar la captura de la imagen. Las señales « imageCaptured » y « imageSaved » se emitirán cuando finalice la captura.
La imagen capturada estará disponible a través de la propiedad «preview», que puede utilizarse como fuente para un elemento «Image» de QML. A continuación, se puede utilizar el método « saveToFile()» para guardar la imagen.
La cámara guarda todos los parámetros de captura, como los ajustes de exposición o los parámetros de procesamiento de imágenes, por lo que los cambios en los parámetros de la cámara tras llamar a `capture()` no afectan a las solicitudes de captura anteriores.
`capture()` devuelve el parámetro `requestId` de la captura, que se utiliza con las señales `imageExposed()`, ` imageCaptured()`, ` imageMetadataAvailable()` y ` imageSaved()`.
Véanse también « readyForCapture » y « preview ».
int captureToFile(location)
Realiza lo mismo que capture(), pero además guarda automáticamente la imagen capturada en la dirección especificada location. Devuelve el parámetro «requestId» de la captura.
Véase también capture().
void saveToFile(location)
Guarda la última imagen capturada en location.
© 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.