qpainter.cpp

Go to the documentation of this file.

// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
 
// QtCore
// Qt-Security score:significant reason:default
#include <memory>
#include <qdebug.h>
#include <qmath.h>
#include <qmutex.h>
 
// QtGui
#include "qbitmap.h"
#include "qimage.h"
#include "qpaintdevice.h"
#include "qpaintengine.h"
#include "qpainter.h"
#include "qpainter_p.h"
#include "qpainterpath.h"
#include "qpicture.h"
#include "qpixmapcache.h"
#include "qpolygon.h"
#include "qtextlayout.h"
#include "qthread.h"
#include "qvarlengtharray.h"
#include "qstatictext.h"
#include "qglyphrun.h"
 
#include <qpa/qplatformtheme.h>
#include <qpa/qplatformintegration.h>
 
#include <private/qfontengine_p.h>
#include <private/qpaintengine_p.h>
#include <private/qemulationpaintengine_p.h>
#include <private/qpainterpath_p.h>
#include <private/qtextengine_p.h>
#include <private/qpaintengine_raster_p.h>
#include <private/qmath_p.h>
#include <private/qstatictext_p.h>
#include <private/qglyphrun_p.h>
#include <private/qhexstring_p.h>
#include <private/qguiapplication_p.h>
#include <private/qrawfont_p.h>
#include <private/qfont_p.h>
 
#include <QtCore/private/qtclasshelper_p.h>
 
QT_BEGIN_NAMESPACE
 
using namespace Qt::StringLiterals;
 
// We changed the type from QScopedPointer to unique_ptr, make sure it's binary compatible:
static_assert(sizeof(QScopedPointer<QPainterPrivate>) == sizeof(std::unique_ptr<QPainterPrivate>));
 
#define QGradient_StretchToDevice 0x10000000
#define QPaintEngine_OpaqueBackground 0x40000000
 
// #define QT_DEBUG_DRAW
#ifdef QT_DEBUG_DRAW
constexpr bool qt_show_painter_debug_output = true;
#endif
 
extern QPixmap qt_pixmapForBrush(int style, bool invert);
 
void qt_format_text(const QFont &font,
                    const QRectF &_r, int tf, const QTextOption *option, const QString& str, QRectF *brect,
                    int tabstops, int* tabarray, int tabarraylen,
                    QPainter *painter);
static void drawTextItemDecoration(QPainter *painter, const QPointF &pos, const QFontEngine *fe, QTextEngine *textEngine,
                                   QTextCharFormat::UnderlineStyle underlineStyle,
                                   QTextItem::RenderFlags flags, qreal width,
                                   const QTextCharFormat &charFormat);
// Helper function to calculate left most position, width and flags for decoration drawing
static void qt_draw_decoration_for_glyphs(QPainter *painter,
                                          const QPointF &decorationPosition,
                                          const glyph_t *glyphArray,
                                          const QFixedPoint *positions,
                                          int glyphCount,
                                          QFontEngine *fontEngine,
                                          bool underline,
                                          bool overline,
                                          bool strikeOut);
 
static inline QGradient::CoordinateMode coordinateMode(const QBrush &brush)
{
    switch (brush.style()) {
    case Qt::LinearGradientPattern:
    case Qt::RadialGradientPattern:
    case Qt::ConicalGradientPattern:
        return brush.gradient()->coordinateMode();
    default:
        ;
    }
    return QGradient::LogicalMode;
}
 
extern bool qHasPixmapTexture(const QBrush &);
 
static inline bool is_brush_transparent(const QBrush &brush) {
    Qt::BrushStyle s = brush.style();
    if (s != Qt::TexturePattern)
        return s >= Qt::Dense1Pattern && s <= Qt::DiagCrossPattern;
    if (qHasPixmapTexture(brush))
        return brush.texture().isQBitmap() || brush.texture().hasAlphaChannel();
    else {
        const QImage texture = brush.textureImage();
        return texture.hasAlphaChannel() || (texture.depth() == 1 && texture.colorCount() == 0);
    }
}
 
static inline bool is_pen_transparent(const QPen &pen) {
    return pen.style() > Qt::SolidLine || is_brush_transparent(pen.brush());
}
 
/* Discards the emulation flags that are not relevant for line drawing
   and returns the result
*/
static inline uint line_emulation(uint emulation)
{
    return emulation & (QPaintEngine::PrimitiveTransform
                        | QPaintEngine::AlphaBlend
                        | QPaintEngine::Antialiasing
                        | QPaintEngine::BrushStroke
                        | QPaintEngine::ConstantOpacity
                        | QGradient_StretchToDevice
                        | QPaintEngine::ObjectBoundingModeGradients
                        | QPaintEngine_OpaqueBackground);
}
 
#ifndef QT_NO_DEBUG
static bool qt_painter_thread_test(int devType, int engineType, const char *what)
{
    const QPlatformIntegration *platformIntegration = QGuiApplicationPrivate::platformIntegration();
    switch (devType) {
    case QInternal::Image:
    case QInternal::Printer:
    case QInternal::Picture:
        // can be drawn onto these devices safely from any thread
        break;
    default:
        if (QThread::currentThread() != qApp->thread()
                // pixmaps cannot be targets unless threaded pixmaps are supported
                && (devType != QInternal::Pixmap || !platformIntegration->hasCapability(QPlatformIntegration::ThreadedPixmaps))
                // framebuffer objects and such cannot be targets unless threaded GL is supported
                && (devType != QInternal::OpenGL || !platformIntegration->hasCapability(QPlatformIntegration::ThreadedOpenGL))
                // widgets cannot be targets except for QGLWidget
                && (devType != QInternal::Widget || !platformIntegration->hasCapability(QPlatformIntegration::ThreadedOpenGL)
                    || (engineType != QPaintEngine::OpenGL && engineType != QPaintEngine::OpenGL2))) {
            qWarning("QPainter: It is not safe to use %s outside the GUI thread", what);
            return false;
        }
        break;
    }
    return true;
}
#endif
 
static bool needsEmulation(const QBrush &brush)
{
    bool res = false;
 
    const QGradient *bg = brush.gradient();
    if (bg) {
        res = (bg->coordinateMode() > QGradient::LogicalMode);
    } else if (brush.style() == Qt::TexturePattern) {
        if (qHasPixmapTexture(brush))
            res = !qFuzzyCompare(brush.texture().devicePixelRatio(), qreal(1.0));
        else
            res = !qFuzzyCompare(brush.textureImage().devicePixelRatio(), qreal(1.0));
    }
 
    return res;
}
 
void QPainterPrivate::checkEmulation()
{
    Q_ASSERT(extended);
    bool doEmulation = false;
    if (state->bgMode == Qt::OpaqueMode)
        doEmulation = true;
 
    if (needsEmulation(state->brush))
        doEmulation = true;
 
    if (needsEmulation(qpen_brush(state->pen)))
        doEmulation = true;
 
    if (doEmulation && extended->flags() & QPaintEngineEx::DoNotEmulate)
        return;
 
    if (doEmulation) {
        if (extended != emulationEngine.get()) {
            if (!emulationEngine)
                emulationEngine = std::make_unique<QEmulationPaintEngine>(extended);
            extended = emulationEngine.get();
            extended->setState(state.get());
        }
    } else if (emulationEngine.get() == extended) {
        extended = emulationEngine->real_engine;
    }
}
 
QPainterPrivate::QPainterPrivate(QPainter *painter)
    : q_ptr(painter), txinv(0), inDestructor(false)
{
}
 
QPainterPrivate::~QPainterPrivate()
    = default;
 
QTransform QPainterPrivate::viewTransform() const
{
    if (state->VxF) {
        qreal scaleW = qreal(state->vw)/qreal(state->ww);
        qreal scaleH = qreal(state->vh)/qreal(state->wh);
        return QTransform(scaleW, 0, 0, scaleH,
                          state->vx - state->wx*scaleW, state->vy - state->wy*scaleH);
    }
    return QTransform();
}
 
qreal QPainterPrivate::effectiveDevicePixelRatio() const
{
    // Special cases for devices that does not support PdmDevicePixelRatio go here:
    if (device->devType() == QInternal::Printer)
        return qreal(1);
 
    return device->devicePixelRatio();
}
 
QTransform QPainterPrivate::hidpiScaleTransform() const
{
    const qreal devicePixelRatio = effectiveDevicePixelRatio();
    return QTransform::fromScale(devicePixelRatio, devicePixelRatio);
}
 
/*
   \internal
   Returns \c true if using a shared painter; otherwise false.
*/
bool QPainterPrivate::attachPainterPrivate(QPainter *q, QPaintDevice *pdev)
{
    Q_ASSERT(q);
    Q_ASSERT(pdev);
 
    QPainter *sp = pdev->sharedPainter();
    if (!sp)
        return false;
 
    // Save the current state of the shared painter and assign
    // the current d_ptr to the shared painter's d_ptr.
    sp->save();
    ++sp->d_ptr->refcount;
    sp->d_ptr->d_ptrs.push_back(std::move(q->d_ptr));
    q->d_ptr.reset(sp->d_ptr.get());
 
    Q_ASSERT(q->d_ptr->state);
 
    // Now initialize the painter with correct widget properties.
    q->d_ptr->initFrom(pdev);
    QPoint offset;
    pdev->redirected(&offset);
    offset += q->d_ptr->engine->coordinateOffset();
 
    // Update system rect.
    q->d_ptr->state->ww = q->d_ptr->state->vw = pdev->width();
    q->d_ptr->state->wh = q->d_ptr->state->vh = pdev->height();
 
    // Update matrix.
    if (q->d_ptr->state->WxF) {
        q->d_ptr->state->redirectionMatrix = q->d_ptr->state->matrix;
        q->d_ptr->state->redirectionMatrix *= q->d_ptr->hidpiScaleTransform().inverted();
        q->d_ptr->state->redirectionMatrix.translate(-offset.x(), -offset.y());
        q->d_ptr->state->worldMatrix = QTransform();
        q->d_ptr->state->WxF = false;
    } else {
        q->d_ptr->state->redirectionMatrix = QTransform::fromTranslate(-offset.x(), -offset.y());
    }
    q->d_ptr->updateMatrix();
 
    QPaintEnginePrivate *enginePrivate = q->d_ptr->engine->d_func();
    if (enginePrivate->currentClipDevice == pdev) {
        enginePrivate->systemStateChanged();
        return true;
    }
 
    // Update system transform and clip.
    enginePrivate->currentClipDevice = pdev;
    enginePrivate->setSystemTransform(q->d_ptr->state->matrix);
    return true;
}
 
void QPainterPrivate::detachPainterPrivate(QPainter *q)
{
    Q_ASSERT(refcount > 1);
    Q_ASSERT(q);
 
    --refcount;
    auto original = std::move(d_ptrs.back());
    d_ptrs.pop_back();
    if (inDestructor) {
        inDestructor = false;
        if (original)
            original->inDestructor = true;
    } else if (!original) {
        original = std::make_unique<QPainterPrivate>(q);
    }
 
    q->restore();
    Q_UNUSED(q->d_ptr.release());
    q->d_ptr = std::move(original);
 
    if (emulationEngine) {
        extended = emulationEngine->real_engine;
        emulationEngine = nullptr;
    }
}
 
 
void QPainterPrivate::draw_helper(const QPainterPath &originalPath, DrawOperation op)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output) {
        printf("QPainter::drawHelper\n");
    }
#endif
 
    if (originalPath.isEmpty())
        return;
 
    QPaintEngine::PaintEngineFeatures gradientStretch =
        QPaintEngine::PaintEngineFeatures(QGradient_StretchToDevice
                                          | QPaintEngine::ObjectBoundingModeGradients);
 
    const bool mustEmulateObjectBoundingModeGradients = extended
                                                        || ((state->emulationSpecifier & QPaintEngine::ObjectBoundingModeGradients)
                                                            && !engine->hasFeature(QPaintEngine::PatternTransform));
 
    if (!(state->emulationSpecifier & ~gradientStretch)
        && !mustEmulateObjectBoundingModeGradients) {
        drawStretchedGradient(originalPath, op);
        return;
    } else if (state->emulationSpecifier & QPaintEngine_OpaqueBackground) {
        drawOpaqueBackground(originalPath, op);
        return;
    }
 
    Q_Q(QPainter);
 
    qreal strokeOffsetX = 0, strokeOffsetY = 0;
 
    QPainterPath path = originalPath * state->matrix;
    QRectF pathBounds = path.boundingRect();
    QRectF strokeBounds;
    bool doStroke = (op & StrokeDraw) && (state->pen.style() != Qt::NoPen);
    if (doStroke) {
        qreal penWidth = state->pen.widthF();
        if (penWidth == 0) {
            strokeOffsetX = 1;
            strokeOffsetY = 1;
        } else {
            // In case of complex xform
            if (state->matrix.type() > QTransform::TxScale) {
                QPainterPathStroker stroker;
                stroker.setWidth(penWidth);
                stroker.setJoinStyle(state->pen.joinStyle());
                stroker.setCapStyle(state->pen.capStyle());
                QPainterPath stroke = stroker.createStroke(originalPath);
                strokeBounds = (stroke * state->matrix).boundingRect();
            } else {
                strokeOffsetX = qAbs(penWidth * state->matrix.m11() / 2.0);
                strokeOffsetY = qAbs(penWidth * state->matrix.m22() / 2.0);
            }
        }
    }
 
    QRect absPathRect;
    if (!strokeBounds.isEmpty()) {
        absPathRect = strokeBounds.intersected(QRectF(0, 0, device->width(), device->height())).toAlignedRect();
    } else {
        absPathRect = pathBounds.adjusted(-strokeOffsetX, -strokeOffsetY, strokeOffsetX, strokeOffsetY)
            .intersected(QRectF(0, 0, device->width(), device->height())).toAlignedRect();
    }
 
    if (q->hasClipping()) {
        bool hasPerspectiveTransform = false;
        for (const QPainterClipInfo &info : std::as_const(state->clipInfo)) {
            if (info.matrix.type() == QTransform::TxProject) {
                hasPerspectiveTransform = true;
                break;
            }
        }
        // avoid mapping QRegions with perspective transforms
        if (!hasPerspectiveTransform) {
            // The trick with txinv and invMatrix is done in order to
            // avoid transforming the clip to logical coordinates, and
            // then back to device coordinates. This is a problem with
            // QRegion/QRect based clips, since they use integer
            // coordinates and converting to/from logical coordinates will
            // lose precision.
            bool old_txinv = txinv;
            QTransform old_invMatrix = invMatrix;
            txinv = true;
            invMatrix = QTransform();
            QPainterPath clipPath = q->clipPath();
            QRectF r = clipPath.boundingRect().intersected(absPathRect);
            absPathRect = r.toAlignedRect();
            txinv = old_txinv;
            invMatrix = old_invMatrix;
        }
    }
 
//     qDebug("\nQPainterPrivate::draw_helper(), x=%d, y=%d, w=%d, h=%d",
//            devMinX, devMinY, device->width(), device->height());
//     qDebug() << " - matrix" << state->matrix;
//     qDebug() << " - originalPath.bounds" << originalPath.boundingRect();
//     qDebug() << " - path.bounds" << path.boundingRect();
 
    if (absPathRect.width() <= 0 || absPathRect.height() <= 0)
        return;
 
    QImage image(absPathRect.width(), absPathRect.height(), QImage::Format_ARGB32_Premultiplied);
    image.fill(0);
 
    QPainter p(&image);
 
    p.d_ptr->helper_device = helper_device;
 
    p.setOpacity(state->opacity);
    p.translate(-absPathRect.x(), -absPathRect.y());
    p.setTransform(state->matrix, true);
    p.setPen(doStroke ? state->pen : QPen(Qt::NoPen));
    p.setBrush((op & FillDraw) ? state->brush : QBrush(Qt::NoBrush));
    p.setBackground(state->bgBrush);
    p.setBackgroundMode(state->bgMode);
    p.setBrushOrigin(state->brushOrigin);
 
    p.setRenderHint(QPainter::Antialiasing, state->renderHints & QPainter::Antialiasing);
    p.setRenderHint(QPainter::SmoothPixmapTransform,
                    state->renderHints & QPainter::SmoothPixmapTransform);
 
    p.drawPath(originalPath);
 
#ifndef QT_NO_DEBUG
    static bool do_fallback_overlay = !qEnvironmentVariableIsEmpty("QT_PAINT_FALLBACK_OVERLAY");
    if (do_fallback_overlay) {
        QImage block(8, 8, QImage::Format_ARGB32_Premultiplied);
        QPainter pt(&block);
        pt.fillRect(0, 0, 8, 8, QColor(196, 0, 196));
        pt.drawLine(0, 0, 8, 8);
        pt.end();
        p.resetTransform();
        p.setCompositionMode(QPainter::CompositionMode_SourceAtop);
        p.setOpacity(0.5);
        p.fillRect(0, 0, image.width(), image.height(), QBrush(block));
    }
#endif
 
    p.end();
 
    q->save();
    state->matrix = QTransform();
    if (extended) {
        extended->transformChanged();
    } else {
        state->dirtyFlags |= QPaintEngine::DirtyTransform;
        updateState(state);
    }
    engine->drawImage(absPathRect,
                 image,
                 QRectF(0, 0, absPathRect.width(), absPathRect.height()),
                 Qt::OrderedDither | Qt::OrderedAlphaDither);
    q->restore();
}
 
void QPainterPrivate::drawOpaqueBackground(const QPainterPath &path, DrawOperation op)
{
    Q_Q(QPainter);
 
    q->setBackgroundMode(Qt::TransparentMode);
 
    if (op & FillDraw && state->brush.style() != Qt::NoBrush) {
        q->fillPath(path, state->bgBrush.color());
        q->fillPath(path, state->brush);
    }
 
    if (op & StrokeDraw && state->pen.style() != Qt::NoPen) {
        q->strokePath(path, QPen(state->bgBrush.color(), state->pen.width()));
        q->strokePath(path, state->pen);
    }
 
    q->setBackgroundMode(Qt::OpaqueMode);
}
 
static inline QBrush stretchGradientToUserSpace(const QBrush &brush, const QRectF &boundingRect)
{
    Q_ASSERT(brush.style() >= Qt::LinearGradientPattern
             && brush.style() <= Qt::ConicalGradientPattern);
 
    QTransform gradientToUser(boundingRect.width(), 0, 0, boundingRect.height(),
                              boundingRect.x(), boundingRect.y());
 
    QGradient g = *brush.gradient();
    g.setCoordinateMode(QGradient::LogicalMode);
 
    QBrush b(g);
    if (brush.gradient()->coordinateMode() == QGradient::ObjectMode)
        b.setTransform(b.transform() * gradientToUser);
    else
        b.setTransform(gradientToUser * b.transform());
    return b;
}
 
void QPainterPrivate::drawStretchedGradient(const QPainterPath &path, DrawOperation op)
{
    Q_Q(QPainter);
 
    const qreal sw = helper_device->width();
    const qreal sh = helper_device->height();
 
    bool changedPen = false;
    bool changedBrush = false;
    bool needsFill = false;
 
    const QPen pen = state->pen;
    const QBrush brush = state->brush;
 
    const QGradient::CoordinateMode penMode = coordinateMode(pen.brush());
    const QGradient::CoordinateMode brushMode = coordinateMode(brush);
 
    QRectF boundingRect;
 
    // Draw the xformed fill if the brush is a stretch gradient.
    if ((op & FillDraw) && brush.style() != Qt::NoBrush) {
        if (brushMode == QGradient::StretchToDeviceMode) {
            q->setPen(Qt::NoPen);
            changedPen = pen.style() != Qt::NoPen;
            q->scale(sw, sh);
            updateState(state);
 
            const qreal isw = 1.0 / sw;
            const qreal ish = 1.0 / sh;
            QTransform inv(isw, 0, 0, ish, 0, 0);
            engine->drawPath(path * inv);
            q->scale(isw, ish);
        } else {
            needsFill = true;
 
            if (brushMode == QGradient::ObjectBoundingMode || brushMode == QGradient::ObjectMode) {
                Q_ASSERT(engine->hasFeature(QPaintEngine::PatternTransform));
                boundingRect = path.boundingRect();
                q->setBrush(stretchGradientToUserSpace(brush, boundingRect));
                changedBrush = true;
            }
        }
    }
 
    if ((op & StrokeDraw) && pen.style() != Qt::NoPen) {
        // Draw the xformed outline if the pen is a stretch gradient.
        if (penMode == QGradient::StretchToDeviceMode) {
            q->setPen(Qt::NoPen);
            changedPen = true;
 
            if (needsFill) {
                updateState(state);
                engine->drawPath(path);
            }
 
            q->scale(sw, sh);
            q->setBrush(pen.brush());
            changedBrush = true;
            updateState(state);
 
            QPainterPathStroker stroker;
            stroker.setDashPattern(pen.style());
            stroker.setWidth(pen.widthF());
            stroker.setJoinStyle(pen.joinStyle());
            stroker.setCapStyle(pen.capStyle());
            stroker.setMiterLimit(pen.miterLimit());
            QPainterPath stroke = stroker.createStroke(path);
 
            const qreal isw = 1.0 / sw;
            const qreal ish = 1.0 / sh;
            QTransform inv(isw, 0, 0, ish, 0, 0);
            engine->drawPath(stroke * inv);
            q->scale(isw, ish);
        } else {
            if (!needsFill && brush.style() != Qt::NoBrush) {
                q->setBrush(Qt::NoBrush);
                changedBrush = true;
            }
 
            if (penMode == QGradient::ObjectBoundingMode || penMode == QGradient::ObjectMode) {
                Q_ASSERT(engine->hasFeature(QPaintEngine::PatternTransform));
 
                // avoid computing the bounding rect twice
                if (!needsFill || (brushMode != QGradient::ObjectBoundingMode && brushMode != QGradient::ObjectMode))
                    boundingRect = path.boundingRect();
 
                QPen p = pen;
                p.setBrush(stretchGradientToUserSpace(pen.brush(), boundingRect));
                q->setPen(p);
                changedPen = true;
            } else if (changedPen) {
                q->setPen(pen);
                changedPen = false;
            }
 
            updateState(state);
            engine->drawPath(path);
        }
    } else if (needsFill) {
        if (pen.style() != Qt::NoPen) {
            q->setPen(Qt::NoPen);
            changedPen = true;
        }
 
        updateState(state);
        engine->drawPath(path);
    }
 
    if (changedPen)
        q->setPen(pen);
    if (changedBrush)
        q->setBrush(brush);
}
 
 
void QPainterPrivate::updateMatrix()
{
    state->matrix = state->WxF ? state->worldMatrix : QTransform();
    if (state->VxF)
        state->matrix *= viewTransform();
 
    txinv = false;                                // no inverted matrix
    state->matrix *= state->redirectionMatrix;
    if (extended)
        extended->transformChanged();
    else
        state->dirtyFlags |= QPaintEngine::DirtyTransform;
 
    state->matrix *= hidpiScaleTransform();
 
//     printf("VxF=%d, WxF=%d\n", state->VxF, state->WxF);
//     qDebug() << " --- using matrix" << state->matrix << redirection_offset;
}
 
/*! \internal */
void QPainterPrivate::updateInvMatrix()
{
    Q_ASSERT(txinv == false);
    txinv = true;                                // creating inverted matrix
    invMatrix = state->matrix.inverted();
}
 
extern bool qt_isExtendedRadialGradient(const QBrush &brush);
 
void QPainterPrivate::updateEmulationSpecifier(QPainterState *s)
{
    bool alpha = false;
    bool linearGradient = false;
    bool radialGradient = false;
    bool extendedRadialGradient = false;
    bool conicalGradient = false;
    bool patternBrush = false;
    bool xform = false;
    bool complexXform = false;
 
    bool skip = true;
 
    // Pen and brush properties (we have to check both if one changes because the
    // one that's unchanged can still be in a state which requires emulation)
    if (s->state() & (QPaintEngine::DirtyPen | QPaintEngine::DirtyBrush | QPaintEngine::DirtyHints)) {
        // Check Brush stroke emulation
        if (!s->pen.isSolid() && !engine->hasFeature(QPaintEngine::BrushStroke))
            s->emulationSpecifier |= QPaintEngine::BrushStroke;
        else
            s->emulationSpecifier &= ~QPaintEngine::BrushStroke;
 
        skip = false;
 
        QBrush penBrush = (qpen_style(s->pen) == Qt::NoPen) ? QBrush(Qt::NoBrush) : qpen_brush(s->pen);
        Qt::BrushStyle brushStyle = qbrush_style(s->brush);
        Qt::BrushStyle penBrushStyle = qbrush_style(penBrush);
        alpha = (penBrushStyle != Qt::NoBrush
                 && (penBrushStyle < Qt::LinearGradientPattern && penBrush.color().alpha() != 255)
                 && !penBrush.isOpaque())
                || (brushStyle != Qt::NoBrush
                    && (brushStyle < Qt::LinearGradientPattern && s->brush.color().alpha() != 255)
                    && !s->brush.isOpaque());
        linearGradient = ((penBrushStyle == Qt::LinearGradientPattern) ||
                           (brushStyle == Qt::LinearGradientPattern));
        radialGradient = ((penBrushStyle == Qt::RadialGradientPattern) ||
                           (brushStyle == Qt::RadialGradientPattern));
        extendedRadialGradient = radialGradient && (qt_isExtendedRadialGradient(penBrush) || qt_isExtendedRadialGradient(s->brush));
        conicalGradient = ((penBrushStyle == Qt::ConicalGradientPattern) ||
                            (brushStyle == Qt::ConicalGradientPattern));
        patternBrush = (((penBrushStyle > Qt::SolidPattern
                           && penBrushStyle < Qt::LinearGradientPattern)
                          || penBrushStyle == Qt::TexturePattern) ||
                         ((brushStyle > Qt::SolidPattern
                           && brushStyle < Qt::LinearGradientPattern)
                          || brushStyle == Qt::TexturePattern));
 
        bool penTextureAlpha = false;
        if (penBrush.style() == Qt::TexturePattern)
            penTextureAlpha = qHasPixmapTexture(penBrush)
                              ? (penBrush.texture().depth() > 1) && penBrush.texture().hasAlpha()
                              : penBrush.textureImage().hasAlphaChannel();
        bool brushTextureAlpha = false;
        if (s->brush.style() == Qt::TexturePattern) {
            brushTextureAlpha = qHasPixmapTexture(s->brush)
                                ? (s->brush.texture().depth() > 1) && s->brush.texture().hasAlpha()
                                : s->brush.textureImage().hasAlphaChannel();
        }
        if (((penBrush.style() == Qt::TexturePattern && penTextureAlpha)
             || (s->brush.style() == Qt::TexturePattern && brushTextureAlpha))
            && !engine->hasFeature(QPaintEngine::MaskedBrush))
            s->emulationSpecifier |= QPaintEngine::MaskedBrush;
        else
            s->emulationSpecifier &= ~QPaintEngine::MaskedBrush;
    }
 
    if (s->state() & (QPaintEngine::DirtyHints
                      | QPaintEngine::DirtyOpacity
                      | QPaintEngine::DirtyBackgroundMode)) {
        skip = false;
    }
 
    if (skip)
        return;
 
#if 0
    qDebug("QPainterPrivate::updateEmulationSpecifier, state=%p\n"
           " - alpha: %d\n"
           " - linearGradient: %d\n"
           " - radialGradient: %d\n"
           " - conicalGradient: %d\n"
           " - patternBrush: %d\n"
           " - hints: %x\n"
           " - xform: %d\n",
           s,
           alpha,
           linearGradient,
           radialGradient,
           conicalGradient,
           patternBrush,
           uint(s->renderHints),
           xform);
#endif
 
    // XForm properties
    if (s->state() & QPaintEngine::DirtyTransform) {
        xform = !s->matrix.isIdentity();
        complexXform = !s->matrix.isAffine();
    } else if (s->matrix.type() >= QTransform::TxTranslate) {
        xform = true;
        complexXform = !s->matrix.isAffine();
    }
 
    const bool brushXform = (s->brush.transform().type() != QTransform::TxNone);
    const bool penXform = (s->pen.brush().transform().type() != QTransform::TxNone);
 
    const bool patternXform = patternBrush && (xform || brushXform || penXform);
 
    // Check alphablending
    if (alpha && !engine->hasFeature(QPaintEngine::AlphaBlend))
        s->emulationSpecifier |= QPaintEngine::AlphaBlend;
    else
        s->emulationSpecifier &= ~QPaintEngine::AlphaBlend;
 
    // Linear gradient emulation
    if (linearGradient && !engine->hasFeature(QPaintEngine::LinearGradientFill))
        s->emulationSpecifier |= QPaintEngine::LinearGradientFill;
    else
        s->emulationSpecifier &= ~QPaintEngine::LinearGradientFill;
 
    // Radial gradient emulation
    if (extendedRadialGradient || (radialGradient && !engine->hasFeature(QPaintEngine::RadialGradientFill)))
        s->emulationSpecifier |= QPaintEngine::RadialGradientFill;
    else
        s->emulationSpecifier &= ~QPaintEngine::RadialGradientFill;
 
    // Conical gradient emulation
    if (conicalGradient && !engine->hasFeature(QPaintEngine::ConicalGradientFill))
        s->emulationSpecifier |= QPaintEngine::ConicalGradientFill;
    else
        s->emulationSpecifier &= ~QPaintEngine::ConicalGradientFill;
 
    // Pattern brushes
    if (patternBrush && !engine->hasFeature(QPaintEngine::PatternBrush))
        s->emulationSpecifier |= QPaintEngine::PatternBrush;
    else
        s->emulationSpecifier &= ~QPaintEngine::PatternBrush;
 
    // Pattern XForms
    if (patternXform && !engine->hasFeature(QPaintEngine::PatternTransform))
        s->emulationSpecifier |= QPaintEngine::PatternTransform;
    else
        s->emulationSpecifier &= ~QPaintEngine::PatternTransform;
 
    // Primitive XForms
    if (xform && !engine->hasFeature(QPaintEngine::PrimitiveTransform))
        s->emulationSpecifier |= QPaintEngine::PrimitiveTransform;
    else
        s->emulationSpecifier &= ~QPaintEngine::PrimitiveTransform;
 
    // Perspective XForms
    if (complexXform && !engine->hasFeature(QPaintEngine::PerspectiveTransform))
        s->emulationSpecifier |= QPaintEngine::PerspectiveTransform;
    else
        s->emulationSpecifier &= ~QPaintEngine::PerspectiveTransform;
 
    // Constant opacity
    if (state->opacity != 1 && !engine->hasFeature(QPaintEngine::ConstantOpacity))
        s->emulationSpecifier |= QPaintEngine::ConstantOpacity;
    else
        s->emulationSpecifier &= ~QPaintEngine::ConstantOpacity;
 
    bool gradientStretch = false;
    bool objectBoundingMode = false;
    if (linearGradient || conicalGradient || radialGradient) {
        QGradient::CoordinateMode brushMode = coordinateMode(s->brush);
        QGradient::CoordinateMode penMode = coordinateMode(s->pen.brush());
 
        gradientStretch |= (brushMode == QGradient::StretchToDeviceMode);
        gradientStretch |= (penMode == QGradient::StretchToDeviceMode);
 
        objectBoundingMode |= (brushMode == QGradient::ObjectBoundingMode || brushMode == QGradient::ObjectMode);
        objectBoundingMode |= (penMode == QGradient::ObjectBoundingMode || penMode == QGradient::ObjectMode);
    }
    if (gradientStretch)
        s->emulationSpecifier |= QGradient_StretchToDevice;
    else
        s->emulationSpecifier &= ~QGradient_StretchToDevice;
 
    if (objectBoundingMode && !engine->hasFeature(QPaintEngine::ObjectBoundingModeGradients))
        s->emulationSpecifier |= QPaintEngine::ObjectBoundingModeGradients;
    else
        s->emulationSpecifier &= ~QPaintEngine::ObjectBoundingModeGradients;
 
    // Opaque backgrounds...
    if (s->bgMode == Qt::OpaqueMode &&
        (is_pen_transparent(s->pen) || is_brush_transparent(s->brush)))
        s->emulationSpecifier |= QPaintEngine_OpaqueBackground;
    else
        s->emulationSpecifier &= ~QPaintEngine_OpaqueBackground;
 
#if 0
    //won't be correct either way because the device can already have
    // something rendered to it in which case subsequent emulation
    // on a fully transparent qimage and then blitting the results
    // won't produce correct results
    // Blend modes
    if (state->composition_mode > QPainter::CompositionMode_Xor &&
        !engine->hasFeature(QPaintEngine::BlendModes))
        s->emulationSpecifier |= QPaintEngine::BlendModes;
    else
        s->emulationSpecifier &= ~QPaintEngine::BlendModes;
#endif
}
 
