- Qt 5.15
- Qt GUI
- C++ Classes
- QPictureFormatPlugin
- Qt 5.15.19 Reference Documentation

# QPictureFormatPlugin Class

The QPictureFormatPlugin class provides an abstract base for custom picture format plugins. More...

Header: | #include <QPictureFormatPlugin>
qmake: | QT += gui

This class is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.

- List of all members, including inherited members

## Public Functions

| QPictureFormatPlugin(QObject *parent = nullptr)
virtual | ~QPictureFormatPlugin()
virtual bool | installIOHandler(const QString &format) = 0
virtual bool | loadPicture(const QString &format, const QString &fileName, QPicture *picture)
virtual bool | savePicture(const QString &format, const QString &fileName, const QPicture &picture)

## Detailed Description

The picture format plugin is a simple plugin interface that makes it easy to create custom picture formats that can be used transparently by applications.

Writing an picture format plugin is achieved by subclassing this base class, reimplementing the pure virtual functions loadPicture(), savePicture(), and installIOHandler(), and exporting the class with the Q_PLUGIN_METADATA() macro.

The json file containing the metadata should contain one entry with the list of picture formats supported by the plugin:

     { "Keys": [ "mypictureformat" ] }

See also How to Create Qt Plugins.

## Member Function Documentation

### QPictureFormatPlugin::QPictureFormatPlugin(QObject *parent = nullptr)

Constructs an picture format plugin with the given parent. This is invoked automatically by the moc generated code that exports the plugin.

### `[virtual]` QPictureFormatPlugin::~QPictureFormatPlugin()

Destroys the picture format plugin.

You never have to call this explicitly. Qt destroys a plugin automatically when it is no longer used.

### `[pure virtual]` bool QPictureFormatPlugin::installIOHandler(const QString &format)

Installs a QPictureIO picture I/O handler for the picture format format. Returns `true` on success.

### `[virtual]` bool QPictureFormatPlugin::loadPicture(const QString &format, const QString &fileName, QPicture *picture)

Loads the picture stored in the file called fileName, with the given format, into *picture. Returns `true` on success; otherwise returns `false`.

See also savePicture().

### `[virtual]` bool QPictureFormatPlugin::savePicture(const QString &format, const QString &fileName, const QPicture &picture)

Saves the given picture into the file called fileName, using the specified format. Returns `true` on success; otherwise returns `false`.

See also loadPicture().