QPainter Class Reference

[QtGui module]

QPainter类的控件和其他绘图设备进行低级别的油画。More…

通过继承QStylePainter。

Types

• enum CompositionMode { CompositionMode_SourceOver, CompositionMode_DestinationOver, CompositionMode_Clear, CompositionMode_Source, ..., RasterOp_SourceAndNotDestination }
• class **[PixmapFragment]($docs-index.htm)**
• enum PixmapFragmentHint { OpaqueHint }
• class **[PixmapFragmentHints]($docs-index.htm)**
• enum RenderHint { Antialiasing, TextAntialiasing, SmoothPixmapTransform, HighQualityAntialiasing, NonCosmeticDefaultPen }
• class **[RenderHints]($docs-index.htm)**

Methods

• __init__ (self)
• __init__ (self, QPaintDevice)
• QBrush background (self)
• Qt.BGMode backgroundMode (self)
• bool begin (self, QPaintDevice)
• beginNativePainting (self)
• QRectF boundingRect (self, QRectF rect, int flags, QString text)
• QRect boundingRect (self, QRect rect, int flags, QString text)
• QRectF boundingRect (self, QRectF rectangle, QString text, QTextOption option = QTextOption())
• QRect boundingRect (self, int x, int y, int w, int h, int flags, QString text)
• QBrush brush (self)
• QPoint brushOrigin (self)
• QRectF clipBoundingRect (self)
• QPainterPath clipPath (self)
• QRegion clipRegion (self)
• QMatrix combinedMatrix (self)
• QTransform combinedTransform (self)
• CompositionMode compositionMode (self)
• QPaintDevice device (self)
• QMatrix deviceMatrix (self)
• QTransform deviceTransform (self)
• drawArc (self, QRectF rect, int a, int alen)
• drawArc (self, QRect r, int a, int alen)
• drawArc (self, int x, int y, int w, int h, int a, int alen)
• drawChord (self, QRectF rect, int a, int alen)
• drawChord (self, QRect rect, int a, int alen)
• drawChord (self, int x, int y, int w, int h, int a, int alen)
• drawConvexPolygon (self, QPointF point, ...)
• drawConvexPolygon (self, QPolygonF poly)
• drawConvexPolygon (self, QPoint point, ...)
• drawConvexPolygon (self, QPolygon poly)
• drawEllipse (self, QRectF r)
• drawEllipse (self, QRect r)
• drawEllipse (self, int x, int y, int w, int h)
• drawEllipse (self, QPointF center, float rx, float ry)
• drawEllipse (self, QPoint center, int rx, int ry)
• drawGlyphRun (self, QPointF position, QGlyphRun glyphRun)
• drawImage (self, QRectF targetRect, QImage image, QRectF sourceRect, Qt.ImageConversionFlags flags = Qt.AutoColor)
• drawImage (self, QRect targetRect, QImage image, QRect sourceRect, Qt.ImageConversionFlags flags = Qt.AutoColor)
• drawImage (self, QPointF p, QImage image, QRectF sr, Qt.ImageConversionFlags flags = Qt.AutoColor)
• drawImage (self, QPoint p, QImage image, QRect sr, Qt.ImageConversionFlags flags = Qt.AutoColor)
• drawImage (self, QRectF r, QImage image)
• drawImage (self, QRect r, QImage image)
• drawImage (self, QPointF p, QImage image)
• drawImage (self, QPoint p, QImage image)
• drawImage (self, int x, int y, QImage image, int sx = 0, int sy = 0, int sw = -1, int sh = -1, Qt.ImageConversionFlags flags = Qt.AutoColor)
• drawLine (self, QLineF l)
• drawLine (self, QLine line)
• drawLine (self, int x1, int y1, int x2, int y2)
• drawLine (self, QPoint p1, QPoint p2)
• drawLine (self, QPointF p1, QPointF p2)
• drawLines (self, QLineF line, ...)
• drawLines (self, list-of-QLineF lines)
• drawLines (self, QPointF pointPair, ...)
• drawLines (self, list-of-QPointF pointPairs)
• drawLines (self, QLine line, ...)
• drawLines (self, list-of-QLine lines)
• drawLines (self, QPoint pointPair, ...)
• drawLines (self, list-of-QPoint pointPairs)
• drawPath (self, QPainterPath path)
• drawPicture (self, QPointF p, QPicture picture)
• drawPicture (self, int x, int y, QPicture p)
• drawPicture (self, QPoint pt, QPicture p)
• drawPie (self, QRectF rect, int a, int alen)
• drawPie (self, QRect rect, int a, int alen)
• drawPie (self, int x, int y, int w, int h, int a, int alen)
• drawPixmap (self, QRectF targetRect, QPixmap pixmap, QRectF sourceRect)
• drawPixmap (self, QRect targetRect, QPixmap pixmap, QRect sourceRect)
• drawPixmap (self, QPointF p, QPixmap pm)
• drawPixmap (self, QPoint p, QPixmap pm)
• drawPixmap (self, QRect r, QPixmap pm)
• drawPixmap (self, int x, int y, QPixmap pm)
• drawPixmap (self, int x, int y, int w, int h, QPixmap pm)
• drawPixmap (self, int x, int y, int w, int h, QPixmap pm, int sx, int sy, int sw, int sh)
• drawPixmap (self, int x, int y, QPixmap pm, int sx, int sy, int sw, int sh)
• drawPixmap (self, QPointF p, QPixmap pm, QRectF sr)
• drawPixmap (self, QPoint p, QPixmap pm, QRect sr)
• drawPixmapFragments (self, list-of-QPainter.PixmapFragment fragments, QPixmap pixmap, PixmapFragmentHints hints = 0)
• drawPixmapFragments (self, list-of-QRectF targetRects, list-of-QRectF sourceRects, QPixmap pixmap, PixmapFragmentHints hints = 0)
• drawPoint (self, QPointF p)
• drawPoint (self, int x, int y)
• drawPoint (self, QPoint p)
• drawPoints (self, QPointF point, ...)
• drawPoints (self, QPolygonF points)
• drawPoints (self, QPoint point, ...)
• drawPoints (self, QPolygon points)
• drawPolygon (self, QPointF point, ...)
• drawPolygon (self, QPolygonF points, Qt.FillRule fillRule = Qt.OddEvenFill)
• drawPolygon (self, QPoint point, ...)
• drawPolygon (self, QPolygon points, Qt.FillRule fillRule = Qt.OddEvenFill)
• drawPolyline (self, QPointF point, ...)
• drawPolyline (self, QPolygonF polyline)
• drawPolyline (self, QPoint point, ...)
• drawPolyline (self, QPolygon polyline)
• drawRect (self, QRectF rect)
• drawRect (self, int x, int y, int w, int h)
• drawRect (self, QRect r)
• drawRects (self, QRectF rect, ...)
• drawRects (self, list-of-QRectF rects)
• drawRects (self, QRect rect, ...)
• drawRects (self, list-of-QRect rects)
• drawRoundedRect (self, QRectF rect, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)
• drawRoundedRect (self, int x, int y, int w, int h, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)
• drawRoundedRect (self, QRect rect, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)
• drawRoundRect (self, QRectF r, int xRound = 25, int yRound = 25)
• drawRoundRect (self, int x, int y, int w, int h, int xRound = 25, int yRound = 25)
• drawRoundRect (self, QRect r, int xRound = 25, int yRound = 25)
• drawStaticText (self, QPointF topLeftPosition, QStaticText staticText)
• drawStaticText (self, QPoint p, QStaticText staticText)
• drawStaticText (self, int x, int y, QStaticText staticText)
• drawText (self, QPointF p, QString s)
• QRectF boundingRect drawText (self, QRectF rectangle, int flags, QString text)
• QRect boundingRect drawText (self, QRect rectangle, int flags, QString text)
• drawText (self, QRectF rectangle, QString text, QTextOption option = QTextOption())
• drawText (self, QPoint p, QString s)
• QRect boundingRect drawText (self, int x, int y, int width, int height, int flags, QString text)
• drawText (self, int x, int y, QString s)
• drawTiledPixmap (self, QRectF rectangle, QPixmap pixmap, QPointF pos = QPointF())
• drawTiledPixmap (self, QRect rectangle, QPixmap pixmap, QPoint pos = QPoint())
• drawTiledPixmap (self, int x, int y, int width, int height, QPixmap pixmap, int sx = 0, int sy = 0)
• bool end (self)
• endNativePainting (self)
• eraseRect (self, QRectF)
• eraseRect (self, QRect rect)
• eraseRect (self, int x, int y, int w, int h)
• fillPath (self, QPainterPath path, QBrush brush)
• fillRect (self, QRectF, QBrush)
• fillRect (self, QRect, QBrush)
• fillRect (self, int x, int y, int w, int h, QBrush b)
• fillRect (self, QRectF, QColor color)
• fillRect (self, QRect, QColor color)
• fillRect (self, int x, int y, int w, int h, QColor b)
• fillRect (self, int x, int y, int w, int h, Qt.GlobalColor c)
• fillRect (self, QRect r, Qt.GlobalColor c)
• fillRect (self, QRectF r, Qt.GlobalColor c)
• fillRect (self, int x, int y, int w, int h, Qt.BrushStyle style)
• fillRect (self, QRect r, Qt.BrushStyle style)
• fillRect (self, QRectF r, Qt.BrushStyle style)
• QFont font (self)
• QFontInfo fontInfo (self)
• QFontMetrics fontMetrics (self)
• bool hasClipping (self)
• initFrom (self, QWidget widget)
• bool isActive (self)
• Qt.LayoutDirection layoutDirection (self)
• QMatrix matrix (self)
• bool matrixEnabled (self)
• float opacity (self)
• QPaintEngine paintEngine (self)
• QPen pen (self)
• RenderHints renderHints (self)
• resetMatrix (self)
• resetTransform (self)
• restore (self)
• rotate (self, float a)
• save (self)
• scale (self, float sx, float sy)
• setBackground (self, QBrush bg)
• setBackgroundMode (self, Qt.BGMode mode)
• setBrush (self, QBrush brush)
• setBrush (self, Qt.BrushStyle style)
• setBrushOrigin (self, QPointF)
• setBrushOrigin (self, int x, int y)
• setBrushOrigin (self, QPoint p)
• setClipPath (self, QPainterPath path, Qt.ClipOperation operation = Qt.ReplaceClip)
• setClipping (self, bool enable)
• setClipRect (self, QRectF rectangle, Qt.ClipOperation operation = Qt.ReplaceClip)
• setClipRect (self, int x, int y, int width, int height, Qt.ClipOperation operation = Qt.ReplaceClip)
• setClipRect (self, QRect rectangle, Qt.ClipOperation operation = Qt.ReplaceClip)
• setClipRegion (self, QRegion region, Qt.ClipOperation operation = Qt.ReplaceClip)
• setCompositionMode (self, CompositionMode mode)
• setFont (self, QFont f)
• setLayoutDirection (self, Qt.LayoutDirection direction)
• setMatrix (self, QMatrix matrix, bool combine = False)
• setMatrixEnabled (self, bool enabled)
• setOpacity (self, float opacity)
• setPen (self, QColor color)
• setPen (self, QPen pen)
• setPen (self, Qt.PenStyle style)
• setRenderHint (self, RenderHint hint, bool on = True)
• setRenderHints (self, RenderHints hints, bool on = True)
• setTransform (self, QTransform transform, bool combine = False)
• setViewport (self, QRect viewport)
• setViewport (self, int x, int y, int w, int h)
• setViewTransformEnabled (self, bool enable)
• setWindow (self, QRect window)
• setWindow (self, int x, int y, int w, int h)
• setWorldMatrix (self, QMatrix matrix, bool combine = False)
• setWorldMatrixEnabled (self, bool enabled)
• setWorldTransform (self, QTransform matrix, bool combine = False)
• shear (self, float sh, float sv)
• strokePath (self, QPainterPath path, QPen pen)
• bool testRenderHint (self, RenderHint hint)
• QTransform transform (self)
• translate (self, QPointF offset)
• translate (self, float dx, float dy)
• translate (self, QPoint offset)
• QRect viewport (self)
• bool viewTransformEnabled (self)
• QRect window (self)
• QMatrix worldMatrix (self)
• bool worldMatrixEnabled (self)
• QTransform worldTransform (self)