void QPainterPrivate::updateStateImpl(QPainterState *newState)
{
    // ### we might have to call QPainter::begin() here...
    if (!engine->state) {
        engine->state = newState;
        engine->setDirty(QPaintEngine::AllDirty);
    }
 
    if (engine->state->painter() != newState->painter)
        // ### this could break with clip regions vs paths.
        engine->setDirty(QPaintEngine::AllDirty);
 
    // Upon restore, revert all changes since last save
    else if (engine->state != newState)
        newState->dirtyFlags |= QPaintEngine::DirtyFlags(static_cast<QPainterState *>(engine->state)->changeFlags);
 
    // We need to store all changes made so that restore can deal with them
    else
        newState->changeFlags |= newState->dirtyFlags;
 
    updateEmulationSpecifier(newState);
 
    // Unset potential dirty background mode
    newState->dirtyFlags &= ~(QPaintEngine::DirtyBackgroundMode
            | QPaintEngine::DirtyBackground);
 
    engine->state = newState;
    engine->updateState(*newState);
    engine->clearDirty(QPaintEngine::AllDirty);
 
}
 
void QPainterPrivate::updateState(QPainterState *newState)
{
 
    if (!newState) {
        engine->state = newState;
    } else if (newState->state() || engine->state!=newState) {
        updateStateImpl(newState);
    }
}
 
/*!
    \class QPainter
    \brief The QPainter class performs low-level painting on widgets and
    other paint devices.
 
    \inmodule QtGui
    \ingroup painting
 
    \reentrant
 
    QPainter provides highly optimized functions to do most of the
    drawing GUI programs require. It can draw everything from simple
    lines to complex shapes like pies and chords. It can also draw
    aligned text and pixmaps. Normally, it draws in a "natural"
    coordinate system, but it can also do view and world
    transformation. QPainter can operate on any object that inherits
    the QPaintDevice class.
 
    The common use of QPainter is inside a widget's paint event:
    Construct and customize (e.g. set the pen or the brush) the
    painter. Then draw. Remember to destroy the QPainter object after
    drawing. For example:
 
    \snippet code/src_gui_painting_qpainter.cpp 0
 
    The core functionality of QPainter is drawing, but the class also
    provide several functions that allows you to customize QPainter's
    settings and its rendering quality, and others that enable
    clipping. In addition you can control how different shapes are
    merged together by specifying the painter's composition mode.
 
    The isActive() function indicates whether the painter is active. A
    painter is activated by the begin() function and the constructor
    that takes a QPaintDevice argument. The end() function, and the
    destructor, deactivates it.
 
    Together with the QPaintDevice and QPaintEngine classes, QPainter
    form the basis for Qt's paint system. QPainter is the class used
    to perform drawing operations. QPaintDevice represents a device
    that can be painted on using a QPainter. QPaintEngine provides the
    interface that the painter uses to draw onto different types of
    devices. If the painter is active, device() returns the paint
    device on which the painter paints, and paintEngine() returns the
    paint engine that the painter is currently operating on. For more
    information, see the \l {Paint System}.
 
    Sometimes it is desirable to make someone else paint on an unusual
    QPaintDevice. QPainter supports a static function to do this,
    setRedirected().
 
    \warning When the paintdevice is a widget, QPainter can only be
    used inside a paintEvent() function or in a function called by
    paintEvent().
 
    \section1 Settings
 
    There are several settings that you can customize to make QPainter
    draw according to your preferences:
 
    \list
 
    \li 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.
 
    \li brush() defines the color or pattern that is used for filling
       shapes.
 
    \li pen() defines the color or stipple that is used for drawing
       lines or boundaries.
 
    \li backgroundMode() defines whether there is a background() or
       not, i.e it is either Qt::OpaqueMode or Qt::TransparentMode.
 
    \li background() only applies when backgroundMode() is \l
       Qt::OpaqueMode and pen() is a stipple. In that case, it
       describes the color of the background pixels in the stipple.
 
    \li brushOrigin() defines the origin of the tiled brushes, normally
       the origin of widget's background.
 
    \li viewport(), window(), worldTransform() make up the painter's coordinate
        transformation system. For more information, see the \l
        {Coordinate Transformations} section and the \l {Coordinate
        System} documentation.
 
    \li hasClipping() tells whether the painter clips at all. (The paint
       device clips, too.) If the painter clips, it clips to clipRegion().
 
    \li layoutDirection() defines the layout direction used by the
       painter when drawing text.
 
    \li worldMatrixEnabled() tells whether world transformation is enabled.
 
    \li viewTransformEnabled() tells whether view transformation is
        enabled.
 
    \endlist
 
    Note that some of these settings mirror settings in some paint
    devices, e.g.  QWidget::font(). The QPainter::begin() function (or
    equivalently the QPainter constructor) copies these attributes
    from the paint device.
 
    You can at any time save the QPainter's state by calling the
    save() function which saves all the available settings on an
    internal stack. The restore() function pops them back.
 
    \section1 Drawing
 
    QPainter provides functions to draw most primitives: drawPoint(),
    drawPoints(), drawLine(), drawRect(), drawRoundedRect(),
    drawEllipse(), drawArc(), drawPie(), drawChord(), drawPolyline(),
    drawPolygon(), drawConvexPolygon() and drawCubicBezier().  The two
    convenience functions, drawRects() and drawLines(), draw the given
    number of rectangles or lines in the given array of \l
    {QRect}{QRects} or \l {QLine}{QLines} using the current pen and
    brush.
 
    The QPainter class also provides the fillRect() function which
    fills the given QRect, with the given QBrush, and the eraseRect()
    function that erases the area inside the given rectangle.
 
    All of these functions have both integer and floating point
    versions.
 
    \table 100%
    \row
    \li \inlineimage qpainter-basicdrawing.png
                     {Basic Drawing application with shape and pen options}
    \li
    \b {Basic Drawing Example}
 
    The \l {painting/basicdrawing}{Basic Drawing} example shows how to
    display basic graphics primitives in a variety of styles using the
    QPainter class.
 
    \endtable
 
    If you need to draw a complex shape, especially if you need to do
    so repeatedly, consider creating a QPainterPath and drawing it
    using drawPath().
 
    \table 100%
    \row
    \li
    \b {Painter Paths example}
 
    The QPainterPath class provides a container for painting
    operations, enabling graphical shapes to be constructed and
    reused.
 
    The \l {painting/painterpaths}{Painter Paths} example shows how
    painter paths can be used to build complex shapes for rendering.
 
    \li \inlineimage qpainter-painterpaths.png
                     {Painter Paths application with various shapes}
    \endtable
 
    QPainter also provides the fillPath() function which fills the
    given QPainterPath with the given QBrush, and the strokePath()
    function that draws the outline of the given path (i.e. strokes
    the path).
 
    See also the \l {painting/deform}{Vector Deformation} example which
    shows how to use advanced vector techniques to draw text using a
    QPainterPath, the \l {painting/gradients}{Gradients} example which shows
    the different types of gradients that are available in Qt, and the \l
    {painting/pathstroke}{Path Stroking} example which shows Qt's built-in
    dash patterns and shows how custom patterns can be used to extend
    the range of available patterns.
 
    \table
    \header
    \li \l {painting/deform}{Vector Deformation}
    \li \l {painting/gradients}{Gradients}
    \li \l {painting/pathstroke}{Path Stroking}
    \row
    \li \inlineimage qpainter-vectordeformation.png
                     {Vector Deformation application with lens effect}
    \li \inlineimage qpainter-gradients.png {Gradients application}
    \li \inlineimage qpainter-pathstroking.png {Path Stroking application}
    \endtable
 
    Text drawing is done using drawText(). When you need
    fine-grained positioning, boundingRect() tells you where a given
    drawText() command will draw.
 
    \section1 Drawing Pixmaps and Images
 
    There are functions to draw pixmaps/images, namely drawPixmap(),
    drawImage() and drawTiledPixmap(). Both drawPixmap() and drawImage()
    produce the same result, except that drawPixmap() is faster
    on-screen while drawImage() may be faster on a QPrinter or other
    devices.
 
    There is a drawPicture() function that draws the contents of an
    entire QPicture. The drawPicture() function is the only function
    that disregards all the painter's settings as QPicture has its own
    settings.
 
    \section2 Drawing High Resolution Versions of Pixmaps and Images
 
    High resolution versions of pixmaps have a \e{device pixel ratio} value larger
    than 1 (see QImageReader, QPixmap::devicePixelRatio()). Should it match the value
    of the underlying QPaintDevice, it is drawn directly onto the device with no
    additional transformation applied.
 
    This is for example the case when drawing a QPixmap of 64x64 pixels size with
    a device pixel ratio of 2 onto a high DPI screen which also has
    a device pixel ratio of 2. Note that the pixmap is then effectively 32x32
    pixels in \e{user space}. Code paths in Qt that calculate layout geometry
    based on the pixmap size will use this size. The net effect of this is that
    the pixmap is displayed as high DPI pixmap rather than a large pixmap.
 
    \section1 Rendering Quality
 
    To get the optimal rendering result using QPainter, you should use
    the platform independent QImage as paint device; i.e. using QImage
    will ensure that the result has an identical pixel representation
    on any platform.
 
    The QPainter class also provides a means of controlling the
    rendering quality through its RenderHint enum and the support for
    floating point precision: All the functions for drawing primitives
    have floating point versions.
 
    \snippet code/src_gui_painting_qpainter.cpp floatBased
 
    These are often used in combination
    with the \l {RenderHint}{QPainter::Antialiasing} render hint.
 
    \snippet code/src_gui_painting_qpainter.cpp renderHint
 
    \table 100%
    \row
    \li Comparing concentric circles with int and float, and with or without
        anti-aliased rendering. Using the floating point precision versions
        produces evenly spaced rings. Anti-aliased rendering results in
        smooth circles.
    \li \inlineimage qpainter-concentriccircles.png
                     {Concentric circles comparing aliased and antialiased}
    \endtable
 
    The RenderHint enum specifies flags to QPainter that may or may
    not be respected by any given engine.  \l
    {RenderHint}{QPainter::Antialiasing} indicates that the engine
    should antialias edges of primitives if possible, \l
    {RenderHint}{QPainter::TextAntialiasing} indicates that the engine
    should antialias text if possible, and the \l
    {RenderHint}{QPainter::SmoothPixmapTransform} indicates that the
    engine should use a smooth pixmap transformation algorithm.
 
    The renderHints() function returns a flag that specifies the
    rendering hints that are set for this painter.  Use the
    setRenderHint() function to set or clear the currently set
    RenderHints.
 
    \section1 Coordinate Transformations
 
    Normally, the QPainter operates on the device's own coordinate
    system (usually pixels), but QPainter has good support for
    coordinate transformations.
 
    \table
    \header
    \li  nop \li rotate() \li scale() \li translate()
    \row
    \li \inlineimage qpainter-clock.png {Clock without transformation}
    \li \inlineimage qpainter-rotation.png {Clock with rotation applied}
    \li \inlineimage qpainter-scale.png {Clock with scale applied}
    \li \inlineimage qpainter-translation.png {Clock with translation applied}
    \endtable
 
    The most commonly used transformations are scaling, rotation,
    translation and shearing. Use the scale() function to scale the
    coordinate system by a given offset, the rotate() function to
    rotate it clockwise and translate() to translate it (i.e. adding a
    given offset to the points). You can also twist the coordinate
    system around the origin using the shear() function. See the \l
    {painting/affine}{Affine Transformations} example for a visualization of
    a sheared coordinate system.
 
    See also the \l {painting/transformations}{Transformations}
    example which shows how transformations influence the way that
    QPainter renders graphics primitives. In particular it shows how
    the order of transformations affects the result.
 
    \table 100%
    \row
    \li
    \b {Affine Transformations Example}
 
    The \l {painting/affine}{Affine Transformations} example shows Qt's
    ability to perform affine transformations on painting
    operations. The demo also allows the user to experiment with the
    transformation operations and see the results immediately.
 
    \li \inlineimage qpainter-affinetransformations.png
        {Affine Transformations example with penguin graphic}
    \endtable
 
    All the transformation operations operate on the transformation
    worldTransform(). A matrix transforms a point in the plane to another
    point. For more information about the transformation matrix, see
    the \l {Coordinate System} and QTransform documentation.
 
    The setWorldTransform() function can replace or add to the currently
    set worldTransform(). The resetTransform() function resets any
    transformations that were made using translate(), scale(),
    shear(), rotate(), setWorldTransform(), setViewport() and setWindow()
    functions. The deviceTransform() returns the matrix that transforms
    from logical coordinates to device coordinates of the platform
    dependent paint device. The latter function is only needed when
    using platform painting commands on the platform dependent handle,
    and the platform does not do transformations nativly.
 
    When drawing with QPainter, we specify points using logical
    coordinates which then are converted into the physical coordinates
    of the paint device. The mapping of the logical coordinates to the
    physical coordinates are handled by QPainter's combinedTransform(), a
    combination of viewport() and window() and worldTransform(). The
    viewport() represents the physical coordinates specifying an
    arbitrary rectangle, the window() describes the same rectangle in
    logical coordinates, and the worldTransform() is identical with the
    transformation matrix.
 
    See also \l {Coordinate System}
 
    \section1 Clipping
 
    QPainter can clip any drawing operation to a rectangle, a region,
    or a vector path. The current clip is available using the
    functions clipRegion() and clipPath(). Whether paths or regions are
    preferred (faster) depends on the underlying paintEngine(). For
    example, the QImage paint engine prefers paths while the X11 paint
    engine prefers regions. Setting a clip is done in the painters
    logical coordinates.
 
    After QPainter's clipping, the paint device may also clip. For
    example, most widgets clip away the pixels used by child widgets,
    and most printers clip away an area near the edges of the paper.
    This additional clipping is not reflected by the return value of
    clipRegion() or hasClipping().
 
    \section1 Composition Modes
    \target Composition Modes
 
    QPainter provides the CompositionMode enum which defines the
    Porter-Duff rules for digital image compositing; it describes a
    model for combining the pixels in one image, the source, with the
    pixels in another image, the destination.
 
    The two most common forms of composition are \l
    {QPainter::CompositionMode}{Source} and \l
    {QPainter::CompositionMode}{SourceOver}.  \l
    {QPainter::CompositionMode}{Source} is used to draw opaque objects
    onto a paint device. In this mode, each pixel in the source
    replaces the corresponding pixel in the destination. In \l
    {QPainter::CompositionMode}{SourceOver} composition mode, the
    source object is transparent and is drawn on top of the
    destination.
 
    Note that composition transformation operates pixelwise. For that
    reason, there is a difference between using the graphic primitive
    itself and its bounding rectangle: The bounding rect contains
    pixels with alpha == 0 (i.e the pixels surrounding the
    primitive). These pixels will overwrite the other image's pixels,
    effectively clearing those, while the primitive only overwrites
    its own area.
 
    \table 100%
    \row
    \li \inlineimage qpainter-compositiondemo.png
        {Composition Modes example with blended images}
 
    \li
    \b {Composition Modes Example}
 
    The \l {painting/composition}{Composition Modes} example, available in
    Qt's examples directory, allows you to experiment with the various
    composition modes and see the results immediately.
 
    \endtable
 
    \section1 Limitations
    \target Limitations
 
    If you are using coordinates with Qt's raster-based paint engine, it is
    important to note that, while coordinates greater than +/- 2\sup 15 can
    be used, any painting performed with coordinates outside this range is not
    guaranteed to be shown; the drawing may be clipped. This is due to the
    use of \c{short int} in the implementation.
 
    The outlines generated by Qt's stroker are only an approximation when dealing
    with curved shapes. It is in most cases impossible to represent the outline of
    a bezier curve segment using another bezier curve segment, and so Qt approximates
    the curve outlines by using several smaller curves. For performance reasons there
    is a limit to how many curves Qt uses for these outlines, and thus when using
    large pen widths or scales the outline error increases. To generate outlines with
    smaller errors it is possible to use the QPainterPathStroker class, which has the
    setCurveThreshold member function which let's the user specify the error tolerance.
    Another workaround is to convert the paths to polygons first and then draw the
    polygons instead.
 
    \section1 Performance
 
    QPainter is a rich framework that allows developers to do a great
    variety of graphical operations, such as gradients, composition
    modes and vector graphics. And QPainter can do this across a
    variety of different hardware and software stacks. Naturally the
    underlying combination of hardware and software has some
    implications for performance, and ensuring that every single
    operation is fast in combination with all the various combinations
    of composition modes, brushes, clipping, transformation, etc, is
    close to an impossible task because of the number of
    permutations. As a compromise we have selected a subset of the
    QPainter API and backends, where performance is guaranteed to be as
    good as we can sensibly get it for the given combination of
    hardware and software.
 
    The backends we focus on as high-performance engines are:
 
    \list
 
    \li 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 used by default for QWidget and QPixmap.
 
    \li 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 QOpenGLWidget.
 
    \endlist
 
    These operations are:
 
    \list
 
    \li Simple transformations, meaning translation and scaling, pluss
    0, 90, 180, 270 degree rotations.
 
    \li \c drawPixmap() in combination with simple transformations and
    opacity with non-smooth transformation mode
    (\c QPainter::SmoothPixmapTransform not enabled as a render hint).
 
    \li Rectangle fills with solid color, two-color linear gradients
    and simple transforms.
 
    \li Rectangular clipping with simple transformations and intersect
    clip.
 
    \li Composition Modes \c QPainter::CompositionMode_Source and
    QPainter::CompositionMode_SourceOver.
 
    \li Rounded rectangle filling using solid color and two-color
    linear gradients fills.
 
    \li 3x3 patched pixmaps, via qDrawBorderPixmap.
 
    \endlist
 
    This list gives an indication of which features to safely use in
    an application where performance is critical. For certain setups,
    other operations may be fast too, but before making extensive use
    of them, it is recommended to benchmark and verify them on the
    system where the software will run in the end. There are also
    cases where expensive operations are ok to use, for instance when
    the result is cached in a QPixmap.
 
    \sa QPaintDevice, QPaintEngine, {Qt SVG}, {Basic Drawing Example}, {<qdrawutil.h>}{Drawing Utility Functions}
*/
 
/*!
    \enum QPainter::RenderHint
 
    Renderhints are used to specify flags to QPainter that may or
    may not be respected by any given engine.
 
    \value Antialiasing Indicates that the engine should antialias
    edges of primitives if possible.
 
    \value TextAntialiasing Indicates that the engine should antialias
    text if possible. To forcibly disable antialiasing for text, do not
    use this hint. Instead, set QFont::NoAntialias on your font's style
    strategy.
 
    \value SmoothPixmapTransform Indicates that the engine should use
    a smooth pixmap transformation algorithm (such as bilinear) rather
    than nearest neighbor.
 
    \value VerticalSubpixelPositioning Allow text to be positioned at fractions
    of pixels vertically as well as horizontally, if this is supported by the
    font engine. This is currently supported by Freetype on all platforms when
    the hinting preference is QFont::PreferNoHinting, and also on macOS. For
    most use cases this will not improve visual quality, but may increase memory
    consumption and some reduction in text rendering performance. Therefore, enabling
    this is not recommended unless the use case requires it. One such use case could
    be aligning glyphs with other visual primitives.
    This value was added in Qt 6.1.
 
    \value LosslessImageRendering Use a lossless image rendering, whenever possible.
    Currently, this hint is only used when QPainter is employed to output a PDF
    file through QPrinter or QPdfWriter, where drawImage()/drawPixmap() calls
    will encode images using a lossless compression algorithm instead of lossy
    JPEG compression.
    This value was added in Qt 5.13.
 
    \value NonCosmeticBrushPatterns When painting with a brush with one of the predefined pattern
    styles, transform the pattern too, along with the object being painted. The default is to treat
    the pattern as cosmetic, so that the pattern pixels will map directly to device pixels,
    independently of any active transformations.
    This value was added in Qt 6.4.
 
    \sa renderHints(), setRenderHint(), {QPainter#Rendering
    Quality}{Rendering Quality}
 
*/
 
/*!
    Constructs a painter.
 
    \sa begin(), end()
*/
 
QPainter::QPainter()
    : d_ptr(new QPainterPrivate(this))
{
}
 
/*!
    \fn QPainter::QPainter(QPaintDevice *device)
 
    Constructs a painter that begins painting the paint \a device
    immediately.
 
    This constructor is convenient for short-lived painters, e.g. in a
    QWidget::paintEvent() and should be used only once. The
    constructor calls begin() for you and the QPainter destructor
    automatically calls end().
 
    Here's an example using begin() and end():
    \snippet code/src_gui_painting_qpainter.cpp 1
 
    The same example using this constructor:
    \snippet code/src_gui_painting_qpainter.cpp 2
 
    Since the constructor cannot provide feedback when the initialization
    of the painter failed you should rather use begin() and end() to paint
    on external devices, e.g. printers.
 
    \sa begin(), end()
*/
 
QPainter::QPainter(QPaintDevice *pd)
    : d_ptr(nullptr)
{
    Q_ASSERT(pd != nullptr);
    if (!QPainterPrivate::attachPainterPrivate(this, pd)) {
        d_ptr.reset(new QPainterPrivate(this));
        begin(pd);
    }
    Q_ASSERT(d_ptr);
}
 
/*!
    Destroys the painter.
*/
QPainter::~QPainter()
{
    d_ptr->inDestructor = true;
    QT_TRY {
        if (isActive())
            end();
        else if (d_ptr->refcount > 1)
            d_ptr->detachPainterPrivate(this);
    } QT_CATCH(...) {
        // don't throw anything in the destructor.
    }
    if (d_ptr) {
        // Make sure we haven't messed things up.
        Q_ASSERT(d_ptr->inDestructor);
        d_ptr->inDestructor = false;
        Q_ASSERT(d_ptr->refcount == 1);
        Q_ASSERT(d_ptr->d_ptrs.empty());
    }
}
 
/*!
    Returns the paint device on which this painter is currently
    painting, or \nullptr if the painter is not active.
 
    \sa isActive()
*/
 
QPaintDevice *QPainter::device() const
{
    Q_D(const QPainter);
    if (isActive() && d->engine->d_func()->currentClipDevice)
        return d->engine->d_func()->currentClipDevice;
    return d->original_device;
}
 
/*!
    Returns \c true if begin() has been called and end() has not yet been
    called; otherwise returns \c false.
 
    \sa begin(), QPaintDevice::paintingActive()
*/
 
bool QPainter::isActive() const
{
    Q_D(const QPainter);
    return d->engine != nullptr;
}
 
void QPainterPrivate::initFrom(const QPaintDevice *device)
{
    if (!engine) {
        qWarning("QPainter::initFrom: Painter not active, aborted");
        return;
    }
 
    Q_Q(QPainter);
    device->initPainter(q);
}
 
void QPainterPrivate::setEngineDirtyFlags(QSpan<const QPaintEngine::DirtyFlags> flags)
{
    if (!engine)
        return;
    for (const QPaintEngine::DirtyFlags f : flags)
        engine->setDirty(f);
}
 
/*!
    Saves the current painter state (pushes the state onto a stack). A
    save() must be followed by a corresponding restore(); the end()
    function unwinds the stack.
 
    \sa restore()
*/
 
void QPainter::save()
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::save()\n");
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::save: Painter not active");
        return;
    }
 
    std::unique_ptr<QPainterState> prev;
    if (d->extended) {
        // separate the creation of a new state from the update of d->state, since some
        // engines access d->state directly (not via createState()'s argument)
        std::unique_ptr<QPainterState> next(d->extended->createState(d->state.get()));
        prev = std::exchange(d->state, std::move(next));
        d->extended->setState(d->state.get());
    } else {
        d->updateState(d->state);
        prev = std::exchange(d->state, std::make_unique<QPainterState>(d->state.get()));
        d->engine->state = d->state.get();
    }
    d->savedStates.push(std::move(prev));
}
 
/*!
    Restores the current painter state (pops a saved state off the
    stack).
 
    \sa save()
*/
 
void QPainter::restore()
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::restore()\n");
#endif
    Q_D(QPainter);
    if (d->savedStates.empty()) {
        qWarning("QPainter::restore: Unbalanced save/restore");
        return;
    } else if (!d->engine) {
        qWarning("QPainter::restore: Painter not active");
        return;
    }
 
    const auto tmp = std::exchange(d->state, std::move(d->savedStates.top()));
    d->savedStates.pop();
    d->txinv = false;
 
    if (d->extended) {
        d->checkEmulation();
        d->extended->setState(d->state.get());
        return;
    }
 
    // trigger clip update if the clip path/region has changed since
    // last save
    if (!d->state->clipInfo.isEmpty()
        && (tmp->changeFlags & (QPaintEngine::DirtyClipRegion | QPaintEngine::DirtyClipPath))) {
        // reuse the tmp state to avoid any extra allocs...
        tmp->dirtyFlags = QPaintEngine::DirtyClipPath;
        tmp->clipOperation = Qt::NoClip;
        tmp->clipPath = QPainterPath();
        d->engine->updateState(*tmp);
        // replay the list of clip states,
        for (const QPainterClipInfo &info : std::as_const(d->state->clipInfo)) {
            tmp->matrix = info.matrix;
            tmp->clipOperation = info.operation;
            if (info.clipType == QPainterClipInfo::RectClip) {
                tmp->dirtyFlags = QPaintEngine::DirtyClipRegion | QPaintEngine::DirtyTransform;
                tmp->clipRegion = info.rect;
            } else if (info.clipType == QPainterClipInfo::RegionClip) {
                tmp->dirtyFlags = QPaintEngine::DirtyClipRegion | QPaintEngine::DirtyTransform;
                tmp->clipRegion = info.region;
            } else { // clipType == QPainterClipInfo::PathClip
                tmp->dirtyFlags = QPaintEngine::DirtyClipPath | QPaintEngine::DirtyTransform;
                tmp->clipPath = info.path;
            }
            d->engine->updateState(*tmp);
        }
 
 
        //Since we've updated the clip region anyway, pretend that the clip path hasn't changed:
        d->state->dirtyFlags &= ~(QPaintEngine::DirtyClipPath | QPaintEngine::DirtyClipRegion);
        tmp->changeFlags &= ~uint(QPaintEngine::DirtyClipPath | QPaintEngine::DirtyClipRegion);
        tmp->changeFlags |= QPaintEngine::DirtyTransform;
    }
 
    d->updateState(d->state.get());
}
 
 
/*!
 
    \fn bool QPainter::begin(QPaintDevice *device)
 
    Begins painting the paint \a device and returns \c true if
    successful; otherwise returns \c false.
 
    Notice that all painter settings (setPen(), setBrush() etc.) are reset
    to default values when begin() is called.
 
    The errors that can occur are serious problems, such as these:
 
    \snippet code/src_gui_painting_qpainter.cpp 3
 
    Note that most of the time, you can use one of the constructors
    instead of begin(), and that end() is automatically done at
    destruction.
 
    \warning A paint device can only be painted by one painter at a
    time.
 
    \warning Painting on a QImage with the format
    QImage::Format_Indexed8 is not supported.
 
    \sa end(), QPainter()
*/
 
static inline void qt_cleanup_painter_state(QPainterPrivate *d)
{
    d->savedStates.clear();
    d->state = nullptr;
    d->engine = nullptr;
    d->device = nullptr;
}
 
