Obsolete Members for QPixmap
The following members of class QPixmap are obsolete. They are provided to keep old source code working. We strongly advise against using them in new code.
| ||alphaChannel() const|
| ||serialNumber() const|
| ||setAlphaChannel(const QPixmap & alphaChannel)|
- 1 public function inherited from QPaintDevice
Member Function Documentation
QPixmap QPixmap::alphaChannel() const
Returns the alpha channel of the pixmap as a new grayscale QPixmap in which each pixel's red, green, and blue values are given the alpha value of the original pixmap. The color depth of the returned pixmap is the system depth on X11 and 8-bit on Windows and Mac OS X.
You can use this function while debugging to get a visible image of the alpha channel. If the pixmap doesn't have an alpha channel, i.e., the alpha channel's value for all pixels equals 0xff), a null pixmap is returned. You can check this with the
We show an example:
pixmap = QPixmap(100, 100); pixmap.fill(Qt::transparent); QRadialGradient gradient(50, 50, 50, 50, 50); gradient.setColorAt(0, QColor::fromRgbF(1, 0, 0, 1)); gradient.setColorAt(1, QColor::fromRgbF(0, 0, 0, 0)); QPainter painter(&pixmap); painter.fillRect(0, 0, 100, 100, gradient); channelImage = pixmap.alphaChannel(); update();
Warning: This is an expensive operation. The alpha channel of the pixmap is extracted dynamically from the pixeldata. Most usecases of this function are covered by QPainter and compositionModes which will normally execute faster.
Use cacheKey() instead.
Warning: The serial number doesn't necessarily change when the pixmap is altered. This means that it may be dangerous to use it as a cache key. For caching pixmaps, we recommend using the QPixmapCache class whenever possible.
void QPixmap::setAlphaChannel(const QPixmap & alphaChannel)
Sets the alpha channel of this pixmap to the given alphaChannel by converting the alphaChannel into 32 bit and using the intensity of the RGB pixel values.
The effect of this function is undefined when the pixmap is being painted on.
Warning: This is potentially an expensive operation. Most usecases for this function are covered by QPainter and compositionModes which will normally execute faster.
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.