Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QCoreGraphicsPaintEngine Class Reference

#include <qpaintengine_mac_p.h>

Inheritance diagram for QCoreGraphicsPaintEngine:
Collaboration diagram for QCoreGraphicsPaintEngine:

Public Member Functions

 QCoreGraphicsPaintEngine ()
 ~QCoreGraphicsPaintEngine ()
bool begin (QPaintDevice *pdev)
 Reimplement this function to initialise your paint engine when painting is to start on the paint device pdev.
bool end ()
 Reimplement this function to finish painting on the current paint device.
void updateState (const QPaintEngineState &state)
 Reimplement this function to update the state of a paint engine.
void updatePen (const QPen &pen)
void updateBrush (const QBrush &brush, const QPointF &pt)
void updateFont (const QFont &font)
void updateOpacity (qreal opacity)
void updateMatrix (const QTransform &matrix)
void updateTransform (const QTransform &matrix)
void updateClipRegion (const QRegion &region, Qt::ClipOperation op)
void updateClipPath (const QPainterPath &path, Qt::ClipOperation op)
void updateCompositionMode (QPainter::CompositionMode mode)
void updateRenderHints (QPainter::RenderHints hints)
void drawLines (const QLineF *lines, int lineCount)
 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.
void drawRects (const QRectF *rects, int rectCount)
 Draws the first rectCount rectangles in the buffer rects.
void drawPoints (const QPointF *p, int pointCount)
 Draws the first pointCount points in the buffer points.
void drawEllipse (const QRectF &r)
 Reimplement this function to draw the largest ellipse that can be contained within rectangle rect.
void drawPath (const QPainterPath &path)
 The default implementation ignores the path and does nothing.
void drawPolygon (const QPointF *points, int pointCount, PolygonDrawMode mode)
 Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.
void drawPixmap (const QRectF &r, const QPixmap &pm, const QRectF &sr)
 Reimplement this function to draw the part of the pm specified by the sr rectangle in the given r.
void drawTiledPixmap (const QRectF &r, const QPixmap &pixmap, const QPointF &s)
 Reimplement this function to draw the pixmap in the given rect, starting at the given p.
void drawTextItem (const QPointF &pos, const QTextItem &item)
 This function draws the text item textItem at position p.
void drawImage (const QRectF &r, const QImage &pm, const QRectF &sr, Qt::ImageConversionFlags flags=Qt::AutoColor)
 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.
Type type () const
 Reimplement this function to return the paint engine \l{Type}.
CGContextRef handle () const
QPainter::RenderHints supportedRenderHints () const
void drawLines (const QLine *lines, int lineCount)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation converts the first lineCount lines in lines to a QLineF and calls the floating point version of this function.
void drawRects (const QRect *rects, int rectCount)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation converts the first rectCount rectangles in the buffer rects to a QRectF and calls the floating point version of this function.
void drawPoints (const QPoint *p, int pointCount)
 Draws the first pointCount points in the buffer points.
void drawEllipse (const QRect &r)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation of this function calls the floating point version of this function.
void drawPolygon (const QPoint *points, int pointCount, PolygonDrawMode mode)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.
Public Member Functions inherited from QPaintEngine
 QPaintEngine (PaintEngineFeatures features=PaintEngineFeatures())
 Creates a paint engine with the featureset specified by caps.
virtual ~QPaintEngine ()
 Destroys the paint engine.
bool isActive () const
 Returns true if the paint engine is actively drawing; otherwise returns false.
void setActive (bool newState)
 Sets the active state of the paint engine to state.
void setPaintDevice (QPaintDevice *device)
QPaintDevice * paintDevice () const
 Returns the device that this engine is painting on, if painting is active; otherwise returns \nullptr.
void setSystemClip (const QRegion &baseClip)
QRegion systemClip () const
void setSystemRect (const QRect &rect)
QRect systemRect () const
virtual QPoint coordinateOffset () const
void fix_neg_rect (int *x, int *y, int *w, int *h)
bool testDirty (DirtyFlags df)
void setDirty (DirtyFlags df)
void clearDirty (DirtyFlags df)
bool hasFeature (PaintEngineFeatures feature) const
 Returns true if the paint engine supports the specified feature; otherwise returns false.
QPainter * painter () const
 Returns the paint engine's painter.
void syncState ()
bool isExtended () const
virtual QPixmap createPixmap (QSize size)
virtual QPixmap createPixmapFromImage (QImage image, Qt::ImageConversionFlags flags=Qt::AutoColor)

Static Public Member Functions

static void initialize ()
static void cleanup ()

Protected Member Functions

 QCoreGraphicsPaintEngine (QPaintEnginePrivate &dptr)
