![]() |
Home · All Classes · Main Classes · Annotated · Grouped Classes · Functions | ![]() |
The QPaintEngine class provides an abstract definition of how QPainter draws to a given device on a given platform. More...
#include <QPaintEngine>
Part of the QtGui module.
The QPaintEngine class provides an abstract definition of how QPainter draws to a given device on a given platform.
Qt 4.0 provides several premade implementations of QPaintEngine for the different painter backends we support. We provide one paint engine for each window system and painting framework we support. This includes X11 on Unix/Linux, GDI/GDI+ on Windows and QuickDraw/CoreGraphics on Mac OS X. In addition we provide QPaintEngine implementations for OpenGL (accessible through QGLWidget) and PostScript (accessible through QPSPrinter on X11).
If one wants to use QPainter to draw to a different backend, such as PDF, one must subclass QPaintEngine and reimplement all its virtual functions. The QPaintEngine implementation is then made available by subclassing QPaintDevice and reimplementing the virtual function QPaintDevice::paintEngine().
QPaintEngine is created and owned by the QPaintDevice that created it.
The big advantage of the QPaintEngine approach opposed to the previous QPainter/QPaintDevice::cmd() approach is that it is now possible to adapt to multiple technologies on each platform and take advantage of the to the fullest.
See also QPainter and QPaintDevice::paintEngine().
This enum is used to describe the features or capabilities that the paint engine has. If a feature is not supported by the engine, QPainter will do a best effort to emulate that feature through other means. The features that are currently emulated are PixmapTransform and LinearGradientFill.
Constant | Value | Description |
---|---|---|
QPaintEngine::PrimitiveTransform | 0x00000001 | The engine has support for transforming drawing primitives. |
QPaintEngine::PatternTransform | 0x00000002 | The engine has support for transforming brush patterns. |
QPaintEngine::PixmapTransform | 0x00000004 | The engine can transform pixmaps, including rotation and shearing. |
QPaintEngine::PatternBrush | 0x00000008 | The engine is capable of rendering brushes with the brush patterns specified in Qt::BrushStyle. |
QPaintEngine::LinearGradientFill | 0x00000010 | Linear gradient fills are supported. |
QPaintEngine::RadialGradientFill | 0x00000020 | Radial gradient fills are supported. |
QPaintEngine::ConicalGradientFill | 0x00000040 | Conical gradient fills are supported. |
QPaintEngine::AlphaBlend | 0x00000080 | The engine can alpha blend primitives. |
QPaintEngine::PorterDuff | 0x00000100 | |
QPaintEngine::PainterPaths | 0x00000200 | The engine has path support. |
QPaintEngine::Antialiasing | 0x00000400 | Antialising can be used to improve the appearance of rendered primitives. |
QPaintEngine::BrushStroke | 0x00000800 | |
QPaintEngine::UsesFontEngine | 0x10000000 | |
QPaintEngine::PaintOutsidePaintEvent | 0x20000000 | The engine is capable of painting outside of paint events. |
QPaintEngine::AllFeatures | 0xffffffff |
The PaintEngineFeatures type stores an OR combination of PaintEngineFeature values.
Constant | Value | Description |
---|---|---|
QPaintEngine::OddEvenMode | 0 | The polygon should be drawn using OddEven fill rule. |
QPaintEngine::WindingMode | 1 | The polygon should be drawn using Winding fill rule. |
QPaintEngine::ConvexMode | 2 | The polygon is a convex polygon and can be drawn using specialized algorithms where available. |
QPaintEngine::PolylineMode | 3 | Only the outline of the polygon should be drawn. |
Constant | Value | Description |
---|---|---|
QPaintEngine::X11 | 0 | |
QPaintEngine::Windows | 1 | |
QPaintEngine::MacPrinter | 4 | |
QPaintEngine::CoreGraphics | 3 | Mac OS X |
QPaintEngine::QuickDraw | 2 | (same as CoreGraphics) |
QPaintEngine::QWindowSystem | 5 | Qt/Embedded |
QPaintEngine::PostScript | 6 | |
QPaintEngine::OpenGL | 7 | |
QPaintEngine::Picture | 8 | QPicture format |
QPaintEngine::SVG | 9 | Scalable Vector Graphics XML format |
QPaintEngine::Raster | 10 | |
QPaintEngine::User | 50 | First user type ID |
QPaintEngine::MaxUser | 100 | Last user type ID |
Creates a paint engine with the featureset specified by caps.
Destroys the paint engine.
Reimplement this function to initialise your paint engine when painting is to start on the paint device pdev. Return true if the initialization was successful; otherwise return false.
See also end() and isActive().
Reimplement this function to draw the largest ellipse that can be contained within rectangle rect.
The default implementation calls drawPolygon().
See also drawPolygon.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
The default implementation of this function calls the floating point version of this function
Reimplement this function to draw the part of the image specified by the sr rectangle in the given rectangle using the given conversion flags flags, to convert it to a pixmap.
The default implementation splits the list of lines in lines into lineCount separate calls to drawPath() or drawPolygon() depending on the feature set of the paint engine.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
The default implementation converts the first lineCount lines in lines to a QLineF and calls the floating point version of this function.
The default implementation ignores the path and does nothing.
Reimplement this function to draw the part of the pm specified by the sr rectangle in the given r.
Draws the first pointCount points in the buffer points
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
Draws the first pointCount points in the buffer points
Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.
The default implementation of this function will try to use drawPath if the engine supports the feature QPaintEngine::PainterPaths or try the int based drawPolygon() implementation if not.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.
The default implementation of this function will try to use drawPath() if the engine supports the feature QPaintEngine::PainterPaths or try the float based drawPolygon() implementation if not.
Draws the first rectCount rectangles in the buffer rects. The default implementation of this function calls drawPath or drawPolygon depending on the feature set of the paint engine.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
The default implementation converts the first rectCount rectangles in the buffer rects to a QRectF and calls the floating point version of this function.
This function draws the text item textItem at position p. The default implementation of this function converts the text to a QPainterPath and paints the resulting path.
Reimplement this function to draw the pixmap in the given rect, starting at the given p. The pixmap will be drawn repeatedly until the rect is filled.
Reimplement this function to finish painting on the current paint device. Return true if painting was finished successfully; otherwise return false.
See also begin() and isActive().
Returns true if the paint engine supports the specified feature; otherwise returns false.
Returns true if the paint engine is actively drawing; otherwise returns false.
See also setActive().
Returns the engine that this engine is painting on, if painting is active; otherwise returns 0.
Returns the paint engine's painter.
Sets the active state of the paint engine to state.
See also isActive().
Reimplement this function to return the paint engine Type.
Copyright © 2005 Trolltech | Trademarks | Qt 4.0.0-rc1 |