Static Methods

• QPaintDevice redirected (QPaintDevice device, QPoint offset = None)
• restoreRedirected (QPaintDevice device)
• setRedirected (QPaintDevice device, QPaintDevice replacement, QPoint offset = QPoint())

Special Methods

• object __enter__ (self)
• __exit__ (self, object type, object value, object traceback)

Detailed Description

QPainter类的控件和其他绘图设备进行低级别的油画。

QPainter提供了高度优化的函数来完成大部分的绘图GUI程序的要求。由此可以得出一切从简单的线条到复杂的形状像馅饼和和弦。它也可以绘制对齐的文本和像素图。通常情况下，它绘制一个“自然”的坐标系中，但它也可以做视图和世界的改造。 QPainter可以在继承的任何对象操作QPaintDevice类。

共同使用的QPainter的是里面的一个小部件的绘制事件：构建和自定义（如设置笔或刷子）的画家。再画。记住拉丝后销毁QPainter的对象。例如：

 void SimpleExampleWidget.paintEvent([QPaintEvent](qpaintevent.html) *)
 {
     QPainter painter(this);
     painter.setPen([Qt](qt.html).blue);
     painter.setFont([QFont]($docs-qfont.html)("Arial", 30));
     painter.drawText(rect(), [Qt](qt.html).AlignCenter, "Qt");
 }

QPainter的核心功能是绘图，但是这个类还提供了几个函数，允许您自定义的QPainter的设置和它的渲染质量，和其他人，使削波。此外，您可以控制不同的形状如何通过指定画家的组成模式合并在一起。

该isActive（）函数表示的画家是否处于活动状态。画家被激活begin（ ）函数，而这需要一个构造函数QPaintDevice的说法。该end（ ）函数，析构函数，停用它。

连同QPaintDevice和QPaintEngine类， QPainter的形成的基础， Qt的涂料体系。 QPainter的是用于执行绘图操作的类。QPaintDevice表示可以涂在使用QPainter的一个装置。QPaintEngine规定，画家用来绘制到不同类型的设备的接口。如果画家是活动的，device（ ）返回绘制设备上的画家描绘，和paintEngine（ ）返回的绘图引擎，该画家目前在运行。欲了解更多信息，请参阅Paint System。

有时候我们需要让别人漆上不同寻常的QPaintDevice。 QPainter的支持静态函数来做到这一点，setRedirected（ ） 。

Warning:当paintdevice是一个小部件， QPainter的只能内的paintEvent （）函数或在一个称为的paintEvent （功能）中使用，也就是说，除非Qt.WA_PaintOutsidePaintEvent插件属性设置。在Mac OS X和Windows ，你只能在一个的paintEvent （ ）函数漆不管这个属性的设置。

Settings

有几个设置，您可以自定义，以使根据您的喜好了QPainter绘制：

• font() is the font used for drawing text. If the painter isActive(), you can retrieve information about the currently set font, and its metrics, using the fontInfo() and fontMetrics() functions respectively.
• brush() defines the color or pattern that is used for filling shapes.
• pen() defines the color or stipple that is used for drawing lines or boundaries.
• backgroundMode() defines whether there is a background() or not, i.e it is either Qt.OpaqueMode or Qt.TransparentMode.
• background() only applies when backgroundMode() is Qt.OpaqueMode and pen() is a stipple. In that case, it describes the color of the background pixels in the stipple.
• brushOrigin() defines the origin of the tiled brushes, normally the origin of widget’s background.
• viewport(), window(), worldTransform() make up the painter’s coordinate transformation system. For more information, see the Coordinate Transformations section and the Coordinate System documentation.
• hasClipping() tells whether the painter clips at all. (The paint device clips, too.) If the painter clips, it clips to clipRegion().
• layoutDirection() defines the layout direction used by the painter when drawing text.
• worldMatrixEnabled() tells whether world transformation is enabled.
• viewTransformEnabled() tells whether view transformation is enabled.

需要注意的是其中的一些设置反映在一些油漆设备的设置，比如QWidget.font（ ） 。该QPainter.begin（ ）函数（或等价的QPainter的构造函数）从绘制设备拷贝这些属性。

您可以在任何时候保存了QPainter的状态通过调用save（ ）函数，它节省了内部堆栈中的所有可用的设置。该restore（ ）函数弹出他们回来。

Drawing

QPainter提供了许多功能来绘制最原语：drawPoint（ ）drawPoints（ ）drawLine（ ）drawRect（ ）drawRoundedRect（ ）drawEllipse（ ）drawArc（ ）drawPie（ ）drawChord（ ）drawPolyline（ ）drawPolygon（ ）drawConvexPolygon（）和drawCubicBezier（ ） 。这两个便利的功能，drawRects（）和drawLines（ ） ，绘制矩形或线条的给定数组中的给定数量QRects or QLines使用当前画笔和画刷。

QPainter类还提供了fillRect（）函数，其填埋所述给定QRect用给定的QBrush和eraseRect（ ）函数，删除给定矩形内的区域。

所有这些功能都同时具有整数和浮点版本。

| | Basic Drawing Example该Basic Drawing示例显示了如何使用QPainter类在各种不同的风格显示基本的图形元素。 |

如果您需要绘制一个形状复杂，特别是如果你需要重复这样做，考虑创建一个QPainterPath并用它绘制drawPath（ ） 。

| Painter Paths example该QPainterPath类提供一个容器，用于绘制操作，从而能够构造和重用的图形形状。该Painter Paths例子显示了画家的路径如何可以用来构建复杂的形状进行渲染。 | |

的QPainter还提供了fillPath（）函数，其填埋所述给定QPainterPath用给定的QBrush和strokePath（ ）函数绘制给定路径的轮廓（即描边路径） 。

另见Vector Deformation演示展示了如何利用先进的矢量技术，用来绘制文本QPainterPath时，Gradients演示显示了不同类型的梯度是在Qt中可用的，并且Path Stroking演示这显示了Qt内建的虚线样式，并显示自定义模式可以如何用来扩展现有模式的范围。

Vector Deformation	Gradients	Path Stroking

有功能绘制像素图/图像，即drawPixmap（ ）drawImage（）和drawTiledPixmap（ ） 。两drawPixmap（）和drawImage（）产生相同的结果，不同之处在于drawPixmap（ ）更快的屏幕，而drawImage（ ）可能会更快的QPrinter或其他装置。

使用文本绘制完成时drawText（ ） 。当你需要细粒度的定位，boundingRect（ ）告诉你在哪里给定的drawText（ ）命令将绘制。

有一个drawPicture（）函数绘制的整个内容QPicture。该drawPicture（ ）函数是忽略所有画家的设置作为唯一功能QPicture有它自己的设置。

Rendering Quality

要获得使用QPainter的最佳渲染效果，你应该使用平台无关QImage油漆设备;即使用QImage将确保结果具有在任何平台上相同的像素表示。

QPainter类还提供了通过控制渲染质量的一种手段其RenderHint枚举和浮点精度支持：绘制原语所有的功能都有一个浮点版本。这些通常以与组合使用QPainter.Antialiasing呈现提示。

| | Concentric Circles Example该Concentric Circles实例表明，可以绘制自定义部件在使用浮点精度和抗混叠得到改善渲染质量。应用程序的主窗口中显示其正在使用的精度和抗混叠的各种组合，得出了几个小部件。 |