Protected Member Functions inherited from QPaintEngine
 QPaintEngine (QPaintEnginePrivate &data, PaintEngineFeatures devcaps=PaintEngineFeatures())

Friends

class QMacPrintEngine
class QMacPrintEnginePrivate

Additional Inherited Members

Public Types inherited from QPaintEngine
enum  PaintEngineFeature {
  PrimitiveTransform = 0x00000001 , PatternTransform = 0x00000002 , PixmapTransform = 0x00000004 , PatternBrush = 0x00000008 ,
  LinearGradientFill = 0x00000010 , RadialGradientFill = 0x00000020 , ConicalGradientFill = 0x00000040 , AlphaBlend = 0x00000080 ,
  PorterDuff = 0x00000100 , PainterPaths = 0x00000200 , Antialiasing = 0x00000400 , BrushStroke = 0x00000800 ,
  ConstantOpacity = 0x00001000 , MaskedBrush = 0x00002000 , PerspectiveTransform = 0x00004000 , BlendModes = 0x00008000 ,
  ObjectBoundingModeGradients = 0x00010000 , RasterOpModes = 0x00020000 , PaintOutsidePaintEvent = 0x20000000 , AllFeatures = 0xffffffff
}
 This enum is used to describe the features or capabilities that the paint engine has. More...
enum  DirtyFlag {
  DirtyPen = 0x0001 , DirtyBrush = 0x0002 , DirtyBrushOrigin = 0x0004 , DirtyFont = 0x0008 ,
  DirtyBackground = 0x0010 , DirtyBackgroundMode = 0x0020 , DirtyTransform = 0x0040 , DirtyClipRegion = 0x0080 ,
  DirtyClipPath = 0x0100 , DirtyHints = 0x0200 , DirtyCompositionMode = 0x0400 , DirtyClipEnabled = 0x0800 ,
  DirtyOpacity = 0x1000 , AllDirty = 0xffff
}
 \value DirtyPen The pen is dirty and needs to be updated. More...
enum  PolygonDrawMode { OddEvenMode , WindingMode , ConvexMode , PolylineMode }
 \value OddEvenMode The polygon should be drawn using OddEven fill rule. More...
enum  Type {
  X11 , Windows , QuickDraw , CoreGraphics ,
  MacPrinter , QWindowSystem , OpenGL , Picture ,
  SVG , Raster , Direct3D , Pdf ,
  OpenVG , OpenGL2 , PaintBuffer , Blitter ,
  Direct2D , User = 50 , MaxUser = 100
}
 \value X11 \value Windows \value MacPrinter \value CoreGraphics \macos's Quartz2D (CoreGraphics) \value QuickDraw \macos's QuickDraw \value QWindowSystem Qt for Embedded Linux \value OpenGL \value Picture QPicture format \value SVG Scalable Vector Graphics XML format \value Raster \value Direct3D Windows only, Direct3D based engine \value Pdf Portable Document Format \value OpenVG \value User First user type ID \value MaxUser Last user type ID \value OpenGL2 \value PaintBuffer \value Blitter \value Direct2D Windows only, Direct2D based engine More...
Protected Attributes inherited from QPaintEngine
QPaintEngineState * state
PaintEngineFeatures gccaps
uint active: 1
uint selfDestruct: 1
uint extended: 1
QScopedPointer< QPaintEnginePrivate > d_ptr

Detailed Description

Definition at line 32 of file qpaintengine_mac_p.h.

Constructor & Destructor Documentation

◆ QCoreGraphicsPaintEngine() [1/2]

QCoreGraphicsPaintEngine::QCoreGraphicsPaintEngine ( )

Definition at line 329 of file qpaintengine_mac.mm.

◆ ~QCoreGraphicsPaintEngine()

QCoreGraphicsPaintEngine::~QCoreGraphicsPaintEngine ( )

Definition at line 339 of file qpaintengine_mac.mm.

◆ QCoreGraphicsPaintEngine() [2/2]

QCoreGraphicsPaintEngine::QCoreGraphicsPaintEngine ( QPaintEnginePrivate & dptr)
protected

Definition at line 334 of file qpaintengine_mac.mm.

References QCoreGraphicsPaintEngine().

Referenced by QCoreGraphicsPaintEngine().

Here is the call graph for this function:
Here is the caller graph for this function:

Member Function Documentation

◆ begin()

bool QCoreGraphicsPaintEngine::begin ( QPaintDevice * pdev)
virtual

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(), isActive()

Implements QPaintEngine.

Definition at line 344 of file qpaintengine_mac.mm.

◆ cleanup()

