Класс QCameraImageCaptureControl
Класс QCameraImageCaptureControl предоставляет интерфейс управления службами захвата изображений. Подробнее...
| Заголовок: | #include <QCameraImageCaptureControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Этот класс устарел. Он предоставляется для поддержки старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.
Открытые функции
| virtual | ~QCameraImageCaptureControl() |
| virtual void | cancelCapture() = 0 |
| virtual int | capture(const QString &fileName) = 0 |
| virtual QCameraImageCapture::DriveMode | driveMode() const = 0 |
| virtual bool | isReadyForCapture() const = 0 |
| virtual void | setDriveMode(QCameraImageCapture::DriveMode mode) = 0 |
Сигналы
| void | error(int id, int error, const QString &errorString) |
| void | imageAvailable(int requestId, const QVideoFrame &buffer) |
| void | imageCaptured(int requestId, const QImage &preview) |
| void | imageExposed(int requestId) |
| void | imageMetadataAvailable(int id, const QString &key, const QVariant &value) |
| void | imageSaved(int requestId, const QString &fileName) |
| void | readyForCaptureChanged(bool ready) |
Защищенные функции
| QCameraImageCaptureControl(QObject *parent = nullptr) |
Макросы
| QCameraImageCaptureControl_iid |
Подробное описание
Имя интерфейса QCameraImageCaptureControl — org.qt-project.qt.cameraimagecapturecontrol/5.0, как определено в QCameraImageCaptureControl_iid.
См. также QMediaService::requestControl().
Документация по функциям-членам
[protected] QCameraImageCaptureControl::QCameraImageCaptureControl(QObject *parent = nullptr)
Создаёт новый объект управления захватом изображений с заданным parent
[signal] void QCameraImageCaptureControl::error(int id, int error, const QString &errorString)
Сигнализирует о том, что запрос захвата id завершился ошибкой с кодом error и сообщением errorString.
См. также QCameraImageCapture::Error.
[signal] void QCameraImageCaptureControl::imageAvailable(int requestId, const QVideoFrame &buffer)
Сигнализирует о том, что буфер buffer с идентификатором requestId доступен.
[signal] void QCameraImageCaptureControl::imageCaptured(int requestId, const QImage &preview)
Сигнализирует о том, что изображение с идентификатором requestId было захвачено и предпросмотр preview доступен.
[signal] void QCameraImageCaptureControl::imageExposed(int requestId)
Сигнализирует о том, что изображение с идентификатором requestId только что было экспонировано. Этот сигнал может использоваться для звуковых эффектов затвора или других указателей.
[signal] void QCameraImageCaptureControl::imageMetadataAvailable(int id, const QString &key, const QVariant &value)
Сигнализирует о том, что метаданные изображения с запросом id доступны. Сигнал также содержит ключ key и значение value метаданных.
Этот сигнал должен быть выпущен между сигналами imageExposed и imageSaved.
[signal] void QCameraImageCaptureControl::imageSaved(int requestId, const QString &fileName)
Сигнализирует о том, что захваченное изображение с идентификатором requestId было сохранено в fileName.
[signal] void QCameraImageCaptureControl::readyForCaptureChanged(bool ready)
Сигнализирует о том, что состояние готовности к захвату управления захватом изменилось.
[virtual] QCameraImageCaptureControl::~QCameraImageCaptureControl()
Удаляет объект управления захватом изображений.
[pure virtual] void QCameraImageCaptureControl::cancelCapture()
Отменяет ожидающие запросы захвата.
[pure virtual] int QCameraImageCaptureControl::capture(const QString &fileName)
Инициализирует захват изображения в fileName. fileName может быть относительным или пустым; в этом случае служба должна использовать специфичный для системы способ определения местоположения и именования файла.
Служба камеры должна сохранять все параметры захвата, такие как настройки экспозиции или параметры обработки изображений, поэтому изменения параметров камеры после вызова capture() не влияют на предыдущие запросы захвата.
Возвращает идентификатор запроса захвата, который используется позднее с сигналами imageExposed(), imageCaptured() и imageSaved().
[pure virtual] QCameraImageCapture::DriveMode QCameraImageCaptureControl::driveMode() const
Возвращает текущий режим работы камеры.
См. также setDriveMode().
[pure virtual] bool QCameraImageCaptureControl::isReadyForCapture() const
Определяет, готов ли модуль захвата выполнить захват немедленно (все необходимые ресурсы для захвата изображения выделены, оборудование инициализировано, вспышка заряжена и т. д.).
Возвращает true, если камера готова к захвату, и false — если нет.
Разрешается вызывать capture() в то время, когда состояние камеры QCamera::ActiveStatus, независимо от значения свойства isReadyForCapture. Если камера не готова к немедленному захвату изображения, запрос захвата помещается в очередь, и все связанные настройки камеры выполняются как можно скорее.
[pure virtual] void QCameraImageCaptureControl::setDriveMode(QCameraImageCapture::DriveMode mode)
Устанавливает текущий режим работы камеры mode.
См. также driveMode().
Документация по макросам
QCameraImageCaptureControl_iid
org.qt-project.qt.cameraimagecapturecontrol/5.0
Определяет имя интерфейса класса QCameraImageCaptureControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qcameraimagecapturecontrol.html