该RenderHint枚举指定标志来QPainter的，可能会或可能不会被任何给定的发动机尊重。QPainter.Antialiasing表明发动机应该反锯齿原语的边缘，如果可能的话，QPainter.TextAntialiasing表明发动机应尽可能消除文字锯齿，而QPainter.SmoothPixmapTransform表明发动机应该使用一个平滑的pixmap变换算法。HighQualityAntialiasing是一个OpenGL的具体呈现提示，指示引擎应使用片断程序和离屏渲染的抗锯齿。

该renderHints（ ）函数返回一个标志，指定在这个画家将呈现提示。使用setRenderHint（ ）函数来设置或清除当前设置的RenderHints。

Coordinate Transformations

通常情况下， QPainter的操作设备自己的坐标系统（通常是像素） ，但QPainter的具有坐标变换良好的支持。

nop	rotate()	scale()	translate()

最常用的变换是缩放，旋转，平移和剪切。使用scale（）函数以一个给定的偏移量来缩放坐标系中，rotate（ ）函数则顺时针旋转和translate（）把它翻译出来（即增加一个给定的偏移量点） 。也可以使用捻坐标系原点周围的shear（）函数。请参阅Affine Transformations演示了剪切坐标系统的可视化。

另见Transformations例如，显示转变如何影响了QPainter的渲染图元的方式。尤其是，它显示了如何变换的顺序会影响结果。

| Affine Transformations Demo该Affine Transformations演示显示了Qt的能力画上执行的操作仿射变换。该演示还允许用户尝试使用转换操作，并立即看到结果。 | |

所有穿越 - 操作上进行改造工作worldTransform（ ） 。矩阵转换成在平面上的点到另一点。如需变换矩阵的更多信息，请参见Coordinate System和QTransform文档。

该setWorldTransform（ ）函数可以更换或添加到当前设置的worldTransform（ ） 。该resetTransform（ ）函数重置的是用做任何转换translate（ ）scale（ ）shear（ ）rotate（ ）setWorldTransform（ ）setViewport（）和setWindow（）函数。该deviceTransform（ ）返回一个转换从逻辑坐标到平台相关的绘图设备的设备坐标的矩阵。后者的功能是对平台相关的手柄使用平台的绘画命令时，才需要，而平台没有做转换nativly 。

当使用QPainter的绘图，我们使用它，然后被转换成漆设备的物理坐标逻辑坐标指定点。逻辑坐标物理坐标的映射由QPainter的的处理combinedTransform（ ）的组合viewport（）和window（）和worldTransform（ ） 。该viewport（）表示物理坐标指定一个任意的矩形，则window（ ）描述在逻辑坐标相同的矩形，并且worldTransform（）是相同的变换矩阵。

另请参阅Coordinate System

Clipping

QPainter的可夹任何拉伸操作到一个矩形，区域，或一个矢量路径。使用功能的当前片段可clipRegion（）和clipPath（ ） 。无论路径或地区是首选（快）取决于相关paintEngine（ ） 。例如，本QImage绘图引擎更喜欢的路径，而X11的绘图引擎更喜欢的区域。设置一个剪辑的画家逻辑坐标进行。

经过了QPainter的裁剪，绘制设备也可能被裁剪。例如，大多数的部件夹了使用的子控件的像素，并且大多数打印机夹了接近纸张的边缘区域。这种额外的裁剪不受的返回值反映clipRegion（）或hasClipping（ ） 。

Composition Modes

QPainter提供了该CompositionMode枚举它定义了数字图像合成波特 - 达芙的规则，它描述了一个模型，结合在一个图像，源像素，在另一个图像中，目标像素。

的组合物中的两种最常见的形式是Source和SourceOver。Source用于绘制不透明的物体上绘制设备。在这种模式下，在源代码中的每个像素将替换目的地中的相应像素。在SourceOver组合模式，源对象是透明的，被描绘在目标之上。

请注意，组成转变经营pixelwise 。出于这个原因，有使用图形原语本身和它的边界矩形之间的差：该边界矩形中包含与α == 0 （即周围的原始像素）的像素。这些像素将复盖其他图像的像素，情感上清除那些，而原始的只有复盖其自身的区域。

| | Composition Modes Demo该Composition Modes演示中，在Qt的demo目录可用，让你体验不同的组合方式，并立即看到结果。 |

Limitations

如果您使用的坐标与Qt的基于光栅的绘图引擎，一定要注意这一点很重要，而坐标大于+ / - 215可以使用，超出该范围的坐标进行任何绘画不保证显示;绘图可能会被裁剪。这是由于使用的short int在执行。

通过Qt的抚摩产生的轮廓是只是一个近似值与时曲线形状处理。它是在不可能代表使用另一个贝塞尔曲线段Bezier曲线段的轮廓大多数情况下，与这样的Qt近似曲线概述通过使用几个较小的曲线。出于性能的考虑是有限制的Qt多少曲线使用这些轮廓，从而使用大画笔的宽度时，或缩放的轮廓误差增大。以产生轮廓线具有较小的误差，可以使用QPainterPathStroker类，它有它，让我们的用户指定的误差容限的setCurveThreshold成员函数。另一种解决方法是将路径多边形先转换，然后绘制多边形来代替。

Performance

QPainter的是一个丰富的框架，它允许开发者做一个伟大的各种图形操作，如渐变，组成方式和矢量图形。和QPainter的可以在各种不同的硬件和软件堆栈做到这一点。当然硬件和软件的基本组合有一定的影响性能，并确保每一个运算速度快结合的组成模式，画笔，裁剪，转换等所有各种组合，是因为接近一个不可能完成的任务排列的号码。作为一种妥协，我们选择了QPainter的API和后端，在性能保证是一样好，我们可以合理地得到它的硬件和软件的结合给定的一个子集。

我们专注于为高性能引擎的后端是：

• Raster - This backend implements all rendering in pure software and is always used to render into QImages. For optimal performance only use the format types QImage.Format_ARGB32_Premultiplied, QImage.Format_RGB32 or QImage.Format_RGB16. Any other format, including QImage.Format_ARGB32, has significantly worse performance. This engine is also used by default on Windows and on QWS. It can be used as default graphics system on any OS/hardware/software combination by passing -graphicssystem raster on the command line
• OpenGL 2.0 (ES) - This backend is the primary backend for hardware accelerated graphics. It can be run on desktop machines and embedded devices supporting the OpenGL 2.0 or OpenGL/ES 2.0 specification. This includes most graphics chips produced in the last couple of years. The engine can be enabled by using QPainter onto a QGLWidget or by passing -graphicssystem opengl on the command line when the underlying system supports it.
• OpenVG - This backend implements the Khronos standard for 2D and Vector Graphics. It is primarily for embedded devices with hardware support for OpenVG. The engine can be enabled by passing -graphicssystem openvg on the command line when the underlying system supports it.

这些操作是：

• Simple transformations, meaning translation and scaling, pluss 0, 90, 180, 270 degree rotations.
• drawPixmap() in combination with simple transformations and opacity with non-smooth transformation mode (QPainter.SmoothPixmapTransform not enabled as a render hint).
• Rectangle fills with solid color, two-color linear gradients and simple transforms.
• Rectangular clipping with simple transformations and intersect clip.
• Composition Modes QPainter.CompositionMode_Source and QPainter.CompositionMode_SourceOver
• Rounded rectangle filling using solid color and two-color linear gradients fills.
• 3x3 patched pixmaps, via qDrawBorderPixmap.

此列表提供了一个迹象，其中的功能在一个应用程序的性能是至关重要的安全使用。对于某些设置，其他操作可能会快过，但使它们的广泛使用之前，建议进行基准测试和验证他们的系统，该软件将在年底运行。此外，有昂贵的操作是确定使用的情况下，例如当结果被缓存在一个QPixmap。

Type Documentation

QPainter.CompositionMode

定义了支持数字图像合成的模式。组合模式用于指定如何在一个图像中的像素，源，在另一图像中，目的地合并像素。

请注意，按位光栅操作模式，表示一个RasterOp的前缀，仅本地支持的X11和光栅涂料引擎。这意味着，利用Mac上这些模式的唯一途径是通过一个QImage。文件中的RasterOp表示混合模式not支持笔和画笔与alpha分量。另外，在接通QPainter.Antialiasing渲染暗示将有效地禁用RasterOp的模式。

最常见的类型是SourceOver （通常被称为只是α混合），其中源像素被混合在目标像素的顶部在这样一种方式，光源的阿尔法分量定义像素的透明度。

当涂料设备是QImage中，图像的格式必须被设置为Format_ARGB32Premultiplied or Format_ARGB32对于该组合物的模式有任何效果。对于业绩的预乘的版本是首选格式。

当一个组成模式设置适用于所有运营商的绘画，钢笔，画笔，渐变和像素图/影像图。

See also compositionMode（ ）setCompositionMode（ ）Composition Modes和Image Composition Example。

QPainter.PixmapFragmentHint

这个枚举被引入或修改的Qt 4.7 。

该PixmapFragmentHints类型是一个typedef为QFlags\u003cPixmapFragmentHint\u003e 。它存储PixmapFragmentHint值的或组合。

See also QPainter.drawPixmapFragments（）和QPainter.PixmapFragment。

QPainter.RenderHint

Renderhints用于指定标志来QPainter可能会或可能不会被任何给定的发动机尊重。

该RenderHints类型是一个typedef为QFlags\u003cRenderHint\u003e 。它存储RenderHint值的或组合。

See also renderHints（ ）setRenderHint（ ）Rendering Quality和Concentric Circles Example。

Method Documentation

QPainter.__init__ (self)

构造一个画家。

See also begin（）和end（ ） 。

QPainter.__init__ (self, QPaintDevice)

构造一个画家的画开始油漆device马上。

此构造方便短命的画家，如：在QWidget.paintEvent（ ），并应只能使用一次。该构造函数调用begin（ ）为您和QPainter析构函数会自动调用end（ ） 。

