QImageData Struct Reference

#include <qimage_p.h>

Public Functions
bool	checkForAlphaPixels () const
bool	convertInPlace (QImage::Format newFormat, Qt::ImageConversionFlags)
bool	doImageIO (const QImage *image, QImageWriter *io, int quality) const
	QImageData ()
	~QImageData ()

Static Public Functions
static QImageData *	create (const QSize &size, QImage::Format format, int numColors=0)
static QImageData *	create (uchar *data, int w, int h, int bpl, QImage::Format format, bool readOnly)

Public Variables
int	bytes_per_line
QVector< QRgb >	colortable
uchar *	data
int	depth
int	detach_no
qreal	dpmx
qreal	dpmy
QImage::Format	format
uint	has_alpha_clut: 1
int	height
uint	is_cached: 1
int	nbytes
QPoint	offset
uint	own_data: 1
QPaintEngine *	paintEngine
QAtomicInt	ref
uint	ro_data: 1
int	ser_no
QMap< QString, QString >	text
int	width

Detailed Description

Definition at line 68 of file qimage_p.h.

Constructors and Destructors

QImageData()

QImageData::QImageData

(

)

Definition at line 129 of file qimage.cpp.

    : ref(0), width(0), height(0), depth(0), nbytes(0), data(0),
#ifdef QT3_SUPPORT
      jumptable(0),
#endif
      format(QImage::Format_ARGB32), bytes_per_line(0),
      ser_no(qimage_serial_number.fetchAndAddRelaxed(1)),
      detach_no(0),
      dpmx(qt_defaultDpiX() * 100 / qreal(2.54)),
      dpmy(qt_defaultDpiY() * 100 / qreal(2.54)),
      offset(0, 0), own_data(true), ro_data(false), has_alpha_clut(false),
      is_cached(false), paintEngine(0)
{
}

~QImageData()

QImageData::~QImageData

(

)

Definition at line 220 of file qimage.cpp.

{
    if (is_cached)
        QImagePixmapCleanupHooks::executeImageHooks((((qint64) ser_no) << 32) | ((qint64) detach_no));
    delete paintEngine;
    if (data && own_data)
        free(data);
#ifdef QT3_SUPPORT
    if (jumptable)
        free(jumptable);
    jumptable = 0;
#endif
    data = 0;
}

Functions

checkForAlphaPixels()

bool QImageData::checkForAlphaPixels

(

)

const

Definition at line 236 of file qimage.cpp.

Referenced by QVGPixmapData::idealFormat().

{
    bool has_alpha_pixels = false;

    switch (format) {

    case QImage::Format_Mono:
    case QImage::Format_MonoLSB:
    case QImage::Format_Indexed8:
        has_alpha_pixels = has_alpha_clut;
        break;

    case QImage::Format_ARGB32:
    case QImage::Format_ARGB32_Premultiplied: {
        uchar *bits = data;
        for (int y=0; y<height && !has_alpha_pixels; ++y) {
            for (int x=0; x<width; ++x)
                has_alpha_pixels |= (((uint *)bits)[x] & 0xff000000) != 0xff000000;
            bits += bytes_per_line;
        }
    } break;

    case QImage::Format_ARGB8555_Premultiplied:
    case QImage::Format_ARGB8565_Premultiplied: {
        uchar *bits = data;
        uchar *end_bits = data + bytes_per_line;

        for (int y=0; y<height && !has_alpha_pixels; ++y) {
            while (bits < end_bits) {
                has_alpha_pixels |= bits[0] != 0;
                bits += 3;
            }
            bits = end_bits;
            end_bits += bytes_per_line;
        }
    } break;

    case QImage::Format_ARGB6666_Premultiplied: {
        uchar *bits = data;
        uchar *end_bits = data + bytes_per_line;

        for (int y=0; y<height && !has_alpha_pixels; ++y) {
            while (bits < end_bits) {
                has_alpha_pixels |= (bits[0] & 0xfc) != 0;
                bits += 3;
            }
            bits = end_bits;
            end_bits += bytes_per_line;
        }
    } break;

    case QImage::Format_ARGB4444_Premultiplied: {
        uchar *bits = data;
        uchar *end_bits = data + bytes_per_line;

        for (int y=0; y<height && !has_alpha_pixels; ++y) {
            while (bits < end_bits) {
                has_alpha_pixels |= (bits[0] & 0xf0) != 0;
                bits += 2;
            }
            bits = end_bits;
            end_bits += bytes_per_line;
        }
    } break;

    default:
        break;
    }

    return has_alpha_pixels;
}

convertInPlace()

bool QImageData::convertInPlace	(	QImage::Format	newFormat,
		Qt::ImageConversionFlags	flags
	)

