Класс QCameraControl
Класс QCameraControl — это абстрактный базовый класс для классов, которые управляют стационарными или видеокамерами. Подробнее...
| Заголовок: | #include <QCameraControl> |
| qmake: | QT += multimedia |
| Наследуется от: | QMediaControl |
Этот класс устарел. Он предоставляется для поддержки старого исходного кода. Мы настоятельно рекомендуем не использовать его в новом коде.
Открытые типы
| перечисление | PropertyChangeType { CaptureMode, ImageEncodingSettings, VideoEncodingSettings, Viewfinder, ViewfinderSettings } |
Открытые функции
| виртуальный | ~QCameraControl() |
| виртуальный bool | canChangeProperty(QCameraControl::PropertyChangeType changeType, QCamera::Status status) const = 0 |
| виртуальный QCamera::CaptureModes | captureMode() const = 0 |
| виртуальный bool | isCaptureModeSupported(QCamera::CaptureModes mode) const = 0 |
| виртуальный void | setCaptureMode(QCamera::CaptureModes mode) = 0 |
| виртуальный void | setState(QCamera::State state) = 0 |
| виртуальный QCamera::State | state() const = 0 |
| виртуальный 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_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.15/qcameracontrol.html