下面是一个使用例子begin（）和end（）：

 void MyWidget.paintEvent([QPaintEvent](qpaintevent.html) *)
 {
     [QPainter]($docs-qpainter.html) p;
     p.begin(this);
     p.drawLine(...);        // drawing code
     p.end();
 }

使用此构造相同的例子：

 void MyWidget.paintEvent([QPaintEvent](qpaintevent.html) *)
 {
     [QPainter]($docs-qpainter.html) p(this);
     p.drawLine(...);        // drawing code
 }

由于构造函数不能提供反馈时，画家的初始化失败，你应该宁可使用begin（）和end（ ）画上的外部设备，例如打印机。

See also begin（）和end（ ） 。

QBrush QPainter.background (self)

[

返回当前背景刷。

]($docs-qbrush.html)

See also setBackground（）和Settings。

Qt.BGMode QPainter.backgroundMode (self)

[

返回当前背景模式。

]($docs-qt.html#BGMode-enum)

See also setBackgroundMode（）和Settings。

bool QPainter.begin (self, QPaintDevice)

开始画漆device如果成功返回True，否则返回False 。

请注意，所有画家的设置（setPen（ ）setBrush（ ）等）被重置为默认时开始值（ ）被调用。

可能发生的错误是严重的问题，如这些：

 painter->begin(0); // impossible - paint device cannot be 0
 [QPixmap]($docs-qpixmap.html) image(0, 0);
 painter->begin(&image); // impossible - image.isNull() == true;
 painter->begin(myWidget);
 painter2->begin(myWidget); // impossible - only one painter at a time

请注意，大多数的时候，你可以使用一个构造函数，而不是开始（ ） ，而end（ ）会自动在毁灭完成。

Warning:一种涂料设备只能由一个画家在同一时间内绘。

Warning:画上一个QImage与格式QImage.Format_Indexed8不被支持。

See also end（）和QPainter（ ） 。

QPainter.beginNativePainting (self)

刷新绘画管道，并准备直接与基础图形上下文发出命令的用户。必须后跟调用endNativePainting（ ） 。

请注意，只有国家的基本绘图引擎的变化将被重置为各自的默认状态。我们重置状态可能会改变从发布到解除。以下状态重置目前在OpenGL的2引擎：

• blending is disabled
• the depth, stencil and scissor tests are disabled
• the active texture unit is reset to 0
• the depth mask, depth function and the clear depth are reset to their default values
• the stencil mask, stencil operation and stencil function are reset to their default values
• the current color is reset to solid white

如果，例如OpenGL的多边形模式是由内部的beginNativePaint用户改变（）/endNativePainting（）块，它不会被重置为默认状态endNativePainting（ ） 。下面是一个例子，显示了画家的命令和原OpenGL命令的混杂：

 [QPainter]($docs-qpainter.html) painter(this);
 painter.fillRect(0, 0, 128, 128, [Qt](qt.html).green);
 painter.beginNativePainting();
 glEnable(GL_SCISSOR_TEST);
 glScissor(0, 0, 64, 64);
 glClearColor(1, 0, 0, 1);
 glClear(GL_COLOR_BUFFER_BIT);
 glDisable(GL_SCISSOR_TEST);
 painter.endNativePainting();

此功能被引入Qt的4.6 。

See also endNativePainting（ ） 。

QRectF QPainter.boundingRect (self, QRectF rect, int flags, QString text)

返回的矩形边界text因为当内给定的绘制它会出现rectangle用指定的flags使用当前设置的font（）;即该函数告诉你在哪里drawText（ ）函数将以此给予相同的参数时。

如果text在给定的不适合rectangle使用指定的flags，该函数返回所需要的矩形。

该flags参数是下列标志的按位或：

• Qt.AlignLeft
• Qt.AlignRight
• Qt.AlignHCenter
• Qt.AlignTop
• Qt.AlignBottom
• Qt.AlignVCenter
• Qt.AlignCenter
• Qt.TextSingleLine
• Qt.TextExpandTabs
• Qt.TextShowMnemonic
• Qt.TextWordWrap
• Qt.TextIncludeTrailingSpaces

如果多个水平或几个的垂直对齐的标志被设置，所产生的取向是不确定的。

See also drawText（ ）Qt.Alignment和Qt.TextFlag。

QRect QPainter.boundingRect (self, QRect rect, int flags, QString text)

QRectF QPainter.boundingRect (self, QRectF rectangle, QString text, QTextOption option = QTextOption())

QRect QPainter.boundingRect (self, int x, int y, int w, int h, int flags, QString text)

[

这是一个重载函数。

]($docs-qrect.html)

返回的矩形边界text因为当内给定的绘制它会出现rectangle用指定的flags使用当前设置的font（ ） 。

QBrush QPainter.brush (self)

[

返回画家的当前画笔。

]($docs-qbrush.html)

See also QPainter.setBrush（）和Settings。

QPoint QPainter.brushOrigin (self)

[

返回当前设置的画刷原点。

]($docs-qpoint.html)

See also setBrushOrigin（）和Settings。

QRectF QPainter.clipBoundingRect (self)

[

返回如果有一个夹子当前剪辑的边框，否则返回一个空的矩形。注意裁剪区域是由于在逻辑坐标。

矩形边界是不能保证是紧张。

此功能被引入Qt的4.8 。

]($docs-qrectf.html)

See also setClipRect（ ）setClipPath（）和setClipRegion（ ） 。

QPainterPath QPainter.clipPath (self)

[

返回当前剪辑的路径。请注意，剪辑路径，给出了逻辑坐标。

]($docs-qpainterpath.html)

Warning: QPainter没有明确地存储该组合的片段，因为这是由底层处理QPaintEngine的，所以路径被重新按要求并转化到当前的逻辑坐标系统。这是一个潜在的昂贵的操作。

See also setClipPath（ ）clipRegion（）和setClipping（ ） 。

QRegion QPainter.clipRegion (self)

[

返回当前设置的裁剪区域。注意裁剪区域是由于在逻辑坐标。

]($docs-qregion.html)

Warning: QPainter没有明确地存储该组合的片段，因为这是由底层处理QPaintEngine的，所以路径被重新按要求并转化到当前的逻辑坐标系统。这是一个潜在的昂贵的操作。

See also setClipRegion（ ）clipPath（）和setClipping（ ） 。

QMatrix QPainter.combinedMatrix (self)

QTransform QPainter.combinedTransform (self)

[

将转换矩阵结合当前窗口/视口和世界的改造。

]($docs-qtransform.html)

See also setWorldTransform（ ）setWindow（）和setViewport（ ） 。

CompositionMode QPainter.compositionMode (self)

[

返回当前的组成模式。

]($docs-qpainter.html#CompositionMode-enum)

See also CompositionMode和setCompositionMode（ ） 。

QPaintDevice QPainter.device (self)

[

返回漆设备上这个画家正在画画，或者0，如果画家不活跃。

]($docs-qpaintdevice.html)

See also isActive（ ） 。

QMatrix QPainter.deviceMatrix (self)

QTransform QPainter.deviceTransform (self)

[

返回从转换逻辑坐标到平台相关的绘图设备的设备坐标的矩阵。

]($docs-qtransform.html)

这个功能是only在平台相关的句柄（使用平台的绘画命令时需要Qt.HANDLE），以及平台不nativly做转换。

该QPaintEngine.PaintEngineFeature枚举可以被查询，以确定是否该平台进行变换与否。

See also worldTransform（）和QPaintEngine.hasFeature（ ） 。

QPainter.drawArc (self, QRectF rect, int a, int alen)

绘制由给定的定义的弧rectangle，startAngle和spanAngle。

该startAngle和spanAngle必须以一定程度的十六分之一来指定，即一个完整的圆等于5760 （ 16 * 360 ） 。用于角度的正值逆时针意思而负值意味着顺时针方向。零度是在3点钟的位置。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 int startAngle = 30 * 16;
 int spanAngle = 120 * 16;
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawArc(rectangle, startAngle, spanAngle);

|

See also drawPie（ ）drawChord（）和Coordinate System。

QPainter.drawArc (self, QRect r, int a, int alen)

这是一个重载函数。

绘制由给定的定义的弧rectangle，startAngle和spanAngle。

QPainter.drawArc (self, int x, int y, int w, int h, int a, int alen)

这是一个重载函数。

绘制由矩形起点在（定义弧x，y）用指定的width和height和给定的startAngle和spanAngle。

QPainter.drawChord (self, QRectF rect, int a, int alen)

绘制和弦由给定的定义rectangle，startAngle和spanAngle。和弦填充有电流brush（ ） 。

该startAngle和spanAngle必须以一定程度的十六分之一来指定，即一个完整的圆等于5760 （ 16 * 360 ） 。用于角度的正值逆时针意思而负值意味着顺时针方向。零度是在3点钟的位置。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 int startAngle = 30 * 16;
 int spanAngle = 120 * 16;
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawChord(rect, startAngle, spanAngle);

|

See also drawArc（ ）drawPie（）和Coordinate System。

QPainter.drawChord (self, QRect rect, int a, int alen)

这是一个重载函数。

绘制和弦由给定的定义rectangle，startAngle和spanAngle。

QPainter.drawChord (self, int x, int y, int w, int h, int a, int alen)

这是一个重载函数。

绘制由矩形开始在定义的弦（x，y）用指定的width和height和给定的startAngle和spanAngle。

QPainter.drawConvexPolygon (self, QPointF point, ...)

绘制由第一定义的凸多边形pointCount阵列中的点points使用当前画笔。

| |

 static const [QPointF](qpointf.html) points[4] = {
     [QPointF](qpointf.html)(10.0, 80.0),
     [QPointF](qpointf.html)(20.0, 10.0),
     [QPointF](qpointf.html)(80.0, 30.0),
     [QPointF](qpointf.html)(90.0, 70.0)
 };
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawConvexPolygon(points, 4);

|

第一点是隐式连接到最后一个点，该多边形被填充有电流brush（ ） 。如果所提供的多边形不是凸的，也就是说，它至少包含一个角度大于180度大，其结果是不确定的。

在某些平台上（例如， X11 ）时， drawConvexPolygon （）函数可以比快drawPolygon（）函数。

See also drawPolygon（ ）drawPolyline（）和Coordinate System。

QPainter.drawConvexPolygon (self, QPolygonF poly)

这是一个重载函数。

绘制由第一定义的凸多边形pointCount阵列中的点points使用当前画笔。

QPainter.drawConvexPolygon (self, QPoint point, ...)

这是一个重载函数。

绘制由定义的凸多边形polygon使用当前画笔和画刷。

QPainter.drawConvexPolygon (self, QPolygon poly)

这是一个重载函数。

绘制由定义的凸多边形polygon使用当前画笔和画刷。

QPainter.drawEllipse (self, QRectF r)

绘制由指定所定义的椭圆rectangle。

一个实心椭圆的大小为rectangle。size()。一个描边椭圆的大小为rectangle。size()加上画笔的宽度。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawEllipse(rectangle);

|

See also drawPie（）和Coordinate System。

QPainter.drawEllipse (self, QRect r)

这是一个重载函数。

绘制由指定所定义的椭圆rectangle。

QPainter.drawEllipse (self, int x, int y, int w, int h)

这是一个重载函数。

绘制由矩形开始在所定义的椭圆（x，y）用给定的width和height。

QPainter.drawEllipse (self, QPointF center, float rx, float ry)

这是一个重载函数。

绘制定位在椭圆center与半径rx和ry。

此功能被引入Qt的4.4 。

QPainter.drawEllipse (self, QPoint center, int rx, int ry)

这是一个重载函数。

绘制定位在椭圆center与半径rx和ry。

此功能被引入Qt的4.4 。

QPainter.drawGlyphRun (self, QPointF position, QGlyphRun glyphRun)

绘制指定glyphs在给定的position。该position给出了基线的字形串的边缘。字形将从所选择的字体检索glyphs以及在由位置给定偏移glyphs。

此功能被引入Qt的4.8 。

See also QGlyphRun.setRawFont（ ）QGlyphRun.setPositions（）和QGlyphRun.setGlyphIndexes（ ） 。

QPainter.drawImage (self, QRectF targetRect, QImage image, QRectF sourceRect, Qt.ImageConversionFlags flags = Qt.AutoColor)

绘制矩形部分source的给定image进入target矩形的绘图设备。

Note:图像缩放以适合该矩形，如果两个图像和矩形大小不同意。

如果图像需要进行修改，以适应在较低分辨率的结果（例如，从32位转换为8位），使用flags指定你将如何喜欢这样的事情发生。

|

 [QRectF]($docs-qrectf.html) target(10.0, 20.0, 80.0, 60.0);
 [QRectF]($docs-qrectf.html) source(0.0, 0.0, 70.0, 40.0);
 [QImage]($docs-qimage.html) image(":/../img/myImage.png");
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawImage(target, image, source);

|

See also drawPixmap（ ） 。

QPainter.drawImage (self, QRect targetRect, QImage image, QRect sourceRect, Qt.ImageConversionFlags flags = Qt.AutoColor)

这是一个重载函数。

绘制矩形部分source的给定image进入target矩形的绘图设备。

Note:图像缩放以适合该矩形，如果两个图像和矩形大小不同意。

QPainter.drawImage (self, QPointF p, QImage image, QRectF sr, Qt.ImageConversionFlags flags = Qt.AutoColor)

这是一个重载函数。

绘制给定的image在给定的point。

QPainter.drawImage (self, QPoint p, QImage image, QRect sr, Qt.ImageConversionFlags flags = Qt.AutoColor)

这是一个重载函数。

绘制给定的image在给定的point。

QPainter.drawImage (self, QRectF r, QImage image)

这是一个重载函数。

绘制矩形部分source的给定image其原点在给定的point。

QPainter.drawImage (self, QRect r, QImage image)

这是一个重载函数。

绘制矩形部分source的给定image其原点在给定的point。

QPainter.drawImage (self, QPointF p, QImage image)

这是一个重载函数。

绘制给定的image在给定的rectangle。

Note:图像缩放以适合该矩形，如果两个图像和矩形大小不同意。

QPainter.drawImage (self, QPoint p, QImage image)

这是一个重载函数。

绘制给定的image在给定的rectangle。

Note:图像缩放以适合该矩形，如果两个图像和矩形大小不同意。

QPainter.drawImage (self, int x, int y, QImage image, int sx = 0, int sy = 0, int sw = -1, int sh = -1, Qt.ImageConversionFlags flags = Qt.AutoColor)

这是一个重载函数。

绘制图像时（x，y）通过复制的一部分image入漆设备。

（x，y）指定在绘制设备将要被绘制到左上点。 （sx，sy）指定左上角点image要被绘制。默认值是（0 ，0）。

（sw，sh）指定将要被绘制的图像的大小。默认的，（0， 0）（和负）指一路图像的右下角。

QPainter.drawLine (self, QLineF l)

绘制由定义的直线line。

| |

 [QLineF](qlinef.html) line(10.0, 80.0, 90.0, 20.0);
 [QPainter]($docs-qpainter.html)(this);
 painter.drawLine(line);

|

See also drawLines（ ）drawPolyline（）和Coordinate System。

QPainter.drawLine (self, QLine line)

这是一个重载函数。

绘制由定义的直线line。

QPainter.drawLine (self, int x1, int y1, int x2, int y2)

这是一个重载函数。

绘制一条线从p1至p2。

QPainter.drawLine (self, QPoint p1, QPoint p2)

这是一个重载函数。

绘制一条线从p1至p2。

QPainter.drawLine (self, QPointF p1, QPointF p2)

这是一个重载函数。

绘制一条线从（x1，y1）至（x2，y2），并设置当前画笔位置为（x2，y2） 。

QPainter.drawLines (self, QLineF line, ...)

绘制第一lineCount阵列中的行lines使用当前画笔。

See also drawLine（）和drawPolyline（ ） 。

QPainter.drawLines (self, list-of-QLineF lines)

这是一个重载函数。

绘制第一lineCount阵列中的行lines使用当前画笔。

QPainter.drawLines (self, QPointF pointPair, ...)

这是一个重载函数。

绘制第一lineCount阵列中的行pointPairs使用当前画笔。的线被指定为点对这样的项的数目pointPairs必须至少lineCount* 2 。

QPainter.drawLines (self, list-of-QPointF pointPairs)

这是一个重载函数。

绘制第一lineCount阵列中的行pointPairs使用当前画笔。

QPainter.drawLines (self, QLine line, ...)

这是一个重载函数。

绘制一条线为每对点的矢量pointPairs using the current pen. If there is an odd number of points in the array, the last point will be ignored.

QPainter.drawLines (self, list-of-QLine lines)

这是一个重载函数。

绘制一条线为每对点的矢量pointPairs使用当前画笔。

QPainter.drawLines (self, QPoint pointPair, ...)

这是一个重载函数。

绘制集的列表中定义的行lines使用当前画笔和画刷。

QPainter.drawLines (self, list-of-QPoint pointPairs)

这是一个重载函数。

绘制集的列表中定义的行lines使用当前画笔和画刷。

QPainter.drawPath (self, QPainterPath path)

绘制给定的画家path使用当前笔的轮廓和当前画笔填充。

| |

 [QPainterPath]($docs-qpainterpath.html) path;
 path.moveTo(20, 80);
 path.lineTo(20, 30);
 path.cubicTo(80, 0, 50, 50, 80, 80);
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawPath(path);

|

See also the Painter Paths example和the Vector Deformation demo。

QPainter.drawPicture (self, QPointF p, QPicture picture)

重播给定的picture在给定的point。

该QPicture类是一个绘图设备，记录和重放QPainter的命令。的图片序列画家命令IO设备在一个平台无关的格式。可以涂在一个部件或pixmap的一切也可以被存储在一个图像。

这个函数完全一样QPicture.play（ ）调用时使用point=QPoint（0 ，0）。

|

 [QPicture]($docs-qpicture.html) picture;
 [QPointF](qpointf.html) point(10.0, 20.0)
 picture.load("drawing.pic");
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawPicture(0, 0, picture);

|

See also QPicture.play（ ） 。

QPainter.drawPicture (self, int x, int y, QPicture p)

这是一个重载函数。

重播给定的picture在给定的point。

QPainter.drawPicture (self, QPoint pt, QPicture p)

这是一个重载函数。

绘制给定的picture在点（x，y） 。

QPainter.drawPie (self, QRectF rect, int a, int alen)

绘制由指定所定义的扇形rectangle，startAngle和和spanAngle。

馅饼填充有电流brush（ ） 。

该startAngle和spanAngle必须以一定程度的十六分之一来指定，即一个完整的圆等于5760 （ 16 * 360 ） 。用于角度的正值逆时针意思而负值意味着顺时针方向。零度是在3点钟的位置。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 int startAngle = 30 * 16;
 int spanAngle = 120 * 16;
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawPie(rectangle, startAngle, spanAngle);

|

See also drawEllipse（ ）drawChord（）和Coordinate System。

QPainter.drawPie (self, QRect rect, int a, int alen)

这是一个重载函数。

绘制由指定所定义的扇形rectangle，startAngle和和spanAngle。

QPainter.drawPie (self, int x, int y, int w, int h, int a, int alen)

这是一个重载函数。

绘制由矩形开始在定义的馅饼（x，y）用指定的width和height和给定的startAngle和spanAngle。

QPainter.drawPixmap (self, QRectF targetRect, QPixmap pixmap, QRectF sourceRect)

绘制矩形部分source的给定pixmap在给定的target在油漆设备。

Note:像素图进行缩放以适合该矩形，如果两个像素图和矩形大小不同意。

|

 [QRectF]($docs-qrectf.html) target(10.0, 20.0, 80.0, 60.0);
 [QRectF]($docs-qrectf.html) source(0.0, 0.0, 70.0, 40.0);
 [QPixmap]($docs-qpixmap.html) pixmap(":myPixmap.png");
 [QPainter]($docs-qpainter.html)(this);
 painter.drawPixmap(target, image, source);

|

If pixmap是QBitmap它被画成与正在使用的笔的颜色“设置”的位。如果backgroundMode是Qt.OpaqueMode中，“未设置”位所使用的背景画笔的颜色绘制，如果backgroundMode是Qt.TransparentMode中，“未设置”位是透明的。不支持位图绘制具有渐变或纹理的颜色。

See also drawImage（ ） 。

QPainter.drawPixmap (self, QRect targetRect, QPixmap pixmap, QRect sourceRect)

这是一个重载函数。

绘制矩形部分source的给定pixmap在给定的target在油漆设备。

Note:像素图进行缩放以适合该矩形，如果两个像素图和矩形大小不同意。

QPainter.drawPixmap (self, QPointF p, QPixmap pm)

这是一个重载函数。

绘制矩形部分source的给定pixmap其原点在给定的point。

QPainter.drawPixmap (self, QPoint p, QPixmap pm)

这是一个重载函数。

绘制矩形部分source的给定pixmap其原点在给定的point。

QPainter.drawPixmap (self, QRect r, QPixmap pm)

这是一个重载函数。

绘制给定的pixmap其原点在给定的point。

QPainter.drawPixmap (self, int x, int y, QPixmap pm)

这是一个重载函数。

绘制给定的pixmap其原点在给定的point。

QPainter.drawPixmap (self, int x, int y, int w, int h, QPixmap pm)

这是一个重载函数。

绘制给定的pixmap在位置（x，y） 。

QPainter.drawPixmap (self, int x, int y, int w, int h, QPixmap pm, int sx, int sy, int sw, int sh)

这是一个重载函数。

绘制给定的pixmap在给定的rectangle。

Note:像素图进行缩放以适合该矩形，如果两个像素图和矩形大小不同意。

QPainter.drawPixmap (self, int x, int y, QPixmap pm, int sx, int sy, int sw, int sh)

这是一个重载函数。

绘制pixmap成在位置（矩形x，y）用给定的width和height。

QPainter.drawPixmap (self, QPointF p, QPixmap pm, QRectF sr)

这是一个重载函数。

绘制与原点的矩形部分（sx，sy） ，宽度sw和高度sh，的给定pixmap，在点（x，y） ，具有一宽w及的高度h。如果SW或SH都等于零的像素映像的宽度/高度被使用，并且调整由偏移SX / SY ;

QPainter.drawPixmap (self, QPoint p, QPixmap pm, QRect sr)

这是一个重载函数。

绘制像素图在（x，y）通过复制的特定部分pixmap入漆设备。

（x，y）指定在绘制设备将要被绘制到左上点。 （sx，sy）指定左上角点pixmap要被绘制。默认值是（0 ，0）。

（sw，sh）指定像素要被绘制的大小。默认的，（0， 0）（和负）是指所有的方式向像素图的右下角。

QPainter.drawPixmapFragments (self, list-of-QPainter.PixmapFragment fragments, QPixmap pixmap, PixmapFragmentHints hints = 0)

此功能是用来绘制pixmap，或者一个子矩形pixmap，在不同的缩放，旋转和透明度多个位置。fragments是阵列fragmentCount元素指定用于绘制每个像素映射片段的参数。该hints参数可用于传递在绘制提示。

此功能可能比多次调用更快drawPixmap（） ，因为后端可以优化状态的变化。

此功能被引入Qt的4.7 。

See also QPainter.PixmapFragment和QPainter.PixmapFragmentHint。

QPainter.drawPixmapFragments (self, list-of-QRectF targetRects, list-of-QRectF sourceRects, QPixmap pixmap, PixmapFragmentHints hints = 0)

该sourceRects参数也可能没有。

此功能是用来绘制相同pixmap由指定多个目标和源矩形targetRects。如果sourceRects为0 ，整个像素映像将在每个目标矩形的呈现。该hints参数可用于传递在绘制提示。

此功能可能比多次调用更快drawPixmap（） ，因为后端可以优化状态的变化。

此功能被引入Qt的4.8 。

See also QPainter.PixmapFragmentHint。

QPainter.drawPoint (self, QPointF p)

绘制一个单点在给定的position使用当前画笔的颜色。

See also Coordinate System。

QPainter.drawPoint (self, int x, int y)

这是一个重载函数。

绘制一个单点在给定的position使用当前画笔的颜色。

QPainter.drawPoint (self, QPoint p)

这是一个重载函数。

绘制一个单点位置（x，y） 。

QPainter.drawPoints (self, QPointF point, ...)

绘制第一pointCount阵列中的点points使用当前画笔的颜色。

See also Coordinate System。

QPainter.drawPoints (self, QPolygonF points)

这是一个重载函数。

绘制第一pointCount阵列中的点points使用当前画笔的颜色。

QPainter.drawPoints (self, QPoint point, ...)

这是一个重载函数。

绘制点的矢量points。

QPainter.drawPoints (self, QPolygon points)

这是一个重载函数。

绘制点的矢量points。

QPainter.drawPolygon (self, QPointF point, ...)

绘制由第一定义的多边形pointCount阵列中的点points使用当前画笔和画刷。

| |

 static const [QPointF](qpointf.html) points[4] = {
     [QPointF](qpointf.html)(10.0, 80.0),
     [QPointF](qpointf.html)(20.0, 10.0),
     [QPointF](qpointf.html)(80.0, 30.0),
     [QPointF](qpointf.html)(90.0, 70.0)
 };
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawPolygon(points, 4);

|

第一点是隐式连接到最后一个点，该多边形被填充有电流brush（ ） 。

If fillRule is Qt.WindingFill中，多边形是用绕组填充算法填充。如果fillRule is Qt.OddEvenFill中，多边形是使用奇偶填充算法填充。看Qt.FillRule对于这些填充规则的更详细的描述。

See also drawConvexPolygon（ ）drawPolyline（）和Coordinate System。

QPainter.drawPolygon (self, QPolygonF points, Qt.FillRule fillRule = Qt.OddEvenFill)

这是一个重载函数。

绘制由第一定义的多边形pointCount阵列中的点points。

QPainter.drawPolygon (self, QPoint point, ...)

QPainter.drawPolygon (self, QPolygon points, Qt.FillRule fillRule = Qt.OddEvenFill)

QPainter.drawPolyline (self, QPointF point, ...)

绘制由第一定义的折线pointCount在点points使用当前画笔。

请注意，与drawPolygon（ ）函数的最后一点是not连接到第一个，也不是漫天的折线。

|

 static const [QPointF](qpointf.html) points[3] = {
     [QPointF](qpointf.html)(10.0, 80.0),
     [QPointF](qpointf.html)(20.0, 10.0),
     [QPointF](qpointf.html)(80.0, 30.0),
 };
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawPolyline(points, 3);

|

See also drawLines（ ）drawPolygon（）和Coordinate System。

QPainter.drawPolyline (self, QPolygonF polyline)

这是一个重载函数。

绘制由第一定义的折线pointCount在点points使用当前画笔。

QPainter.drawPolyline (self, QPoint point, ...)

QPainter.drawPolyline (self, QPolygon polyline)

这是一个重载函数。

绘制由给定的定义的折线points使用当前画笔。

QPainter.drawRect (self, QRectF rect)

绘制电流rectangle与当前的画笔和画刷。

一个填充矩形的大小为rectangle。大小（ ） 。一个描边矩形的大小为rectangle。大小（ ），再加上画笔的宽度。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawRect(rectangle);

|

See also drawRects（ ）drawPolygon（）和Coordinate System。

QPainter.drawRect (self, int x, int y, int w, int h)

这是一个重载函数。

绘制电流rectangle与当前的画笔和画刷。

QPainter.drawRect (self, QRect r)

这是一个重载函数。

与绘制左上角的矩形在（x，y），并用给定的width和height。

QPainter.drawRects (self, QRectF rect, ...)

绘制第一rectCount的给定rectangles使用当前画笔和画刷。

See also drawRect（ ） 。

QPainter.drawRects (self, list-of-QRectF rects)

这是一个重载函数。

绘制第一rectCount的给定rectangles使用当前画笔和画刷。

QPainter.drawRects (self, QRect rect, ...)

这是一个重载函数。

绘制给定的rectangles使用当前画笔和画刷。

QPainter.drawRects (self, list-of-QRect rects)

这是一个重载函数。

绘制给定的rectangles使用当前画笔和画刷。

QPainter.drawRoundedRect (self, QRectF rect, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)

绘制一个矩形rect带有圆角。

该xRadius和yRadius参数指定限定的圆角矩形的角部的椭圆形的半径。何时mode is Qt.RelativeSize，xRadius和yRadius在一半的矩形的宽度和高度的比例分别指定，并应在范围0.0至100.0 。

填充的矩形具有rect.size （的大小） 。一个描边矩形具有rect.size的大小（ ），再加上画笔的宽度。

| |

 [QRectF]($docs-qrectf.html) rectangle(10.0, 20.0, 80.0, 60.0);
 [QPainter]($docs-qpainter.html) painter(this);
 painter.drawRoundedRect(rectangle, 20.0, 15.0);

|

此功能被引入Qt的4.4 。

See also drawRect（）和QPen。

QPainter.drawRoundedRect (self, int x, int y, int w, int h, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)

这是一个重载函数。

绘制一个矩形rect带有圆角。

此功能被引入Qt的4.4 。

QPainter.drawRoundedRect (self, QRect rect, float xRadius, float yRadius, Qt.SizeMode mode = Qt.AbsoluteSize)

这是一个重载函数。

绘制一个矩形x，y，w，h带有圆角。

此功能被引入Qt的4.4 。

QPainter.drawRoundRect (self, QRectF r, int xRound = 25, int yRound = 25)

QPainter.drawRoundRect (self, int x, int y, int w, int h, int xRound = 25, int yRound = 25)

QPainter.drawRoundRect (self, QRect r, int xRound = 25, int yRound = 25)

QPainter.drawStaticText (self, QPointF topLeftPosition, QStaticText staticText)

绘制给定的staticText在给定的topLeftPosition。

该文本将使用的字体和画家的改造集绘制。如果画家设置字体和/或转型是从用来初始化的布局有些出入QStaticText，则布局将不得不被重新计算。使用QStaticText.prepare（）来初始化staticText与字体和转型与它稍后将绘制。

If topLeftPosition是不一样的，当staticText被初始化，或当它被最后绘制，那么就会有翻译文本到新的位置时，会有轻微的开销。

Note:如果画家的转变不仿射，然后staticText将使用普通电话要绘制drawText（ ） ，失去对性能改善的潜力。

Note:y位置被用作字体的顶部。

此功能被引入Qt的4.7 。

See also QStaticText。

QPainter.drawStaticText (self, QPoint p, QStaticText staticText)

这是一个重载函数。

绘制staticText在topLeftPosition。

Note:y位置被用作字体的顶部。

此功能被引入Qt的4.7 。

QPainter.drawStaticText (self, int x, int y, QStaticText staticText)

这是一个重载函数。

绘制staticText在坐标left和top。

Note:y位置被用作字体的顶部。

此功能被引入Qt的4.7 。

QPainter.drawText (self, QPointF p, QString s)

绘制给定的text与当前定义的文字方向，开始在给定的position。

此功能不处理换行符（ \ n）的，因为它不能将文本分成多行，并且它不能显示换行符。使用QPainter.drawText （ ）重载采用一个矩形，而是如果要绘制与换行符多行文本，或者如果您希望文本换行。

默认情况下，QPainter绘制文本抗锯齿。

Note:y位置被用作字体的基线。

QRectF boundingRect QPainter.drawText (self, QRectF rectangle, int flags, QString text)

QRect boundingRect QPainter.drawText (self, QRect rectangle, int flags, QString text)

[

QPainter.drawText (self, QRectF rectangle, QString text, QTextOption option = QTextOption())

QPainter.drawText (self, QPoint p, QString s)

]($docs-qrect.html)

QRect boundingRect QPainter.drawText (self, int x, int y, int width, int height, int flags, QString text)

[

QPainter.drawText (self, int x, int y, QString s)

QPainter.drawTiledPixmap (self, QRectF rectangle, QPixmap pixmap, QPointF pos = QPointF())

绘制的瓷砖pixmap，里面的定rectangle其原点在给定的position。

]($docs-qrect.html)

调用drawTiledPixmap （ ）类似于调用drawPixmap（ ）多次填写（瓦）的面积与像素图，而是取决于不同的底层窗口系统上可能效率更高。

See also drawPixmap（ ） 。

QPainter.drawTiledPixmap (self, QRect rectangle, QPixmap pixmap, QPoint pos = QPoint())

这是一个重载函数。

绘制的瓷砖pixmap，里面的定rectangle其原点在给定的position。

QPainter.drawTiledPixmap (self, int x, int y, int width, int height, QPixmap pixmap, int sx = 0, int sy = 0)

这是一个重载函数。

绘制的瓷砖pixmap在指定的矩形。

（x，y）指定在绘制设备将要被绘制到左上顶点;用给定的width和height。 （sx，sy）指定在左上角点pixmap要被绘制的，这默认为（0 ，0）。

bool QPainter.end (self)

完画。而画中使用的任何资源被释放。你通常不需要调用这个，因为它是由所谓的析构函数。

返回True如果画家不再有效，否则返回False 。

See also begin（）和isActive（ ） 。

QPainter.endNativePainting (self)

后手动发布本地绘制命令恢复画家。让画家还原它依赖于调用任何其他画家的命令之前的任何原生状态。

此功能被引入Qt的4.6 。

See also beginNativePainting（ ） 。

QPainter.eraseRect (self, QRectF)

擦除内部给定的区域rectangle。相当于调用

 fillRect(rectangle, background()).

See also fillRect（ ） 。

QPainter.eraseRect (self, QRect rect)

这是一个重载函数。

擦除内部给定的区域rectangle。

QPainter.eraseRect (self, int x, int y, int w, int h)

这是一个重载函数。

擦除矩形开始内部的区域处（x，y）用给定的width和height。

QPainter.fillPath (self, QPainterPath path, QBrush brush)

充填所给的path使用给定的brush。大纲中未画出。

或者，您可以指定一个QColor代替QBrush;的QBrush构造函数（服用QColor参数）会自动创建一个坚实的图案画笔。

See also drawPath（ ） 。

QPainter.fillRect (self, QRectF, QBrush)

充填所给的rectangle与brush规定。

或者，您可以指定一个QColor代替QBrush;的QBrush构造函数（服用QColor参数）会自动创建一个坚实的图案画笔。

See also drawRect（ ） 。

QPainter.fillRect (self, QRect, QBrush)

这是一个重载函数。

填充矩形开始时（x，y）用给定的width和height使用刷子style规定。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, int x, int y, int w, int h, QBrush b)

这是一个重载函数。

充填所给的rectangle与刷style规定。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, QRectF, QColor color)