Definition at line 6935 of file qimage.cpp.

Referenced by QRasterPixmapData::createPixmapForImage(), QVGPixmapData::createPixmapForImage(), and QGLPixmapData::createPixmapForImage().

{
    if (format == newFormat)
        return true;

    // No in-place conversion if we have to detach
    if (ref > 1)
        return false;

    const InPlace_Image_Converter *const converterPtr = &inplace_converter_map[format][newFormat];
    InPlace_Image_Converter converter = *converterPtr;
    if (converter)
        return converter(this, flags);
    else
        return false;
}

create() [1/2]

QImageData * QImageData::create ( const QSize &  size, QImage::Format  format, int  numColors = 0  )

static

Warning

This function is not part of the public interface.

Creates a new image data. Returns 0 if invalid parameters are give or anything else failed.

Definition at line 151 of file qimage.cpp.

Referenced by convert_ARGB_PM_to_Indexed8(), convert_ARGB_PM_to_Mono(), convert_RGB_to_Indexed8(), QImage::format(), and QImage::QImage().

{
    if (!size.isValid() || numColors < 0 || format == QImage::Format_Invalid)
        return 0;                                // invalid parameter(s)

    if (!checkPixelSize(format)) {
        qWarning("QImageData::create(): Invalid pixel size for format %i",
                 format);
        return 0;
    }

    uint width = size.width();
    uint height = size.height();
    uint depth = qt_depthForFormat(format);

    switch (format) {
    case QImage::Format_Mono:
    case QImage::Format_MonoLSB:
        numColors = 2;
        break;
    case QImage::Format_Indexed8:
        numColors = qBound(0, numColors, 256);
        break;
    default:
        numColors = 0;
        break;
    }

    const int bytes_per_line = ((width * depth + 31) >> 5) << 2; // bytes per scanline (must be multiple of 4)

    // sanity check for potential overflows
    if (INT_MAX/depth < width
        || bytes_per_line <= 0
        || height <= 0
        || INT_MAX/uint(bytes_per_line) < height
        || INT_MAX/sizeof(uchar *) < uint(height))
        return 0;

    QScopedPointer<QImageData> d(new QImageData);
    d->colortable.resize(numColors);
    if (depth == 1) {
        d->colortable[0] = QColor(Qt::black).rgba();
        d->colortable[1] = QColor(Qt::white).rgba();
    } else {
        for (int i = 0; i < numColors; ++i)
            d->colortable[i] = 0;
    }

    d->width = width;
    d->height = height;
    d->depth = depth;
    d->format = format;
    d->has_alpha_clut = false;
    d->is_cached = false;

    d->bytes_per_line = bytes_per_line;

    d->nbytes = d->bytes_per_line*height;
    d->data  = (uchar *)malloc(d->nbytes);

    if (!d->data) {
        return 0;
    }

    d->ref.ref();
    return d.take();

}

create() [2/2]

QImageData * QImageData::create ( uchar *  data, int  w, int  h, int  bpl, QImage::Format  format, bool  readOnly  )

static

Definition at line 837 of file qimage.cpp.

{
    QImageData *d = 0;

    if (format == QImage::Format_Invalid)
        return d;

    if (!checkPixelSize(format)) {
        qWarning("QImageData::create(): Invalid pixel size for format %i",
                 format);
        return 0;
    }

    const int depth = qt_depthForFormat(format);
    const int calc_bytes_per_line = ((width * depth + 31)/32) * 4;
    const int min_bytes_per_line = (width * depth + 7)/8;

    if (bpl <= 0)
        bpl = calc_bytes_per_line;

    if (width <= 0 || height <= 0 || !data
        || INT_MAX/sizeof(uchar *) < uint(height)
        || INT_MAX/uint(depth) < uint(width)
        || bpl <= 0
        || height <= 0
        || bpl < min_bytes_per_line
        || INT_MAX/uint(bpl) < uint(height))
        return d;                                        // invalid parameter(s)

    d = new QImageData;
    d->ref.ref();

    d->own_data = false;
    d->ro_data = readOnly;
    d->data = data;
    d->width = width;
    d->height = height;
    d->depth = depth;
    d->format = format;

    d->bytes_per_line = bpl;
    d->nbytes = d->bytes_per_line * height;

    return d;
}

doImageIO()

bool QImageData::doImageIO	(	const QImage *	image,
		QImageWriter *	io,
		int	quality
	)		const

Definition at line 5379 of file qimage.cpp.

Referenced by QImage::save().

{
    if (quality > 100  || quality < -1)
        qWarning("QPixmap::save: Quality out of range [-1, 100]");
    if (quality >= 0)
        writer->setQuality(qMin(quality,100));
    return writer->write(*image);
}