bool QPainter::begin(QPaintDevice *pd)
{
    Q_ASSERT(pd);
 
    if (pd->painters > 0) {
        qWarning("QPainter::begin: A paint device can only be painted by one painter at a time.");
        return false;
    }
 
    if (d_ptr->engine) {
        qWarning("QPainter::begin: Painter already active");
        return false;
    }
 
    if (QPainterPrivate::attachPainterPrivate(this, pd))
        return true;
 
    Q_D(QPainter);
 
    d->helper_device = pd;
    d->original_device = pd;
 
    QPoint redirectionOffset;
    QPaintDevice *rpd = pd->redirected(&redirectionOffset);
    if (rpd)
        pd = rpd;
 
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::begin(), device=%p, type=%d\n", pd, pd->devType());
#endif
 
    if (pd->devType() == QInternal::Pixmap)
        static_cast<QPixmap *>(pd)->detach();
    else if (pd->devType() == QInternal::Image)
        static_cast<QImage *>(pd)->detach();
 
    d->engine.reset(pd->paintEngine());
 
    if (!d->engine) {
        qWarning("QPainter::begin: Paint device returned engine == 0, type: %d", pd->devType());
        return false;
    }
 
    d->device = pd;
 
    d->extended = d->engine->isExtended() ? static_cast<QPaintEngineEx *>(d->engine.get()) : nullptr;
    if (d->emulationEngine)
        d->emulationEngine->real_engine = d->extended;
 
    // Setup new state...
    Q_ASSERT(!d->state);
    d->state.reset(d->extended ? d->extended->createState(nullptr) : new QPainterState);
    d->state->painter = this;
 
    d->state->redirectionMatrix.translate(-redirectionOffset.x(), -redirectionOffset.y());
    d->state->brushOrigin = QPointF();
 
    // Slip a painter state into the engine before we do any other operations
    if (d->extended)
        d->extended->setState(d->state.get());
    else
        d->engine->state = d->state.get();
 
    switch (pd->devType()) {
        case QInternal::Pixmap:
        {
            QPixmap *pm = static_cast<QPixmap *>(pd);
            Q_ASSERT(pm);
            if (pm->isNull()) {
                qWarning("QPainter::begin: Cannot paint on a null pixmap");
                qt_cleanup_painter_state(d);
                return false;
            }
 
            if (pm->depth() == 1) {
                d->state->pen = QPen(Qt::color1);
                d->state->brush = QBrush(Qt::color0);
            }
            break;
        }
        case QInternal::Image:
        {
            QImage *img = static_cast<QImage *>(pd);
            Q_ASSERT(img);
            if (img->isNull()) {
                qWarning("QPainter::begin: Cannot paint on a null image");
                qt_cleanup_painter_state(d);
                return false;
            } else if (img->format() == QImage::Format_Indexed8 ||
                       img->format() == QImage::Format_CMYK8888) {
                // Painting on these formats is not supported.
                qWarning() << "QPainter::begin: Cannot paint on an image with the"
                           << img->format()
                           << "format";
                qt_cleanup_painter_state(d);
                return false;
            }
            if (img->depth() == 1) {
                d->state->pen = QPen(Qt::color1);
                d->state->brush = QBrush(Qt::color0);
            }
            break;
        }
        default:
            break;
    }
    if (d->state->ww == 0) // For compat with 3.x painter defaults
        d->state->ww = d->state->wh = d->state->vw = d->state->vh = 1024;
 
    d->engine->setPaintDevice(pd);
 
    bool begun = d->engine->begin(pd);
    if (!begun) {
        qWarning("QPainter::begin(): Returned false");
        if (d->engine->isActive()) {
            end();
        } else {
            qt_cleanup_painter_state(d);
        }
        return false;
    } else {
        d->engine->setActive(begun);
    }
 
    switch (d->original_device->devType()) {
    case QInternal::Widget:
        d->initFrom(d->original_device);
        break;
 
    default:
        d->state->layoutDirection = Qt::LayoutDirectionAuto;
        // make sure we have a font compatible with the paintdevice
        d->state->deviceFont = d->state->font = QFont(d->state->deviceFont, device());
        break;
    }
 
    QRect systemRect = d->engine->systemRect();
    if (!systemRect.isEmpty()) {
        d->state->ww = d->state->vw = systemRect.width();
        d->state->wh = d->state->vh = systemRect.height();
    } else {
        d->state->ww = d->state->vw = pd->metric(QPaintDevice::PdmWidth);
        d->state->wh = d->state->vh = pd->metric(QPaintDevice::PdmHeight);
    }
 
    const QPoint coordinateOffset = d->engine->coordinateOffset();
    d->state->redirectionMatrix.translate(-coordinateOffset.x(), -coordinateOffset.y());
 
    Q_ASSERT(d->engine->isActive());
 
    if (!d->state->redirectionMatrix.isIdentity() || !qFuzzyCompare(d->effectiveDevicePixelRatio(), qreal(1.0)))
        d->updateMatrix();
 
    Q_ASSERT(d->engine->isActive());
    d->state->renderHints = QPainter::TextAntialiasing;
    ++d->device->painters;
 
    d->state->emulationSpecifier = 0;
 
    switch (d->original_device->devType()) {
    case QInternal::Widget:
        // for widgets we've aleady initialized the painter above
        break;
    default:
        d->initFrom(d->original_device);
        break;
    }
 
    return true;
}
 
/*!
    Ends painting. Any resources used while painting are released. You
    don't normally need to call this since it is called by the
    destructor.
 
    Returns \c true if the painter is no longer active; otherwise returns \c false.
 
    \sa begin(), isActive()
*/
 
bool QPainter::end()
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::end()\n");
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::end: Painter not active, aborted");
        qt_cleanup_painter_state(d);
        return false;
    }
 
    if (d->refcount > 1) {
        d->detachPainterPrivate(this);
        return true;
    }
 
    bool ended = true;
 
    if (d->engine->isActive()) {
        ended = d->engine->end();
        d->updateState(nullptr);
 
        --d->device->painters;
        if (d->device->painters == 0) {
            d->engine->setPaintDevice(nullptr);
            d->engine->setActive(false);
        }
    }
 
    if (d->savedStates.size() > 0) {
        qWarning("QPainter::end: Painter ended with %d saved states", int(d->savedStates.size()));
    }
 
    d->engine.reset();
    d->emulationEngine = nullptr;
    d->extended = nullptr;
 
    qt_cleanup_painter_state(d);
 
    return ended;
}
 
 
/*!
    Returns the paint engine that the painter is currently operating
    on if the painter is active; otherwise 0.
 
    \sa isActive()
*/
QPaintEngine *QPainter::paintEngine() const
{
    Q_D(const QPainter);
    return d->engine.get();
}
 
/*!
    \since 4.6
 
    Flushes the painting pipeline and prepares for the user issuing commands
    directly to the underlying graphics context. Must be followed by a call to
    endNativePainting().
 
    Note that only the states the underlying paint engine changes will be reset
    to their respective default states. The states we reset may change from
    release to release. The following states are currently reset in the OpenGL
    2 engine:
 
    \list
    \li blending is disabled
    \li the depth, stencil and scissor tests are disabled
    \li the active texture unit is reset to 0
    \li the depth mask, depth function and the clear depth are reset to their
    default values
    \li the stencil mask, stencil operation and stencil function are reset to
    their default values
     \li the current color is reset to solid white
    \endlist
 
    If, for example, the OpenGL polygon mode is changed by the user inside a
    beginNativePaint()/endNativePainting() block, it will not be reset to the
    default state by endNativePainting(). Here is an example that shows
    intermixing of painter commands and raw OpenGL commands:
 
    \snippet code/src_gui_painting_qpainter.cpp 21
 
    \sa endNativePainting()
*/
void QPainter::beginNativePainting()
{
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::beginNativePainting: Painter not active");
        return;
    }
 
    if (d->extended)
        d->extended->beginNativePainting();
}
 
/*!
    \since 4.6
 
    Restores the painter after manually issuing native painting commands. Lets
    the painter restore any native state that it relies on before calling any
    other painter commands.
 
    \sa beginNativePainting()
*/
void QPainter::endNativePainting()
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::beginNativePainting: Painter not active");
        return;
    }
 
    if (d->extended)
        d->extended->endNativePainting();
    else
        d->engine->syncState();
}
 
/*!
    Returns the font metrics for the painter if the painter is
    active. Otherwise, the return value is undefined.
 
    \sa font(), isActive(), {QPainter#Settings}{Settings}
*/
 
QFontMetrics QPainter::fontMetrics() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::fontMetrics: Painter not active");
        return QFontMetrics(QFont());
    }
    return QFontMetrics(d->state->font);
}
 
 
/*!
    Returns the font info for the painter if the painter is
    active. Otherwise, the return value is undefined.
 
    \sa font(), isActive(), {QPainter#Settings}{Settings}
*/
 
QFontInfo QPainter::fontInfo() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::fontInfo: Painter not active");
        return QFontInfo(QFont());
    }
    return QFontInfo(d->state->font);
}
 
/*!
    \since 4.2
 
    Returns the opacity of the painter. The default value is
    1.
*/
 
qreal QPainter::opacity() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::opacity: Painter not active");
        return 1.0;
    }
    return d->state->opacity;
}
 
/*!
    \since 4.2
 
    Sets the opacity of the painter to \a opacity. The value should
    be in the range 0.0 to 1.0, where 0.0 is fully transparent and
    1.0 is fully opaque.
 
    The opacity set on the painter applies to each drawing operation
    separately. Filling a shape and drawing its outline are treated
    as separate drawing operations.
*/
 
void QPainter::setOpacity(qreal opacity)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setOpacity: Painter not active");
        return;
    }
 
    opacity = qMin(qreal(1), qMax(qreal(0), opacity));
 
    if (opacity == d->state->opacity)
        return;
 
    d->state->opacity = opacity;
 
    if (d->extended)
        d->extended->opacityChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyOpacity;
}
 
 
/*!
    Returns the current brush origin.
    Prefer using QPainter::brushOriginF() to get the precise origin.
 
    \sa setBrushOrigin(), {QPainter#Settings}{Settings}
*/
 
QPoint QPainter::brushOrigin() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::brushOrigin: Painter not active");
        return QPoint();
    }
    return QPointF(d->state->brushOrigin).toPoint();
}
 
/*!
    Returns the current brush origin.
 
    \sa setBrushOrigin(), {QPainter#Settings}{Settings}
    \since 6.11
*/
 
QPointF QPainter::brushOriginF() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::brushOrigin: Painter not active");
        return QPointF();
    }
    return d->state->brushOrigin;
}
 
/*!
    \fn void QPainter::setBrushOrigin(const QPointF &position)
 
    Sets the brush origin to \a position.
 
    The brush origin specifies the (0, 0) coordinate of the painter's
    brush.
 
    Note that while the brushOrigin() was necessary to adopt the
    parent's background for a widget in Qt 3, this is no longer the
    case since the Qt 4 painter doesn't paint the background unless
    you explicitly tell it to do so by setting the widget's \l
    {QWidget::autoFillBackground}{autoFillBackground} property to
    true.
 
    \sa brushOrigin(), {QPainter#Settings}{Settings}
*/
 
void QPainter::setBrushOrigin(const QPointF &p)
{
    Q_D(QPainter);
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setBrushOrigin(), (%.2f,%.2f)\n", p.x(), p.y());
#endif
 
    if (!d->engine) {
        qWarning("QPainter::setBrushOrigin: Painter not active");
        return;
    }
 
    d->state->brushOrigin = p;
 
    if (d->extended) {
        d->extended->brushOriginChanged();
        return;
    }
 
    d->state->dirtyFlags |= QPaintEngine::DirtyBrushOrigin;
}
 
/*!
    \fn void QPainter::setBrushOrigin(const QPoint &position)
    \overload
 
    Sets the brush's origin to the given \a position.
*/
 
/*!
    \fn void QPainter::setBrushOrigin(int x, int y)
 
    \overload
 
    Sets the brush's origin to point (\a x, \a y).
*/
 
/*!
    \enum QPainter::CompositionMode
 
    Defines the modes supported for digital image compositing.
    Composition modes are used to specify how the pixels in one image,
    the source, are merged with the pixel in another image, the
    destination.
 
    Please note that the bitwise raster operation modes, denoted with
    a RasterOp prefix, are only natively supported in the X11 and
    raster paint engines. This means that the only way to utilize
    these modes on the Mac is via a QImage. The RasterOp denoted blend
    modes are \e not supported for pens and brushes with alpha
    components. Also, turning on the QPainter::Antialiasing render
    hint will effectively disable the RasterOp modes.
 
 
     \image qpainter-compositionmode1.png {Illustration showing Source,
            Destination, SourceOver, DestinationOver, SourceIn,
            DestinationIn composition modes}
     \image qpainter-compositionmode2.png {Illustration showing SourceOut,
            DestinationOut, SourceAtop, DestinationAtop, Clear and Xor
            composition modes}
 
    The most common type is SourceOver (often referred to as just
    alpha blending) where the source pixel is blended on top of the
    destination pixel in such a way that the alpha component of the
    source defines the translucency of the pixel.
 
    Several composition modes require an alpha channel in the source or
    target images to have an effect. For optimal performance the
    image format \l {QImage::Format}{Format_ARGB32_Premultiplied} is
    preferred.
 
    When a composition mode is set it applies to all painting
    operator, pens, brushes, gradients and pixmap/image drawing.
 
    \value CompositionMode_SourceOver This is the default mode. The
    alpha of the source is used to blend the pixel on top of the
    destination.
 
    \value CompositionMode_DestinationOver The alpha of the
    destination is used to blend it on top of the source pixels. This
    mode is the inverse of CompositionMode_SourceOver.
 
    \value CompositionMode_Clear The pixels in the destination are
    cleared (set to fully transparent) independent of the source.
 
    \value CompositionMode_Source The output is the source
    pixel. (This means a basic copy operation and is identical to
    SourceOver when the source pixel is opaque).
 
    \value CompositionMode_Destination The output is the destination
    pixel. This means that the blending has no effect. This mode is
    the inverse of CompositionMode_Source.
 
    \value CompositionMode_SourceIn The output is the source, where
    the alpha is reduced by that of the destination.
 
    \value CompositionMode_DestinationIn The output is the
    destination, where the alpha is reduced by that of the
    source. This mode is the inverse of CompositionMode_SourceIn.
 
    \value CompositionMode_SourceOut The output is the source, where
    the alpha is reduced by the inverse of destination.
 
    \value CompositionMode_DestinationOut The output is the
    destination, where the alpha is reduced by the inverse of the
    source. This mode is the inverse of CompositionMode_SourceOut.
 
    \value CompositionMode_SourceAtop The source pixel is blended on
    top of the destination, with the alpha of the source pixel reduced
    by the alpha of the destination pixel.
 
    \value CompositionMode_DestinationAtop The destination pixel is
    blended on top of the source, with the alpha of the destination
    pixel is reduced by the alpha of the destination pixel. This mode
    is the inverse of CompositionMode_SourceAtop.
 
    \value CompositionMode_Xor The source, whose alpha is reduced with
    the inverse of the destination alpha, is merged with the
    destination, whose alpha is reduced by the inverse of the source
    alpha. CompositionMode_Xor is not the same as the bitwise Xor.
 
    \value CompositionMode_Plus Both the alpha and color of the source
    and destination pixels are added together.
 
    \value CompositionMode_Multiply The output is the source color
    multiplied by the destination. Multiplying a color with white
    leaves the color unchanged, while multiplying a color
    with black produces black.
 
    \value CompositionMode_Screen The source and destination colors
    are inverted and then multiplied. Screening a color with white
    produces white, whereas screening a color with black leaves the
    color unchanged.
 
    \value CompositionMode_Overlay Multiplies or screens the colors
    depending on the destination color. The destination color is mixed
    with the source color to reflect the lightness or darkness of the
    destination.
 
    \value CompositionMode_Darken The darker of the source and
    destination colors is selected.
 
    \value CompositionMode_Lighten The lighter of the source and
    destination colors is selected.
 
    \value CompositionMode_ColorDodge The destination color is
    brightened to reflect the source color. A black source color
    leaves the destination color unchanged.
 
    \value CompositionMode_ColorBurn The destination color is darkened
    to reflect the source color. A white source color leaves the
    destination color unchanged.
 
    \value CompositionMode_HardLight Multiplies or screens the colors
    depending on the source color. A light source color will lighten
    the destination color, whereas a dark source color will darken the
    destination color.
 
    \value CompositionMode_SoftLight Darkens or lightens the colors
    depending on the source color. Similar to
    CompositionMode_HardLight.
 
    \value CompositionMode_Difference Subtracts the darker of the
    colors from the lighter.  Painting with white inverts the
    destination color, whereas painting with black leaves the
    destination color unchanged.
 
    \value CompositionMode_Exclusion Similar to
    CompositionMode_Difference, but with a lower contrast. Painting
    with white inverts the destination color, whereas painting with
    black leaves the destination color unchanged.
 
    \value RasterOp_SourceOrDestination Does a bitwise OR operation on
    the source and destination pixels (src OR dst).
 
    \value RasterOp_SourceAndDestination Does a bitwise AND operation
    on the source and destination pixels (src AND dst).
 
    \value RasterOp_SourceXorDestination Does a bitwise XOR operation
    on the source and destination pixels (src XOR dst).
 
    \value RasterOp_NotSourceAndNotDestination Does a bitwise NOR
    operation on the source and destination pixels ((NOT src) AND (NOT
    dst)).
 
    \value RasterOp_NotSourceOrNotDestination Does a bitwise NAND
    operation on the source and destination pixels ((NOT src) OR (NOT
    dst)).
 
    \value RasterOp_NotSourceXorDestination Does a bitwise operation
    where the source pixels are inverted and then XOR'ed with the
    destination ((NOT src) XOR dst).
 
    \value RasterOp_NotSource Does a bitwise operation where the
    source pixels are inverted (NOT src).
 
    \value RasterOp_NotSourceAndDestination Does a bitwise operation
    where the source is inverted and then AND'ed with the destination
    ((NOT src) AND dst).
 
    \value RasterOp_SourceAndNotDestination Does a bitwise operation
    where the source is AND'ed with the inverted destination pixels
    (src AND (NOT dst)).
 
    \value RasterOp_NotSourceOrDestination Does a bitwise operation
    where the source is inverted and then OR'ed with the destination
    ((NOT src) OR dst).
 
    \value RasterOp_ClearDestination The pixels in the destination are
    cleared (set to 0) independent of the source.
 
    \value RasterOp_SetDestination The pixels in the destination are
    set (set to 1) independent of the source.
 
    \value RasterOp_NotDestination Does a bitwise operation
    where the destination pixels are inverted (NOT dst).
 
    \value RasterOp_SourceOrNotDestination Does a bitwise operation
    where the source is OR'ed with the inverted destination pixels
    (src OR (NOT dst)).
 
    \omitvalue NCompositionModes
 
    \sa compositionMode(), setCompositionMode(), {QPainter#Composition
    Modes}{Composition Modes}, {Image Composition Example}
*/
 
/*!
    Sets the composition mode to the given \a mode.
 
    \warning Only a QPainter operating on a QImage fully supports all
    composition modes. The RasterOp modes are supported for X11 as
    described in compositionMode().
 
    \sa compositionMode()
*/
void QPainter::setCompositionMode(CompositionMode mode)
{
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setCompositionMode: Painter not active");
        return;
    }
    if (d->state->composition_mode == mode)
        return;
    if (d->extended) {
        d->state->composition_mode = mode;
        d->extended->compositionModeChanged();
        return;
    }
 
    if (mode >= QPainter::RasterOp_SourceOrDestination) {
        if (!d->engine->hasFeature(QPaintEngine::RasterOpModes)) {
            qWarning("QPainter::setCompositionMode: "
                     "Raster operation modes not supported on device");
            return;
        }
    } else if (mode >= QPainter::CompositionMode_Plus) {
        if (!d->engine->hasFeature(QPaintEngine::BlendModes)) {
            qWarning("QPainter::setCompositionMode: "
                     "Blend modes not supported on device");
            return;
        }
    } else if (!d->engine->hasFeature(QPaintEngine::PorterDuff)) {
        if (mode != CompositionMode_Source && mode != CompositionMode_SourceOver) {
            qWarning("QPainter::setCompositionMode: "
                     "PorterDuff modes not supported on device");
            return;
        }
    }
 
    d->state->composition_mode = mode;
    d->state->dirtyFlags |= QPaintEngine::DirtyCompositionMode;
}
 
/*!
  Returns the current composition mode.
 
  \sa CompositionMode, setCompositionMode()
*/
QPainter::CompositionMode QPainter::compositionMode() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::compositionMode: Painter not active");
        return QPainter::CompositionMode_SourceOver;
    }
    return d->state->composition_mode;
}
 
/*!
    Returns the current background brush.
 
    \sa setBackground(), {QPainter#Settings}{Settings}
*/
 
const QBrush &QPainter::background() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::background: Painter not active");
        return d->fakeState()->brush;
    }
    return d->state->bgBrush;
}
 
 
/*!
    Returns \c true if clipping has been set; otherwise returns \c false.
 
    \sa setClipping(), {QPainter#Clipping}{Clipping}
*/
 
bool QPainter::hasClipping() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::hasClipping: Painter not active");
        return false;
    }
    return d->state->clipEnabled && d->state->clipOperation != Qt::NoClip;
}
 
 
/*!
    Enables clipping if  \a enable is true, or disables clipping if  \a
    enable is false.
 
    \sa hasClipping(), {QPainter#Clipping}{Clipping}
*/
 
void QPainter::setClipping(bool enable)
{
    Q_D(QPainter);
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setClipping(), enable=%s, was=%s\n",
               enable ? "on" : "off",
               hasClipping() ? "on" : "off");
#endif
    if (!d->engine) {
        qWarning("QPainter::setClipping: Painter not active, state will be reset by begin");
        return;
    }
 
    if (hasClipping() == enable)
        return;
 
    // we can't enable clipping if we don't have a clip
    if (enable
        && (d->state->clipInfo.isEmpty() || d->state->clipInfo.constLast().operation == Qt::NoClip))
        return;
    d->state->clipEnabled = enable;
 
    if (d->extended) {
        d->extended->clipEnabledChanged();
        return;
    }
 
    d->state->dirtyFlags |= QPaintEngine::DirtyClipEnabled;
    d->updateState(d->state);
}
 
 
/*!
    Returns the currently set clip region. Note that the clip region
    is given in logical coordinates.
 
    \warning QPainter does not store the combined clip explicitly as
    this is handled by the underlying QPaintEngine, so the path is
    recreated on demand and transformed to the current logical
    coordinate system. This is potentially an expensive operation.
 
    \sa setClipRegion(), clipPath(), setClipping()
*/
 
QRegion QPainter::clipRegion() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::clipRegion: Painter not active");
        return QRegion();
    }
 
    QRegion region;
    bool lastWasNothing = true;
 
    if (!d->txinv)
        const_cast<QPainter *>(this)->d_ptr->updateInvMatrix();
 
    // ### Falcon: Use QPainterPath
    for (const QPainterClipInfo &info : std::as_const(d->state->clipInfo)) {
        switch (info.clipType) {
 
        case QPainterClipInfo::RegionClip: {
            QTransform matrix = (info.matrix * d->invMatrix);
            if (lastWasNothing) {
                region = info.region * matrix;
                lastWasNothing = false;
                continue;
            }
            if (info.operation == Qt::IntersectClip)
                region &= info.region * matrix;
            else if (info.operation == Qt::NoClip) {
                lastWasNothing = true;
                region = QRegion();
            } else
                region = info.region * matrix;
            break;
        }
 
        case QPainterClipInfo::PathClip: {
            QTransform matrix = (info.matrix * d->invMatrix);
            if (lastWasNothing) {
                region = QRegion((info.path * matrix).toFillPolygon().toPolygon(),
                                 info.path.fillRule());
                lastWasNothing = false;
                continue;
            }
            if (info.operation == Qt::IntersectClip) {
                region &= QRegion((info.path * matrix).toFillPolygon().toPolygon(),
                                  info.path.fillRule());
            } else if (info.operation == Qt::NoClip) {
                lastWasNothing = true;
                region = QRegion();
            } else {
                region = QRegion((info.path * matrix).toFillPolygon().toPolygon(),
                                 info.path.fillRule());
            }
            break;
        }
 
        case QPainterClipInfo::RectClip: {
            QTransform matrix = (info.matrix * d->invMatrix);
            if (lastWasNothing) {
                region = QRegion(info.rect) * matrix;
                lastWasNothing = false;
                continue;
            }
            if (info.operation == Qt::IntersectClip) {
                // Use rect intersection if possible.
                if (matrix.type() <= QTransform::TxScale)
                    region &= matrix.mapRect(info.rect);
                else
                    region &= matrix.map(QRegion(info.rect));
            } else if (info.operation == Qt::NoClip) {
                lastWasNothing = true;
                region = QRegion();
            } else {
                region = QRegion(info.rect) * matrix;
            }
            break;
        }
 
        case QPainterClipInfo::RectFClip: {
            QTransform matrix = (info.matrix * d->invMatrix);
            if (lastWasNothing) {
                region = QRegion(info.rectf.toRect()) * matrix;
                lastWasNothing = false;
                continue;
            }
            if (info.operation == Qt::IntersectClip) {
                // Use rect intersection if possible.
                if (matrix.type() <= QTransform::TxScale)
                    region &= matrix.mapRect(info.rectf.toRect());
                else
                    region &= matrix.map(QRegion(info.rectf.toRect()));
            } else if (info.operation == Qt::NoClip) {
                lastWasNothing = true;
                region = QRegion();
            } else {
                region = QRegion(info.rectf.toRect()) * matrix;
            }
            break;
        }
        }
    }
 
    return region;
}
 
Q_GUI_EXPORT extern QPainterPath qt_regionToPath(const QRegion &region);
 
/*!
    Returns the current clip path in logical coordinates.
 
    \warning QPainter does not store the combined clip explicitly as
    this is handled by the underlying QPaintEngine, so the path is
    recreated on demand and transformed to the current logical
    coordinate system. This is potentially an expensive operation.
 
    \sa setClipPath(), clipRegion(), setClipping()
*/
QPainterPath QPainter::clipPath() const
{
    Q_D(const QPainter);
 
    // ### Since we do not support path intersections and path unions yet,
    // we just use clipRegion() here...
    if (!d->engine) {
        qWarning("QPainter::clipPath: Painter not active");
        return QPainterPath();
    }
 
    // No clip, return empty
    if (d->state->clipInfo.isEmpty()) {
        return QPainterPath();
    } else {
 
        // Update inverse matrix, used below.
        if (!d->txinv)
            const_cast<QPainter *>(this)->d_ptr->updateInvMatrix();
 
        // For the simple case avoid conversion.
        if (d->state->clipInfo.size() == 1
            && d->state->clipInfo.at(0).clipType == QPainterClipInfo::PathClip) {
            QTransform matrix = (d->state->clipInfo.at(0).matrix * d->invMatrix);
            return d->state->clipInfo.at(0).path * matrix;
 
        } else if (d->state->clipInfo.size() == 1
                   && d->state->clipInfo.at(0).clipType == QPainterClipInfo::RectClip) {
            QTransform matrix = (d->state->clipInfo.at(0).matrix * d->invMatrix);
            QPainterPath path;
            path.addRect(d->state->clipInfo.at(0).rect);
            return path * matrix;
        } else {
            // Fallback to clipRegion() for now, since we don't have isect/unite for paths
            return qt_regionToPath(clipRegion());
        }
    }
}
 
/*!
    Returns the bounding rectangle of the current clip if there is a clip;
    otherwise returns an empty rectangle. Note that the clip region is
    given in logical coordinates.
 
    The bounding rectangle is not guaranteed to be tight.
 
    \sa setClipRect(), setClipPath(), setClipRegion()
 
    \since 4.8
 */
 
QRectF QPainter::clipBoundingRect() const
{
    Q_D(const QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::clipBoundingRect: Painter not active");
        return QRectF();
    }
 
    // Accumulate the bounding box in device space. This is not 100%
    // precise, but it fits within the guarantee and it is reasonably
    // fast.
    QRectF bounds;
    bool first = true;
    for (const QPainterClipInfo &info : std::as_const(d->state->clipInfo)) {
         QRectF r;
 
         if (info.clipType == QPainterClipInfo::RectClip)
             r = info.rect;
         else if (info.clipType == QPainterClipInfo::RectFClip)
             r = info.rectf;
         else if (info.clipType == QPainterClipInfo::RegionClip)
             r = info.region.boundingRect();
         else
             r = info.path.boundingRect();
 
         r = info.matrix.mapRect(r);
 
         if (first)
             bounds = r;
         else if (info.operation == Qt::IntersectClip)
             bounds &= r;
         first = false;
    }
 
 
    // Map the rectangle back into logical space using the inverse
    // matrix.
    if (!d->txinv)
        const_cast<QPainter *>(this)->d_ptr->updateInvMatrix();
 
    return d->invMatrix.mapRect(bounds);
}
 
/*!
    \fn void QPainter::setClipRect(const QRectF &rectangle, Qt::ClipOperation operation)
 
    Enables clipping, and sets the clip region to the given \a
    rectangle using the given clip \a operation. The default operation
    is to replace the current clip rectangle.
 
    Note that the clip rectangle is specified in logical (painter)
    coordinates.
 
    \sa clipRegion(), setClipping(), {QPainter#Clipping}{Clipping}
*/
void QPainter::setClipRect(const QRectF &rect, Qt::ClipOperation op)
{
    Q_D(QPainter);
 
    if (d->extended) {
        if (!d->engine) {
            qWarning("QPainter::setClipRect: Painter not active");
            return;
        }
        bool simplifyClipOp = (paintEngine()->type() != QPaintEngine::Picture);
        if (simplifyClipOp && (!d->state->clipEnabled && op != Qt::NoClip))
            op = Qt::ReplaceClip;
 
        qreal right = rect.x() + rect.width();
        qreal bottom = rect.y() + rect.height();
        qreal pts[] = { rect.x(), rect.y(),
                        right, rect.y(),
                        right, bottom,
                        rect.x(), bottom };
        QVectorPath vp(pts, 4, nullptr, QVectorPath::RectangleHint);
        d->state->clipEnabled = true;
        d->extended->clip(vp, op);
        if (op == Qt::ReplaceClip || op == Qt::NoClip)
            d->state->clipInfo.clear();
        d->state->clipInfo.append(QPainterClipInfo(rect, op, d->state->matrix));
        d->state->clipOperation = op;
        return;
    }
 
    if (qreal(int(rect.top())) == rect.top()
        && qreal(int(rect.bottom())) == rect.bottom()
        && qreal(int(rect.left())) == rect.left()
        && qreal(int(rect.right())) == rect.right())
    {
        setClipRect(rect.toRect(), op);
        return;
    }
 
    if (rect.isEmpty()) {
        setClipRegion(QRegion(), op);
        return;
    }
 
    QPainterPath path;
    path.addRect(rect);
    setClipPath(path, op);
}
 
/*!
    \fn void QPainter::setClipRect(const QRect &rectangle, Qt::ClipOperation operation)
    \overload
 
    Enables clipping, and sets the clip region to the given \a rectangle using the given
    clip \a operation.
*/
void QPainter::setClipRect(const QRect &rect, Qt::ClipOperation op)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setClipRect: Painter not active");
        return;
    }
    bool simplifyClipOp = (paintEngine()->type() != QPaintEngine::Picture);
 
    if (simplifyClipOp && (!d->state->clipEnabled && op != Qt::NoClip))
        op = Qt::ReplaceClip;
 
    if (d->extended) {
        d->state->clipEnabled = true;
        d->extended->clip(rect, op);
        if (op == Qt::ReplaceClip || op == Qt::NoClip)
            d->state->clipInfo.clear();
        d->state->clipInfo.append(QPainterClipInfo(rect, op, d->state->matrix));
        d->state->clipOperation = op;
        return;
    }
 
    if (simplifyClipOp && d->state->clipOperation == Qt::NoClip && op == Qt::IntersectClip)
        op = Qt::ReplaceClip;
 
    d->state->clipRegion = rect;
    d->state->clipOperation = op;
    if (op == Qt::NoClip || op == Qt::ReplaceClip)
        d->state->clipInfo.clear();
    d->state->clipInfo.append(QPainterClipInfo(rect, op, d->state->matrix));
    d->state->clipEnabled = true;
    d->state->dirtyFlags |= QPaintEngine::DirtyClipRegion | QPaintEngine::DirtyClipEnabled;
    d->updateState(d->state);
}
 
