QImageCapture Class

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

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

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

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

Documentation des fonctions membres

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

Construit un objet de capture d'image, à partir d'un parent, qui peut capturer des images fixes individuelles produites par une caméra.

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

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

Détruit l'objet de capture d'images.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

Ajoute metaData à toutes les métadonnées existantes, qui sont intégrées dans l'image capturée.

[slot] int QImageCapture::capture()

Capture l'image et la rend disponible en tant que QImage. Cette opération est asynchrone dans la plupart des cas, suivie par les 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 QMediaCaptureSession::setImageCapture() pour connecter la capture d'image à une session.

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

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

Si un file vide est transmis, l'arrière-plan de la caméra choisit l'emplacement et le schéma de dénomination par défaut pour les photos sur le système, si seul le nom du fichier sans chemin complet est spécifié, l'image sera enregistrée dans le répertoire par défaut, avec un chemin complet signalé par les signaux imageCaptured() et imageSaved().

QCamera enregistre tous les paramètres de capture tels que les paramètres d'exposition ou les paramètres de traitement d'image, de sorte que 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 Id de la capture, utilisé avec les signaux imageExposed(), imageCaptured() et imageSaved().

Voir également isReadyForCapture().

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

Signale que la demande de capture id a échoué avec une description error et errorString.

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

Renvoie la description du format de fichier donné, f.

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

Renvoie le nom du format donné, f.

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

Signal émis lorsque le site frame avec la requête id est disponible.

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

Signal émis lorsque l'image avec la requête id a été capturée, mais n'a pas encore été traitée et sauvegardée. L'image preview peut être affichée à l'utilisateur.

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

Signal émis lorsque le cadre contenant la demande id a été exposé.

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

Signale qu'une image identifiée par id est metaData.

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

Signal émis lorsque QImageCapture::CaptureToFile est activé et que l'image avec la requête id a été enregistrée sur fileName.

bool QImageCapture::isAvailable() const

Retourne true si le service de capture d'images est prêt à être utilisé.

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

Signale que l'état de la caméra ready for capture a changé.

QSize QImageCapture::resolution() const

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

Voir aussi setResolution().

[signal] void QImageCapture::resolutionChanged()

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

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

Définit l'image format.

L'attribution d'une adresse 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, à intégrer dans l'image capturée, par un ensemble de metaData.

Voir également metaData().

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

Définit le codage de l'image quality.

Voir aussi quality().

void QImageCapture::setResolution(const QSize &resolution)

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

Un QSize vide indique que l'encodeur doit faire un choix optimal en fonction de ce qui est disponible dans la source de l'image et des limites du codec.

Voir également resolution().

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

Définit les valeurs 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 également FileFormat.