Properties

bytes_per_line

int QImageData::bytes_per_line

Definition at line 86 of file qimage_p.h.

Referenced by QImage::alphaChannel(), checkForAlphaPixels(), QImage::colorCount(), QImage::constScanLine(), convert_ARGB_PM_to_ARGB(), convert_ARGB_PM_to_RGB(), convert_ARGB_to_ARGB_PM(), convert_ARGB_to_ARGB_PM_inplace(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), convert_RGB_to_RGB16_inplace(), QImage::copy(), create(), dither_to_Mono(), QImage::fill(), QSpanData::initTexture(), QImage::invertPixels(), mask_alpha_converter(), QImage::mirrored(), QImage::operator==(), QImage::QImage(), QImage::scanLine(), QImage::setAlphaChannel(), and swap_bit_order().

colortable

QVector<QRgb> QImageData::colortable

Definition at line 80 of file qimage_p.h.

Referenced by QImage::allGray(), QImage::color(), QImage::colorCount(), QImage::colorTable(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), QImage::copy(), create(), dither_to_Mono(), QImage::fill(), QSpanData::initTexture(), QImage::isGrayscale(), QRasterPixmapData::metric(), QImage::mirrored(), QImage::numColors(), QImage::operator==(), QImage::pixel(), QImage::QImage(), qt_image_colortable(), QImage::rgbSwapped(), QImage::setColor(), QImage::setColorCount(), QImage::setColorTable(), QImage::setPixel(), swap_bit_order(), and QImage::transformed().

data

uchar* QImageData::data

Definition at line 81 of file qimage_p.h.

Referenced by QImage::alphaChannel(), QImage::bits(), checkForAlphaPixels(), QImage::colorCount(), QImage::constBits(), QImage::constScanLine(), convert_ARGB_PM_to_ARGB(), convert_ARGB_PM_to_RGB(), convert_ARGB_to_ARGB_PM(), convert_ARGB_to_ARGB_PM_inplace(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), convert_RGB_to_RGB16_inplace(), QImage::copy(), create(), QMeeGoGraphicsSystem::createPixmapData(), dither_to_Mono(), QImage::fill(), QSpanData::initTexture(), QImage::invertPixels(), mask_alpha_converter(), QImage::mirrored(), QMeeGoGraphicsSystem::pixmapDataFromEGLSharedImage(), QImage::QImage(), QImage::scanLine(), QImage::setAlphaChannel(), QImage::setPixel(), swap_bit_order(), and ~QImageData().

depth

int QImageData::depth

Definition at line 78 of file qimage_p.h.