/*!
    \fn void QPainter::setClipRect(int x, int y, int width, int height, Qt::ClipOperation operation)
 
    Enables clipping, and sets the clip region to the rectangle beginning at (\a x, \a y)
    with the given \a width and \a height.
*/
 
/*!
    \fn void QPainter::setClipRegion(const QRegion &region, Qt::ClipOperation operation)
 
    Sets the clip region to the given \a region using the specified clip
    \a operation. The default clip operation is to replace the current
    clip region.
 
    Note that the clip region is given in logical coordinates.
 
    \sa clipRegion(), setClipRect(), {QPainter#Clipping}{Clipping}
*/
void QPainter::setClipRegion(const QRegion &r, Qt::ClipOperation op)
{
    Q_D(QPainter);
#ifdef QT_DEBUG_DRAW
    QRect rect = r.boundingRect();
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setClipRegion(), size=%d, [%d,%d,%d,%d]\n",
           r.rectCount(), rect.x(), rect.y(), rect.width(), rect.height());
#endif
    if (!d->engine) {
        qWarning("QPainter::setClipRegion: Painter not active");
        return;
    }
    bool simplifyClipOp = (paintEngine()->type() != QPaintEngine::Picture);
 
    if (simplifyClipOp && (!d->state->clipEnabled && op != Qt::NoClip))
        op = Qt::ReplaceClip;
 
    if (d->extended) {
        d->state->clipEnabled = true;
        d->extended->clip(r, op);
        if (op == Qt::NoClip || op == Qt::ReplaceClip)
            d->state->clipInfo.clear();
        d->state->clipInfo.append(QPainterClipInfo(r, op, d->state->matrix));
        d->state->clipOperation = op;
        return;
    }
 
    if (simplifyClipOp && d->state->clipOperation == Qt::NoClip && op == Qt::IntersectClip)
        op = Qt::ReplaceClip;
 
    d->state->clipRegion = r;
    d->state->clipOperation = op;
    if (op == Qt::NoClip || op == Qt::ReplaceClip)
        d->state->clipInfo.clear();
    d->state->clipInfo.append(QPainterClipInfo(r, op, d->state->matrix));
    d->state->clipEnabled = true;
    d->state->dirtyFlags |= QPaintEngine::DirtyClipRegion | QPaintEngine::DirtyClipEnabled;
    d->updateState(d->state);
}
 
/*!
    \since 4.2
 
    Enables transformations if \a enable is true, or disables
    transformations if \a enable is false. The world transformation
    matrix is not changed.
 
    \sa worldMatrixEnabled(), worldTransform(), {QPainter#Coordinate
    Transformations}{Coordinate Transformations}
*/
 
void QPainter::setWorldMatrixEnabled(bool enable)
{
    Q_D(QPainter);
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setMatrixEnabled(), enable=%d\n", enable);
#endif
 
    if (!d->engine) {
        qWarning("QPainter::setMatrixEnabled: Painter not active");
        return;
    }
    if (enable == d->state->WxF)
        return;
 
    d->state->WxF = enable;
    d->updateMatrix();
}
 
/*!
    \since 4.2
 
    Returns \c true if world transformation is enabled; otherwise returns
    false.
 
    \sa setWorldMatrixEnabled(), worldTransform(), {Coordinate System}
*/
 
bool QPainter::worldMatrixEnabled() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::worldMatrixEnabled: Painter not active");
        return false;
    }
    return d->state->WxF;
}
 
/*!
    Scales the coordinate system by (\a{sx}, \a{sy}).
 
    \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
*/
 
void QPainter::scale(qreal sx, qreal sy)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::scale(), sx=%f, sy=%f\n", sx, sy);
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::scale: Painter not active");
        return;
    }
 
    d->state->worldMatrix.scale(sx,sy);
    d->state->WxF = true;
    d->updateMatrix();
}
 
/*!
    Shears the coordinate system by (\a{sh}, \a{sv}).
 
    \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
*/
 
void QPainter::shear(qreal sh, qreal sv)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::shear(), sh=%f, sv=%f\n", sh, sv);
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::shear: Painter not active");
        return;
    }
 
    d->state->worldMatrix.shear(sh, sv);
    d->state->WxF = true;
    d->updateMatrix();
}
 
/*!
    \fn void QPainter::rotate(qreal angle)
 
    Rotates the coordinate system clockwise. The given \a angle parameter is in degrees.
 
    \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
*/
 
void QPainter::rotate(qreal a)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::rotate(), angle=%f\n", a);
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::rotate: Painter not active");
        return;
    }
 
    d->state->worldMatrix.rotate(a);
    d->state->WxF = true;
    d->updateMatrix();
}
 
/*!
    Translates the coordinate system by the given \a offset; i.e. the
    given \a offset is added to points.
 
    \sa setWorldTransform(), {QPainter#Coordinate Transformations}{Coordinate Transformations}
*/
void QPainter::translate(const QPointF &offset)
{
    qreal dx = offset.x();
    qreal dy = offset.y();
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::translate(), dx=%f, dy=%f\n", dx, dy);
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::translate: Painter not active");
        return;
    }
 
    d->state->worldMatrix.translate(dx, dy);
    d->state->WxF = true;
    d->updateMatrix();
}
 
/*!
    \fn void QPainter::translate(const QPoint &offset)
    \overload
 
    Translates the coordinate system by the given \a offset.
*/
 
/*!
    \fn void QPainter::translate(qreal dx, qreal dy)
    \overload
 
    Translates the coordinate system by the vector (\a dx, \a dy).
*/
 
/*!
    \fn void QPainter::setClipPath(const QPainterPath &path, Qt::ClipOperation operation)
 
    Enables clipping, and sets the clip path for the painter to the
    given \a path, with the clip \a operation.
 
    Note that the clip path is specified in logical (painter)
    coordinates.
 
    \sa clipPath(), clipRegion(), {QPainter#Clipping}{Clipping}
 
*/
void QPainter::setClipPath(const QPainterPath &path, Qt::ClipOperation op)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output) {
        QRectF b = path.boundingRect();
        printf("QPainter::setClipPath(), size=%d, op=%d, bounds=[%.2f,%.2f,%.2f,%.2f]\n",
               path.elementCount(), op, b.x(), b.y(), b.width(), b.height());
    }
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setClipPath: Painter not active");
        return;
    }
 
    bool simplifyClipOp = (paintEngine()->type() != QPaintEngine::Picture);
    if (simplifyClipOp && (!d->state->clipEnabled && op != Qt::NoClip))
        op = Qt::ReplaceClip;
 
    if (d->extended) {
        d->state->clipEnabled = true;
        d->extended->clip(path, op);
        if (op == Qt::NoClip || op == Qt::ReplaceClip)
            d->state->clipInfo.clear();
        d->state->clipInfo.append(QPainterClipInfo(path, op, d->state->matrix));
        d->state->clipOperation = op;
        return;
    }
 
    if (simplifyClipOp && d->state->clipOperation == Qt::NoClip && op == Qt::IntersectClip)
        op = Qt::ReplaceClip;
 
    d->state->clipPath = path;
    d->state->clipOperation = op;
    if (op == Qt::NoClip || op == Qt::ReplaceClip)
        d->state->clipInfo.clear();
    d->state->clipInfo.append(QPainterClipInfo(path, op, d->state->matrix));
    d->state->clipEnabled = true;
    d->state->dirtyFlags |= QPaintEngine::DirtyClipPath | QPaintEngine::DirtyClipEnabled;
    d->updateState(d->state);
}
 
/*!
    Draws the outline (strokes) the path \a path with the pen specified
    by \a pen
 
    \sa fillPath(), {QPainter#Drawing}{Drawing}
*/
void QPainter::strokePath(const QPainterPath &path, const QPen &pen)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::strokePath: Painter not active");
        return;
    }
 
    if (path.isEmpty())
        return;
 
    if (d->extended && !needsEmulation(pen.brush())) {
        d->extended->stroke(qtVectorPathForPath(path), pen);
        return;
    }
 
    QBrush oldBrush = d->state->brush;
    QPen oldPen = d->state->pen;
 
    setPen(pen);
    setBrush(Qt::NoBrush);
 
    drawPath(path);
 
    // Reset old state
    setPen(oldPen);
    setBrush(oldBrush);
}
 
/*!
    Fills the given \a path using the given \a brush. The outline is
    not drawn.
 
    Alternatively, you can specify a QColor instead of a QBrush; the
    QBrush constructor (taking a QColor argument) will automatically
    create a solid pattern brush.
 
    \sa drawPath()
*/
void QPainter::fillPath(const QPainterPath &path, const QBrush &brush)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::fillPath: Painter not active");
        return;
    }
 
    if (path.isEmpty())
        return;
 
    if (d->extended && !needsEmulation(brush)) {
        d->extended->fill(qtVectorPathForPath(path), brush);
        return;
    }
 
    QBrush oldBrush = d->state->brush;
    QPen oldPen = d->state->pen;
 
    setPen(Qt::NoPen);
    setBrush(brush);
 
    drawPath(path);
 
    // Reset old state
    setPen(oldPen);
    setBrush(oldBrush);
}
 
/*!
    Draws the given painter \a path using the current pen for outline
    and the current brush for filling.
 
    \table 100%
    \row
    \li \inlineimage qpainter-path.png {Bezier curve path}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 5
    \endtable
 
    \sa {painting/painterpaths}{the Painter Paths
    example},{painting/deform}{the Vector Deformation example}
*/
void QPainter::drawPath(const QPainterPath &path)
{
#ifdef QT_DEBUG_DRAW
    QRectF pathBounds = path.boundingRect();
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPath(), size=%d, [%.2f,%.2f,%.2f,%.2f]\n",
               path.elementCount(),
               pathBounds.x(), pathBounds.y(), pathBounds.width(), pathBounds.height());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawPath: Painter not active");
        return;
    }
 
    if (d->extended) {
        d->extended->drawPath(path);
        return;
    }
    d->updateState(d->state);
 
    if (d->engine->hasFeature(QPaintEngine::PainterPaths) && d->state->emulationSpecifier == 0) {
        d->engine->drawPath(path);
    } else {
        d->draw_helper(path);
    }
}
 
/*!
    \fn void QPainter::drawLine(const QLineF &line)
 
    Draws a line defined by \a line.
 
    \table 100%
    \row
    \li \inlineimage qpainter-line.png {Diagonal line}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 6
    \endtable
 
    \sa drawLines(), drawPolyline(), {Coordinate System}
*/
 
/*!
    \fn void QPainter::drawLine(const QLine &line)
    \overload
 
    Draws a line defined by \a line.
*/
 
/*!
    \fn void QPainter::drawLine(const QPoint &p1, const QPoint &p2)
    \overload
 
    Draws a line from \a p1 to \a p2.
*/
 
/*!
    \fn void QPainter::drawLine(const QPointF &p1, const QPointF &p2)
    \overload
 
    Draws a line from \a p1 to \a p2.
*/
 
/*!
    \fn void QPainter::drawLine(int x1, int y1, int x2, int y2)
    \overload
 
    Draws a line from (\a x1, \a y1) to (\a x2, \a y2).
*/
 
/*!
    \fn void QPainter::drawRect(const QRectF &rectangle)
 
    Draws the current \a rectangle with the current pen and brush.
 
    A filled rectangle has a size of \a{rectangle}.size(). A stroked
    rectangle has a size of \a{rectangle}.size() plus the pen width.
 
    \table 100%
    \row
    \li \inlineimage qpainter-rectangle.png {Rectangle outline}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 7
    \endtable
 
    \sa drawRects(), drawPolygon(), {Coordinate System}
*/
 
/*!
    \fn void QPainter::drawRect(const QRect &rectangle)
 
    \overload
 
    Draws the current \a rectangle with the current pen and brush.
*/
 
/*!
    \fn void QPainter::drawRect(int x, int y, int width, int height)
 
    \overload
 
    Draws a rectangle with upper left corner at (\a{x}, \a{y}) and
    with the given \a width and \a height.
*/
 
/*!
    \fn void QPainter::drawRects(const QRectF *rectangles, int rectCount)
 
    Draws the first \a rectCount of the given \a rectangles using the
    current pen and brush.
 
    \sa drawRect()
*/
void QPainter::drawRects(const QRectF *rects, int rectCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawRects(), count=%d\n", rectCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawRects: Painter not active");
        return;
    }
 
    if (rectCount <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawRects(rects, rectCount);
        return;
    }
 
    d->updateState(d->state);
 
    if (!d->state->emulationSpecifier) {
        d->engine->drawRects(rects, rectCount);
        return;
    }
 
    if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
        && d->state->matrix.type() == QTransform::TxTranslate) {
        for (int i=0; i<rectCount; ++i) {
            QRectF r(rects[i].x() + d->state->matrix.dx(),
                     rects[i].y() + d->state->matrix.dy(),
                     rects[i].width(),
                     rects[i].height());
            d->engine->drawRects(&r, 1);
        }
    } else {
        if (d->state->brushNeedsResolving() || d->state->penNeedsResolving()) {
            for (int i=0; i<rectCount; ++i) {
                QPainterPath rectPath;
                rectPath.addRect(rects[i]);
                d->draw_helper(rectPath, QPainterPrivate::StrokeAndFillDraw);
            }
        } else {
            QPainterPath rectPath;
            for (int i=0; i<rectCount; ++i)
                rectPath.addRect(rects[i]);
            d->draw_helper(rectPath, QPainterPrivate::StrokeAndFillDraw);
        }
    }
}
 
/*!
    \fn void QPainter::drawRects(const QRect *rectangles, int rectCount)
    \overload
 
    Draws the first \a rectCount of the given \a rectangles using the
    current pen and brush.
*/
void QPainter::drawRects(const QRect *rects, int rectCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawRects(), count=%d\n", rectCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawRects: Painter not active");
        return;
    }
 
    if (rectCount <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawRects(rects, rectCount);
        return;
    }
 
    d->updateState(d->state);
 
    if (!d->state->emulationSpecifier) {
        d->engine->drawRects(rects, rectCount);
        return;
    }
 
    if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
        && d->state->matrix.type() == QTransform::TxTranslate) {
        for (int i=0; i<rectCount; ++i) {
            QRectF r(rects[i].x() + d->state->matrix.dx(),
                     rects[i].y() + d->state->matrix.dy(),
                     rects[i].width(),
                     rects[i].height());
 
            d->engine->drawRects(&r, 1);
        }
    } else {
        if (d->state->brushNeedsResolving() || d->state->penNeedsResolving()) {
            for (int i=0; i<rectCount; ++i) {
                QPainterPath rectPath;
                rectPath.addRect(rects[i]);
                d->draw_helper(rectPath, QPainterPrivate::StrokeAndFillDraw);
            }
        } else {
            QPainterPath rectPath;
            for (int i=0; i<rectCount; ++i)
                rectPath.addRect(rects[i]);
 
            d->draw_helper(rectPath, QPainterPrivate::StrokeAndFillDraw);
        }
    }
}
 
/*!
    \fn void QPainter::drawRects(const QList<QRectF> &rectangles)
    \overload
 
    Draws the given \a rectangles using the current pen and brush.
*/
 
/*!
    \fn void QPainter::drawRects(const QList<QRect> &rectangles)
 
    \overload
 
    Draws the given \a rectangles using the current pen and brush.
*/
 
/*!
  \fn void QPainter::drawPoint(const QPointF &position)
 
    Draws a single point at the given \a position using the current
    pen's color.
 
    \sa {Coordinate System}
*/
 
/*!
    \fn void QPainter::drawPoint(const QPoint &position)
    \overload
 
    Draws a single point at the given \a position using the current
    pen's color.
*/
 
/*! \fn void QPainter::drawPoint(int x, int y)
 
    \overload
 
    Draws a single point at position (\a x, \a y).
*/
 
/*!
    Draws the first \a pointCount points in the array \a points using
    the current pen's color.
 
    \sa {Coordinate System}
*/
void QPainter::drawPoints(const QPointF *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPoints(), count=%d\n", pointCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawPoints: Painter not active");
        return;
    }
 
    if (pointCount <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawPoints(points, pointCount);
        return;
    }
 
    d->updateState(d->state);
 
    if (!d->state->emulationSpecifier) {
        d->engine->drawPoints(points, pointCount);
        return;
    }
 
    if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
        && d->state->matrix.type() == QTransform::TxTranslate) {
        // ### use drawPoints function
        for (int i=0; i<pointCount; ++i) {
            QPointF pt(points[i].x() + d->state->matrix.dx(),
                       points[i].y() + d->state->matrix.dy());
            d->engine->drawPoints(&pt, 1);
        }
    } else {
        QPen pen = d->state->pen;
        bool flat_pen = pen.capStyle() == Qt::FlatCap;
        if (flat_pen) {
            save();
            pen.setCapStyle(Qt::SquareCap);
            setPen(pen);
        }
        QPainterPath path;
        for (int i=0; i<pointCount; ++i) {
            path.moveTo(points[i].x(), points[i].y());
            path.lineTo(points[i].x() + 0.0001, points[i].y());
        }
        d->draw_helper(path, QPainterPrivate::StrokeDraw);
        if (flat_pen)
            restore();
    }
}
 
/*!
    \overload
 
    Draws the first \a pointCount points in the array \a points using
    the current pen's color.
*/
 
void QPainter::drawPoints(const QPoint *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPoints(), count=%d\n", pointCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawPoints: Painter not active");
        return;
    }
 
    if (pointCount <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawPoints(points, pointCount);
        return;
    }
 
    d->updateState(d->state);
 
    if (!d->state->emulationSpecifier) {
        d->engine->drawPoints(points, pointCount);
        return;
    }
 
    if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
        && d->state->matrix.type() == QTransform::TxTranslate) {
        // ### use drawPoints function
        for (int i=0; i<pointCount; ++i) {
            QPointF pt(points[i].x() + d->state->matrix.dx(),
                       points[i].y() + d->state->matrix.dy());
            d->engine->drawPoints(&pt, 1);
        }
    } else {
        QPen pen = d->state->pen;
        bool flat_pen = (pen.capStyle() == Qt::FlatCap);
        if (flat_pen) {
            save();
            pen.setCapStyle(Qt::SquareCap);
            setPen(pen);
        }
        QPainterPath path;
        for (int i=0; i<pointCount; ++i) {
            path.moveTo(points[i].x(), points[i].y());
            path.lineTo(points[i].x() + 0.0001, points[i].y());
        }
        d->draw_helper(path, QPainterPrivate::StrokeDraw);
        if (flat_pen)
            restore();
    }
}
 
/*!
    \fn void QPainter::drawPoints(const QPolygonF &points)
 
    \overload
 
    Draws the points in the vector \a points.
*/
 
/*!
    \fn void QPainter::drawPoints(const QPolygon &points)
 
    \overload
 
    Draws the points in the vector \a points.
*/
 
/*!
    Sets the background mode of the painter to the given \a mode
 
    Qt::TransparentMode (the default) draws stippled lines and text
    without setting the background pixels.  Qt::OpaqueMode fills these
    space with the current background color.
 
    Note that in order to draw a bitmap or pixmap transparently, you
    must use QPixmap::setMask().
 
    \sa backgroundMode(), setBackground(),
    {QPainter#Settings}{Settings}
*/
 
void QPainter::setBackgroundMode(Qt::BGMode mode)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setBackgroundMode(), mode=%d\n", mode);
#endif
 
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setBackgroundMode: Painter not active");
        return;
    }
    if (d->state->bgMode == mode)
        return;
 
    d->state->bgMode = mode;
    if (d->extended) {
        d->checkEmulation();
    } else {
        d->state->dirtyFlags |= QPaintEngine::DirtyBackgroundMode;
    }
}
 
/*!
    Returns the current background mode.
 
    \sa setBackgroundMode(), {QPainter#Settings}{Settings}
*/
Qt::BGMode QPainter::backgroundMode() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::backgroundMode: Painter not active");
        return Qt::TransparentMode;
    }
    return d->state->bgMode;
}
 
 
/*!
    \overload
 
    Sets the painter's pen to have style Qt::SolidLine, width 1 and the
    specified \a color.
*/
 
void QPainter::setPen(const QColor &color)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setPen(), color=%04x\n", color.rgb());
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setPen: Painter not active");
        return;
    }
 
    const QColor actualColor = color.isValid() ? color : QColor(Qt::black);
    if (d->state->pen == actualColor)
        return;
 
    d->state->pen = actualColor;
    if (d->extended)
        d->extended->penChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyPen;
}
 
/*!
    \fn void QPainter::setPen(const QPen &pen)
 
    Sets the painter's pen to be the given \a pen.
 
    The \a pen defines how to draw lines and outlines, and it also
    defines the text color.
 
    \sa pen(), {QPainter#Settings}{Settings}
*/
 
/*!
    \fn void QPainter::setPen(QPen &&pen)
    \since 6.11
    \overload
*/
 
void QPainter::doSetPen(const QPen &pen, QPen *rvalue)
{
 
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setPen(), color=%04x, (brushStyle=%d) style=%d, cap=%d, join=%d\n",
           pen.color().rgb(), pen.brush().style(), pen.style(), pen.capStyle(), pen.joinStyle());
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setPen: Painter not active");
        return;
    }
 
    if (d->state->pen == pen)
        return;
 
    q_choose_assign(d->state->pen, pen, rvalue);
 
    if (d->extended) {
        d->checkEmulation();
        d->extended->penChanged();
        return;
    }
 
    d->state->dirtyFlags |= QPaintEngine::DirtyPen;
}
 
/*!
    \overload
 
    Sets the painter's pen to have the given \a style, width 1 and
    black color.
*/
 
void QPainter::setPen(Qt::PenStyle style)
{
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setPen: Painter not active");
        return;
    }
 
    if (d->state->pen == style)
        return;
 
    d->state->pen = style;
 
    if (d->extended)
        d->extended->penChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyPen;
 
}
 
/*!
    Returns the painter's current pen.
 
    \sa setPen(), {QPainter#Settings}{Settings}
*/
 
const QPen &QPainter::pen() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::pen: Painter not active");
        return d->fakeState()->pen;
    }
    return d->state->pen;
}
 
 
/*!
    \fn void QPainter::setBrush(const QBrush &brush)
 
    Sets the painter's brush to the given \a brush.
 
    The painter's brush defines how shapes are filled.
 
    \sa brush(), {QPainter#Settings}{Settings}
*/
 
/*!
    \fn void QPainter::setBrush(QBrush &&brush)
    \since 6.11
    \overload
*/
 
void QPainter::doSetBrush(const QBrush &brush, QBrush *rvalue)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setBrush(), color=%04x, style=%d\n", brush.color().rgb(), brush.style());
#endif
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setBrush: Painter not active");
        return;
    }
 
    if (d->state->brush.d == brush.d)
        return;
 
    if (d->extended) {
        q_choose_assign(d->state->brush, brush, rvalue);
        d->checkEmulation();
        d->extended->brushChanged();
        return;
    }
 
    q_choose_assign(d->state->brush, brush, rvalue);
    d->state->dirtyFlags |= QPaintEngine::DirtyBrush;
}
 
 
/*!
    \overload
 
    Sets the painter's brush to black color and the specified \a
    style.
*/
 
void QPainter::setBrush(Qt::BrushStyle style)
{
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setBrush: Painter not active");
        return;
    }
    if (d->state->brush == style)
        return;
    d->state->brush = QBrush(Qt::black, style);
    if (d->extended)
        d->extended->brushChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyBrush;
}
 
/*!
    \overload
    \since 6.9
 
    Sets the painter's brush to a solid brush with the specified
    \a color.
*/
 
void QPainter::setBrush(QColor color)
{
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setBrush: Painter not active");
        return;
    }
 
    const QColor actualColor = color.isValid() ? color : QColor(Qt::black);
    if (d->state->brush == actualColor)
        return;
    d->state->brush = actualColor;
    if (d->extended)
        d->extended->brushChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyBrush;
}
 
/*!
    \fn void QPainter::setBrush(Qt::GlobalColor color)
    \overload
    \since 6.9
 
    Sets the painter's brush to a solid brush with the specified
    \a color.
*/
 
 
/*!
    Returns the painter's current brush.
 
    \sa QPainter::setBrush(), {QPainter#Settings}{Settings}
*/
 
const QBrush &QPainter::brush() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::brush: Painter not active");
        return d->fakeState()->brush;
    }
    return d->state->brush;
}
 
/*!
    \fn void QPainter::setBackground(const QBrush &brush)
 
    Sets the background brush of the painter to the given \a brush.
 
    The background brush is the brush that is filled in when drawing
    opaque text, stippled lines and bitmaps. The background brush has
    no effect in transparent background mode (which is the default).
 
    \sa background(), setBackgroundMode(),
    {QPainter#Settings}{Settings}
*/
 
void QPainter::setBackground(const QBrush &bg)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setBackground(), color=%04x, style=%d\n", bg.color().rgb(), bg.style());
#endif
 
    Q_D(QPainter);
    if (!d->engine) {
        qWarning("QPainter::setBackground: Painter not active");
        return;
    }
    d->state->bgBrush = bg;
    if (!d->extended)
        d->state->dirtyFlags |= QPaintEngine::DirtyBackground;
}
 
/*!
    Sets the painter's font to the given \a font.
 
    This font is used by subsequent drawText() functions. The text
    color is the same as the pen color.
 
    If you set a font that isn't available, Qt finds a close match.
    font() will return what you set using setFont() and fontInfo() returns the
    font actually being used (which may be the same).
 
    \sa font(), drawText(), {QPainter#Settings}{Settings}
*/
 
void QPainter::setFont(const QFont &font)
{
    Q_D(QPainter);
 
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setFont(), family=%s, pointSize=%d\n", font.family().toLatin1().constData(), font.pointSize());
#endif
 
    if (!d->engine) {
        qWarning("QPainter::setFont: Painter not active");
        return;
    }
 
    d->state->font = QFont(font.resolve(d->state->deviceFont), device());
    if (!d->extended)
        d->state->dirtyFlags |= QPaintEngine::DirtyFont;
}
 
/*!
    Returns the currently set font used for drawing text.
 
    \sa setFont(), drawText(), {QPainter#Settings}{Settings}
*/
const QFont &QPainter::font() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::font: Painter not active");
        return d->fakeState()->font;
    }
    return d->state->font;
}
 
/*!
    \since 4.4
 
    Draws the given rectangle \a rect with rounded corners.
 
    The \a xRadius and \a yRadius arguments specify the radii
    of the ellipses defining the corners of the rounded rectangle.
    When \a mode is Qt::RelativeSize, \a xRadius and
    \a yRadius are specified in percentage of half the rectangle's
    width and height respectively, and should be in the range
    0.0 to 100.0.
 
    A filled rectangle has a size of rect.size(). A stroked rectangle
    has a size of rect.size() plus the pen width.
 
    \table 100%
    \row
    \li \inlineimage qpainter-roundrect.png {Rounded rectangle outline}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 8
    \endtable
 
    \sa drawRect(), QPen
*/
void QPainter::drawRoundedRect(const QRectF &rect, qreal xRadius, qreal yRadius, Qt::SizeMode mode)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawRoundedRect(), [%.2f,%.2f,%.2f,%.2f]\n", rect.x(), rect.y(), rect.width(), rect.height());
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawRoundedRect: Painter not active");
        return;
    }
 
    if (xRadius <= 0 || yRadius <= 0) {             // draw normal rectangle
        drawRect(rect);
        return;
    }
 
    if (d->extended) {
        d->extended->drawRoundedRect(rect, xRadius, yRadius, mode);
        return;
    }
 
    QPainterPath path;
    path.addRoundedRect(rect, xRadius, yRadius, mode);
    drawPath(path);
}
 
/*!
    \fn void QPainter::drawRoundedRect(const QRect &rect, qreal xRadius, qreal yRadius,
                                       Qt::SizeMode mode = Qt::AbsoluteSize);
    \since 4.4
    \overload
 
    Draws the given rectangle \a rect with rounded corners.
*/
 
/*!
    \fn void QPainter::drawRoundedRect(int x, int y, int w, int h, qreal xRadius, qreal yRadius,
                                       Qt::SizeMode mode = Qt::AbsoluteSize);
    \since 4.4
    \overload
 
    Draws the given rectangle \a x, \a y, \a w, \a h with rounded corners.
*/
 
/*!
    \fn void QPainter::drawEllipse(const QRectF &rectangle)
 
    Draws the ellipse defined by the given \a rectangle.
 
    A filled ellipse has a size of \a{rectangle}.\l
    {QRect::size()}{size()}. A stroked ellipse has a size of
    \a{rectangle}.\l {QRect::size()}{size()} plus the pen width.
 
    \table 100%
    \row
    \li \inlineimage qpainter-ellipse.png {Ellipse outline}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 9
    \endtable
 
    \sa drawPie(), {Coordinate System}
*/
void QPainter::drawEllipse(const QRectF &r)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawEllipse(), [%.2f,%.2f,%.2f,%.2f]\n", r.x(), r.y(), r.width(), r.height());
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawEllipse: Painter not active");
        return;
    }
 
    QRectF rect(r.normalized());
 
    if (d->extended) {
        d->extended->drawEllipse(rect);
        return;
    }
 
    d->updateState(d->state);
    if (d->state->emulationSpecifier) {
        if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
            && d->state->matrix.type() == QTransform::TxTranslate) {
            rect.translate(QPointF(d->state->matrix.dx(), d->state->matrix.dy()));
        } else {
            QPainterPath path;
            path.addEllipse(rect);
            d->draw_helper(path, QPainterPrivate::StrokeAndFillDraw);
            return;
        }
    }
 
    d->engine->drawEllipse(rect);
}
 
/*!
    \fn void QPainter::drawEllipse(const QRect &rectangle)
 
    \overload
 
    Draws the ellipse defined by the given \a rectangle.
*/
void QPainter::drawEllipse(const QRect &r)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawEllipse(), [%d,%d,%d,%d]\n", r.x(), r.y(), r.width(), r.height());
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawEllipse: Painter not active");
        return;
    }
 
    QRect rect(r.normalized());
 
    if (d->extended) {
        d->extended->drawEllipse(rect);
        return;
    }
 
    d->updateState(d->state);
 
    if (d->state->emulationSpecifier) {
        if (d->state->emulationSpecifier == QPaintEngine::PrimitiveTransform
            && d->state->matrix.type() == QTransform::TxTranslate) {
            rect.translate(QPoint(qRound(d->state->matrix.dx()), qRound(d->state->matrix.dy())));
        } else {
            QPainterPath path;
            path.addEllipse(rect);
            d->draw_helper(path, QPainterPrivate::StrokeAndFillDraw);
            return;
        }
    }
 
    d->engine->drawEllipse(rect);
}
 
