Класс QCamera

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

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

Типы

Свойства

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

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

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

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

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

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

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

Сигналы

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

Статические публичные члены

• 9 static public members унаследованных от QObject

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

• 2 protected функции унаследованные от QMediaObject
• 9 protected функции унаследованные от 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 — это typedef для QFlags<CaptureMode>. Он хранит логическое ИЛИ сочетание значений CaptureMode.

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

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

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

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

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

Тип LockTypes — это typedef для 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().