Класс QCamera

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

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

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

Свойства

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

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

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

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

Сигналы

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

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

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

const QList<QCameraInfo> cameras = QCameraInfo::availableCameras();
for (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

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

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

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::errorOccurred(QCamera::Error value)

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

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

[slot] void QCamera::load()

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

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

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

/sa QCamera::UnloadedState

[signal] void QCamera::lockFailed()

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

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

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

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

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

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

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

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

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

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

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

[signal] void QCamera::locked()

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

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

Заблокирует настройки камеры с запрошенными 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, если камера запущена успешно, в противном случае генерируется сигнал errorOccurred().

Пока состояние камеры изменено на 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.

В этом состоянии камера по-прежнему потребляет энергию.

См. также unload() и QCamera::UnloadedState.

[slot] void QCamera::unload()

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

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

void QCamera::setViewfinder(QGraphicsVideoItem *viewfinder)

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

void QCamera::setViewfinder(QAbstractVideoSurface *surface)

Устанавливает видео surface в качестве viewfinder камеры.

Если viewfinder уже установлен на камере, новый surface заменит его.

void QCamera::setViewfinderSettings(const QCameraViewfinderSettings &settings)

Устанавливает настройки settings viewfinder.

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

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

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

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

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

QCameraViewfinderSettings QCamera::viewfinderSettings() const

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

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

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

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

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