KLayout 0.29.1 (2024-05-13 48b32733c) [master]

API reference - Class QImageWriter

Notation used in Ruby API documentation

Module: QtGui

Description: Binding of QImageWriter

Sub-classes: ImageWriterError, QFlags_ImageWriterError

Public constructors

new QImageWriternewConstructor QImageWriter::QImageWriter()
new QImageWriternew(QIODevice ptr device,
bytes format)
Constructor QImageWriter::QImageWriter(QIODevice *device, const QByteArray &format)
new QImageWriternew(string fileName,
bytes 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]bytesformatMethod QByteArray QImageWriter::format()
voidformat=(bytes 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(bytes 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]QImageWriter_ImageWriterErrorDeviceErrorEnum constant QImageWriter::DeviceError
[static,const]QImageWriter_ImageWriterErrorUnknownErrorEnum constant QImageWriter::UnknownError
[static,const]QImageWriter_ImageWriterErrorUnsupportedFormatErrorEnum constant QImageWriter::UnsupportedFormatError
bytes[]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

DeviceError

Signature: [static,const] QImageWriter_ImageWriterError DeviceError

Description: Enum constant QImageWriter::DeviceError

Python specific notes:
The object exposes a readable attribute 'DeviceError'. This is the getter.

UnknownError

Signature: [static,const] QImageWriter_ImageWriterError UnknownError

Description: Enum constant QImageWriter::UnknownError

Python specific notes:
The object exposes a readable attribute 'UnknownError'. This is the getter.

UnsupportedFormatError

Signature: [static,const] QImageWriter_ImageWriterError UnsupportedFormatError

Description: Enum constant QImageWriter::UnsupportedFormatError

Python specific notes:
The object exposes a readable attribute 'UnsupportedFormatError'. This is the getter.

_create

Signature: 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.

_destroy

Signature: 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.

_destroyed?

Signature: [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.

_is_const_object?

Signature: [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.

_manage

Signature: 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.

_unmanage

Signature: 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.

canWrite

Signature: [const] bool canWrite

Description: Method bool QImageWriter::canWrite()

compression

Signature: [const] int compression

Description: Method int QImageWriter::compression()

Python specific notes:
The object exposes a readable attribute 'compression'. This is the getter.

compression=

Signature: 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.

create

Signature: void create

Description: Ensures the C++ object is created

Use of this method is deprecated. Use _create instead

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.

description

Signature: [const] string description

Description: Method QString QImageWriter::description()

Python specific notes:
The object exposes a readable attribute 'description'. This is the getter.

description=

Signature: 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.

destroy

Signature: void destroy

Description: Explicitly destroys the object

Use of this method is deprecated. Use _destroy instead

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.

destroyed?

Signature: [const] bool destroyed?

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

Use of this method is deprecated. Use _destroyed? instead

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.

device

Signature: [const] QIODevice ptr device

Description: Method QIODevice *QImageWriter::device()

Python specific notes:
The object exposes a readable attribute 'device'. This is the getter.

device=

Signature: 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.

error

Signature: [const] QImageWriter_ImageWriterError error

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

errorString

Signature: [const] string errorString

Description: Method QString QImageWriter::errorString()

fileName

Signature: [const] string fileName

Description: Method QString QImageWriter::fileName()

Python specific notes:
The object exposes a readable attribute 'fileName'. This is the getter.

fileName=

Signature: 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.

format

Signature: [const] bytes format

Description: Method QByteArray QImageWriter::format()

Python specific notes:
The object exposes a readable attribute 'format'. This is the getter.

format=

Signature: void format= (bytes format)

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

Python specific notes:
The object exposes a writable attribute 'format'. This is the setter.

gamma

Signature: [const] float gamma

Description: Method float QImageWriter::gamma()

Python specific notes:
The object exposes a readable attribute 'gamma'. This is the getter.

gamma=

Signature: 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.

is_const_object?

Signature: [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

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

new

(1) Signature: [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.

(2) Signature: [static] new QImageWriter new (QIODevice ptr device, bytes 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.

(3) Signature: [static] new QImageWriter new (string fileName, bytes 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.

quality

Signature: [const] int quality

Description: Method int QImageWriter::quality()

Python specific notes:
The object exposes a readable attribute 'quality'. This is the getter.

quality=

Signature: 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.

setCompression

Signature: 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.

setDescription

Signature: 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.

setDevice

Signature: 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.

setFileName

Signature: 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.

setFormat

Signature: void setFormat (bytes format)

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

Python specific notes:
The object exposes a writable attribute 'format'. This is the setter.

setGamma

Signature: 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.

setQuality

Signature: 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.

setText

Signature: void setText (string key, string text)

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

supportedImageFormats

Signature: [static] bytes[] supportedImageFormats

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

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

supportsOption

Signature: [const] bool supportsOption (const QImageIOHandler_ImageOption option)

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

write

Signature: bool write (const QImage image)

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