Класс QCamera

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

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

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

Свойства

• captureMode : QCamera::CaptureModes
• lockStatus : const QCamera::LockStatus
• state : const QCamera::State
• status : const QCamera::Status

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

Публичные функции

Реализованные публичные функции

• 10 public functions inherited from QMediaObject
• 32 public functions inherited from QObject

Публичные слоты

• 1 public slot inherited from 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()

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

[override 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 перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в данном примере:

connect(camera, QOverload<QCamera::Error>::of(&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.

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

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

[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 перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию Qt предоставляет удобную вспомогательную функцию для получения указателя на функцию, как показано в данном примере:

connect(camera, QOverload<QCamera::LockStatus, QCamera::LockChangeReason>::of(&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 перегружен в этом классе. Для подключения к этому сигналу с помощью синтаксиса указателя на функцию 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::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.

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

Если камера используется для захвата видео или изображений, настройки видоискателя могут быть проигнорированы, если они конфликтуют с настройками захвата. Вы можете проверить фактические настройки видоискателя, когда камера находится в состоянии 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().