Класс QCamera

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

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

Типы

Свойства

• captureMode : QCamera::РежимыЗахвата
• lockStatus : const QCamera::СтатусБлокировки
• state : const QCamera::Состояние
• status : const 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

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

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

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

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

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

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

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

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

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

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

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

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

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

enum QCamera::Status

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

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

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::LoadedStatus.

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

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

[signal] void QCamera::lockFailed()

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

[signal] void QCamera::lockStatusChanged(QCamera::LockType lock, QCamera::LockStatus status, QCamera::LockChangeReason 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)

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

Примечание: Сигнал 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)

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

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

Сигнал 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)

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

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

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

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

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

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

[slot] void QCamera::stop()

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

[slot] void QCamera::unload()

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

[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 в качестве видоискателя камеры. Предыдущий установленный видоискатель отсоединяется.

void QCamera::setViewfinder(QGraphicsVideoItem *viewfinder)

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

void QCamera::setViewfinder(QAbstractVideoSurface *surface)

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

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

void QCamera::setViewfinderSettings(const QCameraViewfinderSettings &settings)

Устанавливает настройки видоискателя.

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

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

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

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

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

QCameraViewfinderSettings QCamera::viewfinderSettings() const

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

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

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

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

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