这是一个重载函数。

充填所给的rectangle与刷style规定。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, QRect, QColor color)

这是一个重载函数。

充填所给的rectangle用指定的brush。

QPainter.fillRect (self, int x, int y, int w, int h, QColor b)

这是一个重载函数。

充填所给的rectangle与color规定。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, int x, int y, int w, int h, Qt.GlobalColor c)

这是一个重载函数。

充填所给的rectangle与color规定。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, QRect r, Qt.GlobalColor c)

这是一个重载函数。

填充矩形开始时（x，y）用给定的width和height，使用给定的brush。

QPainter.fillRect (self, QRectF r, Qt.GlobalColor c)

这是一个重载函数。

填充矩形开始时（x，y）用给定的width和height，使用给定的color。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, int x, int y, int w, int h, Qt.BrushStyle style)

这是一个重载函数。

填充矩形开始时（x，y）用给定的width和height，使用给定的color。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, QRect r, Qt.BrushStyle style)

这是一个重载函数。

充填所给的rectangle用指定的color。

此功能被引入Qt的4.5 。

QPainter.fillRect (self, QRectF r, Qt.BrushStyle style)

这是一个重载函数。

充填所给的rectangle用指定的color。

此功能被引入Qt的4.5 。

QFont QPainter.font (self)

