QGraphicsEffect Class

멤버 함수 설명서

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

지정된 parent 을 갖는 새로운 QGraphicsEffect 인스턴스를 생성합니다.

[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 를 사용하여 이펙트의 렌더링 구현을 제공하십시오.

예를 들어:

void 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() 내에서만 호출되어야 합니다.

예:

void 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 인 경우, 반환된 픽스맵은 현재 페인터의 디바이스 사각형으로 잘립니다.

Qt::DeviceCoordinates 가 QGraphicsEffect::draw() 외부에서 이 함수를 호출하면 사용 가능한 디바이스 컨텍스트가 없으므로 정의되지 않은 결과가 반환됩니다.

draw() 및 boundingRect()도 참조하십시오 .

[slot] void QGraphicsEffect::update()

이펙트의 다시 그리기를 예약합니다. 이펙트를 다시 그려야 할 때마다 이 함수를 호출하십시오. 이 함수는 소스의 다시 그리기를 트리거하지 않습니다.

updateBoundingRect()도 참조하십시오 .

[protected] void QGraphicsEffect::updateBoundingRect()

이 함수는 이펙트의 경계 사각형이 변경되었을 때 이펙트 프레임워크에 이를 알립니다. 사용자 정의 이펙트 제작자는 가상 함수 ` boundingRectFor()`가 다른 값을 반환하게 되는 매개변수를 변경할 때마다 이 함수를 호출해야 합니다.

이 함수는 필요한 경우 update()을 호출합니다.

boundingRectFor(), boundingRect(), sourceBoundingRect()도 참조하십시오 .