Класс QImageIOPlugin

Класс QImageIOPlugin определяет интерфейс для написания плагина формата изображения. Подробнее...

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

Примечание: Все функции в этом классе являются взаимоисключающими.

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

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

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

QImageIOPlugin является фабрикой для создания объектов QImageIOHandler, которые используются внутри QImageReader и QImageWriter для добавления поддержки различных форматов изображений в Qt.

Написание плагина ввода-вывода изображений достигается путем наследования от этого базового класса, переопределения чистых виртуальных функций возможности() и создать(), и экспорта класса с помощью макроса Q_PLUGIN_METADATA(). Подробнее см. Как создать плагины Qt.

Плагин формата изображения может поддерживать три возможности: чтение (МожноЧитать), запись (МожноЗаписать) и чтение по частям (МожноЧитатьПоЧастям). Переопределите возможности() в своем подклассе, чтобы показать возможности вашего формата изображения.

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

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

{
  "Keys": [ "jpg", "jpeg" ],
  "MimeTypes": [ "image/jpeg", "image/jpeg" ]
}

Различные плагины могут поддерживать различные возможности. Например, у вас может быть один плагин, который поддерживает чтение формата GIF, и другой, который поддерживает запись. Qt выберет соответствующий плагин для задачи, в зависимости от возвращаемого значения возможности(). Если несколько плагинов поддерживают одну и ту же возможность, Qt произвольно выберет один.

См. также QImageIOHandler и Как создать плагины Qt.

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

перечисление QImageIOPlugin::Возможностьфлаги QImageIOPlugin::Возможности

Это перечисление описывает возможности QImageIOPlugin.

Тип Возможности является типом-синонимом QFlags<Возможность>. Он хранит комбинацию значений Возможности.

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

QImageIOPlugin::QImageIOPlugin(QObject *parent = nullptr)

Создаёт плагин изображений с указанным parent. Это вызывается автоматически сгенерированным кодом moc, который экспортирует плагин.

[virtual] QImageIOPlugin::~QImageIOPlugin()

Удаляет плагин формата изображения.

Вам никогда не придётся вызывать это явно. Qt удаляет плагин автоматически, когда он больше не используется.

[pure virtual] QImageIOPlugin::Возможности QImageIOPlugin::возможности(QIODevice *device, const QByteArray &format) const

Возвращает возможности плагина, основанные на данных в device и формате format. Если device является 0, он должен просто сообщить, может ли формат читаться или записываться. В противном случае он должен попытаться определить, может ли заданный формат (или любой формат, поддерживаемый плагином, если format пусто) читаться или записываться в device. Это должно происходить без изменения состояния device (как правило, используя QIODevice::peek()).

Например, если QImageIOPlugin поддерживает формат BMP, format пустой или "bmp", и данные в устройстве начинаются с символов "BM", эта функция должна вернуть МожноЧитать. Если format пустая, device является 0 и обработчик поддерживает чтение и запись, эта функция должна вернуть МожноЧитать | МожноЗаписать.

Имена форматов всегда задаются строчными буквами.

[pure virtual] QImageIOHandler *QImageIOPlugin::создать(QIODevice *device, const QByteArray &format = QByteArray()) const

Создаёт и возвращает подкласс QImageIOHandler с установленными device и format. format должен поступать из значений, указанных в записи "Keys" в метаданных плагина, или быть пустым. Если он пустой, данные в device должны быть распознаны методом возможности() (с аналогичным пустым форматом).

Имена форматов всегда задаются строчными буквами.