Класс QCameraViewfinderSettings

Класс QCameraViewfinderSettings предоставляет набор параметров для видоискателя. Подробнее...

Этот класс был представлен в Qt 5.5.

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

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

Связанные нечлены

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

Объект настроек видоискателя используется для указания настроек видоискателя, используемых объектом QCamera. Настройки видоискателя выбираются путём создания объекта QCameraViewfinderSettings, установки необходимых свойств и передачи его экземпляру QCamera с помощью функции QCamera::setViewfinderSettings().

QCameraViewfinderSettings viewfinderSettings;
viewfinderSettings.setResolution(640, 480);
viewfinderSettings.setMinimumFrameRate(15.0);
viewfinderSettings.setMaximumFrameRate(30.0);

camera->setViewfinderSettings(viewfinderSettings);

Разные камеры могут иметь разные возможности. Приложение должно запросить возможности камеры перед установкой параметров. Например, приложение должно вызвать QCamera::supportedViewfinderResolutions() перед вызовом setResolution().

См. также QCamera.

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

QCameraViewfinderSettings::QCameraViewfinderSettings(const QCameraViewfinderSettings &other)

Создаёт копию объекта настроек видоискателя other.

QCameraViewfinderSettings::QCameraViewfinderSettings()

Создаёт объект настроек видоискателя со значением по умолчанию (null).

QCameraViewfinderSettings &QCameraViewfinderSettings::operator=(QCameraViewfinderSettings &&other)

Перемещает значения из other в текущий объект настроек видоискателя и возвращает ссылку на этот объект.

QCameraViewfinderSettings &QCameraViewfinderSettings::operator=(const QCameraViewfinderSettings &other)

Присваивает значения из other текущему объекту настроек видоискателя.

QCameraViewfinderSettings::~QCameraViewfinderSettings()

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

bool QCameraViewfinderSettings::isNull() const

Определяет, является ли объект настроек видоискателя неинициализированным.

Возвращает true, если настройки null, и false в противном случае.

qreal QCameraViewfinderSettings::maximumFrameRate() const

Возвращает максимальную частоту кадров видоискателя в кадрах в секунду.

См. также setMaximumFrameRate() и minimumFrameRate().

qreal QCameraViewfinderSettings::minimumFrameRate() const

Возвращает минимальную частоту кадров видоискателя в кадрах в секунду.

См. также setMinimumFrameRate() и maximumFrameRate().

QSize QCameraViewfinderSettings::pixelAspectRatio() const

Возвращает соотношение сторон пикселей видоискателя.

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

QVideoFrame::PixelFormat QCameraViewfinderSettings::pixelFormat() const

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

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

QSize QCameraViewfinderSettings::resolution() const

Возвращает разрешение видоискателя.

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

void QCameraViewfinderSettings::setMaximumFrameRate(qreal rate)

Устанавливает максимальную частоту кадров видоискателя rate в кадрах в секунду.

Если максимальная частота кадров равна минимальной, частота кадров фиксирована. В противном случае фактическая частота кадров колеблется между минимальной и максимальной.

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

См. также maximumFrameRate(), setMinimumFrameRate(), и QCamera::supportedViewfinderFrameRateRanges().

void QCameraViewfinderSettings::setMinimumFrameRate(qreal rate)

Устанавливает минимальную частоту кадров видоискателя rate в кадрах в секунду.

Если минимальная частота кадров равна максимальной, частота кадров фиксирована. В противном случае фактическая частота кадров колеблется между минимальной и максимальной.

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

См. также minimumFrameRate(), setMaximumFrameRate() и QCamera::supportedViewfinderFrameRateRanges().

void QCameraViewfinderSettings::setPixelAspectRatio(const QSize &ratio)

Устанавливает аспект соотношения пикселей видоискателя ratio.

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

void QCameraViewfinderSettings::setPixelAspectRatio(int horizontal, int vertical)

Это перегруженный метод.

Устанавливает значения horizontal и vertical для аспекта соотношения пикселей видоискателя.

void QCameraViewfinderSettings::setPixelFormat(QVideoFrame::PixelFormat format)

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

Если заданный format равен QVideoFrame::Format_Invalid, бэкенд использует стандартный формат.

См. также pixelFormat() и QCamera::supportedViewfinderPixelFormats().

void QCameraViewfinderSettings::setResolution(const QSize &resolution)

Устанавливает разрешение видоискателя resolution.

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

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

См. также resolution(), QVideoEncoderSettings::setResolution(), QImageEncoderSettings::setResolution() и QCamera::supportedViewfinderResolutions().

void QCameraViewfinderSettings::setResolution(int width, int height)

Это перегруженный метод.

Устанавливает width и height разрешения видоискателя.

void QCameraViewfinderSettings::swap(QCameraViewfinderSettings &other)

Меняет местами объект настроек видоискателя с other. Эта функция очень быстрая и никогда не терпит неудачу.