QPaintEngine Class Reference · PyQt4 中文文檔

# QPaintEngine Class Reference ## [[QtGui](index.htm) module] 該QPaintEngine類提供了如何的抽象定義[QPainter](qpainter.html)繪制到一個給定的設備在給定平臺上。[More...](#details) ### Types * `enum DirtyFlag { DirtyPen, DirtyBrush, DirtyBrushOrigin, DirtyFont, ..., AllDirty }` * `class **[DirtyFlags](index.htm)**` * `enum PaintEngineFeature { PrimitiveTransform, PatternTransform, PixmapTransform, PatternBrush, ..., AllFeatures }` * `class **[PaintEngineFeatures](index.htm)**` * `enum PolygonDrawMode { OddEvenMode, WindingMode, ConvexMode, PolylineMode }` * `enum Type { X11, Windows, QuickDraw, CoreGraphics, ..., MaxUser }` ### Methods * `__init__ (self, PaintEngineFeatures?features?=?0)` * `bool begin (self, QPaintDevice?pdev)` * `drawEllipse (self, QRectF?r)` * `drawEllipse (self, QRect?r)` * `drawImage (self, QRectF?r, QImage?pm, QRectF?sr, Qt.ImageConversionFlags?flags?=?Qt.AutoColor)` * `drawLines (self, QLine?lines)` * `drawLines (self, QLineF?lines)` * `drawPath (self, QPainterPath?path)` * `drawPixmap (self, QRectF?r, QPixmap?pm, QRectF?sr)` * `drawPoints (self, QPointF?points)` * `drawPoints (self, QPoint?points)` * `drawPolygon (self, QPointF?points, PolygonDrawMode?mode)` * `drawPolygon (self, QPoint?points, PolygonDrawMode?mode)` * `drawRects (self, QRect?rects)` * `drawRects (self, QRectF?rects)` * `drawTextItem (self, QPointF?p, QTextItem?textItem)` * `drawTiledPixmap (self, QRectF?r, QPixmap?pixmap, QPointF?s)` * `bool end (self)` * `bool hasFeature (self, PaintEngineFeatures?feature)` * `bool isActive (self)` * `QPaintDevice paintDevice (self)` * `QPainter painter (self)` * `setActive (self, bool?newState)` * `setPaintDevice (self, QPaintDevice?device)` * `Type type (self)` * `updateState (self, QPaintEngineState?state)` * * * ## Detailed Description 該QPaintEngine類提供了如何的抽象定義[QPainter](qpainter.html)繪制到一個給定的設備在給定平臺上。的Qt 4.0提供QPaintEngine的幾個預制的實現，因為我們支持不同的畫家后端。我們為每個窗口系統和繪畫框架，我們支持提供一個繪制引擎。這包括X11在Unix / Linux和[CoreGraphics](qpaintengine.html#Type-enum)在Mac OS X此外，我們提供QPaintEngine的實現[OpenGL](qpaintengine.html#Type-enum)（可通過[QGLWidget](qglwidget.html)）和[PostScript](qpaintengine.html#Type-enum)（通過QPSPrinter在X11訪問）。此外，還有一個基于光柵的涂料引擎，是一個后備，當引擎不支持某些功能。如果一個人想用[QPainter](qpainter.html)繪制到不同的后端，必須繼承QPaintEngine并重新實現其所有的虛函數。該QPaintEngine執行，然后提供通過繼承[QPaintDevice](qpaintdevice.html)并重新實現虛函數[QPaintDevice.paintEngine](qpaintdevice.html#paintEngine)（）。 QPaintEngine創建和擁有的[QPaintDevice](qpaintdevice.html)創建它。該QPaintEngine辦法反對的Qt 3的的一大優點[QPainter](qpainter.html)/ QPaintDevice.cmd （）方法，它現在可以適應多種技術在每個平臺上，充分利用每一個發揮到淋漓盡致。 * * * ## Type Documentation ``` QPaintEngine.DirtyFlag ``` | Constant | Value | Description | | --- | --- | --- | | `QPaintEngine.DirtyPen` | `0x0001` | 筆是臟，需要更新。 | | `QPaintEngine.DirtyBrush` | `0x0002` | 刷臟了，需要更新。 | | `QPaintEngine.DirtyBrushOrigin` | `0x0004` | 刷原點是臟的，需要更新的。 | | `QPaintEngine.DirtyFont` | `0x0008` | 字體變臟，需要進行更新。 | | `QPaintEngine.DirtyBackground` | `0x0010` | 背景是臟的，需要被更新。 | | `QPaintEngine.DirtyBackgroundMode` | `0x0020` | 背景模式是臟的，需要被更新。 | | `QPaintEngine.DirtyTransform` | `0x0040` | 該變換是臟的，需要被更新。 | | `QPaintEngine.DirtyClipRegion` | `0x0080` | 裁剪區域變臟，需要進行更新。 | | `QPaintEngine.DirtyClipPath` | `0x0100` | 剪輯路徑是臟的，需要被更新。 | | `QPaintEngine.DirtyHints` | `0x0200` | 渲染提示臟了，需要更新。 | | `QPaintEngine.DirtyCompositionMode` | `0x0400` | 該組合物模式是臟的，需要被更新。 | | `QPaintEngine.DirtyClipEnabled` | `0x0800` | 無論裁剪啟用與否是臟，需要更新。 | | `QPaintEngine.DirtyOpacity` | `0x1000` | 不透明度的常已發生變化，需要進行更新的狀態變化的一部分[QPaintEngine.updateState](qpaintengine.html#updateState)（）。 | | `QPaintEngine.AllDirty` | `0xffff` | 內部使用的便利枚舉。 | 這些類型用于通過[QPainter](qpainter.html)來觸發各種狀態的懶惰更新[QPaintEngine](qpaintengine.html) using [QPaintEngine.updateState](qpaintengine.html#updateState)（）。一種涂料引擎必須更新每個臟狀態。該DirtyFlags類型是一個typedef為[QFlags](index.htm)\u003cDirtyFlag\u003e 。它存儲DirtyFlag值的或組合。 ``` QPaintEngine.PaintEngineFeature ``` 此枚舉是用來描述的特征或功能，油漆引擎。如果某個特性不支持的引擎，[QPainter](qpainter.html)會做通過其他方式來模擬該功能，并通過對混合阿爾法盡力[QImage](qimage.html)與模擬結果的引擎。有些功能不能被仿真： AlphaBlend的和PorterDuff 。 | Constant | Value | Description | | --- | --- | --- | | `QPaintEngine.AlphaBlend` | `0x00000080` | 該引擎可以alpha混合語。 | | `QPaintEngine.Antialiasing` | `0x00000400` | 發動機可以使用antialising提高渲染圖元的外觀。 | | `QPaintEngine.BlendModes` | `0x00008000` | 該引擎支持混合模式。 | | `QPaintEngine.BrushStroke` | `0x00000800` | 該引擎支持繪制包含畫筆作為填充招，不只是純色（如寬度2虛線漸變線）。 | | `QPaintEngine.ConicalGradientFill` | `0x00000040` | 該引擎支持的錐形漸變填充。 | | `QPaintEngine.ConstantOpacity` | `0x00001000` | 該引擎支持所提供的功能[QPainter.setOpacity](qpainter.html#setOpacity)（）。 | | `QPaintEngine.LinearGradientFill` | `0x00000010` | 該引擎支持線性漸變填充。 | | `QPaintEngine.MaskedBrush` | `0x00002000` | 該引擎能夠呈現畫筆，有帶有alpha通道或遮罩的質感。 | | `QPaintEngine.ObjectBoundingModeGradients` | `0x00010000` | 該發動機具有梯度與原生支持坐標模式[QGradient.ObjectBoundingMode](qgradient.html#CoordinateMode-enum)。否則，如果支持QPaintEngine.PatternTransform ，對象邊界模式漸變轉換為梯度與協調模式[QGradient.LogicalMode](qgradient.html#CoordinateMode-enum)和一個刷子變換的坐標映射關系。 | | `QPaintEngine.PainterPaths` | `0x00000200` | 該發動機具有路徑的支持。 | | `QPaintEngine.PaintOutsidePaintEvent` | `0x20000000` | 該引擎能夠畫的繪制事件之外。 | | `QPaintEngine.PatternBrush` | `0x00000008` | 該引擎能夠呈現刷子在指定的筆刷模式[Qt.BrushStyle](qt.html#BrushStyle-enum)。 | | `QPaintEngine.PatternTransform` | `0x00000002` | 該發動機具有轉化刷模式的支持。 | | `QPaintEngine.PerspectiveTransform` | `0x00004000` | 該發動機具有對原語進行視角轉換的支持。 | | `QPaintEngine.PixmapTransform` | `0x00000004` | 該引擎可以將像素圖，包括旋轉和剪切。 | | `QPaintEngine.PorterDuff` | `0x00000100` | 該引擎支持波特 - 達夫操作 | | `QPaintEngine.PrimitiveTransform` | `0x00000001` | 該發動機具有轉化的繪圖圖元的支持。 | | `QPaintEngine.RadialGradientFill` | `0x00000020` | 該引擎支持的徑向漸變填充。 | | `QPaintEngine.RasterOpModes` | `0x00020000` | 該引擎支持按位光柵操作。 | | `QPaintEngine.AllFeatures` | `0xffffffff` | 所有的上述功能。這個枚舉值通常被用作一個位掩碼。 | 該PaintEngineFeatures類型是一個typedef為[QFlags](index.htm)\u003cPaintEngineFeature\u003e 。它存儲PaintEngineFeature值的或組合。 ``` QPaintEngine.PolygonDrawMode ``` | Constant | Value | Description | | --- | --- | --- | | `QPaintEngine.OddEvenMode` | `0` | 多邊形應使用OddEven填充規則繪制。 | | `QPaintEngine.WindingMode` | `1` | 多邊形應使用繞線填充規則繪制。 | | `QPaintEngine.ConvexMode` | `2` | 多邊形是凸多邊形，并可以使用提供的專門的算法，其中繪制。 | | `QPaintEngine.PolylineMode` | `3` | 多邊形的唯一的輪廓應繪制。 | ``` QPaintEngine.Type ``` | Constant | Value | Description | | --- | --- | --- | | `QPaintEngine.X11` | `0` | ? | | `QPaintEngine.Windows` | `1` | ? | | `QPaintEngine.MacPrinter` | `4` | ? | | `QPaintEngine.CoreGraphics` | `3` | Mac OS X的Quartz2D （核芯顯卡） | | `QPaintEngine.QuickDraw` | `2` | Mac OS X的的QuickDraw | | `QPaintEngine.QWindowSystem` | `5` | Qt嵌入式Linux的 | | `QPaintEngine.PostScript` | `6` | ? | | `QPaintEngine.OpenGL` | `7` | ? | | `QPaintEngine.Picture` | `8` | [QPicture](qpicture.html)格式 | | `QPaintEngine.SVG` | `9` | 可伸縮矢量圖形的XML格式 | | `QPaintEngine.Raster` | `10` | ? | | `QPaintEngine.Direct3D` | `11` | 僅適用于Windows ，基于Direct3D的發動機 | | `QPaintEngine.Pdf` | `12` | 可移植文檔格式 | | `QPaintEngine.OpenVG` | `13` | ? | | `QPaintEngine.User` | `50` | 第一個用戶類型ID | | `QPaintEngine.MaxUser` | `100` | 最后用戶類型ID | | `QPaintEngine.OpenGL2` | `14` | ? | | `QPaintEngine.PaintBuffer` | `15` | ? | | `QPaintEngine.Blitter` | `16` | ? | * * * ## Method Documentation ``` QPaintEngine.__init__ (self, PaintEngineFeatures?features?=?0) ``` 創建一個繪圖引擎與指定的FEATURESET_caps_。 ``` bool QPaintEngine.begin (self, QPaintDevice?pdev) ``` 這種方法是抽象的，應在任何子類中重新實現。重新實現這個函數繪制時初始化你的繪圖引擎是開始繪制設備上_pdev_。返回True，如果初始化成功，否則返回False 。 **See also** [end](qpaintengine.html#end)（）和[isActive](qpaintengine.html#isActive)（）。 ``` QPaintEngine.drawEllipse (self, QRectF?r) ``` 重新實現這個函數來繪制，可以包含在矩形上最大的橢圓_rect_。默認實現調用[drawPolygon](qpaintengine.html#drawPolygon)（）。 ``` QPaintEngine.drawEllipse (self, QRect?r) ``` 此函數的默認實現調用這個函數的浮點版本 ``` QPaintEngine.drawImage (self, QRectF?r, QImage?pm, QRectF?sr, Qt.ImageConversionFlags?flags?=?Qt.AutoColor) ``` 重新實現這個函數來繪制的部分_image_由指定的_sr_矩形在給定的_rectangle_使用給定的轉換標志_flags_，將其轉換為像素圖。 ``` QPaintEngine.drawLines (self, QLine?lines) ``` 默認實現拆分中的行列表_lines_成_lineCount_單獨調用[drawPath](qpaintengine.html#drawPath)（）或[drawPolygon](qpaintengine.html#drawPolygon)（），這取決于繪圖引擎的功能集。 ``` QPaintEngine.drawLines (self, QLineF?lines) ``` 這是一個重載函數。默認實現將第一_lineCount_在線路_lines_到[QLineF](qlinef.html)并調用這個函數的浮點版本。 ``` QPaintEngine.drawPath (self, QPainterPath?path) ``` 默認實現忽略_path_而什么都不做。 ``` QPaintEngine.drawPixmap (self, QRectF?r, QPixmap?pm, QRectF?sr) ``` 這種方法是抽象的，應在任何子類中重新實現。重新實現這個函數來繪制的部分_pm_由指定的_sr_矩形在給定的_r_。 ``` QPaintEngine.drawPoints (self, QPointF?points) ``` 繪制第一_pointCount_在緩沖點_points_ ``` QPaintEngine.drawPoints (self, QPoint?points) ``` 繪制第一_pointCount_在緩沖點_points_ 默認實現將第一_pointCount_在QPoints_points_到QPointFs并調用drawPoints的浮點版本。 ``` QPaintEngine.drawPolygon (self, QPointF?points, PolygonDrawMode?mode) ``` 重新實現這個虛函數繪制由定義的多邊形_pointCount_在第一分_points_，使用模式_mode_。 **Note:**至少有一個的drawPolygon （）函數必須被重新實現。 ``` QPaintEngine.drawPolygon (self, QPoint?points, PolygonDrawMode?mode) ``` 這是一個重載函數。重新實現這個虛函數繪制由定義的多邊形_pointCount_在第一分_points_，使用模式_mode_。 **Note:**中的至少一個的[drawPolygon](qpaintengine.html#drawPolygon)（）函數必須被重新實現。 ``` QPaintEngine.drawRects (self, QRect?rects) ``` 繪制第一_rectCount_在緩沖區中的矩形_rects_。此函數的默認實現調用[drawPath](qpaintengine.html#drawPath)（）或[drawPolygon](qpaintengine.html#drawPolygon)（），這取決于繪圖引擎的功能集。 ``` QPaintEngine.drawRects (self, QRectF?rects) ``` 這是一個重載函數。默認實現將第一_rectCount_在緩沖區中的矩形_rects_到[QRectF](qrectf.html)并調用這個函數的浮點版本。 ``` QPaintEngine.drawTextItem (self, QPointF?p, QTextItem?textItem) ``` 這個函數繪制文本項_textItem_在位置_p_。這個函數的默認實現文本轉換為[QPainterPath](qpainterpath.html)和油漆產生的路徑。 ``` QPaintEngine.drawTiledPixmap (self, QRectF?r, QPixmap?pixmap, QPointF?s) ``` 重新實現這個函數來繪制_pixmap_在給定的_rect_開始，在給定的_p_。像素圖將被重復繪制，直到_rect_被充滿。 ``` bool QPaintEngine.end (self) ``` 這種方法是抽象的，應在任何子類中重新實現。重新實現此功能可將當前繪圖設備上完成繪畫。返回True，如果繪畫是成功完成，否則返回False 。 **See also** [begin](qpaintengine.html#begin)（）和[isActive](qpaintengine.html#isActive)（）。 ``` bool QPaintEngine.hasFeature (self, PaintEngineFeatures?feature) ``` 如果繪圖引擎支持指定，則返回True_feature_否則返回False 。 ``` bool QPaintEngine.isActive (self) ``` 返回True如果繪圖引擎正在積極制訂，否則返回False 。 **See also** [setActive](qpaintengine.html#setActive)（）。 ``` QPaintDevice QPaintEngine.paintDevice (self) ``` [ 返回這款發動機是畫上，如果畫的是積極的裝置，否則返回0 。 ](qpaintdevice.html) ``` QPainter QPaintEngine.painter (self) ``` [ 返回繪圖引擎的畫家。 ``` QPaintEngine.setActive (self, bool?newState) ``` 設置繪圖引擎的工作狀態，以_state_。 ](qpainter.html) [**See also**](qpainter.html) [isActive](qpaintengine.html#isActive)（）。 ``` QPaintEngine.setPaintDevice (self, QPaintDevice?device) ``` ``` Type QPaintEngine.type (self) ``` [ 這種方法是抽象的，應在任何子類中重新實現。 ](qpaintengine.html#Type-enum) [重新實現這個函數返回的繪圖引擎](qpaintengine.html#Type-enum)[Type](qpaintengine.html#Type-enum)。 ``` QPaintEngine.updateState (self, QPaintEngineState?state) ``` 這種方法是抽象的，應在任何子類中重新實現。重新實現這個函數來更新繪圖引擎的狀態。完成后，該功能是負責檢查油漆引擎的當前_state_并更新已更改的屬性。使用[QPaintEngineState.state](qpaintenginestate.html#state)（）函數來找出哪些屬性，必須更新，??然后使用相應的[get function](qpaintenginestate.html#getfunction)檢索給定的屬性的當前值。 **See also** [QPaintEngineState](qpaintenginestate.html)。