Класс QCamera

Класс QCamera предоставляет интерфейс для устройств системных камер. Подробнее...

• Список всех членов, включая унаследованные

Общедоступные типы

Свойства

• captureMode : QCamera::РежимыЗахвата
• lockStatus : const QCamera::СтатусБлокировки
• state : const QCamera::Состояние
• status : const QCamera::Статус

Открытые функции

Переопределённые открытые функции

Открытые слоты

Сигналы

Подробное описание

QCamera можно использовать с QCameraViewfinder для отображения видоискателя, QMediaRecorder для записи видео и QCameraImageCapture для фотографирования.

Вы можете использовать QCameraInfo для отображения доступных камер и выбора нужной.

const QList<QCameraInfo> cameras = QCameraInfo::availableCameras();
for (const QCameraInfo &cameraInfo : cameras) {
    if (cameraInfo.deviceName() == "mycamera")
        camera = new QCamera(cameraInfo);
}

Дополнительную информацию см. в обзоре камеры.

Документация по типам членов

перечисление QCamera::CaptureModeфлаги QCamera::CaptureModes

Это перечисление содержит режим захвата камеры.

Тип CaptureModes — это псевдоним для QFlags<CaptureMode>. Он хранит логическое ИЛИ комбинацию значений CaptureMode.

перечисление QCamera::Error

Это перечисление содержит последний код ошибки.

перечисление QCamera::LockChangeReason

Это перечисление содержит причину изменения состояния блокировки камеры.

перечисление QCamera::LockStatus

Это перечисление содержит общее состояние всех запрошенных блокировок камеры.

перечисление QCamera::LockTypeфлаги QCamera::LockTypes

Это перечисление содержит тип блокировки камеры.

Тип LockTypes — это псевдоним для QFlags<LockType>. Он хранит логическое ИЛИ комбинацию значений LockType.

перечисление QCamera::Position

Это перечисление указывает физическое положение камеры на системном оборудовании.

Это перечисление было введено или изменено в Qt 5.3.

См. также QCameraInfo::position().

перечисление QCamera::State

Это перечисление содержит текущее состояние камеры.

enum QCamera::Status

Этот перечисление содержит текущий статус камеры.

Документация по функциям-членам

QCamera::QCamera(QCamera::Position position, QObject *parent = nullptr)

Создает QCamera, использующий аппаратную камеру, расположенную в указанной position.

Например, на мобильном телефоне это можно использовать для легкого выбора между передней и задней камерами.

Если камера недоступна в указанной position или если position равно QCamera::UnspecifiedPosition, используется стандартная камера.

Эта функция была добавлена в Qt 5.3.

QCamera::QCamera(const QCameraInfo &cameraInfo, QObject *parent = nullptr)

Создаёт QCamera по описанию камеры cameraInfo и parent.

Эта функция была добавлена в Qt 5.3.

QCamera::QCamera(const QByteArray &deviceName, QObject *parent = nullptr)

Создаёт QCamera из deviceName и parent.

Если камера с таким deviceName не существует, объект камеры будет недействительным.

QCamera::QCamera(QObject *parent = nullptr)

Создаёт QCamera с parent.

[signal] void QCamera::captureModeChanged(QCamera::CaptureModes mode)

Сигнализирует о том, что режим захвата mode изменился.

Примечание: Сигнал-уведомление для свойства captureMode.

[signal] void QCamera::error(QCamera::Error value)

Сигнал, испускаемый, когда состояние ошибки меняется на value.

Примечание: Сигнал error перегружен в этом классе. Для подключения к этому сигналу, используя синтаксис указателя на функцию, Qt предоставляет удобную функцию для получения указателя на функцию, как показано в данном примере:

connect(camera, QOverload<QCamera::Error>::of(&QCamera::error),
    [=](QCamera::Error value){ /* ... */ });

[slot] void QCamera::load()

Открывает устройство камеры. Состояние камеры изменяется на QCamera::LoadedState.

Явно загружать камеру необязательно, если приложение не нуждается в чтении поддерживаемых настроек камеры и изменении значений по умолчанию в соответствии с возможностями камеры.

Во всех остальных случаях камеру можно запустить непосредственно из состояния unloaded.

/sa QCamera::UnloadedState

[signal] void QCamera::lockFailed()

Сигнализирует о неудачном блокировании по крайней мере одной запрошенной настройки камеры.

[signal] void QCamera::lockStatusChanged(QCamera::LockType lock, QCamera::LockStatus status, QCamera::LockChangeReason reason)

Сигнализирует о том, что состояние блокировки lock было изменено с указанным reason.

Примечание: Сигнал lockStatusChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобный помощник для получения указателя на функцию, как показано в этом примере:

connect(camera, QOverload<QCamera::LockType, QCamera::LockStatus, QCamera::LockChangeReason>::of(&QCamera::lockStatusChanged),
    [=](QCamera::LockType lock, QCamera::LockStatus status, QCamera::LockChangeReason reason){ /* ... */ });

