Класс QCamera

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

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

Типы публичного доступа

Свойства

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

Public Slots

Signals

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

QCamera может использоваться в QMediaCaptureSession для записи видео и получения изображений.

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

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
    if (cameraDevice.description() == "mycamera")
        camera = new QCamera(cameraDevice);
}

На оборудовании, которое это поддерживает, QCamera позволяет настраивать фокусировку и масштабирование. Это также включает функциональность, такую как режим «Макро» для работы с близкими объектами (например, считывание штрихкодов или распознавание букв) или «наведение на фокус» — указание интересной области изображения для того, чтобы оборудование пыталось сфокусироваться на ней.

camera->setFocusPointMode(QCamera::FocusModeManual);
camera->setCustomFocusPoint(QPointF(0.25f, 0.75f)); // A point near the bottom left, 25% away from the corner, near that shiny vase

Методы minimumZoomFactor() и maximumZoomFactor() предоставляют диапазон поддерживаемых коэффициентов масштабирования. Метод zoomTo() позволяет изменять коэффициент масштабирования.

camera->setZoomFactor(3.0);

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

Вы можете контролировать многие из этих шагов обработки с помощью свойств камеры. Например, вы можете установить баланс белого (или цветовую температуру), используемый для обработки изображений:

camera->setWhiteBalanceMode(QCamera::WhiteBalanceFluorescent);

Дополнительную информацию об обработке изображений кадров камеры см. в разделе Обработка изображений камеры.

См. Обзор камеры для получения дополнительной информации.

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

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

Это перечисление содержит последний код ошибки.

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

перечисление QCamera::Featureфлаги QCamera::Features

Описание набора функций, поддерживаемых камерой. Возвращаемое значение может быть комбинацией:

Тип Features — псевдоним для QFlags<Feature>. Он хранит комбинацию Feature-значений с операцией «ИЛИ».

enum QCamera::FlashMode

enum QCamera::FocusMode

enum QCamera::TorchMode

enum QCamera::WhiteBalanceMode

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

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

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

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

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

QCamera::QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)

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

QCamera::QCamera(QObject *parent = nullptr)

Создаёт QCamera с parent.

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

[signal] void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

Этот сигнал генерируется при изменении состояния ошибки на error. Описание ошибки предоставляется как errorString.

[signal] void QCamera::exposureCompensationChanged(float value)

Сигнал, генерируемый при изменении экспозиционной компенсации на value.

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

[signal] void QCamera::exposureTimeChanged(float speed)

Сигнализирует изменение выдержки камеры на speed.

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

[signal] void QCamera::flashReady(bool ready)

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

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

[signal] void QCamera::isoSensitivityChanged(int value)

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

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

[slot] void QCamera::setActive(bool active)

Включает камеру, если active равно true, или выключает, если оно равно false.

Примечание: Функция-сеттер для свойства active.

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

[slot] void QCamera::setAutoExposureTime()

Использовать автоматически рассчитанное время экспозиции

[slot] void QCamera::setAutoIsoSensitivity()

Включить автоматическую чувствительность

[slot] void QCamera::setColorTemperature(int colorTemperature)

Устанавливает ручную балансировку белого цвета на colorTemperature. Используется, когда whiteBalanceMode() установлена в WhiteBalanceManual. Единицы — Кельвин.

Установка цветовой температуры повлияет только в том случае, если поддерживается WhiteBalanceManual. В этом случае установка температуры больше 0 автоматически установит режим балансировки белого цвета на WhiteBalanceManual. Установка температуры в 0 сбросит режим балансировки белого цвета на WhiteBalanceAuto.

Примечание: Функция-сеттер для свойства colorTemperature.

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

[slot] void QCamera::setManualExposureTime(float seconds)

Установить ручное время экспозиции на seconds

Примечание: Функция-сеттер для свойства manualExposureTime.

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

[slot] void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

Устанавливает балансировку белого цвета на mode.

Примечание: Функция-сеттер для свойства whiteBalanceMode.

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

[slot] void QCamera::start()

Запускает камеру.

То же, что и setActive(true).

Если камера не может быть запущена по какой-либо причине, генерируется сигнал errorOccurred().

[slot] void QCamera::stop()

Останавливает камеру. То же, что и setActive(false).

[slot] void QCamera::zoomTo(float factor, float rate)

Масштабирует до коэффициента масштабирования factor с использованием rate.

