Класс QCamera

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

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

Открытые типы

Свойства

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

• 1 свойство унаследовано от QMediaObject
• 1 свойство унаследовано от QObject

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

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

• 10 открытых функций унаследовано от QMediaObject
• 31 открытых функций унаследовано от QObject

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

• 1 открытый слот унаследован от QObject

Сигналы

• 6 сигналов унаследовано от QMediaObject
• 2 сигнала унаследовано от QObject

Дополнительные унаследованные члены

• 11 статических публичных членов, унаследованных от QObject
• 2 защищённых функции, унаследованные от QMediaObject
• 9 защищённых функций, унаследованных от QObject

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

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

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

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

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

См. обзор камер для получения дополнительной информации.

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

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

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

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

enum QCamera::LockChangeReason

enum QCamera::LockStatus

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

enum QCamera::LockTypeflags QCamera::LockTypes

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

enum QCamera::Position

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

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

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

enum QCamera::State

Хотя поддерживаемые настройки неизвестны в этом состоянии, разрешено устанавливать параметры захвата камеры, такие как кодек, разрешение или частота кадров.

В состоянии «Простоя» разрешается запрос возможностей камеры, установка разрешения захвата, кодеков и т. д.

В состоянии «Загружено» видоискатель не активен.

enum QCamera::Status

В зависимости от бэкенда, изменение некоторых настроек камеры, таких как режим захвата, кодеки или разрешение в ActiveState, может привести к изменению статуса камеры на LoadedStatus и StartingStatus во время применения настроек и возврату к ActiveStatus, когда камера готова.

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

QCamera::QCamera(QObject *parent = Q_NULLPTR)

Создает объект QCamera с заданным parent.

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

Создаёт объект QCamera по имени устройства deviceName и с заданным parent.

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

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

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

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

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

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

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

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

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

QCamera::~QCamera()

Удаляет объект камеры.

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

Переопределено из QMediaObject::availability().

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

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

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

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

Error QCamera::error() const

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

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

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

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

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

QString QCamera::errorString() const

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

QCameraExposure *QCamera::exposure() const

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

QCameraFocus *QCamera::focus() const

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

QCameraImageProcessing *QCamera::imageProcessing() const

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

bool QCamera::isCaptureModeSupported(CaptureModes mode) const

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

[slot] void QCamera::load()

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

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

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

[signal] void QCamera::lockFailed()

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

QCamera::LockStatus QCamera::lockStatus() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[signal] void QCamera::locked()

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

QCamera::LockTypes QCamera::requestedLocks() const

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

[slot] void QCamera::searchAndLock()

Блокирует все поддерживаемые настройки камеры.

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

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

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

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

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

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

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

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

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().

[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.

QCamera::LockTypes QCamera::supportedLocks() const

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

QList<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.

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

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

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

[slot] void QCamera::unload()

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

[slot] void QCamera::unlock()

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

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

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

QCameraViewfinderSettings QCamera::viewfinderSettings() const

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

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

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

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

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