Класс 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.14/qcameraimagecapturecontrol.html