/*!
    \fn void QPainter::drawEllipse(int x, int y, int width, int height)
 
    \overload
 
    Draws the ellipse defined by the rectangle beginning at (\a{x},
    \a{y}) with the given \a width and \a height.
*/
 
/*!
    \since 4.4
 
    \fn void QPainter::drawEllipse(const QPointF &center, qreal rx, qreal ry)
 
    \overload
 
    Draws the ellipse positioned at \a{center} with radii \a{rx} and \a{ry}.
*/
 
/*!
    \since 4.4
 
    \fn void QPainter::drawEllipse(const QPoint &center, int rx, int ry)
 
    \overload
 
    Draws the ellipse positioned at \a{center} with radii \a{rx} and \a{ry}.
*/
 
/*!
    \fn void QPainter::drawArc(const QRectF &rectangle, int startAngle, int spanAngle)
 
    Draws the arc defined by the given \a rectangle, \a startAngle and
    \a spanAngle.
 
    The \a startAngle and \a spanAngle must be specified in 1/16th of
    a degree, i.e. a full circle equals 5760 (16 * 360). Positive
    values for the angles mean counter-clockwise while negative values
    mean the clockwise direction. Zero degrees is at the 3 o'clock
    position.
 
    \table 100%
    \row
    \li \inlineimage qpainter-arc.png {Arc curve}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 10
    \endtable
 
    \sa drawPie(), drawChord(), {Coordinate System}
*/
 
void QPainter::drawArc(const QRectF &r, int a, int alen)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawArc(), [%.2f,%.2f,%.2f,%.2f], angle=%d, sweep=%d\n",
           r.x(), r.y(), r.width(), r.height(), a/16, alen/16);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawArc: Painter not active");
        return;
    }
 
    QRectF rect = r.normalized();
 
    QPainterPath path;
    path.arcMoveTo(rect, a/16.0);
    path.arcTo(rect, a/16.0, alen/16.0);
    strokePath(path, d->state->pen);
}
 
/*! \fn void QPainter::drawArc(const QRect &rectangle, int startAngle,
                               int spanAngle)
 
    \overload
 
    Draws the arc defined by the given \a rectangle, \a startAngle and
    \a spanAngle.
*/
 
/*!
    \fn void QPainter::drawArc(int x, int y, int width, int height,
                               int startAngle, int spanAngle)
 
    \overload
 
    Draws the arc defined by the rectangle beginning at (\a x, \a y)
    with the specified \a width and \a height, and the given \a
    startAngle and \a spanAngle.
*/
 
/*!
    \fn void QPainter::drawPie(const QRectF &rectangle, int startAngle, int spanAngle)
 
    Draws a pie defined by the given \a rectangle, \a startAngle and \a spanAngle.
 
    The pie is filled with the current brush().
 
    The startAngle and spanAngle must be specified in 1/16th of a
    degree, i.e. a full circle equals 5760 (16 * 360). Positive values
    for the angles mean counter-clockwise while negative values mean
    the clockwise direction. Zero degrees is at the 3 o'clock
    position.
 
    \table 100%
    \row
    \li \inlineimage qpainter-pie.png {Pie slice shape}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 11
    \endtable
 
    \sa drawEllipse(), drawChord(), {Coordinate System}
*/
void QPainter::drawPie(const QRectF &r, int a, int alen)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPie(), [%.2f,%.2f,%.2f,%.2f], angle=%d, sweep=%d\n",
           r.x(), r.y(), r.width(), r.height(), a/16, alen/16);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawPie: Painter not active");
        return;
    }
 
    if (a > (360*16)) {
        a = a % (360*16);
    } else if (a < 0) {
        a = a % (360*16);
        if (a < 0) a += (360*16);
    }
 
    QRectF rect = r.normalized();
 
    QPainterPath path;
    path.moveTo(rect.center());
    path.arcTo(rect.x(), rect.y(), rect.width(), rect.height(), a/16.0, alen/16.0);
    path.closeSubpath();
    drawPath(path);
 
}
 
/*!
    \fn void QPainter::drawPie(const QRect &rectangle, int startAngle, int spanAngle)
    \overload
 
    Draws a pie defined by the given \a rectangle, \a startAngle and
    and \a spanAngle.
*/
 
/*!
    \fn void QPainter::drawPie(int x, int y, int width, int height, int
    startAngle, int spanAngle)
 
    \overload
 
    Draws the pie defined by the rectangle beginning at (\a x, \a y) with
    the specified \a width and \a height, and the given \a startAngle and
    \a spanAngle.
*/
 
/*!
    \fn void QPainter::drawChord(const QRectF &rectangle, int startAngle, int spanAngle)
 
    Draws the chord defined by the given \a rectangle, \a startAngle and
    \a spanAngle.  The chord is filled with the current brush().
 
    The startAngle and spanAngle must be specified in 1/16th of a
    degree, i.e. a full circle equals 5760 (16 * 360). Positive values
    for the angles mean counter-clockwise while negative values mean
    the clockwise direction. Zero degrees is at the 3 o'clock
    position.
 
    \table 100%
    \row
    \li \inlineimage qpainter-chord.png {Chord shape}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 12
    \endtable
 
    \sa drawArc(), drawPie(), {Coordinate System}
*/
void QPainter::drawChord(const QRectF &r, int a, int alen)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawChord(), [%.2f,%.2f,%.2f,%.2f], angle=%d, sweep=%d\n",
           r.x(), r.y(), r.width(), r.height(), a/16, alen/16);
#endif
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawChord: Painter not active");
        return;
    }
 
    QRectF rect = r.normalized();
 
    QPainterPath path;
    path.arcMoveTo(rect, a/16.0);
    path.arcTo(rect, a/16.0, alen/16.0);
    path.closeSubpath();
    drawPath(path);
}
/*!
    \fn void QPainter::drawChord(const QRect &rectangle, int startAngle, int spanAngle)
 
    \overload
 
    Draws the chord defined by the given \a rectangle, \a startAngle and
    \a spanAngle.
*/
 
/*!
    \fn void QPainter::drawChord(int x, int y, int width, int height, int
    startAngle, int spanAngle)
 
    \overload
 
   Draws the chord defined by the rectangle beginning at (\a x, \a y)
   with the specified \a width and \a height, and the given \a
   startAngle and \a spanAngle.
*/
 
 
/*!
    Draws the first \a lineCount lines in the array \a lines
    using the current pen.
 
    \sa drawLine(), drawPolyline()
*/
void QPainter::drawLines(const QLineF *lines, int lineCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawLines(), line count=%d\n", lineCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || lineCount < 1)
        return;
 
    if (d->extended) {
        d->extended->drawLines(lines, lineCount);
        return;
    }
 
    d->updateState(d->state);
 
    uint lineEmulation = line_emulation(d->state->emulationSpecifier);
 
    if (lineEmulation) {
        if (lineEmulation == QPaintEngine::PrimitiveTransform
            && d->state->matrix.type() == QTransform::TxTranslate) {
            for (int i = 0; i < lineCount; ++i) {
                QLineF line = lines[i];
                line.translate(d->state->matrix.dx(), d->state->matrix.dy());
                d->engine->drawLines(&line, 1);
            }
        } else {
            QPainterPath linePath;
            for (int i = 0; i < lineCount; ++i) {
                linePath.moveTo(lines[i].p1());
                linePath.lineTo(lines[i].p2());
            }
            d->draw_helper(linePath, QPainterPrivate::StrokeDraw);
        }
        return;
    }
    d->engine->drawLines(lines, lineCount);
}
 
/*!
    \fn void QPainter::drawLines(const QLine *lines, int lineCount)
    \overload
 
    Draws the first \a lineCount lines in the array \a lines
    using the current pen.
*/
void QPainter::drawLines(const QLine *lines, int lineCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawLine(), line count=%d\n", lineCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || lineCount < 1)
        return;
 
    if (d->extended) {
        d->extended->drawLines(lines, lineCount);
        return;
    }
 
    d->updateState(d->state);
 
    uint lineEmulation = line_emulation(d->state->emulationSpecifier);
 
    if (lineEmulation) {
        if (lineEmulation == QPaintEngine::PrimitiveTransform
            && d->state->matrix.type() == QTransform::TxTranslate) {
            for (int i = 0; i < lineCount; ++i) {
                QLineF line = lines[i];
                line.translate(d->state->matrix.dx(), d->state->matrix.dy());
                d->engine->drawLines(&line, 1);
            }
        } else {
            QPainterPath linePath;
            for (int i = 0; i < lineCount; ++i) {
                linePath.moveTo(lines[i].p1());
                linePath.lineTo(lines[i].p2());
            }
            d->draw_helper(linePath, QPainterPrivate::StrokeDraw);
        }
        return;
    }
    d->engine->drawLines(lines, lineCount);
}
 
/*!
    \overload
 
    Draws the first \a lineCount lines in the array \a pointPairs
    using the current pen.  The lines are specified as pairs of points
    so the number of entries in \a pointPairs must be at least \a
    lineCount * 2.
*/
void QPainter::drawLines(const QPointF *pointPairs, int lineCount)
{
    Q_ASSERT(sizeof(QLineF) == 2*sizeof(QPointF));
 
    drawLines((const QLineF*)pointPairs, lineCount);
}
 
/*!
    \overload
 
    Draws the first \a lineCount lines in the array \a pointPairs
    using the current pen.
*/
void QPainter::drawLines(const QPoint *pointPairs, int lineCount)
{
    Q_ASSERT(sizeof(QLine) == 2*sizeof(QPoint));
 
    drawLines((const QLine*)pointPairs, lineCount);
}
 
 
/*!
    \fn void QPainter::drawLines(const QList<QPointF> &pointPairs)
    \overload
 
    Draws a line for each pair of points in the vector \a pointPairs
    using the current pen. If there is an odd number of points in the
    array, the last point will be ignored.
*/
 
/*!
    \fn void QPainter::drawLines(const QList<QPoint> &pointPairs)
    \overload
 
    Draws a line for each pair of points in the vector \a pointPairs
    using the current pen.
*/
 
/*!
    \fn void QPainter::drawLines(const QList<QLineF> &lines)
    \overload
 
    Draws the set of lines defined by the list \a lines using the
    current pen and brush.
*/
 
/*!
    \fn void QPainter::drawLines(const QList<QLine> &lines)
    \overload
 
    Draws the set of lines defined by the list \a lines using the
    current pen and brush.
*/
 
/*!
    Draws the polyline defined by the first \a pointCount points in \a
    points using the current pen.
 
    Note that unlike the drawPolygon() function the last point is \e
    not connected to the first, neither is the polyline filled.
 
    \table 100%
    \row
    \li
    \snippet code/src_gui_painting_qpainter.cpp 13
    \endtable
 
    \sa drawLines(), drawPolygon(), {Coordinate System}
*/
void QPainter::drawPolyline(const QPointF *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPolyline(), count=%d\n", pointCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::PolylineMode);
        return;
    }
 
    d->updateState(d->state);
 
    uint lineEmulation = line_emulation(d->state->emulationSpecifier);
 
    if (lineEmulation) {
        // ###
//         if (lineEmulation == QPaintEngine::PrimitiveTransform
//             && d->state->matrix.type() == QTransform::TxTranslate) {
//         } else {
        QPainterPath polylinePath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polylinePath.lineTo(points[i]);
        d->draw_helper(polylinePath, QPainterPrivate::StrokeDraw);
//         }
    } else {
        d->engine->drawPolygon(points, pointCount, QPaintEngine::PolylineMode);
    }
}
 
/*!
    \overload
 
    Draws the polyline defined by the first \a pointCount points in \a
    points using the current pen.
 */
void QPainter::drawPolyline(const QPoint *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPolyline(), count=%d\n", pointCount);
#endif
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::PolylineMode);
        return;
    }
 
    d->updateState(d->state);
 
    uint lineEmulation = line_emulation(d->state->emulationSpecifier);
 
    if (lineEmulation) {
        // ###
//         if (lineEmulation == QPaintEngine::PrimitiveTransform
//             && d->state->matrix.type() == QTransform::TxTranslate) {
//         } else {
        QPainterPath polylinePath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polylinePath.lineTo(points[i]);
        d->draw_helper(polylinePath, QPainterPrivate::StrokeDraw);
//         }
    } else {
        d->engine->drawPolygon(points, pointCount, QPaintEngine::PolylineMode);
    }
}
 
/*!
    \fn void QPainter::drawPolyline(const QPolygonF &points)
 
    \overload
 
    Draws the polyline defined by the given \a points using the
    current pen.
*/
 
/*!
    \fn void QPainter::drawPolyline(const QPolygon &points)
 
    \overload
 
    Draws the polyline defined by the given \a points using the
    current pen.
*/
 
/*!
    Draws the polygon defined by the first \a pointCount points in the
    array \a points using the current pen and brush.
 
    \table 100%
    \row
    \li \inlineimage qpainter-polygon.png {Four-sided polygon}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 14
    \endtable
 
    The first point is implicitly connected to the last point, and the
    polygon is filled with the current brush().
 
    If \a fillRule is Qt::WindingFill, the polygon is filled using the
    winding fill algorithm.  If \a fillRule is Qt::OddEvenFill, the
    polygon is filled using the odd-even fill algorithm. See
    \l{Qt::FillRule} for a more detailed description of these fill
    rules.
 
    \sa drawConvexPolygon(), drawPolyline(), {Coordinate System}
*/
void QPainter::drawPolygon(const QPointF *points, int pointCount, Qt::FillRule fillRule)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPolygon(), count=%d\n", pointCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::PolygonDrawMode(fillRule));
        return;
    }
 
    d->updateState(d->state);
 
    uint emulationSpecifier = d->state->emulationSpecifier;
 
    if (emulationSpecifier) {
        QPainterPath polygonPath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polygonPath.lineTo(points[i]);
        polygonPath.closeSubpath();
        polygonPath.setFillRule(fillRule);
        d->draw_helper(polygonPath);
        return;
    }
 
    d->engine->drawPolygon(points, pointCount, QPaintEngine::PolygonDrawMode(fillRule));
}
 
/*! \overload
 
    Draws the polygon defined by the first \a pointCount points in the
    array \a points.
*/
void QPainter::drawPolygon(const QPoint *points, int pointCount, Qt::FillRule fillRule)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPolygon(), count=%d\n", pointCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::PolygonDrawMode(fillRule));
        return;
    }
 
    d->updateState(d->state);
 
    uint emulationSpecifier = d->state->emulationSpecifier;
 
    if (emulationSpecifier) {
        QPainterPath polygonPath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polygonPath.lineTo(points[i]);
        polygonPath.closeSubpath();
        polygonPath.setFillRule(fillRule);
        d->draw_helper(polygonPath);
        return;
    }
 
    d->engine->drawPolygon(points, pointCount, QPaintEngine::PolygonDrawMode(fillRule));
}
 
/*! \fn void QPainter::drawPolygon(const QPolygonF &points, Qt::FillRule fillRule)
 
    \overload
 
    Draws the polygon defined by the given \a points using the fill
    rule \a fillRule.
*/
 
/*! \fn void QPainter::drawPolygon(const QPolygon &points, Qt::FillRule fillRule)
 
    \overload
 
    Draws the polygon defined by the given \a points using the fill
    rule \a fillRule.
*/
 
/*!
    \fn void QPainter::drawConvexPolygon(const QPointF *points, int pointCount)
 
    Draws the convex polygon defined by the first \a pointCount points
    in the array \a points using the current pen.
 
    \table 100%
    \row
    \li \inlineimage qpainter-polygon.png {Four-sided polygon}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 15
    \endtable
 
    The first point is implicitly connected to the last point, and the
    polygon is filled with the current brush().  If the supplied
    polygon is not convex, i.e. it contains at least one angle larger
    than 180 degrees, the results are undefined.
 
    On some platforms (e.g. X11), the drawConvexPolygon() function can
    be faster than the drawPolygon() function.
 
    \sa drawPolygon(), drawPolyline(), {Coordinate System}
*/
 
/*!
    \fn void QPainter::drawConvexPolygon(const QPoint *points, int pointCount)
    \overload
 
    Draws the convex polygon defined by the first \a pointCount points
    in the array \a points using the current pen.
*/
 
/*!
    \fn void QPainter::drawConvexPolygon(const QPolygonF &polygon)
 
    \overload
 
    Draws the convex polygon defined by \a polygon using the current
    pen and brush.
*/
 
/*!
    \fn void QPainter::drawConvexPolygon(const QPolygon &polygon)
    \overload
 
    Draws the convex polygon defined by \a polygon using the current
    pen and brush.
*/
 
void QPainter::drawConvexPolygon(const QPoint *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawConvexPolygon(), count=%d\n", pointCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::ConvexMode);
        return;
    }
 
    d->updateState(d->state);
 
    uint emulationSpecifier = d->state->emulationSpecifier;
 
    if (emulationSpecifier) {
        QPainterPath polygonPath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polygonPath.lineTo(points[i]);
        polygonPath.closeSubpath();
        polygonPath.setFillRule(Qt::WindingFill);
        d->draw_helper(polygonPath);
        return;
    }
 
    d->engine->drawPolygon(points, pointCount, QPaintEngine::ConvexMode);
}
 
void QPainter::drawConvexPolygon(const QPointF *points, int pointCount)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawConvexPolygon(), count=%d\n", pointCount);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || pointCount < 2)
        return;
 
    if (d->extended) {
        d->extended->drawPolygon(points, pointCount, QPaintEngine::ConvexMode);
        return;
    }
 
    d->updateState(d->state);
 
    uint emulationSpecifier = d->state->emulationSpecifier;
 
    if (emulationSpecifier) {
        QPainterPath polygonPath(points[0]);
        for (int i=1; i<pointCount; ++i)
            polygonPath.lineTo(points[i]);
        polygonPath.closeSubpath();
        polygonPath.setFillRule(Qt::WindingFill);
        d->draw_helper(polygonPath);
        return;
    }
 
    d->engine->drawPolygon(points, pointCount, QPaintEngine::ConvexMode);
}
 
static inline QPointF roundInDeviceCoordinates(const QPointF &p, const QTransform &m)
{
    return m.inverted().map(QPointF(m.map(p).toPoint()));
}
 
/*!
    \fn void QPainter::drawPixmap(const QRectF &target, const QPixmap &pixmap, const QRectF &source)
 
    Draws the rectangular portion \a source of the given \a pixmap
    into the given \a target in the paint device.
 
    \note The pixmap is scaled to fit the rectangle, if both the pixmap and rectangle size disagree.
    \note See \l{Drawing High Resolution Versions of Pixmaps and Images} on how this is affected
    by QPixmap::devicePixelRatio().
 
    \table 100%
    \row
    \li
    \snippet code/src_gui_painting_qpainter.cpp 16
    \endtable
 
    If \a pixmap is a QBitmap it is drawn with the bits that are "set"
    using the pens color. If backgroundMode is Qt::OpaqueMode, the
    "unset" bits are drawn using the color of the background brush; if
    backgroundMode is Qt::TransparentMode, the "unset" bits are
    transparent. Drawing bitmaps with gradient or texture colors is
    not supported.
 
    \sa drawImage(), QPixmap::devicePixelRatio()
*/
void QPainter::drawPixmap(const QPointF &p, const QPixmap &pm)
{
#if defined QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPixmap(), p=[%.2f,%.2f], pix=[%d,%d]\n",
               p.x(), p.y(),
               pm.width(), pm.height());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || pm.isNull())
        return;
 
#ifndef QT_NO_DEBUG
    qt_painter_thread_test(d->device->devType(), d->engine->type(), "drawPixmap()");
#endif
 
    if (d->extended) {
        d->extended->drawPixmap(p, pm);
        return;
    }
 
    qreal x = p.x();
    qreal y = p.y();
 
    int w = pm.width();
    int h = pm.height();
 
    if (w <= 0)
        return;
 
    // Emulate opaque background for bitmaps
    if (d->state->bgMode == Qt::OpaqueMode && pm.isQBitmap()) {
        fillRect(QRectF(x, y, w, h), d->state->bgBrush.color());
    }
 
    d->updateState(d->state);
 
    if ((d->state->matrix.type() > QTransform::TxTranslate
         && !d->engine->hasFeature(QPaintEngine::PixmapTransform))
        || (!d->state->matrix.isAffine() && !d->engine->hasFeature(QPaintEngine::PerspectiveTransform))
        || (d->state->opacity != 1.0 && !d->engine->hasFeature(QPaintEngine::ConstantOpacity)))
    {
        save();
        // If there is no rotation involved we have to make sure we use the
        // antialiased and not the aliased coordinate system by rounding the coordinates.
        if (d->state->matrix.type() <= QTransform::TxScale) {
            const QPointF p = roundInDeviceCoordinates(QPointF(x, y), d->state->matrix);
            x = p.x();
            y = p.y();
        }
        translate(x, y);
        setBackgroundMode(Qt::TransparentMode);
        setRenderHint(Antialiasing, renderHints() & SmoothPixmapTransform);
        QBrush brush(d->state->pen.color(), pm);
        setBrush(brush);
        setPen(Qt::NoPen);
        setBrushOrigin(QPointF(0, 0));
 
        drawRect(pm.rect());
        restore();
    } else {
        if (!d->engine->hasFeature(QPaintEngine::PixmapTransform)) {
            x += d->state->matrix.dx();
            y += d->state->matrix.dy();
        }
        qreal scale = pm.devicePixelRatio();
        d->engine->drawPixmap(QRectF(x, y, w / scale, h / scale), pm, QRectF(0, 0, w, h));
    }
}
 
void QPainter::drawPixmap(const QRectF &r, const QPixmap &pm, const QRectF &sr)
{
#if defined QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawPixmap(), target=[%.2f,%.2f,%.2f,%.2f], pix=[%d,%d], source=[%.2f,%.2f,%.2f,%.2f]\n",
               r.x(), r.y(), r.width(), r.height(),
               pm.width(), pm.height(),
               sr.x(), sr.y(), sr.width(), sr.height());
#endif
 
    Q_D(QPainter);
    if (!d->engine || pm.isNull())
        return;
#ifndef QT_NO_DEBUG
    qt_painter_thread_test(d->device->devType(), d->engine->type(), "drawPixmap()");
#endif
 
    qreal x = r.x();
    qreal y = r.y();
    qreal w = r.width();
    qreal h = r.height();
    qreal sx = sr.x();
    qreal sy = sr.y();
    qreal sw = sr.width();
    qreal sh = sr.height();
 
    // Get pixmap scale. Use it when calculating the target
    // rect size from pixmap size. For example, a 2X 64x64 pixel
    // pixmap should result in a 32x32 point target rect.
    const qreal pmscale = pm.devicePixelRatio();
 
    // Sanity-check clipping
    if (sw <= 0)
        sw = pm.width() - sx;
 
    if (sh <= 0)
        sh = pm.height() - sy;
 
    if (w < 0)
        w = sw / pmscale;
    if (h < 0)
        h = sh / pmscale;
 
    if (sx < 0) {
        qreal w_ratio = sx * w/sw;
        x -= w_ratio;
        w += w_ratio;
        sw += sx;
        sx = 0;
    }
 
    if (sy < 0) {
        qreal h_ratio = sy * h/sh;
        y -= h_ratio;
        h += h_ratio;
        sh += sy;
        sy = 0;
    }
 
    if (sw + sx > pm.width()) {
        qreal delta = sw - (pm.width() - sx);
        qreal w_ratio = delta * w/sw;
        sw -= delta;
        w -= w_ratio;
    }
 
    if (sh + sy > pm.height()) {
        qreal delta = sh - (pm.height() - sy);
        qreal h_ratio = delta * h/sh;
        sh -= delta;
        h -= h_ratio;
    }
 
    if (w == 0 || h == 0 || sw <= 0 || sh <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawPixmap(QRectF(x, y, w, h), pm, QRectF(sx, sy, sw, sh));
        return;
    }
 
    // Emulate opaque background for bitmaps
    if (d->state->bgMode == Qt::OpaqueMode && pm.isQBitmap())
        fillRect(QRectF(x, y, w, h), d->state->bgBrush.color());
 
    d->updateState(d->state);
 
    if ((d->state->matrix.type() > QTransform::TxTranslate
         && !d->engine->hasFeature(QPaintEngine::PixmapTransform))
        || (!d->state->matrix.isAffine() && !d->engine->hasFeature(QPaintEngine::PerspectiveTransform))
        || (d->state->opacity != 1.0 && !d->engine->hasFeature(QPaintEngine::ConstantOpacity))
        || ((sw != w || sh != h) && !d->engine->hasFeature(QPaintEngine::PixmapTransform)))
    {
        save();
        // If there is no rotation involved we have to make sure we use the
        // antialiased and not the aliased coordinate system by rounding the coordinates.
        if (d->state->matrix.type() <= QTransform::TxScale) {
            const QPointF p = roundInDeviceCoordinates(QPointF(x, y), d->state->matrix);
            x = p.x();
            y = p.y();
        }
 
        if (d->state->matrix.type() <= QTransform::TxTranslate && sw == w && sh == h) {
            sx = qRound(sx);
            sy = qRound(sy);
            sw = qRound(sw);
            sh = qRound(sh);
        }
 
        translate(x, y);
        scale(w / sw, h / sh);
        setBackgroundMode(Qt::TransparentMode);
        setRenderHint(Antialiasing, renderHints() & SmoothPixmapTransform);
        QBrush brush;
 
        if (sw == pm.width() && sh == pm.height())
            brush = QBrush(d->state->pen.color(), pm);
        else
            brush = QBrush(d->state->pen.color(), pm.copy(sx, sy, sw, sh));
 
        setBrush(brush);
        setPen(Qt::NoPen);
 
        drawRect(QRectF(0, 0, sw, sh));
        restore();
    } else {
        if (!d->engine->hasFeature(QPaintEngine::PixmapTransform)) {
            x += d->state->matrix.dx();
            y += d->state->matrix.dy();
        }
        d->engine->drawPixmap(QRectF(x, y, w, h), pm, QRectF(sx, sy, sw, sh));
    }
}
 
 
/*!
    \fn void QPainter::drawPixmap(const QRect &target, const QPixmap &pixmap,
                                  const QRect &source)
    \overload
 
    Draws the rectangular portion \a source of the given \a pixmap
    into the given \a target in the paint device.
 
    \note The pixmap is scaled to fit the rectangle, if both the pixmap and rectangle size disagree.
*/
 
/*!
    \fn void QPainter::drawPixmap(const QPointF &point, const QPixmap &pixmap,
                                  const QRectF &source)
    \overload
 
    Draws the rectangular portion \a source of the given \a pixmap
    with its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawPixmap(const QPoint &point, const QPixmap &pixmap,
                                  const QRect &source)
 
    \overload
 
    Draws the rectangular portion \a source of the given \a pixmap
    with its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawPixmap(const QPointF &point, const QPixmap &pixmap)
    \overload
 
    Draws the given \a pixmap with its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawPixmap(const QPoint &point, const QPixmap &pixmap)
    \overload
 
    Draws the given \a pixmap with its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawPixmap(int x, int y, const QPixmap &pixmap)
 
    \overload
 
    Draws the given \a pixmap at position (\a{x}, \a{y}).
*/
 
/*!
    \fn void QPainter::drawPixmap(const QRect &rectangle, const QPixmap &pixmap)
    \overload
 
    Draws the given \a  pixmap into the given \a rectangle.
 
    \note The pixmap is scaled to fit the rectangle, if both the pixmap and rectangle size disagree.
*/
 
/*!
    \fn void QPainter::drawPixmap(int x, int y, int width, int height,
    const QPixmap &pixmap)
 
    \overload
 
    Draws the \a pixmap into the rectangle at position (\a{x}, \a{y})
    with  the given \a width and \a height.
*/
 
/*!
    \fn void QPainter::drawPixmap(int x, int y, int w, int h, const QPixmap &pixmap,
                                  int sx, int sy, int sw, int sh)
 
    \overload
 
    Draws the rectangular portion with the origin (\a{sx}, \a{sy}),
    width \a sw and height \a sh, of the given \a pixmap , at the
    point (\a{x}, \a{y}), with a width of \a w and a height of \a h.
    If sw or sh are equal to zero the width/height of the pixmap
    is used and adjusted by the offset sx/sy;
*/
 
/*!
    \fn void QPainter::drawPixmap(int x, int y, const QPixmap &pixmap,
                                  int sx, int sy, int sw, int sh)
 
    \overload
 
    Draws a pixmap at (\a{x}, \a{y}) by copying a part of the given \a
    pixmap into the paint device.
 
    (\a{x}, \a{y}) specifies the top-left point in the paint device that is
    to be drawn onto. (\a{sx}, \a{sy}) specifies the top-left point in \a
    pixmap that is to be drawn. The default is (0, 0).
 
    (\a{sw}, \a{sh}) specifies the size of the pixmap that is to be drawn.
    The default, (0, 0) (and negative) means all the way to the
    bottom-right of the pixmap.
*/
 
void QPainter::drawImage(const QPointF &p, const QImage &image)
{
    Q_D(QPainter);
 
    if (!d->engine || image.isNull())
        return;
 
    if (d->extended) {
        d->extended->drawImage(p, image);
        return;
    }
 
    qreal x = p.x();
    qreal y = p.y();
 
    int w = image.width();
    int h = image.height();
    qreal scale = image.devicePixelRatio();
 
    d->updateState(d->state);
 
    if (((d->state->matrix.type() > QTransform::TxTranslate)
         && !d->engine->hasFeature(QPaintEngine::PixmapTransform))
        || (!d->state->matrix.isAffine() && !d->engine->hasFeature(QPaintEngine::PerspectiveTransform))
        || (d->state->opacity != 1.0 && !d->engine->hasFeature(QPaintEngine::ConstantOpacity)))
    {
        save();
        // If there is no rotation involved we have to make sure we use the
        // antialiased and not the aliased coordinate system by rounding the coordinates.
        if (d->state->matrix.type() <= QTransform::TxScale) {
            const QPointF p = roundInDeviceCoordinates(QPointF(x, y), d->state->matrix);
            x = p.x();
            y = p.y();
        }
        translate(x, y);
        setBackgroundMode(Qt::TransparentMode);
        setRenderHint(Antialiasing, renderHints() & SmoothPixmapTransform);
        QBrush brush(image);
        setBrush(brush);
        setPen(Qt::NoPen);
        setBrushOrigin(QPointF(0, 0));
        drawRect(QRect(QPoint(0, 0), image.size() / scale));
        restore();
        return;
    }
 
    if (d->state->matrix.type() == QTransform::TxTranslate
        && !d->engine->hasFeature(QPaintEngine::PixmapTransform)) {
        x += d->state->matrix.dx();
        y += d->state->matrix.dy();
    }
 
    d->engine->drawImage(QRectF(x, y, w / scale, h / scale), image, QRectF(0, 0, w, h), Qt::AutoColor);
}
 