Referenced by QImage::allGray(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_RGB_to_RGB16_inplace(), QImage::convertToFormat(), QImage::copy(), create(), QImage::createAlphaMask(), QImage::createHeuristicMask(), QRasterPixmapData::createPixmapForImage(), QImage::depth(), dither_to_Mono(), QImage::fill(), QImage::invertPixels(), QImage::mirrored(), QImage::pixelIndex(), QImage::QImage(), qt_get_bitflip_array(), QImage::setAlphaChannel(), QImage::setColor(), and QImage::setPixel().

detach_no

int QImageData::detach_no

Definition at line 88 of file qimage_p.h.

Referenced by QImage::detach(), and ~QImageData().

dpmx

qreal QImageData::dpmx

Definition at line 90 of file qimage_p.h.

Referenced by QImage::copy(), and QImage::transformed().

dpmy

qreal QImageData::dpmy

Definition at line 91 of file qimage_p.h.

Referenced by QImage::copy(), and QImage::transformed().

format

QImage::Format QImageData::format

Definition at line 85 of file qimage_p.h.

Referenced by QImage::allGray(), convert_ARGB_PM_to_ARGB(), convert_ARGB_PM_to_RGB(), convert_ARGB_to_ARGB_PM(), convert_ARGB_to_ARGB_PM_inplace(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), convert_RGB_to_RGB16_inplace(), QImage::convertToFormat(), QImage::copy(), create(), QImage::createAlphaMask(), QRasterPixmapData::createPixmapForImage(), dither_to_Mono(), QRasterPixmapData::fill(), QImage::fill(), QImage::format(), QSpanData::initTexture(), QImage::mirrored(), QImage::operator==(), QImage::pixel(), QImage::pixelIndex(), QImage::QImage(), qt_get_bitflip_array(), QImage::rgbSwapped(), QImage::setPixel(), and swap_bit_order().

has_alpha_clut

uint QImageData::has_alpha_clut

Definition at line 96 of file qimage_p.h.

Referenced by checkForAlphaPixels(), convert_Mono_to_Indexed8(), convert_RGB_to_Indexed8(), QImage::copy(), create(), QImage::mirrored(), QImage::setColor(), QImage::setColorTable(), and QImage::transformed().

height

int QImageData::height

Definition at line 77 of file qimage_p.h.

Referenced by QImage::bytesPerLine(), checkForAlphaPixels(), QImage::colorCount(), convert_ARGB_PM_to_ARGB(), convert_ARGB_PM_to_Indexed8(), convert_ARGB_PM_to_Mono(), convert_ARGB_PM_to_RGB(), convert_ARGB_to_ARGB_PM(), convert_ARGB_to_ARGB_PM_inplace(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), convert_RGB_to_RGB16_inplace(), QImage::convertToFormat(), QImage::copy(), create(), QImage::createAlphaMask(), QImage::createMaskFromColor(), QRasterPixmapData::createPixmapForImage(), dither_to_Mono(), QImage::fill(), QImage::height(), QSpanData::initTexture(), QImage::invertPixels(), mask_alpha_converter(), QRasterPixmapData::metric(), QImage::mirrored(), QImage::operator==(), QImage::QImage(), QImage::rect(), QImage::rgbSwapped(), QImage::setAlphaChannel(), QImage::setPixel(), QImage::size(), swap_bit_order(), and QImage::valid().

is_cached

uint QImageData::is_cached

Definition at line 97 of file qimage_p.h.

Referenced by create(), QImage::detach(), and ~QImageData().

nbytes

int QImageData::nbytes

Definition at line 79 of file qimage_p.h.

Referenced by QImage::byteCount(), QImage::bytesPerLine(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_RGB_to_RGB16_inplace(), QImage::copy(), create(), dither_to_Mono(), QImage::invertPixels(), QImage::numBytes(), QImage::QImage(), QImage::setPixel(), and swap_bit_order().

offset

QPoint QImageData::offset

Definition at line 92 of file qimage_p.h.

Referenced by QImage::copy().

own_data

uint QImageData::own_data

Definition at line 94 of file qimage_p.h.

Referenced by create(), QImage::QImage(), qpaintbuffer_storable_image(), QX11PixmapData::takeQImageFromXImage(), and ~QImageData().

paintEngine

QPaintEngine* QImageData::paintEngine

Definition at line 110 of file qimage_p.h.

Referenced by QPixmapCacheEntry::QPixmapCacheEntry(), QRasterPixmapData::toImage(), QGLPixmapData::toImage(), and ~QImageData().

ref

QAtomicInt QImageData::ref

Definition at line 74 of file qimage_p.h.

Referenced by create(), QImage::detach(), QImage::format(), QImage::operator=(), QImage::QImage(), and QImage::~QImage().

ro_data

uint QImageData::ro_data

Definition at line 95 of file qimage_p.h.

Referenced by create(), and QImage::detach().

ser_no

int QImageData::ser_no

Definition at line 87 of file qimage_p.h.

Referenced by ~QImageData().

text

QMap<QString, QString> QImageData::text

Definition at line 106 of file qimage_p.h.

Referenced by QImage::convertToFormat(), and QImage::copy().

width

int QImageData::width

Definition at line 76 of file qimage_p.h.

Referenced by checkForAlphaPixels(), convert_ARGB_PM_to_ARGB(), convert_ARGB_PM_to_Indexed8(), convert_ARGB_PM_to_Mono(), convert_ARGB_PM_to_RGB(), convert_ARGB_to_ARGB_PM(), convert_ARGB_to_ARGB_PM_inplace(), convert_indexed8_to_ARGB_PM_inplace(), convert_indexed8_to_RGB16_inplace(), convert_indexed8_to_RGB_inplace(), convert_Indexed8_to_X32(), convert_Mono_to_Indexed8(), convert_Mono_to_X32(), convert_RGB_to_Indexed8(), convert_RGB_to_RGB16_inplace(), QImage::convertToFormat(), QImage::copy(), create(), QImage::createAlphaMask(), QImage::createMaskFromColor(), QRasterPixmapData::createPixmapForImage(), dither_to_Mono(), QImage::fill(), QSpanData::initTexture(), QImage::invertPixels(), mask_alpha_converter(), QRasterPixmapData::metric(), QImage::mirrored(), QImage::operator==(), QImage::pixel(), QImage::pixelIndex(), QImage::QImage(), QImage::rect(), QImage::rgbSwapped(), QImage::setAlphaChannel(), QImage::setPixel(), QImage::size(), swap_bit_order(), QImage::valid(), and QImage::width().

---

The documentation for this struct was generated from the following files:

• /src/gui/image/qimage_p.h
• /src/gui/image/qimage.cpp