rate задаётся в степенях двойки в секунду. При значении 1 потребуется 2 секунды, чтобы перейти от коэффициента масштабирования 1 к 4.

[virtual] QCamera::~QCamera()

Уничтожает объект камеры.

QCameraDevice QCamera::cameraDevice() const

Возвращает объект QCameraDevice, связанный с этой камерой.

Примечание: Функция-геттер для свойства cameraDevice.

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

QCameraFormat QCamera::cameraFormat() const

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

Примечание: Функция-геттер для свойства cameraFormat.

См. также setCameraFormat() и QCameraDevice::videoFormats.

QMediaCaptureSession *QCamera::captureSession() const

Возвращает сеанс захвата, к которому подключена эта камера, или nullptr, если камера не подключена к сеансу захвата.

Используйте QMediaCaptureSession::setCamera(), чтобы подключить камеру к сеансу.

int QCamera::colorTemperature() const

Возвращает текущую цветовую температуру, если текущий режим балансировки белого цвета — WhiteBalanceManual. Для других режимов возвращаемое значение неопределено.

Примечание: Функция-геттер для свойства colorTemperature.

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

QCamera::Error QCamera::error() const

Возвращает состояние ошибки камеры.

Примечание: Функция-геттер для свойства error.

QString QCamera::errorString() const

Возвращает читаемую человеком строку, описывающую состояние ошибки камеры.

Примечание: Функция-геттер для свойства errorString.

float QCamera::exposureTime() const

Возвращает текущее время экспозиции в секундах.

Примечание: Функция-геттер для свойства exposureTime.

QPointF QCamera::focusPoint() const

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

Примечание: Функция-геттер для свойства focusPoint.

bool QCamera::isActive() const

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

Примечание: Функция-геттер для свойства active.

bool QCamera::isAvailable() const

Возвращает true, если камера может быть использована.

[invokable] bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

Возвращает true, если режим экспозиции mode поддерживается.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

Возвращает true, если режим вспышки mode поддерживается.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] bool QCamera::isFlashReady() const

Возвращает true, если вспышка заряжена.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

Примечание: Функция-геттер для свойства flashReady.

[invokable] bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

Возвращает true, если режим фокусировки mode поддерживается камерой.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

Возвращает true, если режим фонарика mode поддерживается.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

Возвращает true, если режим баланса белого mode поддерживается.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

float QCamera::manualExposureTime() const

Возвращает время ручной экспозиции в секундах или -1, если камера использует автоматические значения времени экспозиции.

Примечание: Функция-геттер для свойства manualExposureTime.

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

float QCamera::maximumExposureTime() const

Максимальное время экспозиции в секундах.

int QCamera::maximumIsoSensitivity() const

Возвращает максимальную чувствительность ISO, поддерживаемую камерой.

float QCamera::maximumZoomFactor() const

Возвращает максимальный коэффициент масштабирования.

Будет 1.0 на камерах, которые не поддерживают масштабирование.

Примечание: Функция-геттер для свойства maximumZoomFactor.

float QCamera::minimumExposureTime() const

Минимальное время экспозиции в секундах.

int QCamera::minimumIsoSensitivity() const

Возвращает минимальную чувствительность ISO, поддерживаемую камерой.

float QCamera::minimumZoomFactor() const

Возвращает минимальный коэффициент масштабирования.

Будет 1.0 на камерах, которые не поддерживают масштабирование.

Примечание: Функция-геттер для свойства minimumZoomFactor.

void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)

Подключает объект камеры к физическому устройству камеры, описанному в cameraDevice. Использование объекта QCameraDevice с конструктором по умолчанию в качестве cameraDevice подключит камеру к устройству системы по умолчанию.

Примечание: Функция-сеттер для свойства cameraDevice.

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

void QCamera::setCameraFormat(const QCameraFormat &format)

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

Примечание: Функция-сеттер для свойства cameraFormat.

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

void QCamera::setZoomFactor(float factor)

Масштабирует до коэффициента масштабирования factor со скоростью 1 единица коэффициента в секунду.

Примечание: Функция-сеттер для свойства zoomFactor.

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

QCamera::Features QCamera::supportedFeatures() const

Возвращает поддерживаемые данной камерой функции.

Примечание: Функция-геттер для свойства supportedFeatures.

См. также QCamera::Feature.

QCamera::WhiteBalanceMode QCamera::whiteBalanceMode() const

Возвращает используемый режим баланса белого.

Примечание: Функция-геттер для свойства whiteBalanceMode.

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