Класс QCamera

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

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

Публичные типы

Свойства

• captureMode : QCamera::CaptureModes
• lockStatus : const QCamera::LockStatus
• состояние : const QCamera::State
• статус : const QCamera::Status

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

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

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

• 10 публичных функций унаследовано от QMediaObject
• 34 публичных функций унаследовано от QObject

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

• 1 public slot унаследованный от QObject

Сигналы

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

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

• 1 public переменная, унаследованная от QObject
• 10 статических public членов, унаследованных от QObject
• 2 защищённых функций, унаследованных от QMediaObject
• 9 защищённых функций, унаследованных от QObject
• 2 защищённых переменных, унаследованных от 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

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

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

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

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

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

Перечисление QCamera::LockType

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

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

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

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

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

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

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

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

Видоискатель не активен в состоянии загрузки.

enum QCamera::Status

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

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

QCamera::QCamera(QObject *parent = nullptr)

Создаёт QCamera с parent.

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

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

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

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

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

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

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

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

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

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

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

[virtual] QCamera::~QCamera()

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

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

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

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

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

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

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

QCamera::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(QCamera::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.

Если некоторые параметры не указаны или передан 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<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.

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

Эта функция была введена в 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 со значением null.

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

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