void QPainter::drawImage(const QRectF &targetRect, const QImage &image, const QRectF &sourceRect,
                         Qt::ImageConversionFlags flags)
{
    Q_D(QPainter);
 
    if (!d->engine || image.isNull())
        return;
 
    qreal x = targetRect.x();
    qreal y = targetRect.y();
    qreal w = targetRect.width();
    qreal h = targetRect.height();
    qreal sx = sourceRect.x();
    qreal sy = sourceRect.y();
    qreal sw = sourceRect.width();
    qreal sh = sourceRect.height();
    qreal imageScale = image.devicePixelRatio();
 
    // Sanity-check clipping
    if (sw <= 0)
        sw = image.width() - sx;
 
    if (sh <= 0)
        sh = image.height() - sy;
 
    if (w < 0)
        w = sw / imageScale;
    if (h < 0)
        h = sh / imageScale;
 
    if (sx < 0) {
        qreal w_ratio = sx * w/sw;
        x -= w_ratio;
        w += w_ratio;
        sw += sx;
        sx = 0;
    }
 
    if (sy < 0) {
        qreal h_ratio = sy * h/sh;
        y -= h_ratio;
        h += h_ratio;
        sh += sy;
        sy = 0;
    }
 
    if (sw + sx > image.width()) {
        qreal delta = sw - (image.width() - sx);
        qreal w_ratio = delta * w/sw;
        sw -= delta;
        w -= w_ratio;
    }
 
    if (sh + sy > image.height()) {
        qreal delta = sh - (image.height() - sy);
        qreal h_ratio = delta * h/sh;
        sh -= delta;
        h -= h_ratio;
    }
 
    if (w == 0 || h == 0 || sw <= 0 || sh <= 0)
        return;
 
    if (d->extended) {
        d->extended->drawImage(QRectF(x, y, w, h), image, QRectF(sx, sy, sw, sh), flags);
        return;
    }
 
    d->updateState(d->state);
 
    if (((d->state->matrix.type() > QTransform::TxTranslate || (sw != w || sh != h))
         && !d->engine->hasFeature(QPaintEngine::PixmapTransform))
        || (!d->state->matrix.isAffine() && !d->engine->hasFeature(QPaintEngine::PerspectiveTransform))
        || (d->state->opacity != 1.0 && !d->engine->hasFeature(QPaintEngine::ConstantOpacity)))
    {
        save();
        // If there is no rotation involved we have to make sure we use the
        // antialiased and not the aliased coordinate system by rounding the coordinates.
        if (d->state->matrix.type() <= QTransform::TxScale) {
            const QPointF p = roundInDeviceCoordinates(QPointF(x, y), d->state->matrix);
            x = p.x();
            y = p.y();
        }
 
        if (d->state->matrix.type() <= QTransform::TxTranslate && sw == w && sh == h) {
            sx = qRound(sx);
            sy = qRound(sy);
            sw = qRound(sw);
            sh = qRound(sh);
        }
        translate(x, y);
        scale(w / sw, h / sh);
        setBackgroundMode(Qt::TransparentMode);
        setRenderHint(Antialiasing, renderHints() & SmoothPixmapTransform);
        QBrush brush(image);
        setBrush(brush);
        setPen(Qt::NoPen);
        setBrushOrigin(QPointF(-sx, -sy));
 
        drawRect(QRectF(0, 0, sw, sh));
        restore();
        return;
    }
 
    if (d->state->matrix.type() == QTransform::TxTranslate
        && !d->engine->hasFeature(QPaintEngine::PixmapTransform)) {
        x += d->state->matrix.dx();
        y += d->state->matrix.dy();
    }
 
    d->engine->drawImage(QRectF(x, y, w, h), image, QRectF(sx, sy, sw, sh), flags);
}
 
/*!
    \fn void QPainter::drawGlyphRun(const QPointF &position, const QGlyphRun &glyphs)
 
    Draws the glyphs represented by \a glyphs at \a position. The \a position gives the
    edge of the baseline for the string of glyphs. The glyphs will be retrieved from the font
    selected on \a glyphs and at offsets given by the positions in \a glyphs.
 
    \since 4.8
 
    \sa QGlyphRun::setRawFont(), QGlyphRun::setPositions(), QGlyphRun::setGlyphIndexes()
*/
#if !defined(QT_NO_RAWFONT)
void QPainter::drawGlyphRun(const QPointF &position, const QGlyphRun &glyphRun)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawGlyphRun: Painter not active");
        return;
    }
 
    QRawFont font = glyphRun.rawFont();
    if (!font.isValid())
        return;
 
    QGlyphRunPrivate *glyphRun_d = QGlyphRunPrivate::get(glyphRun);
 
    const quint32 *glyphIndexes = glyphRun_d->glyphIndexData;
    const QPointF *glyphPositions = glyphRun_d->glyphPositionData;
 
    int count = qMin(glyphRun_d->glyphIndexDataSize, glyphRun_d->glyphPositionDataSize);
    QVarLengthArray<QFixedPoint, 128> fixedPointPositions(count);
 
    QRawFontPrivate *fontD = QRawFontPrivate::get(font);
    bool engineRequiresPretransformedGlyphPositions = d->extended
        ? d->extended->requiresPretransformedGlyphPositions(fontD->fontEngine, d->state->matrix)
        : d->engine->type() != QPaintEngine::CoreGraphics && !d->state->matrix.isAffine();
 
    for (int i=0; i<count; ++i) {
        QPointF processedPosition = position + glyphPositions[i];
        if (engineRequiresPretransformedGlyphPositions)
            processedPosition = d->state->transform().map(processedPosition);
        fixedPointPositions[i] = QFixedPoint::fromPointF(processedPosition);
    }
 
    d->drawGlyphs(engineRequiresPretransformedGlyphPositions
                    ? d->state->transform().map(position)
                    : position,
                  glyphIndexes,
                  fixedPointPositions.data(),
                  count,
                  fontD->fontEngine,
                  glyphRun.overline(),
                  glyphRun.underline(),
                  glyphRun.strikeOut());
}
 
void QPainterPrivate::drawGlyphs(const QPointF &decorationPosition,
                                 const quint32 *glyphArray,
                                 QFixedPoint *positions,
                                 int glyphCount,
                                 QFontEngine *fontEngine,
                                 bool overline,
                                 bool underline,
                                 bool strikeOut)
{
    Q_Q(QPainter);
 
    updateState(state);
 
    if (extended != nullptr && state->matrix.isAffine()) {
        QStaticTextItem staticTextItem;
        staticTextItem.color = state->pen.color();
        staticTextItem.font = state->font;
        staticTextItem.setFontEngine(fontEngine);
        staticTextItem.numGlyphs = glyphCount;
        staticTextItem.glyphs = reinterpret_cast<glyph_t *>(const_cast<glyph_t *>(glyphArray));
        staticTextItem.glyphPositions = positions;
        // The font property is meaningless, the fontengine must be used directly:
        staticTextItem.usesRawFont = true;
 
        extended->drawStaticTextItem(&staticTextItem);
    } else {
        QTextItemInt textItem;
        textItem.fontEngine = fontEngine;
 
        QVarLengthArray<QFixed, 128> advances(glyphCount);
        QVarLengthArray<QGlyphJustification, 128> glyphJustifications(glyphCount);
        QVarLengthArray<QGlyphAttributes, 128> glyphAttributes(glyphCount);
        memset(glyphAttributes.data(), 0, glyphAttributes.size() * sizeof(QGlyphAttributes));
        memset(static_cast<void *>(advances.data()), 0, advances.size() * sizeof(QFixed));
        memset(static_cast<void *>(glyphJustifications.data()), 0, glyphJustifications.size() * sizeof(QGlyphJustification));
 
        textItem.glyphs.numGlyphs = glyphCount;
        textItem.glyphs.glyphs = const_cast<glyph_t *>(glyphArray);
        textItem.glyphs.offsets = positions;
        textItem.glyphs.advances = advances.data();
        textItem.glyphs.justifications = glyphJustifications.data();
        textItem.glyphs.attributes = glyphAttributes.data();
 
        engine->drawTextItem(QPointF(0, 0), textItem);
    }
 
    qt_draw_decoration_for_glyphs(q,
                                  decorationPosition,
                                  glyphArray,
                                  positions,
                                  glyphCount,
                                  fontEngine,
                                  underline,
                                  overline,
                                  strikeOut);
}
#endif // QT_NO_RAWFONT
 
/*!
 
    \fn void QPainter::drawStaticText(const QPoint &topLeftPosition, const QStaticText &staticText)
    \since 4.7
    \overload
 
    Draws the \a staticText at the \a topLeftPosition.
 
    \note The y-position is used as the top of the font.
 
*/
 
/*!
    \fn void QPainter::drawStaticText(int left, int top, const QStaticText &staticText)
    \since 4.7
    \overload
 
    Draws the \a staticText at coordinates \a left and \a top.
 
    \note The y-position is used as the top of the font.
*/
 
/*!
    \fn void QPainter::drawText(const QPointF &position, const QString &text)
 
    Draws the given \a text with the currently defined text direction,
    beginning at the given \a position.
 
    This function does not handle the newline character (\\n), as it cannot
    break text into multiple lines, and it cannot display the newline character.
    Use the QPainter::drawText() overload that takes a rectangle instead
    if you want to draw multiple lines of text with the newline character, or
    if you want the text to be wrapped.
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-position is used as the baseline of the font.
 
    \sa setFont(), setPen()
*/
 
void QPainter::drawText(const QPointF &p, const QString &str)
{
    drawText(p, str, 0, 0);
}
 
/*!
    \since 4.7
 
    Draws the given \a staticText at the given \a topLeftPosition.
 
    The text will be drawn using the font and the transformation set on the painter. If the
    font and/or transformation set on the painter are different from the ones used to initialize
    the layout of the QStaticText, then the layout will have to be recalculated. Use
    QStaticText::prepare() to initialize \a staticText with the font and transformation with which
    it will later be drawn.
 
    If \a topLeftPosition is not the same as when \a staticText was initialized, or when it was
    last drawn, then there will be a slight overhead when translating the text to its new position.
 
    \note If the painter's transformation is not affine, then \a staticText will be drawn using
    regular calls to drawText(), losing any potential for performance improvement.
 
    \note The y-position is used as the top of the font.
 
    \sa QStaticText
*/
void QPainter::drawStaticText(const QPointF &topLeftPosition, const QStaticText &staticText)
{
    Q_D(QPainter);
    if (!d->engine || staticText.text().isEmpty() || pen().style() == Qt::NoPen)
        return;
 
    QStaticTextPrivate *staticText_d =
            const_cast<QStaticTextPrivate *>(QStaticTextPrivate::get(&staticText));
 
    QFontPrivate *fp = QFontPrivate::get(font());
    QFontPrivate *stfp = QFontPrivate::get(staticText_d->font);
    if (font() != staticText_d->font || fp == nullptr || stfp == nullptr || fp->dpi != stfp->dpi) {
        staticText_d->font = font();
        staticText_d->needsRelayout = true;
    } else if (stfp->engineData == nullptr || stfp->engineData->fontCacheId != QFontCache::instance()->id()) {
        staticText_d->needsRelayout = true;
    }
 
    QFontEngine *fe = staticText_d->font.d->engineForScript(QChar::Script_Common);
    if (fe->type() == QFontEngine::Multi)
        fe = static_cast<QFontEngineMulti *>(fe)->engine(0);
 
    // If we don't have an extended paint engine, if the painter is projected,
    // or if the font engine does not support the matrix, we go through standard
    // code path
    if (d->extended == nullptr
            || !d->state->matrix.isAffine()
            || !fe->supportsTransformation(d->state->matrix)) {
        staticText_d->paintText(topLeftPosition, this, pen().color());
        return;
    }
 
    bool engineRequiresPretransform = d->extended->requiresPretransformedGlyphPositions(fe, d->state->matrix);
    if (staticText_d->untransformedCoordinates && engineRequiresPretransform) {
        // The coordinates are untransformed, and the engine can't deal with that
        // nativly, so we have to pre-transform the static text.
        staticText_d->untransformedCoordinates = false;
        staticText_d->needsRelayout = true;
    } else if (!staticText_d->untransformedCoordinates && !engineRequiresPretransform) {
        // The coordinates are already transformed, but the engine can handle that
        // nativly, so undo the transform of the static text.
        staticText_d->untransformedCoordinates = true;
        staticText_d->needsRelayout = true;
    }
 
    // Don't recalculate entire layout because of translation, rather add the dx and dy
    // into the position to move each text item the correct distance.
    QPointF transformedPosition = topLeftPosition;
    if (!staticText_d->untransformedCoordinates)
        transformedPosition = transformedPosition * d->state->matrix;
    QTransform oldMatrix;
 
    // The translation has been applied to transformedPosition. Remove translation
    // component from matrix.
    if (d->state->matrix.isTranslating() && !staticText_d->untransformedCoordinates) {
        qreal m11 = d->state->matrix.m11();
        qreal m12 = d->state->matrix.m12();
        qreal m13 = d->state->matrix.m13();
        qreal m21 = d->state->matrix.m21();
        qreal m22 = d->state->matrix.m22();
        qreal m23 = d->state->matrix.m23();
        qreal m33 = d->state->matrix.m33();
 
        oldMatrix = d->state->matrix;
        d->state->matrix.setMatrix(m11, m12, m13,
                                   m21, m22, m23,
                                   0.0, 0.0, m33);
    }
 
    // If the transform is not identical to the text transform,
    // we have to relayout the text (for other transformations than plain translation)
    bool staticTextNeedsReinit = staticText_d->needsRelayout;
    if (!staticText_d->untransformedCoordinates && staticText_d->matrix != d->state->matrix) {
        staticText_d->matrix = d->state->matrix;
        staticTextNeedsReinit = true;
    }
 
    // Recreate the layout of the static text because the matrix or font has changed
    if (staticTextNeedsReinit)
        staticText_d->init();
 
    if (transformedPosition != staticText_d->position) { // Translate to actual position
        QFixed fx = QFixed::fromReal(transformedPosition.x());
        QFixed fy = QFixed::fromReal(transformedPosition.y());
        QFixed oldX = QFixed::fromReal(staticText_d->position.x());
        QFixed oldY = QFixed::fromReal(staticText_d->position.y());
        for (int item=0; item<staticText_d->itemCount;++item) {
            QStaticTextItem *textItem = staticText_d->items + item;
            for (int i=0; i<textItem->numGlyphs; ++i) {
                textItem->glyphPositions[i].x += fx - oldX;
                textItem->glyphPositions[i].y += fy - oldY;
            }
            textItem->userDataNeedsUpdate = true;
        }
 
        staticText_d->position = transformedPosition;
    }
 
    QPen oldPen = d->state->pen;
    QColor currentColor = oldPen.color();
    static const QColor bodyIndicator(0, 0, 0, 0);
    for (int i=0; i<staticText_d->itemCount; ++i) {
        QStaticTextItem *item = staticText_d->items + i;
        if (item->color.isValid() && currentColor != item->color
            && item->color != bodyIndicator) {
                setPen(item->color);
                currentColor = item->color;
        } else if (item->color == bodyIndicator) {
            setPen(oldPen);
            currentColor = oldPen.color();
        }
        d->extended->drawStaticTextItem(item);
 
        qt_draw_decoration_for_glyphs(this,
                                      topLeftPosition,
                                      item->glyphs,
                                      item->glyphPositions,
                                      item->numGlyphs,
                                      item->fontEngine(),
                                      staticText_d->font.underline(),
                                      staticText_d->font.overline(),
                                      staticText_d->font.strikeOut());
    }
    if (currentColor != oldPen.color())
        setPen(oldPen);
 
    if (!staticText_d->untransformedCoordinates && oldMatrix.isTranslating())
        d->state->matrix = oldMatrix;
}
 
/*!
   \internal
*/
void QPainter::drawText(const QPointF &p, const QString &str, int tf, int justificationPadding)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawText(), pos=[%.2f,%.2f], str='%s'\n", p.x(), p.y(), str.toLatin1().constData());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || str.isEmpty() || pen().style() == Qt::NoPen)
        return;
 
    Q_DECL_UNINITIALIZED QStackTextEngine engine(str, d->state->font);
    engine.option.setTextDirection(d->state->layoutDirection);
    if (tf & (Qt::TextForceLeftToRight|Qt::TextForceRightToLeft)) {
        engine.ignoreBidi = true;
        engine.option.setTextDirection((tf & Qt::TextForceLeftToRight) ? Qt::LeftToRight : Qt::RightToLeft);
    }
    engine.itemize();
    QScriptLine line;
    line.length = str.size();
    engine.shapeLine(line);
 
    int nItems = engine.layoutData->items.size();
    QVarLengthArray<int> visualOrder(nItems);
    QVarLengthArray<uchar> levels(nItems);
    for (int i = 0; i < nItems; ++i)
        levels[i] = engine.layoutData->items[i].analysis.bidiLevel;
    QTextEngine::bidiReorder(nItems, levels.data(), visualOrder.data());
 
    if (justificationPadding > 0) {
        engine.option.setAlignment(Qt::AlignJustify);
        engine.forceJustification = true;
        // this works because justify() is only interested in the difference between width and textWidth
        line.width = justificationPadding;
        engine.justify(line);
    }
    QFixed x = QFixed::fromReal(p.x());
 
    for (int i = 0; i < nItems; ++i) {
        int item = visualOrder[i];
        const QScriptItem &si = engine.layoutData->items.at(item);
        if (si.analysis.flags >= QScriptAnalysis::TabOrObject) {
            x += si.width;
            continue;
        }
        QFont f = engine.font(si);
        QTextItemInt gf(si, &f);
        gf.glyphs = engine.shapedGlyphs(&si);
        gf.chars = engine.layoutData->string.unicode() + si.position;
        gf.num_chars = engine.length(item);
        if (engine.forceJustification) {
            for (int j=0; j<gf.glyphs.numGlyphs; ++j)
                gf.width += gf.glyphs.effectiveAdvance(j);
        } else {
            gf.width = si.width;
        }
        gf.logClusters = engine.logClusters(&si);
 
        drawTextItem(QPointF(x.toReal(), p.y()), gf);
 
        x += gf.width;
    }
}
 
void QPainter::drawText(const QRect &r, int flags, const QString &str, QRect *br)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawText(), r=[%d,%d,%d,%d], flags=%d, str='%s'\n",
           r.x(), r.y(), r.width(), r.height(), flags, str.toLatin1().constData());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || str.size() == 0 || pen().style() == Qt::NoPen)
        return;
 
    if (!d->extended)
        d->updateState(d->state);
 
    QRectF bounds;
    qt_format_text(d->state->font, r, flags, nullptr, str, br ? &bounds : nullptr, 0, nullptr, 0, this);
    if (br)
        *br = bounds.toAlignedRect();
}
 
/*!
    \fn void QPainter::drawText(const QPoint &position, const QString &text)
 
    \overload
 
    Draws the given \a text with the currently defined text direction,
    beginning at the given \a position.
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-position is used as the baseline of the font.
 
    \sa setFont(), setPen()
*/
 
/*!
    \fn void QPainter::drawText(const QRectF &rectangle, int flags, const QString &text, QRectF *boundingRect)
    \overload
 
    Draws the given \a text within the provided \a rectangle.
    The \a rectangle along with alignment \a flags defines the anchors for the \a text.
 
    \table 100%
    \row
    \li \inlineimage qpainter-text.png {Text showing Qt Project}
    \li
    \snippet code/src_gui_painting_qpainter.cpp 17
    \endtable
 
    The \a boundingRect (if not null) is set to what the bounding rectangle
    should be in order to enclose the whole text. For example, in the following
    image, the dotted line represents \a boundingRect as calculated by the
    function, and the dashed line represents \a rectangle:
 
    \table 100%
    \row
    \li \inlineimage qpainter-text-bounds.png {Text with bounding rectangles}
    \li \snippet code/src_gui_painting_qpainter.cpp drawText
    \endtable
 
    The \a flags argument is a bitwise OR of the following flags:
 
    \list
    \li Qt::AlignLeft
    \li Qt::AlignRight
    \li Qt::AlignHCenter
    \li Qt::AlignJustify
    \li Qt::AlignTop
    \li Qt::AlignBottom
    \li Qt::AlignVCenter
    \li Qt::AlignCenter
    \li Qt::TextDontClip
    \li Qt::TextSingleLine
    \li Qt::TextExpandTabs
    \li Qt::TextShowMnemonic
    \li Qt::TextWordWrap
    \li Qt::TextIncludeTrailingSpaces
    \endlist
 
    \sa Qt::AlignmentFlag, Qt::TextFlag, boundingRect(), layoutDirection()
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-coordinate of \a rectangle is used as the top of the font.
*/
void QPainter::drawText(const QRectF &r, int flags, const QString &str, QRectF *br)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawText(), r=[%.2f,%.2f,%.2f,%.2f], flags=%d, str='%s'\n",
           r.x(), r.y(), r.width(), r.height(), flags, str.toLatin1().constData());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || str.size() == 0 || pen().style() == Qt::NoPen)
        return;
 
    if (!d->extended)
        d->updateState(d->state);
 
    qt_format_text(d->state->font, r, flags, nullptr, str, br, 0, nullptr, 0, this);
}
 
/*!
    \fn void QPainter::drawText(const QRect &rectangle, int flags, const QString &text, QRect *boundingRect)
    \overload
 
    Draws the given \a text within the provided \a rectangle according
    to the specified \a flags.
 
    The \a boundingRect (if not null) is set to the what the bounding rectangle
    should be in order to enclose the whole text. For example, in the following
    image, the dotted line represents \a boundingRect as calculated by the
    function, and the dashed line represents \a rectangle:
 
    \table 100%
    \row
    \li \inlineimage qpainter-text-bounds.png {Text with bounding rectangles}
    \li \snippet code/src_gui_painting_qpainter.cpp drawText
    \endtable
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-coordinate of \a rectangle is used as the top of the font.
 
    \sa setFont(), setPen()
*/
 
/*!
    \fn void QPainter::drawText(int x, int y, const QString &text)
 
    \overload
 
    Draws the given \a text at position (\a{x}, \a{y}), using the painter's
    currently defined text direction.
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-position is used as the baseline of the font.
 
    \sa setFont(), setPen()
*/
 
/*!
    \fn void QPainter::drawText(int x, int y, int width, int height, int flags,
                                const QString &text, QRect *boundingRect)
 
    \overload
 
    Draws the given \a text within the rectangle with origin (\a{x},
    \a{y}), \a width and \a height.
 
    The \a boundingRect (if not null) is set to the what the bounding rectangle
    should be in order to enclose the whole text. For example, in the following
    image, the dotted line represents \a boundingRect as calculated by the
    function, and the dashed line represents the rectangle defined by
    \a x, \a y, \a width and \a height:
 
    \table 100%
    \row
    \li \inlineimage qpainter-text-bounds.png {Text with bounding rectangles}
    \li \snippet code/src_gui_painting_qpainter.cpp drawText
    \endtable
 
    The \a flags argument is a bitwise OR of the following flags:
 
    \list
    \li Qt::AlignLeft
    \li Qt::AlignRight
    \li Qt::AlignHCenter
    \li Qt::AlignJustify
    \li Qt::AlignTop
    \li Qt::AlignBottom
    \li Qt::AlignVCenter
    \li Qt::AlignCenter
    \li Qt::TextSingleLine
    \li Qt::TextExpandTabs
    \li Qt::TextShowMnemonic
    \li Qt::TextWordWrap
    \endlist
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-position is used as the top of the font.
 
    \sa Qt::AlignmentFlag, Qt::TextFlag, setFont(), setPen()
*/
 
/*!
    \fn void QPainter::drawText(const QRectF &rectangle, const QString &text,
        const QTextOption &option)
    \overload
 
    Draws the given \a text in the \a rectangle specified using the \a option
    to control its positioning, direction, and orientation. The options given
    in \a option override those set on the QPainter object itself.
 
    By default, QPainter draws text anti-aliased.
 
    \note The y-coordinate of \a rectangle is used as the top of the font.
 
    \sa setFont(), setPen()
*/
void QPainter::drawText(const QRectF &r, const QString &text, const QTextOption &o)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawText(), r=[%.2f,%.2f,%.2f,%.2f], str='%s'\n",
           r.x(), r.y(), r.width(), r.height(), text.toLatin1().constData());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine || text.size() == 0 || pen().style() == Qt::NoPen)
        return;
 
    if (!d->extended)
        d->updateState(d->state);
 
    qt_format_text(d->state->font, r, 0, &o, text, nullptr, 0, nullptr, 0, this);
}
 
/*!
    \fn void QPainter::drawTextItem(int x, int y, const QTextItem &ti)
 
    \internal
    \overload
*/
 
/*!
    \fn void QPainter::drawTextItem(const QPoint &p, const QTextItem &ti)
 
    \internal
    \overload
 
    Draws the text item \a ti at position \a p.
*/
 
/*!
    \fn void QPainter::drawTextItem(const QPointF &p, const QTextItem &ti)
 
    \internal
    \since 4.1
 
    Draws the text item \a ti at position \a p.
 
    This method ignores the painters background mode and
    color. drawText and qt_format_text have to do it themselves, as
    only they know the extents of the complete string.
 
    It ignores the font set on the painter as the text item has one of its own.
 
    The underline and strikeout parameters of the text items font are
    ignored as well. You'll need to pass in the correct flags to get
    underlining and strikeout.
*/
 
static QPixmap generateWavyPixmap(qreal maxRadius, const QPen &pen)
{
    const qreal radiusBase = qMax(qreal(1), maxRadius);
 
    QString key = "WaveUnderline-"_L1
                  % pen.color().name()
                  % HexString<qreal>(radiusBase)
                  % HexString<qreal>(pen.widthF());
 
    QPixmap pixmap;
    if (QPixmapCache::find(key, &pixmap))
        return pixmap;
 
    const qreal halfPeriod = qMax(qreal(2), qreal(radiusBase * 1.61803399)); // the golden ratio
    const int width = qCeil(100 / (2 * halfPeriod)) * (2 * halfPeriod);
    const qreal radius = qFloor(radiusBase * 2) / 2.;
 
    QPainterPath path;
 
    qreal xs = 0;
    qreal ys = radius;
 
    while (xs < width) {
        xs += halfPeriod;
        ys = -ys;
        path.quadTo(xs - halfPeriod / 2, ys, xs, 0);
    }
 
    pixmap = QPixmap(width, radius * 2);
    pixmap.fill(Qt::transparent);
    {
        QPen wavePen = pen;
        wavePen.setCapStyle(Qt::SquareCap);
 
        // This is to protect against making the line too fat, as happens on OS X
        // due to it having a rather thick width for the regular underline.
        const qreal maxPenWidth = .8 * radius;
        if (wavePen.widthF() > maxPenWidth)
            wavePen.setWidthF(maxPenWidth);
 
        QPainter imgPainter(&pixmap);
        imgPainter.setPen(wavePen);
        imgPainter.setRenderHint(QPainter::Antialiasing);
        imgPainter.translate(0, radius);
        imgPainter.drawPath(path);
    }
 
    QPixmapCache::insert(key, pixmap);
 
    return pixmap;
}
 
static void drawTextItemDecoration(QPainter *painter, const QPointF &pos, const QFontEngine *fe, QTextEngine *textEngine,
                                   QTextCharFormat::UnderlineStyle underlineStyle,
                                   QTextItem::RenderFlags flags, qreal width,
                                   const QTextCharFormat &charFormat)
{
    if (underlineStyle == QTextCharFormat::NoUnderline
        && !(flags & (QTextItem::StrikeOut | QTextItem::Overline)))
        return;
 
    const QPen oldPen = painter->pen();
    const QBrush oldBrush = painter->brush();
    painter->setBrush(Qt::NoBrush);
    QPen pen = oldPen;
    pen.setStyle(Qt::SolidLine);
    pen.setWidthF(fe->lineThickness().toReal());
    pen.setCapStyle(Qt::FlatCap);
 
    QLineF line(qFloor(pos.x()), pos.y(), qFloor(pos.x() + width), pos.y());
 
    const qreal underlineOffset = fe->underlinePosition().toReal();
 
    if (underlineStyle == QTextCharFormat::SpellCheckUnderline) {
        QPlatformTheme *theme = QGuiApplicationPrivate::platformTheme();
        if (theme)
            underlineStyle = QTextCharFormat::UnderlineStyle(theme->themeHint(QPlatformTheme::SpellCheckUnderlineStyle).toInt());
        if (underlineStyle == QTextCharFormat::SpellCheckUnderline) // still not resolved
            underlineStyle = QTextCharFormat::WaveUnderline;
    }
 
    if (underlineStyle == QTextCharFormat::WaveUnderline) {
        painter->save();
        painter->translate(0, pos.y() + 1);
        qreal maxHeight = fe->descent().toReal() - qreal(1);
 
        QColor uc = charFormat.underlineColor();
        if (uc.isValid())
            pen.setColor(uc);
 
        // Adapt wave to underlineOffset or pen width, whatever is larger, to make it work on all platforms
        const QPixmap wave = generateWavyPixmap(qMin(qMax(underlineOffset, pen.widthF()), maxHeight / qreal(2.)), pen);
        const int descent = qFloor(maxHeight);
 
        painter->setBrushOrigin(painter->brushOrigin().x(), 0);
        painter->fillRect(pos.x(), 0, qCeil(width), qMin(wave.height(), descent), wave);
        painter->restore();
    } else if (underlineStyle != QTextCharFormat::NoUnderline) {
        const bool isAntialiasing = painter->renderHints().testFlag(QPainter::Antialiasing);
        if (!isAntialiasing)
            pen.setWidthF(qMax(fe->lineThickness().round(), QFixed(1)).toReal());
        const qreal lineThicknessOffset = pen.widthF() / 2.0;
 
        // Deliberately ceil the offset to avoid the underline coming too close to
        // the text above it, but limit it to stay within descent.
        qreal adjustedUnderlineOffset = std::ceil(underlineOffset) + lineThicknessOffset;
        if (underlineOffset <= fe->descent().toReal())
            adjustedUnderlineOffset = qMin(adjustedUnderlineOffset, fe->descent().toReal() - lineThicknessOffset);
        const qreal underlinePos = pos.y() + adjustedUnderlineOffset;
        QColor uc = charFormat.underlineColor();
        if (uc.isValid())
            pen.setColor(uc);
 
        pen.setStyle((Qt::PenStyle)(underlineStyle));
        painter->setPen(pen);
        QLineF underline(line.x1(), underlinePos, line.x2(), underlinePos);
        if (textEngine)
            textEngine->addUnderline(painter, underline);
        else
            painter->drawLine(underline);
 
        if (!isAntialiasing)
            pen.setWidthF(fe->lineThickness().toReal());
    }
 
    pen.setStyle(Qt::SolidLine);
    pen.setColor(oldPen.color());
 
    if (flags & QTextItem::StrikeOut) {
        QLineF strikeOutLine = line;
        strikeOutLine.translate(0., - fe->ascent().toReal() / 3.);
        QColor uc = charFormat.underlineColor();
        if (uc.isValid())
            pen.setColor(uc);
        painter->setPen(pen);
        if (textEngine)
            textEngine->addStrikeOut(painter, strikeOutLine);
        else
            painter->drawLine(strikeOutLine);
    }
 
    if (flags & QTextItem::Overline) {
        QLineF overline = line;
        overline.translate(0., - fe->ascent().toReal());
        QColor uc = charFormat.underlineColor();
        if (uc.isValid())
            pen.setColor(uc);
        painter->setPen(pen);
        if (textEngine)
            textEngine->addOverline(painter, overline);
        else
            painter->drawLine(overline);
    }
 
    painter->setPen(oldPen);
    painter->setBrush(oldBrush);
}
 
static void qt_draw_decoration_for_glyphs(QPainter *painter,
                                          const QPointF &decorationPosition,
                                          const glyph_t *glyphArray,
                                          const QFixedPoint *positions,
                                          int glyphCount,
                                          QFontEngine *fontEngine,
                                          bool underline,
                                          bool overline,
                                          bool strikeOut)
{
    if (!underline && !overline && !strikeOut)
        return;
 
    QTextItem::RenderFlags flags;
    if (underline)
        flags |= QTextItem::Underline;
    if (overline)
        flags |= QTextItem::Overline;
    if (strikeOut)
        flags |= QTextItem::StrikeOut;
 
    bool rtl = positions[glyphCount - 1].x < positions[0].x;
    QFixed baseline = positions[0].y;
    glyph_metrics_t gm = fontEngine->boundingBox(glyphArray[rtl ? 0 : glyphCount - 1]);
 
    qreal width = rtl
            ? (positions[0].x + gm.xoff - positions[glyphCount - 1].x).toReal()
            : (positions[glyphCount - 1].x + gm.xoff - positions[0].x).toReal();
 
    drawTextItemDecoration(painter,
                           QPointF(decorationPosition.x(), baseline.toReal()),
                           fontEngine,
                           nullptr, // textEngine
                           underline ? QTextCharFormat::SingleUnderline
                                     : QTextCharFormat::NoUnderline,
                           flags,
                           width,
                           QTextCharFormat());
}
 
void QPainter::drawTextItem(const QPointF &p, const QTextItem &ti)
{
    Q_D(QPainter);
 
    d->drawTextItem(p, ti, static_cast<QTextEngine *>(nullptr));
}
 
void QPainterPrivate::drawTextItem(const QPointF &p, const QTextItem &_ti, QTextEngine *textEngine)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawTextItem(), pos=[%.f,%.f], str='%s'\n",
               p.x(), p.y(), qPrintable(_ti.text()));
#endif
 
    Q_Q(QPainter);
 
    if (!engine)
        return;
 
    QTextItemInt &ti = const_cast<QTextItemInt &>(static_cast<const QTextItemInt &>(_ti));
 
    if (!extended && state->bgMode == Qt::OpaqueMode) {
        QRectF rect(p.x(), p.y() - ti.ascent.toReal(), ti.width.toReal(), (ti.ascent + ti.descent).toReal());
        q->fillRect(rect, state->bgBrush);
    }
 
    if (q->pen().style() == Qt::NoPen)
        return;
 
    const QPainter::RenderHints oldRenderHints = state->renderHints;
    if (!(state->renderHints & QPainter::Antialiasing) && state->matrix.type() >= QTransform::TxScale) {
        // draw antialias decoration (underline/overline/strikeout) with
        // transformed text
 
        bool aa = true;
        const QTransform &m = state->matrix;
        if (state->matrix.type() < QTransform::TxShear) {
            bool isPlain90DegreeRotation =
                (qFuzzyIsNull(m.m11())
                 && qFuzzyIsNull(m.m12() - qreal(1))
                 && qFuzzyIsNull(m.m21() + qreal(1))
                 && qFuzzyIsNull(m.m22())
                    )
                ||
                (qFuzzyIsNull(m.m11() + qreal(1))
                 && qFuzzyIsNull(m.m12())
                 && qFuzzyIsNull(m.m21())
                 && qFuzzyIsNull(m.m22() + qreal(1))
                    )
                ||
                (qFuzzyIsNull(m.m11())
                 && qFuzzyIsNull(m.m12() + qreal(1))
                 && qFuzzyIsNull(m.m21() - qreal(1))
                 && qFuzzyIsNull(m.m22())
                    )
                ;
            aa = !isPlain90DegreeRotation;
        }
        if (aa)
            q->setRenderHint(QPainter::Antialiasing, true);
    }
 
    if (!extended)
        updateState(state);
 
    if (!ti.glyphs.numGlyphs) {
        drawTextItemDecoration(q, p, ti.fontEngine, textEngine, ti.underlineStyle,
            ti.flags, ti.width.toReal(), ti.charFormat);
    } else if (ti.fontEngine->type() == QFontEngine::Multi) {
        QFontEngineMulti *multi = static_cast<QFontEngineMulti *>(ti.fontEngine);
 
        const QGlyphLayout &glyphs = ti.glyphs;
        int which = glyphs.glyphs[0] >> 24;
 
        qreal x = p.x();
        qreal y = p.y();
 
        bool rtl = ti.flags & QTextItem::RightToLeft;
        if (rtl)
            x += ti.width.toReal();
 
        int start = 0;
        int end, i;
        for (end = 0; end < ti.glyphs.numGlyphs; ++end) {
            const int e = glyphs.glyphs[end] >> 24;
            if (e == which)
                continue;
 
 
            multi->ensureEngineAt(which);
            QTextItemInt ti2 = ti.midItem(multi->engine(which), start, end - start);
            ti2.width = 0;
            // set the high byte to zero and calc the width
            for (i = start; i < end; ++i) {
                glyphs.glyphs[i] = glyphs.glyphs[i] & 0xffffff;
                ti2.width += ti.glyphs.effectiveAdvance(i);
            }
 
            if (rtl)
                x -= ti2.width.toReal();
 
            if (extended)
                extended->drawTextItem(QPointF(x, y), ti2);
            else
                engine->drawTextItem(QPointF(x, y), ti2);
            drawTextItemDecoration(q, QPointF(x, y), ti2.fontEngine, textEngine, ti2.underlineStyle,
                                   ti2.flags, ti2.width.toReal(), ti2.charFormat);
 
            if (!rtl)
                x += ti2.width.toReal();
 
            // reset the high byte for all glyphs and advance to the next sub-string
            const int hi = which << 24;
            for (i = start; i < end; ++i) {
                glyphs.glyphs[i] = hi | glyphs.glyphs[i];
            }
 
            // change engine
            start = end;
            which = e;
        }
 
        multi->ensureEngineAt(which);
        QTextItemInt ti2 = ti.midItem(multi->engine(which), start, end - start);
        ti2.width = 0;
        // set the high byte to zero and calc the width
        for (i = start; i < end; ++i) {
            glyphs.glyphs[i] = glyphs.glyphs[i] & 0xffffff;
            ti2.width += ti.glyphs.effectiveAdvance(i);
        }
 
        if (rtl)
            x -= ti2.width.toReal();
 
        if (extended)
            extended->drawTextItem(QPointF(x, y), ti2);
        else
            engine->drawTextItem(QPointF(x,y), ti2);
        drawTextItemDecoration(q, QPointF(x, y), ti2.fontEngine, textEngine, ti2.underlineStyle,
                               ti2.flags, ti2.width.toReal(), ti2.charFormat);
 
        // reset the high byte for all glyphs
        const int hi = which << 24;
        for (i = start; i < end; ++i)
            glyphs.glyphs[i] = hi | glyphs.glyphs[i];
 
    } else {
        if (extended)
            extended->drawTextItem(p, ti);
        else
            engine->drawTextItem(p, ti);
        drawTextItemDecoration(q, p, ti.fontEngine, textEngine, ti.underlineStyle,
                               ti.flags, ti.width.toReal(), ti.charFormat);
    }
 
    if (state->renderHints != oldRenderHints) {
        state->renderHints = oldRenderHints;
        if (extended)
            extended->renderHintsChanged();
        else
            state->dirtyFlags |= QPaintEngine::DirtyHints;
    }
}
 
/*!
    \fn QRectF QPainter::boundingRect(const QRectF &rectangle, int flags, const QString &text)
 
    Returns the bounding rectangle of the \a text as it will appear
    when drawn inside the given \a rectangle with the specified \a
    flags using the currently set font(); i.e the function tells you
    where the drawText() function will draw when given the same
    arguments.
 
    If the \a text does not fit within the given \a rectangle using
    the specified \a flags, the function returns the required
    rectangle.
 
    The \a flags argument is a bitwise OR of the following flags:
    \list
         \li Qt::AlignLeft
         \li Qt::AlignRight
         \li Qt::AlignHCenter
         \li Qt::AlignTop
         \li Qt::AlignBottom
         \li Qt::AlignVCenter
         \li Qt::AlignCenter
         \li Qt::TextSingleLine
         \li Qt::TextExpandTabs
         \li Qt::TextShowMnemonic
         \li Qt::TextWordWrap
         \li Qt::TextIncludeTrailingSpaces
    \endlist
    If several of the horizontal or several of the vertical alignment
    flags are set, the resulting alignment is undefined.
 
    \sa drawText(), Qt::Alignment, Qt::TextFlag
*/
 
/*!
    \fn QRect QPainter::boundingRect(const QRect &rectangle, int flags,
                                     const QString &text)
 
    \overload
 
    Returns the bounding rectangle of the \a text as it will appear
    when drawn inside the given \a rectangle with the specified \a
    flags using the currently set font().
*/
 
/*!
    \fn QRect QPainter::boundingRect(int x, int y, int w, int h, int flags,
                                     const QString &text);
 
    \overload
 
    Returns the bounding rectangle of the given \a text as it will
    appear when drawn inside the rectangle beginning at the point
    (\a{x}, \a{y}) with width \a w and height \a h.
*/
QRect QPainter::boundingRect(const QRect &rect, int flags, const QString &str)
{
    if (str.isEmpty())
        return QRect(rect.x(),rect.y(), 0,0);
    QRect brect;
    drawText(rect, flags | Qt::TextDontPrint, str, &brect);
    return brect;
}
 
 
 
QRectF QPainter::boundingRect(const QRectF &rect, int flags, const QString &str)
{
    if (str.isEmpty())
        return QRectF(rect.x(),rect.y(), 0,0);
    QRectF brect;
    drawText(rect, flags | Qt::TextDontPrint, str, &brect);
    return brect;
}
 
/*!
    \fn QRectF QPainter::boundingRect(const QRectF &rectangle,
        const QString &text, const QTextOption &option)
 
    \overload
 
    Instead of specifying flags as a bitwise OR of the
    Qt::AlignmentFlag and Qt::TextFlag, this overloaded function takes
    an \a option argument. The QTextOption class provides a
    description of general rich text properties.
 
    \sa QTextOption
*/
QRectF QPainter::boundingRect(const QRectF &r, const QString &text, const QTextOption &o)
{
    Q_D(QPainter);
 
    if (!d->engine || text.size() == 0)
        return QRectF(r.x(),r.y(), 0,0);
 
    QRectF br;
    qt_format_text(d->state->font, r, Qt::TextDontPrint, &o, text, &br, 0, nullptr, 0, this);
    return br;
}
 
/*!
    \fn void QPainter::drawTiledPixmap(const QRectF &rectangle, const QPixmap &pixmap, const QPointF &position)
 
    Draws a tiled \a pixmap, inside the given \a rectangle with its
    origin at the given \a position.
 
    Calling drawTiledPixmap() is similar to calling drawPixmap()
    several times to fill (tile) an area with a pixmap, but is
    potentially much more efficient depending on the underlying window
    system.
 
    drawTiledPixmap() will produce the same visual tiling pattern on
    high-dpi displays (with devicePixelRatio > 1), compared to normal-
    dpi displays. Set the devicePixelRatio on the \a pixmap to control
    the tile size. For example, setting it to 2 halves the tile width
    and height (on both 1x and 2x displays), and produces high-resolution
    output on 2x displays.
 
    The \a position offset is provided in the device independent pixels
    relative to the top-left corner of the \a rectangle. The \a position
    can be used to align the repeating pattern inside the \a rectangle.
 
    \sa drawPixmap()
*/
void QPainter::drawTiledPixmap(const QRectF &r, const QPixmap &pixmap, const QPointF &sp)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::drawTiledPixmap(), target=[%.2f,%.2f,%.2f,%.2f], pix=[%d,%d], offset=[%.2f,%.2f]\n",
               r.x(), r.y(), r.width(), r.height(),
               pixmap.width(), pixmap.height(),
               sp.x(), sp.y());
#endif
 
    Q_D(QPainter);
    if (!d->engine || pixmap.isNull() || r.isEmpty())
        return;
 
#ifndef QT_NO_DEBUG
    qt_painter_thread_test(d->device->devType(), d->engine->type(), "drawTiledPixmap()");
#endif
 
    const qreal sw = pixmap.width() / pixmap.devicePixelRatio();
    const qreal sh = pixmap.height() / pixmap.devicePixelRatio();
    qreal sx = sp.x();
    qreal sy = sp.y();
    if (sx < 0)
        sx = qRound(sw) - qRound(-sx) % qRound(sw);
    else
        sx = qRound(sx) % qRound(sw);
    if (sy < 0)
        sy = qRound(sh) - -qRound(sy) % qRound(sh);
    else
        sy = qRound(sy) % qRound(sh);
 
 
    if (d->extended) {
        d->extended->drawTiledPixmap(r, pixmap, QPointF(sx, sy));
        return;
    }
 
    if (d->state->bgMode == Qt::OpaqueMode && pixmap.isQBitmap())
        fillRect(r, d->state->bgBrush);
 
    d->updateState(d->state);
    if ((d->state->matrix.type() > QTransform::TxTranslate
        && !d->engine->hasFeature(QPaintEngine::PixmapTransform))
        || (d->state->opacity != 1.0 && !d->engine->hasFeature(QPaintEngine::ConstantOpacity)))
    {
        save();
        setBackgroundMode(Qt::TransparentMode);
        setRenderHint(Antialiasing, renderHints() & SmoothPixmapTransform);
        setBrush(QBrush(d->state->pen.color(), pixmap));
        setPen(Qt::NoPen);
 
        // If there is no rotation involved we have to make sure we use the
        // antialiased and not the aliased coordinate system by rounding the coordinates.
        if (d->state->matrix.type() <= QTransform::TxScale) {
            const QPointF p = roundInDeviceCoordinates(r.topLeft(), d->state->matrix);
 
            if (d->state->matrix.type() <= QTransform::TxTranslate) {
                sx = qRound(sx);
                sy = qRound(sy);
            }
 
            setBrushOrigin(QPointF(r.x()-sx, r.y()-sy));
            drawRect(QRectF(p, r.size()));
        } else {
            setBrushOrigin(QPointF(r.x()-sx, r.y()-sy));
            drawRect(r);
        }
        restore();
        return;
    }
 
    qreal x = r.x();
    qreal y = r.y();
    if (d->state->matrix.type() == QTransform::TxTranslate
        && !d->engine->hasFeature(QPaintEngine::PixmapTransform)) {
        x += d->state->matrix.dx();
        y += d->state->matrix.dy();
    }
 
    d->engine->drawTiledPixmap(QRectF(x, y, r.width(), r.height()), pixmap, QPointF(sx, sy));
}
 
/*!
    \fn void QPainter::drawTiledPixmap(const QRect &rectangle, const QPixmap &pixmap,
                                  const QPoint &position = QPoint())
    \overload
 
    Draws a tiled \a pixmap, inside the given \a rectangle with its
    origin at the given \a position.
*/
 
/*!
    \fn void QPainter::drawTiledPixmap(int x, int y, int width, int height, const
         QPixmap &pixmap, int sx, int sy);
    \overload
 
    Draws a tiled \a pixmap in the specified rectangle.
 
    (\a{x}, \a{y}) specifies the top-left point in the paint device
    that is to be drawn onto; with the given \a width and \a
    height.
 
    (\a{sx}, \a{sy}) specifies the origin inside the specified rectangle
    where the pixmap will be drawn. The origin position is specified in
    the device independent pixels relative to (\a{x}, \a{y}). This defaults
    to (0, 0).
*/
 
#ifndef QT_NO_PICTURE
 
/*!
    \fn void QPainter::drawPicture(const QPointF &point, const QPicture &picture)
 
    Replays the given \a picture at the given \a point.
 
    The QPicture class is a paint device that records and replays
    QPainter commands. A picture serializes the painter commands to an
    IO device in a platform-independent format. Everything that can be
    painted on a widget or pixmap can also be stored in a picture.
 
    This function does exactly the same as QPicture::play() when
    called with \a point = QPointF(0, 0).
 
    \note The state of the painter is preserved by this function.
 
    \table 100%
    \row
    \li
    \snippet code/src_gui_painting_qpainter.cpp 18
    \endtable
 
    \sa QPicture::play()
*/
 
void QPainter::drawPicture(const QPointF &p, const QPicture &picture)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::drawPicture: Painter not active");
        return;
    }
 
    if (!d->extended)
        d->updateState(d->state);
 
    save();
    translate(p);
    const_cast<QPicture *>(&picture)->play(this);
    restore();
}
 
/*!
    \fn void QPainter::drawPicture(const QPoint &point, const QPicture &picture)
    \overload
 
    Replays the given \a picture at the given \a point.
*/
 
/*!
    \fn void QPainter::drawPicture(int x, int y, const QPicture &picture)
    \overload
 
    Draws the given \a picture at point (\a x, \a y).
*/
 
#endif // QT_NO_PICTURE
 
/*!
    \fn void QPainter::eraseRect(const QRectF &rectangle)
 
    Erases the area inside the given \a rectangle. Equivalent to
    calling
    \snippet code/src_gui_painting_qpainter.cpp 19
 
    \sa fillRect()
*/
void QPainter::eraseRect(const QRectF &r)
{
    Q_D(QPainter);
 
    fillRect(r, d->state->bgBrush);
}
 
static inline bool needsResolving(const QBrush &brush)
{
    Qt::BrushStyle s = brush.style();
    return ((s == Qt::LinearGradientPattern || s == Qt::RadialGradientPattern ||
             s == Qt::ConicalGradientPattern) &&
            (brush.gradient()->coordinateMode() == QGradient::ObjectBoundingMode ||
             brush.gradient()->coordinateMode() == QGradient::ObjectMode));
}
 
/*!
    \fn void QPainter::eraseRect(const QRect &rectangle)
    \overload
 
    Erases the area inside the given  \a rectangle.
*/
 
/*!
    \fn void QPainter::eraseRect(int x, int y, int width, int height)
    \overload
 
    Erases the area inside the rectangle beginning at (\a x, \a y)
    with the given \a width and \a height.
*/
 
 
/*!
    \fn void QPainter::fillRect(int x, int y, int width, int height, Qt::BrushStyle style)
    \overload
 
    Fills the rectangle beginning at (\a{x}, \a{y}) with the given \a
    width and \a height, using the brush \a style specified.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(const QRect &rectangle, Qt::BrushStyle style)
    \overload
 
    Fills the given \a rectangle  with the brush \a style specified.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(const QRectF &rectangle, Qt::BrushStyle style)
    \overload
 
    Fills the given \a rectangle  with the brush \a style specified.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(const QRectF &rectangle, const QBrush &brush)
 
    Fills the given \a rectangle  with the \a brush specified.
 
    Alternatively, you can specify a QColor instead of a QBrush; the
    QBrush constructor (taking a QColor argument) will automatically
    create a solid pattern brush.
 
    \sa drawRect()
*/
void QPainter::fillRect(const QRectF &r, const QBrush &brush)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::fillRect: Painter not active");
        return;
    }
 
    if (d->extended && !needsEmulation(brush)) {
        d->extended->fillRect(r, brush);
        return;
    }
 
    QPen oldPen = pen();
    QBrush oldBrush = this->brush();
    setPen(Qt::NoPen);
    if (brush.style() == Qt::SolidPattern) {
        d->colorBrush.setStyle(Qt::SolidPattern);
        d->colorBrush.setColor(brush.color());
        setBrush(d->colorBrush);
    } else {
        setBrush(brush);
    }
 
    drawRect(r);
    setBrush(oldBrush);
    setPen(oldPen);
}
 
/*!
    \fn void QPainter::fillRect(const QRect &rectangle, const QBrush &brush)
    \overload
 
    Fills the given \a rectangle with the specified \a brush.
*/
 
void QPainter::fillRect(const QRect &r, const QBrush &brush)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::fillRect: Painter not active");
        return;
    }
 
    if (d->extended && !needsEmulation(brush)) {
        d->extended->fillRect(r, brush);
        return;
    }
 
    QPen oldPen = pen();
    QBrush oldBrush = this->brush();
    setPen(Qt::NoPen);
    if (brush.style() == Qt::SolidPattern) {
        d->colorBrush.setStyle(Qt::SolidPattern);
        d->colorBrush.setColor(brush.color());
        setBrush(d->colorBrush);
    } else {
        setBrush(brush);
    }
 
    drawRect(r);
    setBrush(oldBrush);
    setPen(oldPen);
}
 
 
 
/*!
    \fn void QPainter::fillRect(const QRect &rectangle, const QColor &color)
    \overload
 
    Fills the given \a rectangle with the \a color specified.
 
    \since 4.5
*/
void QPainter::fillRect(const QRect &r, const QColor &color)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::fillRect: Painter not active");
        return;
    }
 
    if (d->extended) {
        d->extended->fillRect(r, color);
        return;
    }
 
    fillRect(r, QBrush(color));
}
 
 
/*!
    \fn void QPainter::fillRect(const QRectF &rectangle, const QColor &color)
    \overload
 
    Fills the given \a rectangle with the \a color specified.
 
    \since 4.5
*/
void QPainter::fillRect(const QRectF &r, const QColor &color)
{
    Q_D(QPainter);
 
    if (!d->engine)
        return;
 
    if (d->extended) {
        d->extended->fillRect(r, color);
        return;
    }
 
    fillRect(r, QBrush(color));
}
 
/*!
    \fn void QPainter::fillRect(int x, int y, int width, int height, const QBrush &brush)
 
    \overload
 
    Fills the rectangle beginning at (\a{x}, \a{y}) with the given \a
    width and \a height, using the given \a brush.
*/
 
/*!
    \fn void QPainter::fillRect(int x, int y, int width, int height, const QColor &color)
 
    \overload
 
    Fills the rectangle beginning at (\a{x}, \a{y}) with the given \a
    width and \a height, using the given \a color.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(int x, int y, int width, int height, Qt::GlobalColor color)
 
    \overload
 
    Fills the rectangle beginning at (\a{x}, \a{y}) with the given \a
    width and \a height, using the given \a color.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(const QRect &rectangle, Qt::GlobalColor color);
 
    \overload
 
    Fills the given \a rectangle with the specified \a color.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(const QRectF &rectangle, Qt::GlobalColor color);
 
    \overload
 
    Fills the given \a rectangle with the specified \a color.
 
    \since 4.5
*/
 
/*!
    \fn void QPainter::fillRect(int x, int y, int width, int height, QGradient::Preset preset)
 
    \overload
 
    Fills the rectangle beginning at (\a{x}, \a{y}) with the given \a
    width and \a height, using the given gradient \a preset.
 
    \since 5.12
*/
 
/*!
    \fn void QPainter::fillRect(const QRect &rectangle, QGradient::Preset preset);
 
    \overload
 
    Fills the given \a rectangle with the specified gradient \a preset.
 
    \since 5.12
*/
 
/*!
    \fn void QPainter::fillRect(const QRectF &rectangle, QGradient::Preset preset);
 
    \overload
 
    Fills the given \a rectangle with the specified gradient \a preset.
 
    \since 5.12
*/
 
/*!
    Sets the given render \a hint on the painter if \a on is true;
    otherwise clears the render hint.
 
    \sa setRenderHints(), renderHints(), {QPainter#Rendering
    Quality}{Rendering Quality}
*/
void QPainter::setRenderHint(RenderHint hint, bool on)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setRenderHint: hint=%x, %s\n", hint, on ? "on" : "off");
#endif
 
#ifndef QT_NO_DEBUG
    static const bool antialiasingDisabled = qEnvironmentVariableIntValue("QT_NO_ANTIALIASING");
    if (hint == QPainter::Antialiasing && antialiasingDisabled)
        return;
#endif
 
    setRenderHints(hint, on);
}
 
/*!
    \since 4.2
 
    Sets the given render \a hints on the painter if \a on is true;
    otherwise clears the render hints.
 
    \sa setRenderHint(), renderHints(), {QPainter#Rendering
    Quality}{Rendering Quality}
*/
 
void QPainter::setRenderHints(RenderHints hints, bool on)
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setRenderHint: Painter must be active to set rendering hints");
        return;
    }
 
    if (on)
        d->state->renderHints |= hints;
    else
        d->state->renderHints &= ~hints;
 
    if (d->extended)
        d->extended->renderHintsChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyHints;
}
 
/*!
    Returns a flag that specifies the rendering hints that are set for
    this painter.
 
    \sa testRenderHint(), {QPainter#Rendering Quality}{Rendering Quality}
*/
QPainter::RenderHints QPainter::renderHints() const
{
    Q_D(const QPainter);
 
    if (!d->engine)
        return { };
 
    return d->state->renderHints;
}
 
/*!
    \fn bool QPainter::testRenderHint(RenderHint hint) const
    \since 4.3
 
    Returns \c true if \a hint is set; otherwise returns \c false.
 
    \sa renderHints(), setRenderHint()
*/
 
/*!
    Returns \c true if view transformation is enabled; otherwise returns
    false.
 
    \sa setViewTransformEnabled(), worldTransform()
*/
 
bool QPainter::viewTransformEnabled() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::viewTransformEnabled: Painter not active");
        return false;
    }
    return d->state->VxF;
}
 
/*!
    \fn void QPainter::setWindow(const QRect &rectangle)
 
    Sets the painter's window to the given \a rectangle, and enables
    view transformations.
 
    The window rectangle is part of the view transformation. The
    window specifies the logical coordinate system. Its sister, the
    viewport(), specifies the device coordinate system.
 
    The default window rectangle is the same as the device's
    rectangle.
 
    \sa window(), viewTransformEnabled(), {Coordinate
    System#Window-Viewport Conversion}{Window-Viewport Conversion}
*/
 
/*!
    \fn void QPainter::setWindow(int x, int y, int width, int height)
    \overload
 
    Sets the painter's window to the rectangle beginning at (\a x, \a
    y) and the given \a width and \a height.
*/
 
void QPainter::setWindow(const QRect &r)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setWindow(), [%d,%d,%d,%d]\n", r.x(), r.y(), r.width(), r.height());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setWindow: Painter not active");
        return;
    }
 
    d->state->wx = r.x();
    d->state->wy = r.y();
    d->state->ww = r.width();
    d->state->wh = r.height();
 
    d->state->VxF = true;
    d->updateMatrix();
}
 
/*!
    Returns the window rectangle.
 
    \sa setWindow(), setViewTransformEnabled()
*/
 
QRect QPainter::window() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::window: Painter not active");
        return QRect();
    }
    return QRect(d->state->wx, d->state->wy, d->state->ww, d->state->wh);
}
 
/*!
    \fn void QPainter::setViewport(const QRect &rectangle)
 
    Sets the painter's viewport rectangle to the given \a rectangle,
    and enables view transformations.
 
    The viewport rectangle is part of the view transformation. The
    viewport specifies the device coordinate system. Its sister, the
    window(), specifies the logical coordinate system.
 
    The default viewport rectangle is the same as the device's
    rectangle.
 
    \sa viewport(), viewTransformEnabled(), {Coordinate
    System#Window-Viewport Conversion}{Window-Viewport Conversion}
*/
 
/*!
    \fn void QPainter::setViewport(int x, int y, int width, int height)
    \overload
 
    Sets the painter's viewport rectangle to be the rectangle
    beginning at (\a x, \a y) with the given \a width and \a height.
*/
 
void QPainter::setViewport(const QRect &r)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setViewport(), [%d,%d,%d,%d]\n", r.x(), r.y(), r.width(), r.height());
#endif
 
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setViewport: Painter not active");
        return;
    }
 
    d->state->vx = r.x();
    d->state->vy = r.y();
    d->state->vw = r.width();
    d->state->vh = r.height();
 
    d->state->VxF = true;
    d->updateMatrix();
}
 
/*!
    Returns the viewport rectangle.
 
    \sa setViewport(), setViewTransformEnabled()
*/
 
QRect QPainter::viewport() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::viewport: Painter not active");
        return QRect();
    }
    return QRect(d->state->vx, d->state->vy, d->state->vw, d->state->vh);
}
 
/*!
    Enables view transformations if \a enable is true, or disables
    view transformations if \a enable is false.
 
    \sa viewTransformEnabled(), {Coordinate System#Window-Viewport
    Conversion}{Window-Viewport Conversion}
*/
 
void QPainter::setViewTransformEnabled(bool enable)
{
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::setViewTransformEnabled(), enable=%d\n", enable);
#endif
 
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setViewTransformEnabled: Painter not active");
        return;
    }
 
    if (enable == d->state->VxF)
        return;
 
    d->state->VxF = enable;
    d->updateMatrix();
}
 
void qt_format_text(const QFont &fnt,
                    const QRectF &_r,
                    int tf,
                    int alignment,
                    const QTextOption *option,
                    const QString& str,
                    QRectF *brect,
                    int tabstops,
                    int *ta,
                    int tabarraylen,
                    QPainter *painter)
{
    Q_ASSERT( !((tf & ~Qt::TextDontPrint)!=0 && option!=nullptr) ); // we either have an option or flags
 
    if (_r.isEmpty() && !(tf & Qt::TextDontClip)) {
        if (!brect)
            return;
        else
            tf |= Qt::TextDontPrint;
    }
 
    if (option) {
        alignment |= option->alignment();
        if (option->wrapMode() != QTextOption::NoWrap)
            tf |= Qt::TextWordWrap;
 
        if (option->flags() & QTextOption::IncludeTrailingSpaces)
            tf |= Qt::TextIncludeTrailingSpaces;
 
        if (option->tabStopDistance() >= 0 || !option->tabArray().isEmpty())
            tf |= Qt::TextExpandTabs;
    }
 
    // we need to copy r here to protect against the case (&r == brect).
    QRectF r(_r);
 
    bool dontclip  = (tf & Qt::TextDontClip);
    bool wordwrap  = (tf & Qt::TextWordWrap) || (tf & Qt::TextWrapAnywhere);
    bool singleline = (tf & Qt::TextSingleLine);
    bool showmnemonic = (tf & Qt::TextShowMnemonic);
    bool hidemnmemonic = (tf & Qt::TextHideMnemonic);
 
    Qt::LayoutDirection layout_direction;
    if (tf & Qt::TextForceLeftToRight)
        layout_direction = Qt::LeftToRight;
    else if (tf & Qt::TextForceRightToLeft)
        layout_direction = Qt::RightToLeft;
    else if (option)
        layout_direction = option->textDirection();
    else if (painter)
        layout_direction = painter->layoutDirection();
    else
        layout_direction = Qt::LeftToRight;
 
    alignment = QGuiApplicationPrivate::visualAlignment(layout_direction, QFlag(alignment));
 
    bool isRightToLeft = layout_direction == Qt::RightToLeft;
    bool expandtabs = ((tf & Qt::TextExpandTabs) &&
                        (((alignment & Qt::AlignLeft) && !isRightToLeft) ||
                          ((alignment & Qt::AlignRight) && isRightToLeft)));
 
    if (!painter)
        tf |= Qt::TextDontPrint;
 
    uint maxUnderlines = 0;
 
    QFontMetricsF fm(fnt);
    QString text = str;
    int offset = 0;
start_lengthVariant:
    bool hasMoreLengthVariants = false;
    // compatible behaviour to the old implementation. Replace
    // tabs by spaces
    int old_offset = offset;
    for (; offset < text.size(); offset++) {
        QChar chr = text.at(offset);
        if (chr == u'\r' || (singleline && chr == u'\n')) {
            text[offset] = u' ';
        } else if (chr == u'\n') {
            text[offset] = QChar::LineSeparator;
        } else if (chr == u'&') {
            ++maxUnderlines;
        } else if (chr == u'\t') {
            if (!expandtabs) {
                text[offset] = u' ';
            } else if (!tabarraylen && !tabstops) {
                tabstops = qRound(fm.horizontalAdvance(u'x')*8);
            }
        } else if (chr == u'\x9c') {
            // string with multiple length variants
            hasMoreLengthVariants = true;
            break;
        }
    }
 
    QList<QTextLayout::FormatRange> underlineFormats;
    int length = offset - old_offset;
    if ((hidemnmemonic || showmnemonic) && maxUnderlines > 0) {
        QChar *cout = text.data() + old_offset;
        QChar *cout0 = cout;
        QChar *cin = cout;
        int l = length;
        while (l) {
            if (*cin == u'&') {
                ++cin;
                --length;
                --l;
                if (!l)
                    break;
                if (*cin != u'&' && !hidemnmemonic && !(tf & Qt::TextDontPrint)) {
                    QTextLayout::FormatRange range;
                    range.start = cout - cout0;
                    range.length = 1;
                    range.format.setFontUnderline(true);
                    underlineFormats.append(range);
                }
#ifdef Q_OS_APPLE
            } else if (hidemnmemonic && *cin == u'(' && l >= 4 &&
                       cin[1] == u'&' && cin[2] != u'&' &&
                       cin[3] == u')') {
                int n = 0;
                while ((cout - n) > cout0 && (cout - n - 1)->isSpace())
                    ++n;
                cout -= n;
                cin += 4;
                length -= n + 4;
                l -= 4;
                continue;
#endif //Q_OS_APPLE
            }
            *cout = *cin;
            ++cout;
            ++cin;
            --l;
        }
    }
 
    qreal height = 0;
    qreal width = 0;
 
    QString finalText = text.mid(old_offset, length);
    Q_DECL_UNINITIALIZED QStackTextEngine engine(finalText, fnt);
    if (option) {
        engine.option = *option;
    }
 
    if (engine.option.tabStopDistance() < 0 && tabstops > 0)
        engine.option.setTabStopDistance(tabstops);
 
    if (engine.option.tabs().isEmpty() && ta) {
        QList<qreal> tabs;
        tabs.reserve(tabarraylen);
        for (int i = 0; i < tabarraylen; i++)
            tabs.append(qreal(ta[i]));
        engine.option.setTabArray(tabs);
    }
 
    engine.option.setTextDirection(layout_direction);
    if (alignment & Qt::AlignJustify)
        engine.option.setAlignment(Qt::AlignJustify);
    else
        engine.option.setAlignment(Qt::AlignLeft); // do not do alignment twice
 
    if (!option && (tf & Qt::TextWrapAnywhere))
        engine.option.setWrapMode(QTextOption::WrapAnywhere);
 
    if (tf & Qt::TextJustificationForced)
        engine.forceJustification = true;
    QTextLayout textLayout(&engine);
    textLayout.setCacheEnabled(true);
    textLayout.setFormats(underlineFormats);
 
    if (finalText.isEmpty()) {
        height = fm.height();
        width = 0;
        tf |= Qt::TextDontPrint;
    } else {
        qreal lineWidth = 0x01000000;
        if (wordwrap || (tf & Qt::TextJustificationForced))
            lineWidth = qMax<qreal>(0, r.width());
        if (!wordwrap)
            tf |= Qt::TextIncludeTrailingSpaces;
        textLayout.beginLayout();
 
        qreal leading = fm.leading();
        height = -leading;
 
        while (1) {
            QTextLine l = textLayout.createLine();
            if (!l.isValid())
                break;
 
            l.setLineWidth(lineWidth);
            height += leading;
 
            // Make sure lines are positioned on whole pixels
            height = qCeil(height);
 
            if (alignment & Qt::AlignBaseline && l.lineNumber() == 0)
                height -= l.ascent();
 
            l.setPosition(QPointF(0., height));
            height += textLayout.engine()->lines[l.lineNumber()].height().toReal();
            width = qMax(width, l.naturalTextWidth());
            if (!dontclip && !brect && height >= r.height())
                break;
        }
        textLayout.endLayout();
    }
 
    qreal yoff = 0;
    qreal xoff = 0;
    if (alignment & Qt::AlignBottom)
        yoff = r.height() - height;
    else if (alignment & Qt::AlignVCenter)
        yoff = (r.height() - height)/2;
 
    if (alignment & Qt::AlignRight)
        xoff = r.width() - width;
    else if (alignment & Qt::AlignHCenter)
        xoff = (r.width() - width)/2;
 
    QRectF bounds = QRectF(r.x() + xoff, r.y() + yoff, width, height);
 
    if (hasMoreLengthVariants && !(tf & Qt::TextLongestVariant) && !r.contains(bounds)) {
        offset++;
        goto start_lengthVariant;
    }
    if (brect)
        *brect = bounds;
 
    if (!(tf & Qt::TextDontPrint)) {
        bool restore = false;
        if (!dontclip && !r.contains(bounds)) {
            restore = true;
            painter->save();
            painter->setClipRect(r, Qt::IntersectClip);
        }
 
        for (int i = 0; i < textLayout.lineCount(); i++) {
            QTextLine line = textLayout.lineAt(i);
            QTextEngine *eng = textLayout.engine();
            eng->enableDelayDecorations();
 
            qreal advance = line.horizontalAdvance();
            xoff = 0;
            if (alignment & Qt::AlignRight) {
                xoff = r.width() - advance -
                    eng->leadingSpaceWidth(eng->lines[line.lineNumber()]).toReal();
            } else if (alignment & Qt::AlignHCenter) {
                xoff = (r.width() - advance) / 2;
            }
 
            line.draw(painter, QPointF(r.x() + xoff, r.y() + yoff));
            eng->drawDecorations(painter);
        }
 
        if (restore) {
            painter->restore();
        }
    }
}
 
void qt_format_text(const QFont &fnt, const QRectF &_r,
                    int tf, const QString& str, QRectF *brect,
                    int tabstops, int *ta, int tabarraylen,
                    QPainter *painter)
{
    qt_format_text(fnt,
                   _r,
                   tf,
                   tf & ~Qt::AlignBaseline, // Qt::AlignBaseline conflicts with Qt::TextSingleLine
                   nullptr,
                   str,
                   brect,
                   tabstops,
                   ta,
                   tabarraylen,
                   painter);
}
 
void qt_format_text(const QFont &fnt,
                    const QRectF &_r,
                    int tf,
                    const QTextOption *option,
                    const QString& str,
                    QRectF *brect,
                    int tabstops,
                    int *ta,
                    int tabarraylen,
                    QPainter *painter)
{
    qt_format_text(fnt,
                   _r,
                   tf,
                   tf & ~Qt::AlignBaseline, // Qt::AlignBaseline conflicts with Qt::TextSingleLine
                   option,
                   str,
                   brect,
                   tabstops,
                   ta,
                   tabarraylen,
                   painter);
}
 
/*!
    Sets the layout direction used by the painter when drawing text,
    to the specified \a direction.
 
    The default is Qt::LayoutDirectionAuto, which will implicitly determine the
    direction from the text drawn.
 
    \sa QTextOption::setTextDirection(), layoutDirection(), drawText(), {QPainter#Settings}{Settings}
*/
void QPainter::setLayoutDirection(Qt::LayoutDirection direction)
{
    Q_D(QPainter);
    if (d->state)
        d->state->layoutDirection = direction;
}
 
/*!
    Returns the layout direction used by the painter when drawing text.
 
    \sa QTextOption::textDirection(), setLayoutDirection(), drawText(), {QPainter#Settings}{Settings}
*/
Qt::LayoutDirection QPainter::layoutDirection() const
{
    Q_D(const QPainter);
    return d->state ? d->state->layoutDirection : Qt::LayoutDirectionAuto;
}
 
QPainterState::QPainterState(const QPainterState *s)
    : brushOrigin(s->brushOrigin), font(s->font), deviceFont(s->deviceFont),
      pen(s->pen), brush(s->brush), bgBrush(s->bgBrush),
      clipRegion(s->clipRegion), clipPath(s->clipPath),
      clipOperation(s->clipOperation),
      renderHints(s->renderHints), clipInfo(s->clipInfo),
      worldMatrix(s->worldMatrix), matrix(s->matrix), redirectionMatrix(s->redirectionMatrix),
      wx(s->wx), wy(s->wy), ww(s->ww), wh(s->wh),
      vx(s->vx), vy(s->vy), vw(s->vw), vh(s->vh),
      opacity(s->opacity), WxF(s->WxF), VxF(s->VxF),
      clipEnabled(s->clipEnabled), bgMode(s->bgMode), painter(s->painter),
      layoutDirection(s->layoutDirection),
      composition_mode(s->composition_mode),
      emulationSpecifier(s->emulationSpecifier), changeFlags(0)
{
    dirtyFlags = s->dirtyFlags;
}
 
QPainterState::QPainterState()
    : brushOrigin(0, 0), WxF(false), VxF(false), clipEnabled(true),
      layoutDirection(QGuiApplication::layoutDirection())
{
}
 
QPainterState::~QPainterState()
{
}
 
void QPainterState::init(QPainter *p) {
    bgBrush = Qt::white;
    bgMode = Qt::TransparentMode;
    WxF = false;
    VxF = false;
    clipEnabled = true;
    wx = wy = ww = wh = 0;
    vx = vy = vw = vh = 0;
    painter = p;
    pen = QPen();
    brushOrigin = QPointF(0, 0);
    brush = QBrush();
    font = deviceFont = QFont();
    clipRegion = QRegion();
    clipPath = QPainterPath();
    clipOperation = Qt::NoClip;
    clipInfo.clear();
    worldMatrix.reset();
    matrix.reset();
    layoutDirection = QGuiApplication::layoutDirection();
    composition_mode = QPainter::CompositionMode_SourceOver;
    emulationSpecifier = 0;
    dirtyFlags = { };
    changeFlags = 0;
    renderHints = { };
    opacity = 1;
}
 
/*!
    \fn void QPainter::drawImage(const QRectF &target, const QImage &image, const QRectF &source,
                         Qt::ImageConversionFlags flags)
 
    Draws the rectangular portion \a source of the given \a image
    into the \a target rectangle in the paint device.
 
    \note The image is scaled to fit the rectangle, if both the image and rectangle size disagree.
    \note See \l{Drawing High Resolution Versions of Pixmaps and Images} on how this is affected
    by QImage::devicePixelRatio().
 
    If the image needs to be modified to fit in a lower-resolution
    result (e.g. converting from 32-bit to 8-bit), use the \a flags to
    specify how you would prefer this to happen.
 
    \table 100%
    \row
    \li
    \snippet code/src_gui_painting_qpainter.cpp 20
    \endtable
 
    \sa drawPixmap(), QImage::devicePixelRatio()
*/
 
/*!
    \fn void QPainter::drawImage(const QRect &target, const QImage &image, const QRect &source,
                                 Qt::ImageConversionFlags flags)
    \overload
 
    Draws the rectangular portion \a source of the given \a image
    into the \a target rectangle in the paint device.
 
    \note The image is scaled to fit the rectangle, if both the image and rectangle size disagree.
*/
 
/*!
    \fn void QPainter::drawImage(const QPointF &point, const QImage &image)
 
    \overload
 
    Draws the given \a image at the given \a point.
*/
 
/*!
    \fn void QPainter::drawImage(const QPoint &point, const QImage &image)
 
    \overload
 
    Draws the given \a image at the given \a point.
*/
 
/*!
    \fn void QPainter::drawImage(const QPointF &point, const QImage &image, const QRectF &source,
                                 Qt::ImageConversionFlags flags = Qt::AutoColor)
 
    \overload
 
    Draws the rectangular portion \a source of the given \a image with
    its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawImage(const QPoint &point, const QImage &image, const QRect &source,
                                 Qt::ImageConversionFlags flags = Qt::AutoColor)
    \overload
 
    Draws the rectangular portion \a source of the given \a image with
    its origin at the given \a point.
*/
 
/*!
    \fn void QPainter::drawImage(const QRectF &rectangle, const QImage &image)
 
    \overload
 
    Draws the given \a image into the given \a rectangle.
 
    \note The image is scaled to fit the rectangle, if both the image and rectangle size disagree.
*/
 
/*!
    \fn void QPainter::drawImage(const QRect &rectangle, const QImage &image)
 
    \overload
 
    Draws the given \a image into the given \a rectangle.
 
   \note The image is scaled to fit the rectangle, if both the image and rectangle size disagree.
*/
 
/*!
    \fn void QPainter::drawImage(int x, int y, const QImage &image,
                                 int sx, int sy, int sw, int sh,
                                 Qt::ImageConversionFlags flags)
    \overload
 
    Draws an image at (\a{x}, \a{y}) by copying a part of \a image into
    the paint device.
 
    (\a{x}, \a{y}) specifies the top-left point in the paint device that is
    to be drawn onto. (\a{sx}, \a{sy}) specifies the top-left point in \a
    image that is to be drawn. The default is (0, 0).
 
    (\a{sw}, \a{sh}) specifies the size of the image that is to be drawn.
    The default, (0, 0) (and negative) means all the way to the
    bottom-right of the image.
*/
 
/*!
    \class QPaintEngineState
    \since 4.1
    \inmodule QtGui
 
    \brief The QPaintEngineState class provides information about the
    active paint engine's current state.
    \reentrant
 
    QPaintEngineState records which properties that have changed since
    the last time the paint engine was updated, as well as their
    current value.
 
    Which properties that have changed can at any time be retrieved
    using the state() function. This function returns an instance of
    the QPaintEngine::DirtyFlags type which stores an OR combination
    of QPaintEngine::DirtyFlag values. The QPaintEngine::DirtyFlag
    enum defines whether a property has changed since the last update
    or not.
 
    If a property is marked with a dirty flag, its current value can
    be retrieved using the corresponding get function:
 
    \target GetFunction
 
    \table
    \header \li Property Flag \li Current Property Value
    \row \li QPaintEngine::DirtyBackground \li backgroundBrush()
    \row \li QPaintEngine::DirtyBackgroundMode \li backgroundMode()
    \row \li QPaintEngine::DirtyBrush \li brush()
    \row \li QPaintEngine::DirtyBrushOrigin \li brushOrigin()
    \row \li QPaintEngine::DirtyClipRegion \e or QPaintEngine::DirtyClipPath
         \li clipOperation()
    \row \li QPaintEngine::DirtyClipPath \li clipPath()
    \row \li QPaintEngine::DirtyClipRegion \li clipRegion()
    \row \li QPaintEngine::DirtyCompositionMode \li compositionMode()
    \row \li QPaintEngine::DirtyFont \li font()
    \row \li QPaintEngine::DirtyTransform \li transform()
    \row \li QPaintEngine::DirtyClipEnabled \li isClipEnabled()
    \row \li QPaintEngine::DirtyPen \li pen()
    \row \li QPaintEngine::DirtyHints \li renderHints()
    \endtable
 
    The QPaintEngineState class also provide the painter() function
    which returns a pointer to the painter that is currently updating
    the paint engine.
 
    An instance of this class, representing the current state of the
    active paint engine, is passed as argument to the
    QPaintEngine::updateState() function. The only situation in which
    you will have to use this class directly is when implementing your
    own paint engine.
 
    \sa QPaintEngine
*/
 
 
/*!
    \fn QPaintEngine::DirtyFlags QPaintEngineState::state() const
 
    Returns a combination of flags identifying the set of properties
    that need to be updated when updating the paint engine's state
    (i.e. during a call to the QPaintEngine::updateState() function).
 
    \sa QPaintEngine::updateState()
*/
 
 
/*!
    Returns the pen in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyPen flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QPen QPaintEngineState::pen() const
{
    return static_cast<const QPainterState *>(this)->pen;
}
 
/*!
    Returns the brush in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyBrush flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QBrush QPaintEngineState::brush() const
{
    return static_cast<const QPainterState *>(this)->brush;
}
 
/*!
    Returns the brush origin in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyBrushOrigin flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QPointF QPaintEngineState::brushOrigin() const
{
    return static_cast<const QPainterState *>(this)->brushOrigin;
}
 
/*!
    Returns the background brush in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyBackground flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QBrush QPaintEngineState::backgroundBrush() const
{
    return static_cast<const QPainterState *>(this)->bgBrush;
}
 
/*!
    Returns the background mode in the current paint engine
    state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyBackgroundMode flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
Qt::BGMode QPaintEngineState::backgroundMode() const
{
    return static_cast<const QPainterState *>(this)->bgMode;
}
 
/*!
    Returns the font in the current paint engine
    state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyFont flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QFont QPaintEngineState::font() const
{
    return static_cast<const QPainterState *>(this)->font;
}
 
/*!
    \since 4.3
 
    Returns the matrix in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyTransform flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
 
QTransform QPaintEngineState::transform() const
{
    const QPainterState *st = static_cast<const QPainterState *>(this);
 
    return st->matrix;
}
 
 
/*!
    Returns the clip operation in the current paint engine
    state.
 
    This variable should only be used when the state() returns a
    combination which includes either the QPaintEngine::DirtyClipPath
    or the QPaintEngine::DirtyClipRegion flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
Qt::ClipOperation QPaintEngineState::clipOperation() const
{
    return static_cast<const QPainterState *>(this)->clipOperation;
}
 
/*!
    \since 4.3
 
    Returns whether the coordinate of the fill have been specified
    as bounded by the current rendering operation and have to be
    resolved (about the currently rendered primitive).
*/
bool QPaintEngineState::brushNeedsResolving() const
{
    const QBrush &brush = static_cast<const QPainterState *>(this)->brush;
    return needsResolving(brush);
}
 
 
/*!
    \since 4.3
 
    Returns whether the coordinate of the stroke have been specified
    as bounded by the current rendering operation and have to be
    resolved (about the currently rendered primitive).
*/
bool QPaintEngineState::penNeedsResolving() const
{
    const QPen &pen = static_cast<const QPainterState *>(this)->pen;
    return needsResolving(pen.brush());
}
 
/*!
    Returns the clip region in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyClipRegion flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QRegion QPaintEngineState::clipRegion() const
{
    return static_cast<const QPainterState *>(this)->clipRegion;
}
 
/*!
    Returns the clip path in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyClipPath flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QPainterPath QPaintEngineState::clipPath() const
{
    return static_cast<const QPainterState *>(this)->clipPath;
}
 
/*!
    Returns whether clipping is enabled or not in the current paint
    engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyClipEnabled
    flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
bool QPaintEngineState::isClipEnabled() const
{
    return static_cast<const QPainterState *>(this)->clipEnabled;
}
 
/*!
    Returns the render hints in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyHints
    flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QPainter::RenderHints QPaintEngineState::renderHints() const
{
    return static_cast<const QPainterState *>(this)->renderHints;
}
 
/*!
    Returns the composition mode in the current paint engine state.
 
    This variable should only be used when the state() returns a
    combination which includes the QPaintEngine::DirtyCompositionMode
    flag.
 
    \sa state(), QPaintEngine::updateState()
*/
 
QPainter::CompositionMode QPaintEngineState::compositionMode() const
{
    return static_cast<const QPainterState *>(this)->composition_mode;
}
 
 
/*!
    Returns a pointer to the painter currently updating the paint
    engine.
*/
 
QPainter *QPaintEngineState::painter() const
{
    return static_cast<const QPainterState *>(this)->painter;
}
 
 
/*!
    \since 4.2
 
    Returns the opacity in the current paint engine state.
*/
 
qreal QPaintEngineState::opacity() const
{
    return static_cast<const QPainterState *>(this)->opacity;
}
 
/*!
    \since 4.3
 
    Sets the world transformation matrix.
    If \a combine is true, the specified \a transform is combined with
    the current matrix; otherwise it replaces the current matrix.
 
    \sa transform(), setWorldTransform()
*/
 
void QPainter::setTransform(const QTransform &transform, bool combine )
{
    setWorldTransform(transform, combine);
}
 
/*!
    Alias for worldTransform().
    Returns the world transformation matrix.
 
    \sa worldTransform()
*/
 
const QTransform & QPainter::transform() const
{
    return worldTransform();
}
 
 
/*!
    Returns the matrix that transforms from logical coordinates to
    device coordinates of the platform dependent paint device.
 
    This function is \e only needed when using platform painting
    commands on the platform dependent handle (Qt::HANDLE), and the
    platform does not do transformations nativly.
 
    The QPaintEngine::PaintEngineFeature enum can be queried to
    determine whether the platform performs the transformations or
    not.
 
    \sa worldTransform(), QPaintEngine::hasFeature(),
*/
 
const QTransform & QPainter::deviceTransform() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::deviceTransform: Painter not active");
        return d->fakeState()->transform;
    }
    return d->state->matrix;
}
 
 
/*!
    Resets any transformations that were made using translate(),
    scale(), shear(), rotate(), setWorldTransform(), setViewport()
    and setWindow().
 
    \sa {Coordinate Transformations}
*/
 
void QPainter::resetTransform()
{
     Q_D(QPainter);
#ifdef QT_DEBUG_DRAW
    if constexpr (qt_show_painter_debug_output)
        printf("QPainter::resetMatrix()\n");
#endif
    if (!d->engine) {
        qWarning("QPainter::resetMatrix: Painter not active");
        return;
    }
 
    d->state->wx = d->state->wy = d->state->vx = d->state->vy = 0;                        // default view origins
    d->state->ww = d->state->vw = d->device->metric(QPaintDevice::PdmWidth);
    d->state->wh = d->state->vh = d->device->metric(QPaintDevice::PdmHeight);
    d->state->worldMatrix = QTransform();
    setWorldMatrixEnabled(false);
    setViewTransformEnabled(false);
    if (d->extended)
        d->extended->transformChanged();
    else
        d->state->dirtyFlags |= QPaintEngine::DirtyTransform;
}
 
/*!
    Sets the world transformation matrix.
    If \a combine is true, the specified \a matrix is combined with the current matrix;
    otherwise it replaces the current matrix.
 
    \sa transform(), setTransform()
*/
 
void QPainter::setWorldTransform(const QTransform &matrix, bool combine )
{
    Q_D(QPainter);
 
    if (!d->engine) {
        qWarning("QPainter::setWorldTransform: Painter not active");
        return;
    }
 
    if (combine)
        d->state->worldMatrix = matrix * d->state->worldMatrix;                        // combines
    else
        d->state->worldMatrix = matrix;                                // set new matrix
 
    d->state->WxF = true;
    d->updateMatrix();
}
 
/*!
    Returns the world transformation matrix.
*/
 
const QTransform & QPainter::worldTransform() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::worldTransform: Painter not active");
        return d->fakeState()->transform;
    }
    return d->state->worldMatrix;
}
 
/*!
    Returns the transformation matrix combining the current
    window/viewport and world transformation.
 
    \sa setWorldTransform(), setWindow(), setViewport()
*/
 
QTransform QPainter::combinedTransform() const
{
    Q_D(const QPainter);
    if (!d->engine) {
        qWarning("QPainter::combinedTransform: Painter not active");
        return QTransform();
    }
    return d->state->worldMatrix * d->viewTransform() * d->hidpiScaleTransform();
}
 
/*!
    \since 4.7
 
    This function is used to draw \a pixmap, or a sub-rectangle of \a pixmap,
    at multiple positions with different scale, rotation and opacity. \a
    fragments is an array of \a fragmentCount elements specifying the
    parameters used to draw each pixmap fragment. The \a hints
    parameter can be used to pass in drawing hints.
 
    This function is potentially faster than multiple calls to drawPixmap(),
    since the backend can optimize state changes.
 
    \sa QPainter::PixmapFragment, QPainter::PixmapFragmentHint
*/
 
void QPainter::drawPixmapFragments(const PixmapFragment *fragments, int fragmentCount,
                                   const QPixmap &pixmap, PixmapFragmentHints hints)
{
    Q_D(QPainter);
 
    if (!d->engine || pixmap.isNull())
        return;
 
#ifndef QT_NO_DEBUG
    for (int i = 0; i < fragmentCount; ++i) {
        QRectF sourceRect(fragments[i].sourceLeft, fragments[i].sourceTop,
                          fragments[i].width, fragments[i].height);
        if (!(QRectF(pixmap.rect()).contains(sourceRect)))
            qWarning("QPainter::drawPixmapFragments - the source rect is not contained by the pixmap's rectangle");
    }
#endif
 
    if (d->engine->isExtended()) {
        d->extended->drawPixmapFragments(fragments, fragmentCount, pixmap, hints);
    } else {
        qreal oldOpacity = opacity();
        QTransform oldTransform = transform();
 
        for (int i = 0; i < fragmentCount; ++i) {
            QTransform transform = oldTransform;
            qreal xOffset = 0;
            qreal yOffset = 0;
            if (fragments[i].rotation == 0) {
                xOffset = fragments[i].x;
                yOffset = fragments[i].y;
            } else {
                transform.translate(fragments[i].x, fragments[i].y);
                transform.rotate(fragments[i].rotation);
            }
            setOpacity(oldOpacity * fragments[i].opacity);
            setTransform(transform);
 
            qreal w = fragments[i].scaleX * fragments[i].width;
            qreal h = fragments[i].scaleY * fragments[i].height;
            QRectF sourceRect(fragments[i].sourceLeft, fragments[i].sourceTop,
                              fragments[i].width, fragments[i].height);
            drawPixmap(QRectF(-0.5 * w + xOffset, -0.5 * h + yOffset, w, h), pixmap, sourceRect);
        }
 
        setOpacity(oldOpacity);
        setTransform(oldTransform);
    }
}
 
/*!
    \since 4.7
    \class QPainter::PixmapFragment
    \inmodule QtGui
 
    \brief This class is used in conjunction with the
    QPainter::drawPixmapFragments() function to specify how a pixmap, or
    sub-rect of a pixmap, is drawn.
 
    The \a sourceLeft, \a sourceTop, \a width and \a height variables are used
    as a source rectangle within the pixmap passed into the
    QPainter::drawPixmapFragments() function. The variables \a x, \a y, \a
    width and \a height are used to calculate the target rectangle that is
    drawn. \a x and \a y denotes the center of the target rectangle. The \a
    width and \a height in the target rectangle is scaled by the \a scaleX and
    \a scaleY values. The resulting target rectangle is then rotated \a
    rotation degrees around the \a x, \a y center point.
 
    \sa QPainter::drawPixmapFragments()
*/
 
/*!
    \since 4.7
 
    This is a convenience function that returns a QPainter::PixmapFragment that is
    initialized with the \a pos, \a sourceRect, \a scaleX, \a scaleY, \a
    rotation, \a opacity parameters.
*/
 
QPainter::PixmapFragment QPainter::PixmapFragment::create(const QPointF &pos, const QRectF &sourceRect,
                                              qreal scaleX, qreal scaleY, qreal rotation,
                                              qreal opacity)
{
    PixmapFragment fragment = {pos.x(), pos.y(), sourceRect.x(), sourceRect.y(), sourceRect.width(),
                               sourceRect.height(), scaleX, scaleY, rotation, opacity};
    return fragment;
}
 
/*!
    \variable QPainter::PixmapFragment::x
    \brief the x coordinate of center point in the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::y
    \brief the y coordinate of the center point in the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::sourceLeft
    \brief the left coordinate of the source rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::sourceTop
    \brief the top coordinate of the source rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::width
 
    \brief the width of the source rectangle and is used to calculate the width
    of the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::height
 
    \brief the height of the source rectangle and is used to calculate the
    height of the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::scaleX
    \brief the horizontal scale of the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::scaleY
    \brief the vertical scale of the target rectangle.
*/
 
/*!
    \variable QPainter::PixmapFragment::rotation
 
    \brief the rotation of the target rectangle in degrees. The target
    rectangle is rotated after it has been scaled.
*/
 
/*!
    \variable QPainter::PixmapFragment::opacity
 
    \brief the opacity of the target rectangle, where 0.0 is fully transparent
    and 1.0 is fully opaque.
*/
 
/*!
    \since 4.7
 
    \enum QPainter::PixmapFragmentHint
 
    \value OpaqueHint Indicates that the pixmap fragments to be drawn are
    opaque. Opaque fragments are potentially faster to draw.
 
    \sa QPainter::drawPixmapFragments(), QPainter::PixmapFragment
*/
 
void qt_draw_helper(QPainterPrivate *p, const QPainterPath &path, QPainterPrivate::DrawOperation operation)
{
    p->draw_helper(path, operation);
}
 
QT_END_NAMESPACE
 
#include "moc_qpainter.cpp"