QGraphicsEffect Class

成员函数 文档

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

构建一个新的 QGraphicsEffect 实例，该实例具有指定的parent 。

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

从信号源中移除效果，并破坏 Graphical Effects。

QRectF QGraphicsEffect::boundingRect() const

返回此特效的有效边界矩形，即以设备坐标表示的源边界矩形，并根据特效本身应用的任何边距进行调整。

另请参阅 boundingRectFor() 和updateBoundingRect()。

[virtual] QRectF QGraphicsEffect::boundingRectFor(const QRectF &rect) const

根据所提供的rect 设备坐标，返回此特效的有效边界矩形。在编写自己的自定义特效时，如果参数发生变化，可能导致此函数返回不同的值，这时必须调用updateBoundingRect() 。

另请参阅 sourceBoundingRect()。

[pure virtual protected] void QGraphicsEffect::draw(QPainter *painter)

这个纯虚拟函数用于绘制效果，每当需要绘制源时都会被调用。

请在QGraphicsEffect 子类中重新实现该函数，以便使用painter 实现效果绘制。

例如

MyGraphicsEffect::draw(QPainter *painter)
{
    ...
    QPoint offset;
    if (sourceIsPixmap()) {
        // No point in drawing in device coordinates (pixmap will be scaled anyways).
        const QPixmap pixmap = sourcePixmap(Qt::LogicalCoordinates, &offset);
        ...
        painter->drawPixmap(offset, pixmap);
    } else {
        // Draw pixmap in device coordinates to avoid pixmap scaling;
        const QPixmap pixmap = sourcePixmap(Qt::DeviceCoordinates, &offset);
        painter->setWorldTransform(QTransform());
        ...
        painter->drawPixmap(offset, pixmap);
    }
    ...
}

用户不应明确调用此函数，因为它仅用于重新实现。

[protected] void QGraphicsEffect::drawSource(QPainter *painter)

使用给定的painter 直接绘制源文件。

该函数只能从QGraphicsEffect::draw() 中调用。

例如

MyGraphicsOpacityEffect::draw(QPainter *painter)
{
    // Fully opaque; draw directly without going through a pixmap.
    if (qFuzzyCompare(m_opacity, 1)) {
        drawSource(painter);
        return;
    }
    ...
}

另请参见 QGraphicsEffect::draw().

[signal] void QGraphicsEffect::enabledChanged(bool enabled)

每当特效启用或禁用时，都会发出该信号。enabled 参数包含特效的新启用状态。

另请参阅 isEnabled().

[protected] QRectF QGraphicsEffect::sourceBoundingRect(Qt::CoordinateSystem system = Qt::LogicalCoordinates) const

返回映射到给定system 的源的边界矩形。

在QGraphicsEffect::draw() 之外使用Qt::DeviceCoordinates 调用此函数将产生未定义的结果，因为没有可用的设备上下文。

另请参见 draw()。

[virtual protected] void QGraphicsEffect::sourceChanged(QGraphicsEffect::ChangeFlags flags)

QGraphicsEffect 调用此虚函数，通知效果源已更改。如果效果应用了缓存，则必须清除缓存以反映源的新外观。

flags 会描述发生了哪些变化。

[protected] bool QGraphicsEffect::sourceIsPixmap() const

如果源有效为像素图，如QGraphicsPixmapItem ，则返回true 。

此函数对优化非常有用。例如，如果该函数返回true ，那么以设备坐标绘制源以避免像素图缩放就没有意义了--无论如何，源像素图都会被缩放。

[protected] QPixmap QGraphicsEffect::sourcePixmap(Qt::CoordinateSystem system = Qt::LogicalCoordinates, QPoint *offset = nullptr, QGraphicsEffect::PixmapPadMode mode = PadToEffectiveBoundingRect) const

返回绘有源图像的像素图。

system 指定了源要使用的坐标系。可选的offset 参数会返回使用当前绘制器绘制像素图时的偏移量。要控制像素图的填充方式，请使用mode 参数。

当system 为Qt::DeviceCoordinates 时，返回的像素图将被剪切到当前绘制器的设备矩形内。

在QGraphicsEffect::draw() 之外使用Qt::DeviceCoordinates 调用此函数将产生未定义的结果，因为没有可用的设备上下文。

另请参阅 draw() 和boundingRect()。

[slot] void QGraphicsEffect::update()

安排重绘效果。在需要重绘效果时调用此函数。此函数不会触发源的重绘。

另请参阅 updateBoundingRect()。

[protected] void QGraphicsEffect::updateBoundingRect()

当特效的边界矩形发生变化时，该函数会通知特效框架。作为自定义特效的制作者，每当您更改任何会导致虚拟boundingRectFor() 函数返回不同值的参数时，都必须调用此函数。

如有必要，该函数将调用update() 。

另请参阅 boundingRectFor()、boundingRect() 和sourceBoundingRect()。