|
Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME |
本的QPixmap类是可用于作为涂料设备离屏图像表示。More...
继承QPaintDevice。
通过继承QBitmap。
本的QPixmap类是可用于作为涂料设备离屏图像表示。
Qt提供了四个类用于处理图像数据：QImage， QPixmap的，QBitmap和QPicture。QImage被设计和优化用于I / O ，并直接像素访问和操作，而QPixmap的设计和用于在屏幕上显示的图像进行了优化。QBitmap只有一个继承自QPixmap ，确保深度为1一个方便的类。该isQBitmap（如果一个物体的QPixmap是一个真正的位图）函数返回True，否则返回False 。最后，该QPicture类是一个绘图设备，记录和重放QPainter的命令。
使用A的QPixmap可以很容易地显示在屏幕上QLabel或1QAbstractButton的亚类（如QPushButton和QToolButton） 。QLabel有一个像素映射属性，而QAbstractButton有一个icon属性。
除了普通的构造函数，一个的QPixmap可以使用静态的构造grabWidget（）和grabWindow（ ），它创建了一个的QPixmap和油漆给定的部件，或窗口，进入它的功能。
的QPixmap对象可以围绕通过值传递，因为的QPixmap类使用隐式数据共享。欲了解更多信息，请参阅Implicit Data Sharing文档。 QPixmap的对象也可以流。
需要注意的是在一个像素图的像素数据是内部和由基本窗口系统进行管理。因为QPixmap的是QPaintDevice子类，QPainter可用于直接绘制到像素图。像素只能通过被访问QPainter功能或通过转换的QPixmap到QImage。然而，本fill（）函数是用于初始化整个像素映像与一个给定的颜色。
有功能之间的转换QImage和QPixmap的。典型地，该QImage类是用来加载一个图像文件，可选操作的图像数据，前QImage对象被转换成的QPixmap在屏幕上显示出来。另外，如果没有操作是理想，图像文件可以直接加载到的QPixmap 。在Windows上， QPixmap的类还支持之间的转换HBITMAP和QPixmap的。在Symbian中， QPixmap的类还支持的CFbsBitmap和的QPixmap之间的转换。
的QPixmap提供了可以被用来获得各种关于像素映像信息的功能的集合。此外，有几个函数，它使像素映像的转换。
的QPixmap提供了阅读一个图像文件几种方法：该文件可以构建的QPixmap对象时被加载，或者通过使用load（）或loadFromData（ ）函数以后。当加载一个图像，文件名可以指在磁盘上的实际文件或应用的嵌入式资源之一。看The Qt Resource System概述有关如何嵌入在应用程序的可执行映像和其他资源文件的详细信息。
只需调用save（ ）函数保存的QPixmap对象。
都可以通过支持的文件格式的完整列表QImageReader.supportedImageFormats（）和QImageWriter.supportedImageFormats（）函数。新的文件格式可以添加插件。默认情况下， Qt支持以下格式：
| Format | Description | Qt's support |
|---|---|---|
| BMP | Windows Bitmap | Read/write |
| GIF | Graphic Interchange Format (optional) | Read |
| JPG | Joint Photographic Experts Group | Read/write |
| JPEG | Joint Photographic Experts Group | Read/write |
| PNG | Portable Network Graphics | Read/write |
| PBM | Portable Bitmap | Read |
| PGM | Portable Graymap | Read |
| PPM | Portable Pixmap | Read/write |
| XBM | X11 Bitmap | Read/write |
| XPM | X11 Pixmap | Read/write |
的QPixmap提供了可以被用来获得各种关于像素映像信息的功能的集合：
| Available Functions | |
|---|---|
| Geometry | The size(), width() and height() functions provide information about the pixmap's size. The rect() function returns the image's enclosing rectangle. |
| Alpha component | The hasAlphaChannel() returns true
if the pixmap has a format that respects the alpha channel,
otherwise returns false. The hasAlpha(), setMask() and mask() functions are legacy and should not
be used. They are potentially very slow.
该createHeuristicMask（ ）函数创建并返回一个1 - BPP启发式面膜（即QBitmap）这个像素映射。它的工作原理是从一个角选择一种颜色，然后小打小闹该颜色的像素，开始在所有的边缘。该createMaskFromColor（ ）函数创建并返回一个掩码（即一QBitmap），用于根据一个给定的彩色的像素图。 |
| Low-level information | The depth() function returns
the depth of the pixmap. The defaultDepth() function returns the
default depth, i.e. the depth used by the application on the given
screen.
该cacheKey（ ）函数返回一个数字，唯一标识的QPixmap对象的内容。 该x11Info（ ）函数返回使用到的像素图目前属于屏幕的X显示的配置信息。该x11PictureHandle（ ）函数返回的像素图的XRender的支持X11的图片处理。需要注意的是后两个功能仅适用于X11 。 |
一个QPixmap的对象可以被转换成一个QImage使用toImage（）函数。同样，一个QImage可以使用被转换成的QPixmap的fromImage（ ） 。如果这是过于昂贵的操作，您可以使用QBitmap.fromImage（ ）来代替。
此外，在Windows上， QPixmap的类支持的转换和从HBITMAP ：在toWinHBITMAP（）函数创建了一个HBITMAP相当于QPixmap的，根据给定的HBitmapFormat，并返回HBITMAP句柄。该fromWinHBITMAP（ ）函数返回的QPixmap ，它等效于在给定的位图具有指定格式。该的QPixmap类还支持转换和从HICON ：在toWinHICON（ ）函数创建一个HICON相当于的QPixmap ，并返回HICON句柄。该fromWinHICON（ ）函数返回的QPixmap ，等效于给定的图标。
另外，在Symbian中， QPixmap的类支持的转换和从CFbsBitmap的方法：在toSymbianCFbsBitmap（ ）函数创建的CFbsBitmap相当于QPixmap的，根据给定的模式并返回的CFbsBitmap对象。该fromSymbianCFbsBitmap（ ）函数返回的QPixmap ，等效于给定的位图，给定模式。
的QPixmap支持许多函数，用于创建一个新的像素图，它是原始的转换后的版本：
该scaled（ ）scaledToWidth（）和scaledToHeight（ ）函数返回的像素图的缩放复印，而copy（ ）函数创建一个QPixmap的是原来的一个普通的副本。
该transformed（ ）函数返回的转化与给定的变换矩阵与变换模式的像素图的副本：在内部，该变换矩阵进行调整，以补偿不需要翻译，即transformed（ ）返回一个包含原始像素图的全部改造点的最小像素图。静trueMatrix（ ）函数返回用于转化像素图的实际矩阵。
Note:当使用原生的X11图形系统，在像素映射变为无效时，QApplication实例被销毁。
这个枚举类型定义了共享模式创建时可用一QPixmap从原始的X11像素图句柄的对象。
| Constant | Value | Description |
|---|---|---|
| QPixmap.ImplicitlyShared | 0 | 此模式将导致QPixmap反对建立内部数据的副本，然后才修改，从而保持原有的X11的像素图完好无损。 |
| QPixmap.ExplicitlyShared | 1 | 在这种模式下，像素映像数据将not前它被修改，这实际上会改变原来的X11像素映像被复制。 |
Warning:这个枚举仅用于X11的特定功能;使用它是不可移植的。
这个枚举被引入或修改的Qt 4.5 。
See also QPixmap.fromX11Pixmap（ ） 。
构造一个空像素图。
See also isNull（ ） 。
构造一个像素图与给定width和height。如果任width or height是零，空像素图的构造。
Warning:这将创建一个QPixmap与未初始化的数据。通话fill（ ）与绘制到它之前，以填补一个合适的颜色的像素图QPainter。
See also isNull（ ） 。
构造一个像素图从文件中给定的fileName。如果文件不存在或未知格式，像素图变成了空像素图。
装载程序将尝试使用指定的读取像素图format。如果format未指定（这是默认值） ，加载器探测文件的标题来猜测文件格式。
文件名可以是指在磁盘上的实际文件或应用的嵌入式资源之一。请参阅Resource System概述有关如何嵌入在应用程序的可执行映像和其他资源文件的详细信息。
如果图像需要进行修改，以适应在较低分辨率的结果（例如，从32位转换为8位），使用flags来控制转换。
该fileName，format和flags参数上传递load（ ） 。这意味着，在数据fileName是不是编译成二进制文件。如果fileName包含相对路径（例如，文件名只）的相关文件，必须找到相对于运行时的工作目录。
See also Reading and Writing Image Files。
构造一个像素图从给定的xpm数据，该数据必须是有效的XPM图像。
错误被忽略。
请注意，它可能通过使用一个不同寻常的声明挤压XPM变量一点点：
static const char * const start_xpm[]={ "16 15 8 1", "a c #cec6bd", ....
额外的const使得整个定义为只读，这会更有效（例如，当该代码在一个共享库）和ROMable当应用程序被存储在ROM中。
构造一个像素映射，它是给定的一个副本pixmap。
See also copy（ ） 。
返回一个数字，用于标识此QPixmap。不同QPixmap对象只能有相同的高速缓存密钥，如果它们指的是相同的内容。
该cacheKey （ ）会改变，当像素映射被改变。
代替该像素的数据与给定image使用指定的flags来控制转换。该flags参数是的一个按位或Qt.ImageConversionFlags。路过0flags设置所有的默认选项。返回True如果结果是，这个像素映射不为null 。
注：此功能是在Qt的4.6和更早的版本的Qt 3支持的一部分。它已被晋升为官方的API状态4.7支持更新的pixmap的图像，而无需创建一个新的QPixmap如fromImage（ ）会。
此功能被引入Qt的4.7 。
See also fromImage（ ） 。
返回像素图的子集是由给定的指定的一个深层副本rectangle。有关深副本的详细信息，请参阅Implicit Data Sharing文档。
如果给定的rectangle为空时，整个图像被复制。
See also operator=（ ）QPixmap（）和Pixmap Transformations。
这是一个重载函数。
返回像素图的子集是由矩形指定一个深层副本QRect（x，y，width，height） 。
创建并返回一个启发式的面具为这个像素映射。
该功能是通过从一个角中选择一种颜色，然后小打小闹该颜色的像素处开始，所有的边。如果clipTight为True（默认值）的面具只是大到足以复盖的像素，否则，面膜比数据像素。
面具可能不是完美的，但它应该是合理的，所以你可以做的事情，如下列：
QPixmap myPixmap; myPixmap->setMask(myPixmap->createHeuristicMask());
此功能是缓慢的，因为它涉及到从一个转换到/QImage和非平凡计算。
See also QImage.createHeuristicMask（）和createMaskFromColor（ ） 。
创建并返回的基础上，给出了这个像素映射口罩maskColor。如果mode is Qt.MaskInColor，匹配MaskColor的所有像素将是透明的。如果mode is Qt.MaskOutColor，匹配MaskColor的所有像素是不透明的。
此功能是缓慢的，因为它涉及到从一个转换到/QImage。
See also createHeuristicMask（）和QImage.createMaskFromColor（ ） 。
这是一个重载函数。
创建并返回的基础上，给出了这个像素映射口罩maskColor。与调用createMaskFromColor （ MaskColor的，Qt.MaskInColor）
See also createHeuristicMask（）和QImage.createMaskFromColor（ ） 。
返回应用程序所使用的默认的pixmap的深度。
在Windows和Mac ，默认的深度始终是32 。在X11和嵌入式，在屏幕的深度将通过这个函数返回。
See also depth（ ）QColormap.depth（）和Pixmap Information。
返回像素图的深度。
像素图的深度也被称为每像素位数（ BPP ）或像素图的位面。空像素图具有深度为0 。
See also defaultDepth（）和Pixmap Information。
分离从共享像素映射数据的像素图。
一个像素图是由Qt的自动分离，每当其内容是即将改变。这是在几乎所有做QPixmap该修改像素图的成员函数（fill（ ）fromImage（ ）load（） ，等等） ，并且在QPainter.begin（ ）上的一个像素映射。
有两个例外，其中分离（ ）必须被显式调用，在调用时是handle（）或x11PictureHandle（ ）函数（仅适用于X11 ） 。否则，使用系统调用进行任何修改，将在共享的数据进行的。
该分离（ ）函数立即返回，如果有只是一个参考，或者如果像素映射还没有被初始化。
填充像素图与给定color。
这个函数的作用时，像素图被画上是不确定的。
See also Pixmap Transformations。
填充的像素图widget根据给定的偏移量的背景颜色或像素图。
该QPoint offset定义窗口小部件的点坐标到像素图的左上角的像素将被映射到。这是唯一的显着如果插件有一个背景像素映像，否则该像素映像将被简单地填充有小窗口的背景色。
这是一个重载函数。
填充的像素图widget的背景颜色或像素图。给定的点， （x，y） ，定义了一个在小部件偏移坐标到像素图的左上角的像素将被映射到。
转换给定的image使用指定的一个像素图flags来控制转换。该flags参数是的一个按位或Qt.ImageConversionFlags。路过0flags设置所有的默认选项。
在单色的情况下和8位的图像，该图像首先被转换为一个32位的像素图，然后填充在颜色表的颜色。如果这是过于昂贵的操作，您可以使用QBitmap.fromImage（ ）来代替。
See also fromImageReader（ ）toImage（）和Pixmap Conversion。
创建QPixmap从直接从读取的图像imageReader。该flags参数是的一个按位或Qt.ImageConversionFlags。路过0flags设置所有的默认选项。
在某些系统中，直接读取图像QPixmap可以使用较少的内存比读一本QImage将其转换为QPixmap。
See also fromImage（ ）toImage（）和Pixmap Conversion。
创建QPixmap从原生X11的像素图手柄pixmap，使用mode为共享模式。默认共享模式QPixmap.ImplicitlyShared，这意味着像素图的副本，如果有人试图通过如要修改它是由绘制到它。
QPixmap不not采取所有权pixmap处理，并必须由用户删除。
Warning:这个功能是X11特定;使用它是不可移植的。
此功能被引入Qt的4.5 。
See also QPixmap.ShareMode。
创建一个像素图和油漆给定的widget，受限于给定的rectangle在它。如果widget有任何孩子，那么他们也画在适当的位置。
如果没有指定矩形（默认值）将整个窗体是画。
If widget为0 ，指定的矩形不重叠部件的矩形，或发生错误，该函数将返回一个nullQPixmap。如果矩形是给定的一个超集widget，外面的区域widget都复盖着widget的背景。
这个功能实际上是问widget油漆本身（及其子画画本身）通过调用的paintEvent （ ）与画家重定向打开。但QPixmap还提供了grabWindow（ ）函数，它是一个快一点通过抓取像素直接关闭屏幕。此外，如果有重叠的窗口，grabWindow（ ） ，不像grabWidget （ ） ，会看到他们。
Warning:不要从它抢一个widgetQWidget.paintEvent（ ） 。然而，它是安全的抢从另一小窗口的小部件paintEvent()。
See also grabWindow（ ） 。
这是一个重载函数。
创建一个像素图和油漆给定的widget，受限于QRect（x，y，width，height） ，在它。
Warning:不要从它抢一个widgetQWidget.paintEvent（ ） 。然而，它是安全的抢从另一小窗口的小部件paintEvent()。
创建并返回被抓住给定的内容构成的像素图window限制QRect（x，y，width，height） 。
该参数（x，y）指定的窗口偏移，而（width，height）指定要复制的区域。如果width为负，则函数将一切交给窗口的右边框。如果height是否定的，则函数将一切向窗口的底部。
窗口系统标识符（WId）可使用检索到的QWidget.winId（）函数。使用一个窗口标识符，而不是一个的理由QWidget，是使窗口不属于该应用程序的一部分，窗口系统框架，等等抓取。
该grabWindow （ ）函数抓取像素的屏幕，而不是从窗口，也就是说，如果有另一个窗口部分或完全超过你抢，你从上复窗口得到的像素，太一。将鼠标光标一般不抓住。
注意：在X11 ，如果给定的window不具有相同的深度为根窗口，另一个窗口部分或全部掩盖你抢一个，你会not从上复窗口得到的像素。在像素图的遮挡区域的内容将是不确定的和未初始化的。
在Windows Vista及以上的抓住一个分层的窗口，这是通过设置创建Qt.WA_TranslucentBackground属性，将无法正常工作。而是抓住了桌面widget应该工作。
Warning:一般情况下，抓一个区域外屏幕是不是安全。这取决于底层的窗口系统。
See also grabWidget（）和Screenshot Example。
返回像素图的句柄，设备上下文。
需要注意的是，由于QPixmap利用implicit data sharing时，detach（）函数必须被调用明确，以确保只有this如果像素图的数据是共享的像素图的数据被修改。
Warning:这个功能是X11特定;使用它是不可移植的。
Warning:由于4.8 ，像素映射没有一个X11的手柄，除非与创造fromX11Pixmap()或者，如果本机图形系统明确激活。
See also detach（）和QApplication.setGraphicsSystem（ ） 。
返回True如果该像素图有一个alpha通道，or有一个面具，否则返回False 。
See also hasAlphaChannel（）和mask（ ） 。
返回True如果像素映射有一个尊重的alpha通道的格式，否则返回False 。
See also hasAlpha（ ） 。
返回像素图的高度。
See also size（）和Pixmap Information。
返回True如果这是一个空像素图，否则返回False 。
空像素映射具有零宽度，高度为零，没有内容。你可以不画在一个空像素图。
返回True如果这是一个QBitmap否则返回False 。
加载一个像素图从文件给定的fileName。返回True如果成功加载的像素图，否则返回False 。
装载程序将尝试使用指定的读取像素图format。如果format未指定（这是默认值） ，加载器探测文件的标题来猜测文件格式。
文件名可以是指在磁盘上的实际文件或应用的嵌入式资源之一。请参阅Resource System概述如何嵌入到应用程序的可执行像素图等资源文件的详细信息。
如果需要修改，以适应在一个较低分辨率的结果（例如，从32位转换为8位）的数据，使用flags来控制转换。
需要注意的是QPixmaps会自动添加到QPixmapCache当从文件加载;使用的密钥是内部的，不能获得的。
See also loadFromData（）和Reading and Writing Image Files。
加载从一个像素图len给定的二进制字节第一data。返回True如果加载成功的像素图，否则返回False 。
装载程序将尝试使用指定的读取像素图format。如果format未指定（这是默认值） ，加载器探测文件的标题来猜测文件格式。
如果需要修改，以适应在一个较低分辨率的结果（例如，从32位转换为8位）的数据，使用flags来控制转换。
See also load（）和Reading and Writing Image Files。
从像素图的Alpha通道中提取位图蒙版。
Warning:这是一个潜在的昂贵的操作。像素映像的掩码是从PixelData取出动态萃取。
See also setMask（）和Pixmap Information。
返回像素图的外接矩形。
See also Pixmap Information。
节省了像素映像的文件用给定的fileName使用指定的图像文件format和quality因素。成功返回True ，否则返回False 。
该quality因子必须在范围[ 0,100 ]或-1 。指定0以获得小的压缩文件， 100为大型未压缩的文件，和-1来使用默认设置。
If format是0 ，图像格式将被选自fileName的后缀。
See also Reading and Writing Image Files。
这是一个重载函数。
该函数将一个QPixmap为给定的device使用指定的图像文件format和quality因素。这可以用来，例如，直接保存一个像素映像成QByteArray：
QPixmap pixmap;
QByteArray bytes;
QBuffer buffer(&bytes);
buffer.open(QIODevice.WriteOnly);
pixmap.save(&buffer, "PNG"); // writes pixmap into bytes in PNG format
缩放像素映射到给定size使用由指定的高宽比和变换模式aspectRatioMode和transformMode。
如果给定的size是空的，这个函数返回一个空的像素图。
在某些情况下，它可以更有利绘制像素映射到带刻度设置，而不是缩放的像素图画家。这种情况下，当基于OpenGL或当快速缩放因子变化的画家为实例。
See also isNull（）和Pixmap Transformations。
这是一个重载函数。
返回像素图的缩放，以矩形与给定的一个副本width和height根据给定的aspectRatioMode和transformMode。
如果任何一个width或height为零或负数，则该函数返回一个空的pixmap 。
返回图像的缩放复印。返回的图像被缩放为给定的height使用指定的变换mode。是自动计算的像素映像的宽度，使像素图的纵横比被保存下来。
If height为0或负数，则返回一个空的像素图。
See also isNull（）和Pixmap Transformations。
返回图像的缩放复印。返回的图像被缩放为给定的width使用指定的变换mode。像素映像的高度是自动计算的，使得像素图的纵横比被保存下来。
If width为0或负数，则返回一个空的像素图。
See also isNull（）和Pixmap Transformations。
这个方便的功能等同于调用QPixmap.scroll （dx，dy，QRect（x，y，width，height） ，exposed） 。
此功能被引入Qt的4.6 。
See also QWidget.scroll（）和QGraphicsItem.scroll（ ） 。
滚动区rect这个像素映射的（dx，dy） 。暴露区域保持不变。您可以选择性地传递一个指针为空QRegion得到，它是区域exposed通过滚动操作。
QPixmap pixmap("background.png"); QRegion exposed; pixmap.scroll(10, 10, pixmap.rect(), &exposed);
你不能滚动，而没有对像素映射活跃的画家。
此功能被引入Qt的4.6 。
See also QWidget.scroll（）和QGraphicsItem.scroll（ ） 。
设置掩码位图。
此功能的合并mask与像素图的Alpha通道。 1在面具的像素值表示像素图的像素保持不变; 0值表示的像素是透明的。掩模必须具有相同的尺寸，因为这像素图。
设置一个空面具复位面具，留下前面透明像素的黑色。这个函数的作用时，像素图被画上是不确定的。
Warning:这是一个潜在的昂贵的操作。
See also mask（ ）Pixmap Transformations和QBitmap。
返回该像素映像的大小。
See also width（ ）height（）和Pixmap Information。
掉期的pixmapother与此像素图。这个操作是非常快的，而且永远不会。
此功能被引入Qt的4.8 。
像素图转换为QImage。返回如果转换失败，一个空的图像。
如果像素映射有1位深度，返回的图像也将是1位深。有更多的比特图像将在格式返回密切代表了底层系统。通常这将是QImage.Format_ARGB32_Premultiplied对于用alpha像素图和QImage.Format_RGB32 or QImage.Format_RGB16为像素图没有Alpha 。
请注意，就目前而言，在单色图像alpha蒙板被忽略。
See also fromImage（）和Image Formats。
返回被转换的像素图的使用给定的转型副本transform改造mode。原始像素图不改变。
改造transform是内部调整，以补偿不需要翻译，即所产生的像素图是包含原始像素图的所有转换后的点的最小像素图。使用trueMatrix（ ）函数来检索用于转化像素图的实际矩阵。
此功能是缓慢的，因为它涉及到转型为QImage，非平凡的计算和转换回QPixmap。
See also trueMatrix（）和Pixmap Transformations。
这是一个重载函数。
此功能方便的加载matrix成QTransform并调用重载函数。
返回用于转化一个像素映像与给定的实际的矩阵width，height和matrix。
当使用一个转换的像素图transformed（）函数，该变换矩阵是在内部调整以补偿不需要的翻译，即transformed（ ）返回一个包含原始像素图的全部改造点的最小像素图。这个函数返回修改后的矩阵，正确映射点从原来的像素映射到新的像素图。
See also transformed（）和Pixmap Transformations。
这是一个重载函数。
这种方便的功能加载矩阵m成QTransform并调用与重载的函数QTransform和宽度w和高度h。
返回像素图的宽度。
See also size（）和Pixmap Information。
X11 only:返回有关所使用到的像素图目前属于屏幕的X显示的配置信息。
Warning:此功能仅适用于X11 。
See also Pixmap Information。
X11 only:返回像素图的XRender的支持X11的图片处理。
这个函数将返回0，如果XRender的支持是不会被编译到Qt的，如果XRender的扩展不支持X11的显示器上，或者如果无法创建的句柄。这个函数的使用是不可移植的。
Warning:此功能仅适用于X11 。
See also Pixmap Information。
| PyQt 4.10.3 for X11 | Copyright © Riverbank Computing Ltd and Nokia 2012 | Qt 4.8.5 |