QImageCapture Class

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);

viewfinder = new QVideoWidget;
viewfinder->show();
captureSession.setVideoOutput(viewfinder);

imageCapture = new QImageCapture;
captureSession.setImageCapture(imageCapture);

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

Documentation sur les fonctions membres

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

Crée un objet de capture d'image, à partir d'un ` parent`, capable de capturer des images fixes individuelles produites par un appareil photo.

Pour capturer des images, vous devez connecter à la fois un objet de capture d'image et une QCamera à une session de capture.

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

Supprime les images associées à l'objet.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

Ajoute des informations supplémentaires ( metaData ) à toutes les métadonnées existantes, qui sont intégrées à l'image capturée.

[slot] int QImageCapture::capture()

Capturez l'image et rendez-la disponible sous la forme d'un objet ` QImage`. Cette opération est asynchrone dans la plupart des cas ; elle est suivie des signaux ` QImageCapture::imageExposed()`, ` QImageCapture::imageCaptured()` ou ` QImageCapture::error()`.

QImageCapture::capture renvoie le paramètre « capture Id », utilisé avec les signaux imageExposed(), imageCaptured() et imageSaved().

Voir également isReadyForCapture().

QMediaCaptureSession *QImageCapture::captureSession() const

Renvoie la session de capture à laquelle cette caméra est connectée, ou un `nullptr` si la caméra n'est pas connectée à une session de capture.

Utilisez la fonction QMediaCaptureSession::setImageCapture() pour connecter la capture d'image à une session.

[slot] int QImageCapture::captureToFile(const QString &file = QString())

Capturez l'image et enregistrez-la dans ` file`. Cette opération est asynchrone dans la plupart des cas ; elle est suivie des signaux ` QImageCapture::imageExposed()`, ` QImageCapture::imageCaptured()`, ` QImageCapture::imageSaved()` ou ` QImageCapture::error()`.

Si un paramètre « file » vide est transmis, le back-end de la caméra choisit l’emplacement et le schéma de nommage par défaut pour les photos sur le système ; si seul le nom de fichier est spécifié sans chemin d’accès complet, l’image sera enregistrée dans le répertoire par défaut, et le chemin d’accès complet sera indiqué via les signaux imageCaptured(), imageSaved() et ().

QCamera Enregistre tous les paramètres de capture, tels que les réglages d’exposition ou les paramètres de traitement d’image ; ainsi, les modifications apportées aux paramètres de l’appareil photo après l’appel de ` capture()` n’affectent pas les demandes de capture précédentes.

QImageCapture::capture Renvoie le paramètre d’identifiant de capture, utilisé avec les signaux imageExposed(), imageCaptured() et imageSaved().

Voir également isReadyForCapture().

[signal] void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)

Indique que la requête de capture id a échoué, avec une description disponible à l'adresse error et errorString.

[static] QString QImageCapture::fileFormatDescription(QImageCapture::FileFormat f)

Renvoie la description du format de fichier indiqué : f.

[static] QString QImageCapture::fileFormatName(QImageCapture::FileFormat f)

Renvoie le nom du format indiqué, f.

[signal] void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)

Signal émis lorsque l'frame, dont la requête porte l'id, est disponible.

[signal] void QImageCapture::imageCaptured(int id, const QImage &preview)

Signal émis lorsque la trame contenant la requête id a été capturée, mais n'a pas encore été traitée ni enregistrée. La trame preview peut être affichée à l'utilisateur.

[signal] void QImageCapture::imageExposed(int id)

Signal émis lorsque la trame contenant la requête « id » a été transmise.

[signal] void QImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &metaData)

Indique qu'une image identifiée par id contient metaData.

[signal] void QImageCapture::imageSaved(int id, const QString &fileName)

Signal émis lorsque la méthode `QImageCapture::CaptureToFile` est appelée et que l'image correspondant à la requête id a été enregistrée dans le fichier fileName.

bool QImageCapture::isAvailable() const

Renvoie « true » si le service de capture d'images est prêt à l'emploi.

[signal] void QImageCapture::readyForCaptureChanged(bool ready)

Indique que l'ready de l'état de capture d'une caméra a changé.

QSize QImageCapture::resolution() const

Renvoie la résolution de l'image encodée.

Voir aussi setResolution().

[signal] void QImageCapture::resolutionChanged()

Signale tout changement de résolution de l'image.

void QImageCapture::setFileFormat(QImageCapture::FileFormat format)

Définit l'format de l'image.

L'attribution d'une FileFormat non prise en charge n'a aucun effet.

Voir également ` fileFormat()` et ` supportedFormats`.

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

Remplace toutes les métadonnées existantes, destinées à être intégrées à l'image capturée, par un ensemble de metaData.

Voir également metaData().

void QImageCapture::setQuality(QImageCapture::Quality quality)

Définit l'encodage de l'image quality.

Voir aussi quality().

void QImageCapture::setResolution(const QSize &resolution)

Définit l'resolution de l'image encodée.

Un paramètre « QSize » vide indique que l'encodeur doit faire un choix optimal en fonction des informations disponibles dans la source de l'image et des limitations du codec.

Voir aussi resolution().

void QImageCapture::setResolution(int width, int height)

Définit les paramètres width et height de la résolution de l'image encodée.

[static] QList<QImageCapture::FileFormat> QImageCapture::supportedFormats()

Renvoie une liste des formats de fichiers pris en charge.

Voir aussi FileFormat.