Класс QCameraControl
Класс QCameraControl — это абстрактный базовый класс для классов, управляющих стационарными камерами или видеокамерами. Подробнее...
| Заголовок: | #include <QCameraControl> |
| qmake: | QT += multimedia |
| Наследует: | QMediaControl |
Типы public
| Перечисление | PropertyChangeType { CaptureMode, ImageEncodingSettings, VideoEncodingSettings, Viewfinder, ViewfinderSettings } |
Функции public
| virtual | ~QCameraControl() |
| virtual bool | canChangeProperty(QCameraControl::PropertyChangeType changeType, QCamera::Status status) const = 0 |
| virtual QCamera::CaptureModes | captureMode() const = 0 |
| virtual bool | isCaptureModeSupported(QCamera::CaptureModes mode) const = 0 |
| virtual void | setCaptureMode(QCamera::CaptureModes mode) = 0 |
| virtual void | setState(QCamera::State state) = 0 |
| virtual QCamera::State | state() const = 0 |
| virtual QCamera::Status | status() const = 0 |
Сигналы
| void | captureModeChanged(QCamera::CaptureModes mode) |
| void | error(int error, const QString &errorString) |
| void | stateChanged(QCamera::State state) |
| void | statusChanged(QCamera::Status status) |
Защищенные функции
| QCameraControl(QObject *parent = nullptr) |
Макросы
| QCameraControl_iid |
Подробное описание
Эта служба предоставляется объектом QMediaService через QMediaService::control(). Она используется классом QCamera.
Имя интерфейса QCameraControl равно org.qt-project.qt.cameracontrol/5.0, как определено в QCameraControl_iid.
См. также QMediaService::requestControl() и QCamera.
Документация по типам членов
Перечисление QCameraControl::PropertyChangeType
| Постоянная | Значение | Описание |
|---|---|---|
QCameraControl::CaptureMode |
1 |
Указывает, что режим захвата изменен. |
QCameraControl::ImageEncodingSettings |
2 |
Настройки кодировщика изображений изменены, включая разрешение. |
QCameraControl::VideoEncodingSettings |
3 |
Настройки кодировщика видео изменены, включая настройки аудио, видео и контейнера. |
QCameraControl::Viewfinder |
4 |
Экран предварительного просмотра изменён. |
QCameraControl::ViewfinderSettings |
5 |
Настройки экрана предварительного просмотра изменены. |
Документация по функциям-членам
[protected] QCameraControl::QCameraControl(QObject *parent = nullptr)
Конструирует объект управления камерой с parent.
[signal] void QCameraControl::captureModeChanged(QCamera::CaptureModes mode)
Сигнал, генерируемый при изменении режима захвата камеры mode.
[signal] void QCameraControl::error(int error, const QString &errorString)
Сигнал, генерируемый при возникновении ошибки с кодом ошибки error и описанием ошибки errorString.
[signal] void QCameraControl::stateChanged(QCamera::State state)
Сигнал, генерируемый при изменении состояния камеры state.
В большинстве случаев изменение состояния происходит из-за QCameraControl::setState(), но если произошла критическая ошибка, состояние изменяется на QCamera::UnloadedState.
[signal] void QCameraControl::statusChanged(QCamera::Status status)
Сигнал, генерируемый при изменении состояния камеры status.
[virtual] QCameraControl::~QCameraControl()
Деструктор объекта управления камерой.
[pure virtual] bool QCameraControl::canChangeProperty(QCameraControl::PropertyChangeType changeType, QCamera::Status status) const
Возвращает true, если бэкенд может эффективно применить изменения свойств камеры типа changeType, когда состояние камеры — QCamera::Active, а состояние камеры соответствует параметру status.
Если бэкенд не поддерживает применение этого изменения в активном состоянии, оно будет остановлено перед изменением настроек и перезапущено после. В противном случае бэкенд должен применить изменение в текущем состоянии, с состоянием камеры, указывающим на прогресс, при необходимости.
[pure virtual] QCamera::CaptureModes QCameraControl::captureMode() const
Возвращает текущий режим захвата.
См. также setCaptureMode().
[pure virtual] bool QCameraControl::isCaptureModeSupported(QCamera::CaptureModes mode) const
Возвращает true, если режим захвата mode поддерживается.
[pure virtual] void QCameraControl::setCaptureMode(QCamera::CaptureModes mode)
Устанавливает текущий режим захвата mode.
Изменения режима захвата синхронны и разрешены в любом состоянии камеры.
Если режим захвата изменяется, когда камера активна, рекомендуется изменить состояние на QCamera::LoadedStatus и начать активацию камеры в следующем цикле событий со статусом, измененным на QCamera::StartingStatus. Это позволяет применить настройки захвата перед запуском камеры. Затем измените состояние на QCamera::StartedStatus, когда изменение режима захвата завершено.
См. также captureMode().
[pure virtual] void QCameraControl::setState(QCamera::State state)
Устанавливает состояние камеры state.
Изменения состояния синхронны и указывают на намерение пользователя, в то время как состояние камеры используется в качестве механизма обратной связи для информирования приложения о состоянии бэкенда. Изменения состояния сообщаются асинхронно с сигналом QCameraControl::statusChanged().
См. также state() и QCamera::State.
[pure virtual] QCamera::State QCameraControl::state() const
Возвращает состояние службы камеры.
См. также setState() и QCamera::state.
[pure virtual] QCamera::Status QCameraControl::status() const
Возвращает состояние службы камеры.
См. также QCamera::state.
Документация макросов
QCameraControl::QCameraControl_iid
org.qt-project.qt.cameracontrol/5.0
Определяет имя интерфейса класса QCameraControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qcameracontrol.html