API reference - Class QImageWriter

Notation used in Ruby API documentation

Description: Binding of QImageWriter

Sub-classes: ImageWriterError

Public constructors

new QImageWriternewConstructor QImageWriter::QImageWriter()
new QImageWriternew(QIODevice ptr device,
string format)
Constructor QImageWriter::QImageWriter(QIODevice *device, const QByteArray &format)
new QImageWriternew(string fileName,
string format = QByteArray())
Constructor QImageWriter::QImageWriter(const QString &fileName, const QByteArray &format)

Public methods

void_createEnsures the C++ object is created
void_destroyExplicitly destroys the object
[const]bool_destroyed?Returns a value indicating whether the object was already destroyed
[const]bool_is_const_object?Returns a value indicating whether the reference is a const reference
void_manageMarks the object as managed by the script side.
void_unmanageMarks the object as no longer owned by the script side.
[const]boolcanWriteMethod bool QImageWriter::canWrite()
[const]intcompressionMethod int QImageWriter::compression()
voidcompression=(int compression)Method void QImageWriter::setCompression(int compression)
[const]stringdescriptionMethod QString QImageWriter::description()
voiddescription=(string description)Method void QImageWriter::setDescription(const QString &description)
[const]QIODevice ptrdeviceMethod QIODevice *QImageWriter::device()
voiddevice=(QIODevice ptr device)Method void QImageWriter::setDevice(QIODevice *device)
[const]QImageWriter_ImageWriterErrorerrorMethod QImageWriter::ImageWriterError QImageWriter::error()
[const]stringerrorStringMethod QString QImageWriter::errorString()
[const]stringfileNameMethod QString QImageWriter::fileName()
voidfileName=(string fileName)Method void QImageWriter::setFileName(const QString &fileName)
[const]stringformatMethod QByteArray QImageWriter::format()
voidformat=(string format)Method void QImageWriter::setFormat(const QByteArray &format)
[const]floatgammaMethod float QImageWriter::gamma()
voidgamma=(float gamma)Method void QImageWriter::setGamma(float gamma)
[const]intqualityMethod int QImageWriter::quality()
voidquality=(int quality)Method void QImageWriter::setQuality(int quality)
voidsetCompression(int compression)Method void QImageWriter::setCompression(int compression)
voidsetDescription(string description)Method void QImageWriter::setDescription(const QString &description)
voidsetDevice(QIODevice ptr device)Method void QImageWriter::setDevice(QIODevice *device)
voidsetFileName(string fileName)Method void QImageWriter::setFileName(const QString &fileName)
voidsetFormat(string format)Method void QImageWriter::setFormat(const QByteArray &format)
voidsetGamma(float gamma)Method void QImageWriter::setGamma(float gamma)
voidsetQuality(int quality)Method void QImageWriter::setQuality(int quality)
voidsetText(string key,
string text)
Method void QImageWriter::setText(const QString &key, const QString &text)
[const]boolsupportsOption(const QImageIOHandler_ImageOption option)Method bool QImageWriter::supportsOption(QImageIOHandler::ImageOption option)
boolwrite(const QImage image)Method bool QImageWriter::write(const QImage &image)

Public static methods and constants

[static,const]new QImageWriter_ImageWriterError ptrDeviceErrorEnum constant QImageWriter::DeviceError
[static,const]new QImageWriter_ImageWriterError ptrUnknownErrorEnum constant QImageWriter::UnknownError
[static,const]new QImageWriter_ImageWriterError ptrUnsupportedFormatErrorEnum constant QImageWriter::UnsupportedFormatError
string[]supportedImageFormatsStatic method QList<QByteArray> QImageWriter::supportedImageFormats()

Deprecated methods (protected, public, static, non-static and constructors)

voidcreateUse of this method is deprecated. Use _create instead
voiddestroyUse of this method is deprecated. Use _destroy instead
[const]booldestroyed?Use of this method is deprecated. Use _destroyed? instead
[const]boolis_const_object?Use of this method is deprecated. Use _is_const_object? instead

Detailed description

[static,const] new QImageWriter_ImageWriterError ptr DeviceError

Description: Enum constant QImageWriter::DeviceError

[static,const] new QImageWriter_ImageWriterError ptr UnknownError

Description: Enum constant QImageWriter::UnknownError

[static,const] new QImageWriter_ImageWriterError ptr UnsupportedFormatError

Description: Enum constant QImageWriter::UnsupportedFormatError

void _create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

void _destroy

Description: Explicitly destroys the object

Explicitly destroys the object on C++ side if it was owned by the script interpreter. Subsequent access to this object will throw an exception. If the object is not owned by the script, this method will do nothing.

[const] bool _destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

[const] bool _is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

void _manage

Description: Marks the object as managed by the script side.

After calling this method on an object, the script side will be responsible for the management of the object. This method may be called if an object is returned from a C++ function and the object is known not to be owned by any C++ instance. If necessary, the script side may delete the object if the script's reference is no longer required.

Usually it's not required to call this method. It has been introduced in version 0.24.

void _unmanage

Description: Marks the object as no longer owned by the script side.

Calling this method will make this object no longer owned by the script's memory management. Instead, the object must be managed in some other way. Usually this method may be called if it is known that some C++ object holds and manages this object. Technically speaking, this method will turn the script's reference into a weak reference. After the script engine decides to delete the reference, the object itself will still exist. If the object is not managed otherwise, memory leaks will occur.

