Qt 3 Support Members for QImage

enum QImage::Endian

This enum type is used to describe the endianness of the CPU and graphics hardware. It is provided here for compatibility with earlier versions of Qt.

Use the Format enum instead. The Format enum specify the endianess for monchrome formats, but for other formats the endianess is not relevant.

Member Function Documentation

QImage::QImage ( int width, int height, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )

Constructs an image with the given width, height, depth, numColors colors and bitOrder.

Use the constructor that accepts a width, a height and a format (i.e. specifying the depth and bit order), in combination with the setColorCount() function, instead.

For example, if you have code like

 QImage image(width, height, depth, numColors);

you can rewrite it as

 QImage image(width, height, format);

 // For 8 bit images the default number of colors is 256. If
 // another number of colors is required it can be specified
 // using the setColorCount() function.
 image.setColorCount(numColors);

QImage::QImage ( const QSize & size, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )

Constructs an image with the given size, depth, numColors and bitOrder.

Use the constructor that accepts a size and a format (i.e. specifying the depth and bit order), in combination with the setColorCount() function, instead.

For example, if you have code like

 QSize mySize(width, height);
 QImage image(mySize, depth, numColors);

you can rewrite it as

 QSize mySize(width, height);
 QImage image(mySize, format);

 // For 8 bit images the default number of colors is 256. If
 // another number of colors is required it can be specified
 // using the setColorCount() function.
 image.setColorCount(numColors);

QImage::QImage ( uchar * data, int width, int height, int depth, const QRgb * colortable, int numColors, Endian bitOrder )

Constructs an image with the given width, height, depth, colortable, numColors and bitOrder, that uses an existing memory buffer, data.

Use the constructor that accepts a uchar pointer, a width, a height and a format (i.e. specifying the depth and bit order), in combination with the setColorTable() function, instead.

For example, if you have code like

 uchar *myData;
 QRgb *myColorTable;

 QImage image(myData, width, height, depth,
                        myColorTable, numColors, IgnoreEndian);

you can rewrite it as

 uchar *myData;
 QVector<QRgb> myColorTable;

 QImage image(myData, width, height, format);
 image.setColorTable(myColorTable);

QImage::QImage ( uchar * data, int width, int height, int depth, int bytesPerLine, const QRgb * colortable, int numColors, Endian bitOrder )

Constructs an image with the given width, height, depth, bytesPerLine, colortable, numColors and bitOrder, that uses an existing memory buffer, data. The image does not delete the buffer at destruction.

Warning: This constructor is only available in Qt for Embedded Linux.

The data has to be 32-bit aligned, and each scanline of data in the image must also be 32-bit aligned, so it's no longer possible to specify a custom bytesPerLine value.

QImage::QImage ( const QByteArray & data )

Use the static fromData() function instead.

For example, if you have code like

 QByteArray data;
 ...
 QImage image(data);

you can rewrite it as

 QByteArray data;
 ...
 QImage image = QImage::fromData(data);

 QImage image;
 image.reset();

 QImage image;
 image = QImage();

 QImage image;
 image.smoothScale(width, height, mode);

 QImage image;
 image.scaled(width, height, mode, Qt::SmoothTransformation);

 QImage image;
 image.smoothScale(size, mode);

 QImage image;
 image.scaled(size, mode, Qt::SmoothTransformation);

 QImage image;
 ...
 image.xForm(matrix);

 QImage image;
 ...
 image.transformed(matrix);