Поддерживаемые члены Qt 3 класса QImageОписанные ниже члены класса являются частью слоя поддержки Qt 3. Они введены для поддержки старого кода в Qt 4. Мы советуем не использовать их во вновь создаваемом коде. Открытые типы
Открытые функции
Статические открытые члены
Связанные нечлены класса
Описание типов-членовenum QImage::EndianЭтот тип перечисления используется для описания байт ЦПУ и графического ускорителя. Здесь он предоставлен для совместимости со с ранними версиями Qt. Вместо этого используйте перечисление Format. Перечисление Format определяет порядок следования байтов для монохромных форматов, однако для остальных форматов порядок следования байтов не является актуальным.
Описание функций-членовQImage::QImage ( int width, int height, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )Создаёт изображение с заданной width, height, depth, numColors цветов и bitOrder. Вместо этого используйте конструктор, который принимает ширину, высоту и формат (т.е. задаётся глубина и порядок битов), в сочетании с функцией setColorCount(). Например, если у вас есть код QImage image(width, height, depth, numColors); вы можете записать его в виде QImage image(width, height, format); // Для 8-битных изображения количество цветов по умолчанию составляет 256. Если // требуется другое количество цветов, оно может быть задано // используя функцию setColorCount(). image.setColorCount(numColors); QImage::QImage ( const QSize & size, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )Создаёт изображение с заданными size, depth, numColors и bitOrder. Вместо этого используйте конструктор, который принимает размер и формат (т.е. задаётся глубина и порядок битов), в сочетании с функцией setColorCount(). Например, если у вас есть код QSize mySize(width, height); QImage image(mySize, depth, numColors); вы можете записать его в виде QSize mySize(width, height); QImage image(mySize, format); // Для 8-битных изображения количество цветов по умолчанию составляет 256. Если // требуется другое количество цветов, оно может быть задано // используя функцию setColorCount(). image.setColorCount(numColors); QImage::QImage ( uchar * data, int width, int height, int depth, const QRgb * colortable, int numColors, Endian bitOrder )Создаёт изображение с заданными width, height, depth, colortable, numColors и bitOrder, которые используют существующий буфер памяти data. Вместо этого используйте конструктор, который принимает указатель на uchar, ширину, высоту и формат (т.е. задаётся глубина и порядок битов), в сочетании с функцией setColorTable(). Например, если у вас есть код uchar *myData; QRgb *myColorTable; QImage image(myData, width, height, depth, myColorTable, numColors, IgnoreEndian); вы можете записать его в виде 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 )Создаёт изображение с заданными width, height, depth, bytesPerLine, colortable, numColors и bitOrder, которые используют существующий буфер памяти data. При уничтожении изображение не удаляет буфер. Предупреждение: Этот конструктор доступен только в Qt для встраиваемых Linux-систем. Данные должны быть выравнены по 32 битам, а также каждая строка данных в изображении должна быть выровнена по 32 битам, поэтому задать пользовательское значение bytesPerLine более невозможно. QImage::QImage ( const QByteArray & data )Вместо этого используйте статическую функцию fromData(). Например, если у вас есть код QByteArray data; ... QImage image(data); вы можете записать его в виде QByteArray data; ... QImage image = QImage::fromData(data); Endian QImage::bitOrder () constВозвращает порядок битов в изображении. Если это изображение с 1 битом на цвет, то эта функция возвратит либо QImage::BigEndian либо QImage::LittleEndian. В противном случае, эта функция возвращает QImage::IgnoreEndian. Вместо этого используйте для монохромных форматов функцию format(). Для немонохроматических форматов порядок битов не имеет значения. QImage QImage::convertBitOrder ( Endian bitOrder ) constПреобразует порядок битов изображения к заданному bitOrder и возвращает преобразованное изображение. Исходное изображение не изменяется. Возвращает это же изображение, если заданный bitOrder совпадает с текущим порядком битов изображения, или пустое изображение, если это изображение не преобразовано. Вместо этого используйте convertToFormat(). QImage QImage::convertDepth ( int depth, Qt::ImageConversionFlags flags = Qt::AutoColor ) constПреобразует глубину (бит на пиксел, bpp) изображения в заданную глубину depth и возвращает преобразованное изображение. Исходное изображение не изменяется. Возвращает это же изображение, если depth совпадает с глубиной изображения, или пустое изображение, если это изображение не преобразовано. Аргумент depth должен иметь значение 1, 8 или 32. Если необходимо изменить изображение, чтобы получить результат с более низким разрешением (например, преобразовать из 32-битного в 8-битное), то используйте flags для задания того, как вы предпочитаете, чтобы это произошло. Вместо этого используйте функцию convertToFormat(). QImage QImage::convertDepthWithPalette ( int depth, QRgb * palette, int palette_count, Qt::ImageConversionFlags flags = Qt::AutoColor ) constВозвращает изображение с заданной depth, используя palette_count цветов из палитры palette. Если depth равна 1 или 8, то возвращаемое изображение будет иметь свою таблицу цветов упорядоченную таким же способом, что и palette. Если необходимо изменить изображение, чтобы получить результат с более низким разрешением (например, преобразовать из 32-битного в 8-битное), то используйте flags для задания того, как вы предпочитаете, чтобы это произошло. Примечание: в настоящее время не выполняется поиск ближайшего цвета. Если найдены цвета не из палитры, то палитра полностью не может быть использована. Этот результат нельзя считать действительным, поскольку он может измениться в будущих реализациях. В настоящее время не эффективно для не 32-битовых изображений. Вместо этого используйте функцию convertToFormat() в сочетании с функцией setColorTable(). QImage QImage::copy ( int x, int y, int w, int h, Qt::ImageConversionFlags flags ) constВместо этого используйте copy(). QImage QImage::copy ( const QRect & rect, Qt::ImageConversionFlags flags ) constВместо этого используйте copy(). bool QImage::create ( int width, int height, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )Устанавливает ширину width, высоту height, глубину depth изображения, количество цветов (в numColors), а также порядок битов. Возвращает true в случае успеха, или false, если параметры некорректны или если память не может быть выделена. Значение width и height ограничено 32767. Глубина depth должна иметь значение 1, 8 или 32. Если глубина depth равна 1, то bitOrder должен быть установлен равным либо QImage::LittleEndian либо QImage::BigEndian. Для другой глубины bitOrder должен быть равен QImage::IgnoreEndian. Эта функция выделяет таблицу цветов и буфер для данных изображения. Данные изображения не инициализируются. Память для буфера изображения выделяется как один блок, который содержит таблицу казателей scanLine() (jumpTable()) и данные изображения (bits()). Вместо этого используйте конструктор QImage. bool QImage::create ( const QSize & size, int depth, int numColors = 0, Endian bitOrder = IgnoreEndian )Это перегруженная функция. Ширина и высота задаются в аргументе size. Вместо этого используйте конструктор QImage. bool QImage::hasAlphaBuffer () constВозвращает true, если режим альфа-буфера включён; в противном случае возвратит false. Вместо этого используйте функцию hasAlphaChannel(). void QImage::invertPixels ( bool invertAlpha )Вместо этого используйте функцию invertPixels(), которая принимает параметр QImage::InvertMode. uchar ** QImage::jumpTable ()Возвращает указатель на таблицу указателей на строки. Это начало блока данных изображения. В случае ошибки возвращает 0. Вместо этого используйте функцию bits() или scanLine(). const uchar * const * QImage::jumpTable () constЭто перегруженная функция. QImage QImage::mirror ( bool horizontal = false, bool vertical = true ) constВместо этого используйте mirrored(). int QImage::numBytes () constВозвращает количество байтов, занятых данными изображения. Смотрите также byteCount(). int QImage::numColors () constВозвращает размер таблицы цветов для изображения. Смотрите также setNumColors() and setColorCount(). void QImage::reset ()Сброс все параметров изображения и освобождение выделенной для данных изображения памяти. Взамен присваивайте пустое изображение. Например, если у вас есть код QImage image; image.reset(); вы можете записать его в виде QImage image; image = QImage(); QImage QImage::scaleHeight ( int h ) constВместо этого используйте scaledToHeight(). QImage QImage::scaleWidth ( int w ) constВместо этого используйте scaledToWidth(). void QImage::setAlphaBuffer ( bool enable )Включает режим альфа-буфера, если enable равно true, в противном случае отключает его. Альфа-буфер используется для установки маски когда QImage перемещается в QPixmap. Если монохромное или проиндексированное 8-битовое изображение имеет альфа-каналы в своей таблице цветов, то наличие в них альфа-канала будет автоматически определено, поэтому эта функция не нужна. Чтобы форсировать альфа-каналы в 32-битовых изображения используйте функцию convertToFormat(). Смотрите также hasAlphaBuffer(). void QImage::setNumColors ( int numColors )Изменяет размер таблицы цветов до содержащей numColors записей. Смотрите также numColors() и setColorCount(). QImage QImage::smoothScale ( int width, int height, Qt::AspectRatioMode mode = Qt::IgnoreAspectRatio ) constВместо этого используйте scaled(). Например, если у вас есть код QImage image; image.smoothScale(width, height, mode); вы можете записать его в виде QImage image; image.scaled(width, height, mode, Qt::SmoothTransformation); QImage QImage::smoothScale ( const QSize & size, Qt::AspectRatioMode mode = Qt::IgnoreAspectRatio ) constЭто перегруженная функция. Вместо этого используйте scaled(). Например, если у вас есть код QImage image; image.smoothScale(size, mode); вы можете записать его в виде QImage image; image.scaled(size, mode, Qt::SmoothTransformation); QImage QImage::swapRGB () constВместо этого используйте rgbSwapped(). Endian QImage::systemBitOrder () [static]Определяет порядок битов в аппаратуре вывода изображений. Возвращает QImage::LittleEndian (первый LSB) или QImage::BigEndian (первый MSB). Эта функция более не актуальна для QImage. Вместо этого используйте QSysInfo. Endian QImage::systemByteOrder () [static]Определяет порядок байтов хост-компьютера. Возвращает QImage::LittleEndian (первый LSB) или QImage::BigEndian (первый MSB). Эта функция более не актуальна для QImage. Вместо этого используйте QSysInfo. QImage QImage::xForm ( const QMatrix & matrix ) constВместо этого используйте transformed(). Например, если у вас есть код QImage image; ... image.xForm(matrix); вы можете записать его в виде QImage image; ... image.transformed(matrix); Связанные нечлены классаvoid bitBlt ( QImage * dst, int dx, int dy, const QImage * src, int sx = 0, int sy = 0, int sw = -1, int sh = -1, Qt::ImageConversionFlags flags = Qt::AutoColor )Копирует блок пикселей из src в dst. Копируемые из источника (src) пиксели преобразуются в соответствии с flags, если они не совместимы с приёмником(dst). sx, sy - верхний левый пиксел в src, dx, dy - верхняя левая позиция в dst и sw, sh - размер копируемого блока. Копируемое обрезается, если размеры src или dst заданы сверх их размеров. Если sw равно -1, то оно приводится к src->width(). Аналогично, если sh равно -1, оно приводится к src->height(). В настоящее время не эффективно для не 32-битовых изображений. Вместо этого используйте copy() или QPainter::drawImage().
|
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |