Класс QImageCapture

Класс QImageCapture используется для записи медиаконтента. Подробнее...

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

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

Свойства

• fileFormat : const FileFormat
• metaData : QMediaMetaData
• quality : const Качество
• readyForCapture : const bool

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

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

Сигналы

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

Класс QImageCapture — это класс высокого уровня для записи изображений. Он не предназначен для самостоятельного использования, а для доступа к функциям записи медиа других медиаобъектов, таких как QCamera.

QMediaCaptureSession captureSession;
camera = new QCamera;
captureSession.setCamera(camera);

QVideoWidget *preview = new QVideoWidget();
preview->show();
captureSession.setVideoOutput(preview);

imageCapture = new QImageCapture(camera);
captureSession.setImageCapture(imageCapture);

camera->start();
//on shutter button pressed
imageCapture->capture();

См. также QCamera.

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

Перечисление QImageCapture::Ошибка

Перечисление QImageCapture::Качество

Перечисляет уровни кодирования качества.

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

QImageCapture::QImageCapture(QObject *parent = nullptr)

Создаёт объект захвата изображения, от parent, который может захватывать отдельные неподвижные изображения, создаваемые камерой.

Для захвата изображений необходимо подключить объект захвата изображения и QCamera к сессии захвата.

[slot] int QImageCapture::capture()

Захватывает изображение и делает его доступным как QImage. Эта операция в большинстве случаев асинхронна, за которой следуют сигналы QImageCapture::imageExposed(), QImageCapture::imageCaptured() или QImageCapture::error().

QImageCapture::capture возвращает параметр идентификатора захвата, используемый с сигналами imageExposed(), imageCaptured() и imageSaved().

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

[slot] int QImageCapture::captureToFile(const QString &file = QString())

Захватывает изображение и сохраняет его в file. Эта операция в большинстве случаев асинхронна, за которой следуют сигналы QImageCapture::imageExposed(), QImageCapture::imageCaptured(), QImageCapture::imageSaved() или QImageCapture::error().

Если в качестве file передано пустое значение, бэкенд камеры выбирает стандартное местоположение и схему именования для фотографий в системе, если указано только имя файла без полного пути, изображение будет сохранено в стандартном каталоге, и полный путь будет указан в сигналах imageCaptured() и imageSaved().

QCamera сохраняет все параметры захвата, такие как параметры экспозиции или параметры обработки изображений, поэтому изменения параметров камеры после вызова capture() не влияют на предыдущие запросы захвата.

QImageCapture::capture возвращает параметр идентификатора захвата, используемый с сигналами imageExposed(), imageCaptured() и imageSaved().

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

[signal] void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)

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

[signal] void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)

Сигнал, генерируемый, когда QImageCapture::CaptureToBuffer установлен и кадр frame с запросом id доступен.

[signal] void QImageCapture::imageCaptured(int id, const QImage &preview)

Сигнал генерируется, когда кадр с запросом id был захвачен, но ещё не обработан и сохранён. Кадр preview может быть отображён пользователю.

[signal] void QImageCapture::imageExposed(int id)

Сигнал генерируется, когда кадр с запросом id был подвергнут экспозиции.

[signal] void QImageCapture::imageSaved(int id, const QString &fileName)

Сигнал генерируется, когда QImageCapture::CaptureToFile установлен и кадр с запросом id был сохранён в fileName.

[signal] void QImageCapture::readyForCaptureChanged(bool ready)

Сигнализирует о том, что состояние готовности камеры к захвату ready изменилось.

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

[virtual] QImageCapture::~QImageCapture()

Удаляет объект захвата изображений.

void QImageCapture::addMetaData(const QMediaMetaData &metaData)

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

QMediaCaptureSession *QImageCapture::captureSession() const

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

Используйте QMediaCaptureSession::setImageCapture() для подключения захвата изображения к сеансу.

QImageCapture::Error QImageCapture::error() const

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

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

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

QString QImageCapture::errorString() const

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

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

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

bool QImageCapture::isAvailable() const

Возвращает true, если служба захвата изображений готова к использованию.

QSize QImageCapture::resolution() const

Возвращает разрешение закодированного изображения.

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

void QImageCapture::setFileFormat(QImageCapture::FileFormat format)

Устанавливает формат изображения format.

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

void QImageCapture::setMetaData(const QMediaMetaData &metaData)

Заменяет любые существующие метаданные, которые будут встроены в захваченное изображение, на заданные metaData.

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

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

void QImageCapture::setQuality(QImageCapture::Quality quality)

Устанавливает качество кодирования изображения quality.

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

void QImageCapture::setResolution(const QSize &resolution)

Устанавливает разрешение кодируемого изображения.

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

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

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

Устанавливает ширину и высоту разрешения кодируемого изображения.

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