[

返回用于绘制文本的当前设置的字体。

]($docs-qfont.html)

See also setFont（ ）drawText（）和Settings。

QFontInfo QPainter.fontInfo (self)

[

返回画家的字体信息，如果画家是积极的。否则，返回值是不确定的。

]($docs-qfontinfo.html)

See also font（ ）isActive（）和Settings。

QFontMetrics QPainter.fontMetrics (self)

[

返回的字体规格为画家当画家是积极的。否则，返回值是不确定的。

]($docs-qfontmetrics.html)

See also font（ ）isActive（）和Settings。

bool QPainter.hasClipping (self)

返回True如果裁剪已经设置，否则返回False 。

See also setClipping（）和Clipping。

QPainter.initFrom (self, QWidget widget)

初始化画家的笔，背景和字体一样给出widget。当画家被打开的这个功能是自动调用QWidget。

See also begin（）和Settings。

bool QPainter.isActive (self)

返回True如果begin（ ）被调用，并end（ ）尚未被调用，否则返回False 。

See also begin（）和QPaintDevice.paintingActive（ ） 。

Qt.LayoutDirection QPainter.layoutDirection (self)

[

返回绘制文本时所使用的画家布局方向。

]($docs-qt.html#LayoutDirection-enum)

See also QTextOption.textDirection（ ）setLayoutDirection（ ）drawText（）和Settings。

QMatrix QPainter.matrix (self)

[

bool QPainter.matrixEnabled (self)

float QPainter.opacity (self)

返回画家的不透明度。默认值是1。

这个函数中引入了Qt 4.2中。

]($docs-qmatrix.html)

See also setOpacity（ ） 。

QPaintEngine QPainter.paintEngine (self)

[

返回绘图引擎的画家是目前，如果画家是积极的运作，否则为0 。

]($docs-qpaintengine.html)

See also isActive（ ） 。

QPen QPainter.pen (self)

[

返回画家的当前画笔。

]($docs-qpen.html)

See also setPen（）和Settings。

QPaintDevice QPainter.redirected (QPaintDevice device, QPoint offset = None)

RenderHints QPainter.renderHints (self)

[

返回一个标志，指定在这个画家将呈现提示。

]($docs-index.htm)

See also setRenderHints（ ）testRenderHint（）和Rendering Quality。

QPainter.resetMatrix (self)

QPainter.resetTransform (self)

重置过去使用的任何变革translate（ ）scale（ ）shear（ ）rotate（ ）setWorldTransform（ ）setViewport（）和setWindow（ ） 。

See also Coordinate Transformations。

QPainter.restore (self)

恢复当前的画家状态（弹出一个保存的状态出栈） 。

See also save（ ） 。

QPainter.restoreRedirected (QPaintDevice device)

QPainter.rotate (self, float a)

旋转坐标系中给出angle顺时针方向旋转。

See also setWorldTransform（）和Coordinate Transformations。

QPainter.save (self)

保存当前状态的画家（推状态入栈） 。一个save（）方法必须遵循的相应的restore（）;的end（ ）函数展开栈。

See also restore（ ） 。

QPainter.scale (self, float sx, float sy)

由（缩放坐标系sx，sy） 。

See also setWorldTransform（）和Coordinate Transformations。

QPainter.setBackground (self, QBrush bg)

设定画家的背景刷到给定brush。

背景画笔是绘制不透明文本，点画线和位图填充时，在刷。背景刷没有效果的透明背景模式（这是默认值） 。

See also background（ ）setBackgroundMode（）和Settings。

QPainter.setBackgroundMode (self, Qt.BGMode mode)

设定画家的背景模式给定的mode

Qt.TransparentMode（默认值）绘制点画线条和文字没有设置背景像素。Qt.OpaqueMode填充这些空间与当前的背景色。

需要注意的是，为了绘制位图或像素透明，则必须使用QPixmap.setMask（ ） 。

See also backgroundMode（ ）setBackground（）和Settings。

QPainter.setBrush (self, QBrush brush)

集画家笔下的给定brush。

画家笔下的定义是如何的形状填充。

See also brush（）和Settings。

QPainter.setBrush (self, Qt.BrushStyle style)

这是一个重载函数。

集画家笔下的黑颜色和指定的style。

QPainter.setBrushOrigin (self, QPointF)

设置画笔原点position。

画刷原点指定（ 0 ， 0 ）画家笔下的坐标。

请注意，虽然brushOrigin（ ）是要采取父母的背景Qt中3小部件，这已不再是如此，因为Qt的4画家不画背景，除非你明确告诉它通过设置widget的这样做autoFillBackground属性设置为True 。

See also brushOrigin（）和Settings。

QPainter.setBrushOrigin (self, int x, int y)

这是一个重载函数。

设置画笔的原点给定的position。

QPainter.setBrushOrigin (self, QPoint p)

这是一个重载函数。

设置画笔的原点指向（x，y） 。

QPainter.setClipPath (self, QPainterPath path, Qt.ClipOperation operation = Qt.ReplaceClip)

使裁剪，并设置为给定的剪辑路径画家path与剪辑operation。

请注意，剪辑路径逻辑（画家）坐标指定。

See also clipPath（ ）clipRegion（）和Clipping。

QPainter.setClipping (self, bool enable)

使裁剪，如果enable是真的，或禁用裁剪，如果enable是假的。

See also hasClipping（）和Clipping。

QPainter.setClipRect (self, QRectF rectangle, Qt.ClipOperation operation = Qt.ReplaceClip)

使裁剪，并设置裁剪区域为给定的rectangle使用给定的夹operation。默认操作是替换当前剪辑矩形。

需要注意的是剪辑矩形的逻辑（画家）坐标指定。

See also clipRegion（ ）setClipping（）和Clipping。

QPainter.setClipRect (self, int x, int y, int width, int height, Qt.ClipOperation operation = Qt.ReplaceClip)

使裁剪，并设置裁剪区域为矩形开始时（x，y）用给定的width和height。

QPainter.setClipRect (self, QRect rectangle, Qt.ClipOperation operation = Qt.ReplaceClip)

这是一个重载函数。

使裁剪，并设置裁剪区域为给定的rectangle使用给定的夹operation。

QPainter.setClipRegion (self, QRegion region, Qt.ClipOperation operation = Qt.ReplaceClip)

设置剪辑区域给定的region使用指定的剪辑operation。默认剪辑操作是替换当前剪辑区域。

注意裁剪区域是由于在逻辑坐标。

See also clipRegion（ ）setClipRect（）和Clipping。

QPainter.setCompositionMode (self, CompositionMode mode)

载的组成模式为给定的mode。

Warning:只有一个QPainter在操作QImage完全支持所有的组成模式。如所描述的RasterOp的模式支持在X11compositionMode（ ） 。

See also compositionMode（ ） 。

QPainter.setFont (self, QFont f)

集画家的字体给定的font。

此字体用于后续的drawText（）函数。文字颜色是一样的画笔颜色。

如果您设置的字体不可用， Qt的发现一场势均力敌的比赛。font（ ）将返回你所设定使用中的setFont （）和fontInfo（）返回的字体实际使用（其可以是相同的） 。

See also font（ ）drawText（）和Settings。

QPainter.setLayoutDirection (self, Qt.LayoutDirection direction)

设置绘制文本时所使用的画家布局方向，到指定的direction.

默认值是Qt.LayoutDirectionAuto，这将隐式地从绘制文本确定方向。

See also QTextOption.setTextDirection（ ）layoutDirection（ ）drawText（）和Settings。

QPainter.setMatrix (self, QMatrix matrix, bool combine = False)

QPainter.setMatrixEnabled (self, bool enabled)

QPainter.setOpacity (self, float opacity)

设定画家的不透明度为opacity。该值应在范围0.0到1.0 ，其中0.0表示完全透明和1.0表示完全不透明。

不透明的画家设置将适用于所有绘图操作分别。

这个函数中引入了Qt 4.2中。

See also opacity（ ） 。

QPainter.setPen (self, QColor color)

设定画家的笔下被定pen。

该pen定义如何绘制线条和轮廓，而且还定义了文字颜色。

See also pen（）和Settings。

QPainter.setPen (self, QPen pen)

这是一个重载函数。

设定画家的笔下有风格Qt.SolidLine，宽0和指定的color。

QPainter.setPen (self, Qt.PenStyle style)

这是一个重载函数。

设定画家的笔下有定style，宽度0和黑色的颜色。

QPainter.setRedirected (QPaintDevice device, QPaintDevice replacement, QPoint offset = QPoint())

QPainter.setRenderHint (self, RenderHint hint, bool on = True)

设置给定的渲染hint在画家如果on为True，否则清除渲染提示。

See also setRenderHints（ ）renderHints（）和Rendering Quality。

QPainter.setRenderHints (self, RenderHints hints, bool on = True)

设置给定的渲染hints在画家如果on为True，否则清除渲染提示。

这个函数中引入了Qt 4.2中。

See also setRenderHint（ ）renderHints（）和Rendering Quality。

QPainter.setTransform (self, QTransform transform, bool combine = False)

设置世界变换矩阵。如果combine为True，则指定transform是结合当前矩阵，否则将替换当前矩阵。

此功能被引入Qt的4.3 。

See also transform（）和setWorldTransform（ ） 。

QPainter.setViewport (self, QRect viewport)

设定画家的视口矩形到给定rectangle，并启用视图转换。

视口矩形是认为转型的一部分。视口指定设备坐标系统。它的姊妹，在window（ ） ，指定的逻辑坐标系。

默认的视口矩形是相同的器件的矩形。

See also viewport（ ）viewTransformEnabled（）和Window-Viewport Conversion。

QPainter.setViewport (self, int x, int y, int w, int h)

这是一个重载函数。

设定画家的视口矩形是开始在矩形（x，y）用给定的width和height。

QPainter.setViewTransformEnabled (self, bool enable)

启用视图变换，如果enable是真的，或禁用视图变换，如果enable是假的。

See also viewTransformEnabled（）和Window-Viewport Conversion。

QPainter.setWindow (self, QRect window)

集画家的窗口给定的rectangle，并启用视图转换。

窗口矩形认为转型的一部分。该窗口指定了逻辑坐标系统。它的姊妹，在viewport（ ） ，指定设备坐标系统。

默认窗口矩形是相同的器件的矩形。

See also window（ ）viewTransformEnabled（）和Window-Viewport Conversion。

QPainter.setWindow (self, int x, int y, int w, int h)

这是一个重载函数。

集画家的窗口，矩形开始时（x，y）和给定的width和height。

QPainter.setWorldMatrix (self, QMatrix matrix, bool combine = False)

QPainter.setWorldMatrixEnabled (self, bool enabled)

使转换，如果enable是真的，或禁用，如果转换enable是假的。世界变换矩阵不被改变。

这个函数中引入了Qt 4.2中。

See also worldMatrixEnabled（ ）worldTransform（）和Coordinate Transformations。

QPainter.setWorldTransform (self, QTransform matrix, bool combine = False)

设置世界变换矩阵。如果combine为True，则指定matrix是结合当前矩阵，否则将替换当前矩阵。

See also worldTransform（ ）transform（）和setTransform（ ） 。

QPainter.shear (self, float sh, float sv)

由（剪坐标系sh，sv） 。

See also setWorldTransform（）和Coordinate Transformations。

QPainter.strokePath (self, QPainterPath path, QPen pen)

绘制轮廓（招）的路径path由指定的笔pen

See also fillPath（）和Drawing。

bool QPainter.testRenderHint (self, RenderHint hint)

返回True如果hint被置位，否则返回False 。

此功能被引入Qt的4.3 。

See also renderHints（）和setRenderHint（ ） 。

QTransform QPainter.transform (self)

[

返回世界变换矩阵。

]($docs-qtransform.html)

See also setTransform（）和worldTransform（ ） 。

QPainter.translate (self, QPointF offset)

由给定的平移坐标系offset，即给定offset加入到分。

See also setWorldTransform（）和Coordinate Transformations。

QPainter.translate (self, float dx, float dy)

这是一个重载函数。

由给定的平移坐标系offset。

QPainter.translate (self, QPoint offset)

这是一个重载函数。

转换由矢量的坐标系（dx，dy） 。

QRect QPainter.viewport (self)

[

返回视口矩形。

]($docs-qrect.html)

See also setViewport（）和setViewTransformEnabled（ ） 。

bool QPainter.viewTransformEnabled (self)

返回True如果视图转换被启用，否则返回False 。

See also setViewTransformEnabled（）和worldTransform（ ） 。

QRect QPainter.window (self)

[

返回窗口的矩形。

]($docs-qrect.html)

See also setWindow（）和setViewTransformEnabled（ ） 。

QMatrix QPainter.worldMatrix (self)

[

bool QPainter.worldMatrixEnabled (self)