Obsolete Members for QImage

以下成员源于类 QImage 已过时。 提供它们是为使旧源代码能继续工作。强烈建议不要在新代码中使用它们。

公共函数

(obsolete) QImage	alphaChannel () const
(obsolete) int	byteCount () const
(obsolete) int	numBytes () const
(obsolete) int	numColors () const
(obsolete) int	serialNumber () const
(obsolete) void	setNumColors (int n )
(obsolete) void	setText (const char * key , const char * 语言 , const QString & text )
(obsolete) QString	text (const char * key , const char * 语言 = nullptr) const
(obsolete) QString	text (const QImageTextKeyLang & keywordAndLanguage ) const
(obsolete) QStringList	textLanguages () const
(obsolete) QList<QImageTextKeyLang>	textList () const
(obsolete) QImage	transformed (const QMatrix & matrix , Qt::TransformationMode mode = Qt::FastTransformation) const

静态公共成员

(obsolete) QMatrix

trueMatrix (const QMatrix & matrix , int width , int height )

成员函数文档编制

QImage QImage:: alphaChannel () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Returns the alpha channel of the image as a new grayscale QImage in which each pixel's red, green, and blue values are given the alpha value of the original image. The color depth of the returned image is 8-bit.

You can see an example of use of this function in QPixmap 's alphaChannel() , which works in the same way as this function on QPixmaps.

Most usecases for this function can be replaced with QPainter and using composition modes.

Note this returns a color-indexed image if you want the alpha channel in the alpha8 format instead use convertToFormat ( Format_Alpha8 ) on the source image.

警告： This is an expensive function.

另请参阅 setAlphaChannel (), hasAlphaChannel (), convertToFormat (), Pixmap ，和 图像变换 .

int QImage:: byteCount () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

返回由图像数据占据的字节数。

Note this method should never be called on an image larger than 2 gigabytes. Instead use sizeInBytes ().

该函数在 Qt 4.6 引入。

另请参阅 sizeInBytes (), bytesPerLine (), bits ()，和 图像信息 .

int QImage:: numBytes () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

返回由图像数据占据的字节数。

另请参阅 sizeInBytes ().

int QImage:: numColors () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

返回图像的颜色表大小。

另请参阅 setNumColors () 和 setColorCount ().

int QImage:: serialNumber () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

返回的数字标识内容对于此 QImage 对象。截然不同的 QImage objects can only have the same serial number if they refer to the same contents (but they don't have to).

使用 cacheKey () 代替。

警告： The serial number doesn't necessarily change when the image is altered. This means that it may be dangerous to use it as a cache key.

另请参阅 operator== ().

void QImage:: setNumColors ( int n )

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

重置颜色表大小以包含 n 条目。

另请参阅 numColors () 和 setColorCount ().

void QImage:: setText (const char * key , const char * 语言 , const QString & text )

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

将图像文本设为给定 text 并将其关联到给定 key . The text is recorded in the specified 语言 , or in a default language if 语言 is nullptr .

Use setText() instead.

The language the text is recorded in is no longer relevant since the text is always set using QString and UTF-8 representation.

QString QImage:: text (const char * key , const char * 语言 = nullptr) const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Returns the text recorded for the given key 以给定 语言 , or in a default language if 语言 is nullptr .

Use text() instead.

The language the text is recorded in is no longer relevant since the text is always set using QString and UTF-8 representation.

QString QImage:: text (const QImageTextKeyLang & keywordAndLanguage ) const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

这是重载函数。

Returns the text recorded for the given keywordAndLanguage .

Use text() instead.

The language the text is recorded in is no longer relevant since the text is always set using QString and UTF-8 representation.

QStringList QImage:: textLanguages () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Returns the language identifiers for which some texts are recorded. Note that if you want to iterate over the list, you should iterate over a copy.

The language the text is recorded in is no longer relevant since the text is always set using QString and UTF-8 representation.

另请参阅 textKeys ().

QList < QImageTextKeyLang > QImage:: textList () const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Returns a list of QImageTextKeyLang objects that enumerate all the texts key/language pairs set for this image.

The language the text is recorded in is no longer relevant since the text is always set using QString and UTF-8 representation.

另请参阅 textKeys ().

QImage QImage:: transformed (const QMatrix & matrix , Qt::TransformationMode mode = Qt::FastTransformation) const

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Use transformed(const QTransform &matrix, Qt::TransformationMode mode) instead.

返回图像副本的变换是使用给定变换 matrix 和变换 mode .

返回图像通常拥有如原始图像的相同 {图像格式}{格式}。不管怎样，复杂变换可能产生原始图像变换像素并不会覆盖其所有像素的图像。在这种情况下，会将透明颜色值赋值给这些背景像素，且会赋予变换图像带有 Alpha 通道的格式，即使原始图像没有。

变换 matrix 在内部调节以补偿不想要的平移；即，产生图像是包含原始图像所有变换点的最小图像。使用 trueMatrix () 函数检索用于变换图像的实际矩阵。

另请参阅 trueMatrix () 和 图像变换 .

[static] QMatrix QImage:: trueMatrix (const QMatrix & matrix , int width , int height )

此函数已过时。提供它是为使旧源代码能继续工作。强烈建议不要在新代码中使用它。

Use trueMatrix(const QTransform &matrix, int w, int h) instead.

返回用于变换图像的实际矩阵采用给定 width , height and matrix .

当变换图像使用 transformed () 函数，变换矩阵在内部调节以补偿不想要的平移，即 transformed () 返回包含原始图像中所有变换点的最小图像。此函数返回修改矩阵，将来自原始图像中的点正确地映射到新图像。

另请参阅 transformed () 和 图像变换 .