Примечание: Сигнал-уведомление для свойства lockStatus.

[signal] void QCamera::lockStatusChanged(QCamera::LockStatus status, QCamera::LockChangeReason reason)

Сигнализирует об изменении общего состояния status всех запрошенных блокировок камеры с указанным reason.

Примечание: Сигнал lockStatusChanged перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобный помощник для получения указателя на функцию, как показано в этом примере:

connect(camera, QOverload<QCamera::LockStatus, QCamera::LockChangeReason>::of(&QCamera::lockStatusChanged),
    [=](QCamera::LockStatus status, QCamera::LockChangeReason reason){ /* ... */ });

Примечание: Сигнал-уведомление для свойства lockStatus.

[signal] void QCamera::locked()

Сигнализирует о том, что все запрошенные настройки камеры заблокированы.

[slot] void QCamera::searchAndLock(QCamera::LockTypes locks)

Блокирует настройки камеры с запрошенными locks, включая фокусировку в режиме одиночной автофокусировки, экспозицию и баланс белого, если режимы экспозиции и баланса белого не являются ручными.

Настройки камеры обычно блокируются перед съемкой одного или нескольких статических изображений в ответ на нажатие кнопки спуска затвора наполовину.

Сигнал QCamera::locked() отправляется, когда настройки камеры успешно заблокированы, в противном случае отправляется QCamera::lockFailed().

QCamera также отправляет lockStatusChanged(QCamera::LockType, QCamera::LockStatus) при изменении статуса отдельных блокировок и lockStatusChanged(QCamera::LockStatus) при изменении составного статуса.

Блокировка выполняет две задачи: она инициализирует вычисление автоматических параметров (фокусировка, расчет правильной экспозиции и баланса белого) и позволяет сохранять некоторые или все эти параметры при серии снимков.

Если камера не поддерживает сохранение одного из параметров между снимками, соответствующее состояние блокировки изменяется на QCamera::Unlocked.

Также допустимо повторное блокирование уже заблокированных настроек, в зависимости от параметра блокировки это инициирует новое вычисление фокусировки, экспозиции или баланса белого.

[slot] void QCamera::searchAndLock()

Заблокировать все поддерживаемые настройки камеры.

[slot] void QCamera::start()

Запускает камеру.

Состояние изменяется на QCamera::ActiveState, если камера запущена успешно, в противном случае отправляется сигнал error().

Пока состояние камеры изменено на QCamera::ActiveState, запуск службы камеры может быть асинхронным, а фактический статус сообщается свойством QCamera::status.

[signal] void QCamera::stateChanged(QCamera::State state)

Сигнализирует об изменении состояния камеры state.

Обычно изменения состояния вызываются вызовами load(), unload(), start() и stop(), но состояние также может быть изменено в результате ошибки камеры.

Примечание: Сигнал-уведомление для свойства state.

[signal] void QCamera::statusChanged(QCamera::Status status)

Сигнализирует об изменении статуса камеры status.

Примечание: Сигнал-уведомление для свойства status.

[slot] void QCamera::stop()

Останавливает камеру. Состояние камеры изменяется с QCamera::ActiveState на QCamera::LoadedState.

В этом состоянии камера по-прежнему потребляет энергию.

См. также unload() и QCamera::UnloadedState.

[slot] void QCamera::unload()

Закрывает устройство камеры и освобождает связанные ресурсы. Состояние камеры изменяется на QCamera::UnloadedState.

[slot] void QCamera::unlock(QCamera::LockTypes locks)

Разблокирует настройки камеры, указанные параметром locks, или отменяет текущую блокировку, если она активна.

[slot] void QCamera::unlock()

Разблокировать все запрошенные блокировки камеры.

[virtual] QCamera::~QCamera()

Уничтожает объект камеры.

[override virtual] QMultimedia::AvailabilityStatus QCamera::availability() const

Переопределяет: QMediaObject::availability() const.

Возвращает состояние доступности службы камеры.

QCamera::Error QCamera::error() const

Возвращает состояние ошибки объекта.

QString QCamera::errorString() const

Возвращает строку, описывающую состояние ошибки камеры.

QCameraExposure *QCamera::exposure() const

Возвращает объект управления экспозицией камеры.

QCameraFocus *QCamera::focus() const

Возвращает объект управления фокусом камеры.

QCameraImageProcessing *QCamera::imageProcessing() const

Возвращает объект управления обработкой изображений камеры.

bool QCamera::isCaptureModeSupported(QCamera::CaptureModes mode) const

Возвращает true, если режим захвата mode поддерживается.

QCamera::LockStatus QCamera::lockStatus() const

Возвращает состояние блокировок запрошенных настроек камеры.

Примечание: Функция-получатель для свойства lockStatus.

QCamera::LockStatus QCamera::lockStatus(QCamera::LockType lockType) const

Возвращает состояние блокировки для заданного lockType.

Примечание: Функция-получатель для свойства lockStatus.

QCamera::LockTypes QCamera::requestedLocks() const

Возвращает запрошенные типы блокировок.

void QCamera::setViewfinder(QVideoWidget *viewfinder)

Устанавливает QVideoWidget в качестве видоискателя камеры viewfinder. Предыдущий видоискатель отсоединяется.

void QCamera::setViewfinder(QGraphicsVideoItem *viewfinder)

Устанавливает QGraphicsVideoItem в качестве видоискателя камеры viewfinder. Предыдущий видоискатель отсоединяется.

void QCamera::setViewfinder(QAbstractVideoSurface *surface)

Устанавливает видеоповерхность surface как видоискатель камеры.

Если видоискатель уже установлен на камере, новая поверхность заменит его.

void QCamera::setViewfinderSettings(const QCameraViewfinderSettings &settings)

Устанавливает параметры видоискателя settings.

Если некоторые параметры не указаны или переданы null значения настроек, камера выберет значения по умолчанию.

Если камера используется для захвата видео или изображений, настройки видоискателя могут быть проигнорированы, если они конфликтуют с настройками захвата. Вы можете проверить фактические настройки видоискателя, когда камера находится в состоянии QCamera::ActiveStatus.

Изменение настроек видоискателя, когда камера находится в состоянии QCamera::ActiveState, может привести к перезапуску камеры.

Эта функция была добавлена в Qt 5.5.

См. также viewfinderSettings(), supportedViewfinderResolutions(), supportedViewfinderFrameRateRanges() и supportedViewfinderPixelFormats().

QCamera::LockTypes QCamera::supportedLocks() const

Возвращает типы блокировок, поддерживаемые камерой.

QList<QCamera::FrameRateRange> QCamera::supportedViewfinderFrameRateRanges(const QCameraViewfinderSettings &settings = QCameraViewfinderSettings()) const

Возвращает список поддерживаемых диапазонов частоты кадров видоискателя.

Это функция-утилита, которая извлекает уникальные диапазоны частоты кадров из поддерживаемых настроек.

Если переданы непустые настройки видоискателя settings, возвращаемый список сокращается до диапазонов частоты кадров, поддерживаемых с частично применёнными settings.

Перед вызовом этой функции камера должна быть загружена, в противном случае возвращаемый список пуст.

Эта функция была добавлена в Qt 5.5.

См. также QCameraViewfinderSettings::minimumFrameRate(), QCameraViewfinderSettings::maximumFrameRate() и setViewfinderSettings().

QList<QVideoFrame::PixelFormat> QCamera::supportedViewfinderPixelFormats(const QCameraViewfinderSettings &settings = QCameraViewfinderSettings()) const

Возвращает список поддерживаемых форматов пикселей видоискателя.

Это функция-утилита, которая извлекает уникальные форматы пикселей из поддерживаемых настроек.

Если переданы непустые настройки видоискателя settings, возвращаемый список сокращается до форматов пикселей, поддерживаемых с частично применёнными settings.

Перед вызовом этой функции камера должна быть загружена, в противном случае возвращаемый список пуст.

Эта функция была добавлена в Qt 5.5.

См. также QCameraViewfinderSettings::pixelFormat() и setViewfinderSettings().

QList<QSize> QCamera::supportedViewfinderResolutions(const QCameraViewfinderSettings &settings = QCameraViewfinderSettings()) const

Возвращает список поддерживаемых разрешений видоискателя.

Это функция-утилита, которая извлекает уникальные разрешения из поддерживаемых настроек.

Если переданы непустые настройки видоискателя settings, возвращаемый список сокращается до разрешений, поддерживаемых с частично применёнными settings.

Перед вызовом этой функции камера должна быть загружена, в противном случае возвращаемый список пуст.

Эта функция была добавлена в Qt 5.5.

См. также QCameraViewfinderSettings::resolution() и setViewfinderSettings().

QList<QCameraViewfinderSettings> QCamera::supportedViewfinderSettings(const QCameraViewfinderSettings &settings = QCameraViewfinderSettings()) const

Возвращает список поддерживаемых настроек видоискателя.

Список упорядочен по предпочтениям; предпочтительные настройки находятся в начале.

Дополнительный аргумент settings может использоваться для удобного фильтрации результатов. Если settings не пуст, возвращаемый список сокращается до настроек, соответствующих заданным частичным settings.

Состояние камеры должно быть LoadedStatus перед вызовом этой функции, в противном случае возвращаемый список пуст.

Эта функция была добавлена в Qt 5.5.

См. также setViewfinderSettings(), supportedViewfinderResolutions(), supportedViewfinderFrameRateRanges() и supportedViewfinderPixelFormats().

QCameraViewfinderSettings QCamera::viewfinderSettings() const

Возвращает настройки видоискателя, используемые камерой.

Настройки могут изменяться при запуске камеры, например, если настройки видоискателя не определены или если установлены недопустимые значения.

Если настройки видоискателя не поддерживаются камерой, всегда возвращается объект QCameraViewfinderSettings со значением null.

Эта функция была добавлена в Qt 5.5.

См. также setViewfinderSettings().