Usually it's not required to call this method. It has been introduced in version 0.24.

[const] bool canWrite

Description: Method bool QImageWriter::canWrite()

[const] int compression

Description: Method int QImageWriter::compression()

Python specific notes:

The object exposes a readable attribute 'compression'. This is the getter.

void compression=(int compression)

Description: Method void QImageWriter::setCompression(int compression)

Python specific notes:

The object exposes a writable attribute 'compression'. This is the setter.

void create

Description: Ensures the C++ object is created

Use of this method is deprecated. Use _create instead

[const] string description

Description: Method QString QImageWriter::description()

Python specific notes:

The object exposes a readable attribute 'description'. This is the getter.

void description=(string description)

Description: Method void QImageWriter::setDescription(const QString &description)

Python specific notes:

The object exposes a writable attribute 'description'. This is the setter.

void destroy

Description: Explicitly destroys the object

Use of this method is deprecated. Use _destroy instead

[const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

Use of this method is deprecated. Use _destroyed? instead

[const] QIODevice ptr device

Description: Method QIODevice *QImageWriter::device()

Python specific notes:

The object exposes a readable attribute 'device'. This is the getter.

void device=(QIODevice ptr device)

Description: Method void QImageWriter::setDevice(QIODevice *device)

Python specific notes:

The object exposes a writable attribute 'device'. This is the setter.

[const] QImageWriter_ImageWriterError error

Description: Method QImageWriter::ImageWriterError QImageWriter::error()

[const] string errorString

Description: Method QString QImageWriter::errorString()

[const] string fileName

Description: Method QString QImageWriter::fileName()

Python specific notes:

The object exposes a readable attribute 'fileName'. This is the getter.

void fileName=(string fileName)

Description: Method void QImageWriter::setFileName(const QString &fileName)

Python specific notes:

The object exposes a writable attribute 'fileName'. This is the setter.

[const] string format

Description: Method QByteArray QImageWriter::format()

Python specific notes:

The object exposes a readable attribute 'format'. This is the getter.

void format=(string format)

Description: Method void QImageWriter::setFormat(const QByteArray &format)

Python specific notes:

The object exposes a writable attribute 'format'. This is the setter.

[const] float gamma

Description: Method float QImageWriter::gamma()

Python specific notes:

The object exposes a readable attribute 'gamma'. This is the getter.

void gamma=(float gamma)

Description: Method void QImageWriter::setGamma(float gamma)

Python specific notes:

The object exposes a writable attribute 'gamma'. This is the setter.

[const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

Use of this method is deprecated. Use _is_const_object? instead

[static] new QImageWriter new

Description: Constructor QImageWriter::QImageWriter()

This method creates an object of class QImageWriter.

Python specific notes:

This method is the default initializer of the object

[static] new QImageWriter new(QIODevice ptr device,string format)

Description: Constructor QImageWriter::QImageWriter(QIODevice *device, const QByteArray &format)

This method creates an object of class QImageWriter.

Python specific notes:

This method is the default initializer of the object

[static] new QImageWriter new(string fileName,string format = QByteArray())

Description: Constructor QImageWriter::QImageWriter(const QString &fileName, const QByteArray &format)

This method creates an object of class QImageWriter.

Python specific notes:

This method is the default initializer of the object

[const] int quality

Description: Method int QImageWriter::quality()

Python specific notes:

The object exposes a readable attribute 'quality'. This is the getter.

void quality=(int quality)

Description: Method void QImageWriter::setQuality(int quality)

Python specific notes:

The object exposes a writable attribute 'quality'. This is the setter.

void setCompression(int compression)

Description: Method void QImageWriter::setCompression(int compression)

Python specific notes:

The object exposes a writable attribute 'compression'. This is the setter.

void setDescription(string description)

Description: Method void QImageWriter::setDescription(const QString &description)

Python specific notes:

The object exposes a writable attribute 'description'. This is the setter.

void setDevice(QIODevice ptr device)

Description: Method void QImageWriter::setDevice(QIODevice *device)

Python specific notes:

The object exposes a writable attribute 'device'. This is the setter.

void setFileName(string fileName)

Description: Method void QImageWriter::setFileName(const QString &fileName)

Python specific notes:

The object exposes a writable attribute 'fileName'. This is the setter.

void setFormat(string format)

Description: Method void QImageWriter::setFormat(const QByteArray &format)

Python specific notes:

The object exposes a writable attribute 'format'. This is the setter.

void setGamma(float gamma)

Description: Method void QImageWriter::setGamma(float gamma)

Python specific notes:

The object exposes a writable attribute 'gamma'. This is the setter.

void setQuality(int quality)

Description: Method void QImageWriter::setQuality(int quality)

Python specific notes:

The object exposes a writable attribute 'quality'. This is the setter.

void setText(string key,string text)

Description: Method void QImageWriter::setText(const QString &key, const QString &text)

[static] string[] supportedImageFormats

Description: Static method QList<QByteArray> QImageWriter::supportedImageFormats()

This method is static and can be called without an instance.

[const] bool supportsOption(const QImageIOHandler_ImageOption option)

Description: Method bool QImageWriter::supportsOption(QImageIOHandler::ImageOption option)

bool write(const QImage image)

Description: Method bool QImageWriter::write(const QImage &image)