void QCoreGraphicsPaintEngine::cleanup ( )
static

Definition at line 796 of file qpaintengine_mac.mm.

◆ drawEllipse() [1/2]

void QCoreGraphicsPaintEngine::drawEllipse ( const QRect & r)
inlinevirtual

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation of this function calls the floating point version of this function.

Reimplemented from QPaintEngine.

Definition at line 83 of file qpaintengine_mac_p.h.

◆ drawEllipse() [2/2]

void QCoreGraphicsPaintEngine::drawEllipse ( const QRectF & rect)
virtual

Reimplement this function to draw the largest ellipse that can be contained within rectangle rect.

The default implementation calls drawPolygon().

Reimplemented from QPaintEngine.

Definition at line 681 of file qpaintengine_mac.mm.

◆ drawImage()

void QCoreGraphicsPaintEngine::drawImage ( const QRectF & r,
const QImage & pm,
const QRectF & sr,
Qt::ImageConversionFlags flags = Qt::AutoColor )
virtual

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.

Reimplemented from QPaintEngine.

Definition at line 774 of file qpaintengine_mac.mm.

◆ drawLines() [1/2]

void QCoreGraphicsPaintEngine::drawLines ( const QLine * lines,
int lineCount )
inlinevirtual

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation converts the first lineCount lines in lines to a QLineF and calls the floating point version of this function.

Reimplemented from QPaintEngine.

Definition at line 80 of file qpaintengine_mac_p.h.

◆ drawLines() [2/2]

void QCoreGraphicsPaintEngine::drawLines ( const QLineF * lines,
int lineCount )
virtual

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.

Reimplemented from QPaintEngine.

Definition at line 722 of file qpaintengine_mac.mm.

References end().

Here is the call graph for this function:

◆ drawPath()

void QCoreGraphicsPaintEngine::drawPath ( const QPainterPath & path)
virtual

The default implementation ignores the path and does nothing.

Reimplemented from QPaintEngine.

Definition at line 607 of file qpaintengine_mac.mm.

References QCoreGraphicsPaintEnginePrivate::CGEOFill, QCoreGraphicsPaintEnginePrivate::CGFill, and QCoreGraphicsPaintEnginePrivate::CGStroke.

◆ drawPixmap()

void QCoreGraphicsPaintEngine::drawPixmap ( const QRectF & r,
const QPixmap & pm,
const QRectF & sr )
virtual

Reimplement this function to draw the part of the pm specified by the sr rectangle in the given r.

Implements QPaintEngine.

Definition at line 740 of file qpaintengine_mac.mm.

◆ drawPoints() [1/2]

void QCoreGraphicsPaintEngine::drawPoints ( const QPoint * points,
int pointCount )
inlinevirtual

Draws the first pointCount points in the buffer points.

The default implementation converts the first pointCount QPoints in points to QPointFs and calls the floating point version of drawPoints.

Reimplemented from QPaintEngine.

Definition at line 82 of file qpaintengine_mac_p.h.

◆ drawPoints() [2/2]

void QCoreGraphicsPaintEngine::drawPoints ( const QPointF * points,
int pointCount )
virtual

Draws the first pointCount points in the buffer points.

Reimplemented from QPaintEngine.

Definition at line 647 of file qpaintengine_mac.mm.

◆ drawPolygon() [1/2]

void QCoreGraphicsPaintEngine::drawPolygon ( const QPoint * points,
int pointCount,
PolygonDrawMode mode )
inlinevirtual

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.

Note
At least one of the drawPolygon() functions must be reimplemented.

Reimplemented from QPaintEngine.

Definition at line 84 of file qpaintengine_mac_p.h.

◆ drawPolygon() [2/2]

void QCoreGraphicsPaintEngine::drawPolygon ( const QPointF * points,
int pointCount,
PolygonDrawMode mode )
virtual

Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.

Note
At least one of the drawPolygon() functions must be reimplemented.

Reimplemented from QPaintEngine.

Definition at line 699 of file qpaintengine_mac.mm.

References QCoreGraphicsPaintEnginePrivate::CGStroke.

◆ drawRects() [1/2]

void QCoreGraphicsPaintEngine::drawRects ( const QRect * rects,
int rectCount )
inlinevirtual

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.The default implementation converts the first rectCount rectangles in the buffer rects to a QRectF and calls the floating point version of this function.

Reimplemented from QPaintEngine.

Definition at line 81 of file qpaintengine_mac_p.h.

◆ drawRects() [2/2]

void QCoreGraphicsPaintEngine::drawRects ( const QRectF * rects,
int rectCount )
virtual

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.

