Класс QPlatformImageCapture
Класс QPlatformImageCapture предоставляет интерфейс управления для сервисов захвата изображений. Подробнее...
| Заголовок: | #include <QPlatformImageCapture> |
| CMake: | find_package(Qt6 COMPONENTS Multimedia REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Наследует: | QObject |
Этот класс устарел. Не рекомендуется использовать его в новом коде.
Открытые функции
| virtual int | capture(const QString &fileName) = 0 |
| virtual QImageEncoderSettings | imageSettings() const = 0 |
| virtual bool | isReadyForCapture() const = 0 |
| virtual void | setImageSettings(const QImageEncoderSettings &settings) = 0 |
Сигналы
| void | error(int id, int error, const QString &errorString) |
| void | imageAvailable(int requestId, const QVideoFrame &buffer) |
| void | imageCaptured(int requestId, const QImage &preview) |
| void | imageExposed(int requestId) |
| void | imageMetadataAvailable(int id, const QMediaMetaData &) |
| void | imageSaved(int requestId, const QString &fileName) |
| void | readyForCaptureChanged(bool ready) |
Защищенные функции
| QPlatformImageCapture(QImageCapture *parent = nullptr) |
Подробное описание
Документация по функциям-членам
[protected] QPlatformImageCapture::QPlatformImageCapture(QImageCapture *parent = nullptr)
Создаёт новый объект управления захватом изображений с заданным parent
[signal] void QPlatformImageCapture::error(int id, int error, const QString &errorString)
Сигнализирует об ошибке запроса захвата id с кодом ошибки error и сообщением errorString.
См. также QImageCapture::Error.
[signal] void QPlatformImageCapture::imageAvailable(int requestId, const QVideoFrame &buffer)
Сигнализирует о доступности полученного buffer с идентификатором requestId.
[signal] void QPlatformImageCapture::imageCaptured(int requestId, const QImage &preview)
Сигнализирует о том, что изображение с идентификатором requestId было захвачено, и preview доступно.
[signal] void QPlatformImageCapture::imageExposed(int requestId)
Сигнализирует о том, что изображение с идентификатором requestId было только что экспонировано. Этот сигнал может использоваться для звука затвора или других индикаций.
[signal] void QPlatformImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &)
Сигнализирует о доступности метаданных изображения с идентификатором запроса id.
Этот сигнал должен излучаться между сигналами imageExposed и imageSaved.
[signal] void QPlatformImageCapture::imageSaved(int requestId, const QString &fileName)
Сигнализирует о том, что захваченное изображение с идентификатором requestId было сохранено в файл fileName.
[signal] void QPlatformImageCapture::readyForCaptureChanged(bool ready)
Сигнализирует о том, что состояние готовности управления захватом ready изменилось.
[pure virtual] int QPlatformImageCapture::capture(const QString &fileName)
Инициирует захват изображения в файл fileName. fileName может быть относительным или пустым; в этом случае служба должна использовать специфичную для системы схему именования файлов и расположения.
Сервис камеры должен сохранять все параметры захвата, такие как настройки экспозиции или параметры обработки изображений, поэтому изменения параметров камеры после вызова capture() не влияют на предыдущие запросы захвата.
Возвращает идентификатор запроса захвата, используемый позже с сигналами imageExposed(), imageCaptured() и imageSaved().
[pure virtual] QImageEncoderSettings QPlatformImageCapture::imageSettings() const
Возвращает текущие используемые настройки кодировщика изображений.
Возвращаемое значение может отличаться от значения, переданного в setImageSettings(), если настройки содержат значения по умолчанию или неопределённые параметры.
См. также setImageSettings().
[pure virtual] bool QPlatformImageCapture::isReadyForCapture() const
Определяет, готова ли система захвата для немедленного выполнения захвата (все необходимые ресурсы для захвата изображения выделены, оборудование инициализировано, вспышка заряжена и т.д.).
Возвращает true, если камера готова к захвату; и false, если нет.
Допустимо вызывать capture() в то время, когда состояние камеры — QCamera::ActiveStatus, независимо от значения свойства isReadyForCapture. Если камера не готова к немедленному захвату изображения, запрос захвата добавляется в очередь с сопутствующими настройками камеры, которые будут выполнены как можно скорее.
[pure virtual] void QPlatformImageCapture::setImageSettings(const QImageEncoderSettings &settings)
Устанавливает выбранные настройки кодировщика изображений settings.
См. также imageSettings().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qplatformimagecapture.html