Reimplemented from QPaintEngine.

Definition at line 627 of file qpaintengine_mac.mm.

◆ drawTextItem()

void QCoreGraphicsPaintEngine::drawTextItem ( const QPointF & p,
const QTextItem & textItem )
virtual

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.

Reimplemented from QPaintEngine.

Definition at line 851 of file qpaintengine_mac.mm.

◆ drawTiledPixmap()

void QCoreGraphicsPaintEngine::drawTiledPixmap ( const QRectF & rect,
const QPixmap & pixmap,
const QPointF & p )
virtual

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.

Reimplemented from QPaintEngine.

Definition at line 807 of file qpaintengine_mac.mm.

References QMacPattern::height(), qt_mac_dispose_pattern(), qt_mac_draw_pattern(), and QMacPattern::width().

Here is the call graph for this function:

◆ end()

bool QCoreGraphicsPaintEngine::end ( )
virtual

Reimplement this function to finish painting on the current paint device.

Return true if painting was finished successfully; otherwise return false.

See also
begin(), isActive()

Implements QPaintEngine.

Definition at line 400 of file qpaintengine_mac.mm.

Referenced by drawLines().

Here is the caller graph for this function:

◆ handle()

CGContextRef QCoreGraphicsPaintEngine::handle ( ) const

Definition at line 801 of file qpaintengine_mac.mm.

◆ initialize()

void QCoreGraphicsPaintEngine::initialize ( )
static

Definition at line 792 of file qpaintengine_mac.mm.

◆ supportedRenderHints()

QPainter::RenderHints QCoreGraphicsPaintEngine::supportedRenderHints ( ) const

Definition at line 912 of file qpaintengine_mac.mm.

◆ type()

Type QCoreGraphicsPaintEngine::type ( ) const
inlinevirtual

Reimplement this function to return the paint engine \l{Type}.

Implements QPaintEngine.

Definition at line 70 of file qpaintengine_mac_p.h.

◆ updateBrush()

void QCoreGraphicsPaintEngine::updateBrush ( const QBrush & brush,
const QPointF & pt )

Definition at line 489 of file qpaintengine_mac.mm.

◆ updateClipPath()

void QCoreGraphicsPaintEngine::updateClipPath ( const QPainterPath & path,
Qt::ClipOperation op )

Definition at line 547 of file qpaintengine_mac.mm.

◆ updateClipRegion()

void QCoreGraphicsPaintEngine::updateClipRegion ( const QRegion & region,
Qt::ClipOperation op )

Definition at line 586 of file qpaintengine_mac.mm.

◆ updateCompositionMode()

void QCoreGraphicsPaintEngine::updateCompositionMode ( QPainter::CompositionMode mode)

Definition at line 935 of file qpaintengine_mac.mm.

References kCGCompositeModeDestinationIn.

◆ updateFont()

void QCoreGraphicsPaintEngine::updateFont ( const QFont & font)

Definition at line 521 of file qpaintengine_mac.mm.

◆ updateMatrix()

void QCoreGraphicsPaintEngine::updateMatrix ( const QTransform & matrix)

Definition at line 529 of file qpaintengine_mac.mm.

◆ updateOpacity()

void QCoreGraphicsPaintEngine::updateOpacity ( qreal opacity)

Definition at line 514 of file qpaintengine_mac.mm.

◆ updatePen()

void QCoreGraphicsPaintEngine::updatePen ( const QPen & pen)

Definition at line 480 of file qpaintengine_mac.mm.

◆ updateRenderHints()

void QCoreGraphicsPaintEngine::updateRenderHints ( QPainter::RenderHints hints)

Definition at line 1020 of file qpaintengine_mac.mm.

◆ updateState()

void QCoreGraphicsPaintEngine::updateState ( const QPaintEngineState & state)
virtual

Reimplement this function to update the state of a paint engine.

When implemented, this function is responsible for checking the paint engine's current state and update the properties that are changed. Use the QPaintEngineState::state() function to find out which properties that must be updated, then use the corresponding \l {GetFunction}{get function} to retrieve the current values for the given properties.

See also
QPaintEngineState

Implements QPaintEngine.

Definition at line 419 of file qpaintengine_mac.mm.

◆ updateTransform()

void QCoreGraphicsPaintEngine::updateTransform ( const QTransform & matrix)

◆ QMacPrintEngine

friend class QMacPrintEngine
friend

Definition at line 88 of file qpaintengine_mac_p.h.

◆ QMacPrintEnginePrivate

friend class QMacPrintEnginePrivate
friend

Definition at line 89 of file qpaintengine_mac_p.h.

The documentation for this class was generated from the following files: