QGraphicsEffect Class

Documentación de funciones miembro

QGraphicsEffect::QGraphicsEffect(QObject *parent = nullptr)

Construye una nueva instancia de QGraphicsEffect con la dirección parent.

[virtual noexcept] QGraphicsEffect::~QGraphicsEffect()

Elimina el efecto de la fuente y destruye el efecto gráfico.

QRectF QGraphicsEffect::boundingRect() const

Devuelve el rectángulo efectivo de este efecto, es decir, el rectángulo de la fuente en coordenadas del dispositivo, ajustado por los márgenes aplicados por el propio efecto.

Véase también boundingRectFor() y updateBoundingRect().

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

Devuelve el rectángulo efectivo para este efecto, dado el rect proporcionado en las coordenadas del dispositivo. Cuando escriba su propio efecto personalizado, debe llamar a updateBoundingRect() siempre que cambie algún parámetro que pueda hacer que esta función devuelva un valor diferente.

Véase también sourceBoundingRect().

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

Esta función virtual pura dibuja el efecto y es llamada cada vez que la fuente necesita ser dibujada.

Reimplemente esta función en una subclase de QGraphicsEffect para proporcionar la implementación de dibujo del efecto, utilizando painter.

Por ejemplo:

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);
    }
    ...
}

Esta función no debe ser llamada explícitamente por el usuario, ya que está pensada sólo para propósitos de reimplementación.

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

Dibuja la fuente directamente usando el painter dado.

Esta función sólo debe invocarse desde QGraphicsEffect::draw().

Por ejemplo:

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

Véase también QGraphicsEffect::draw().

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

Esta señal se emite cada vez que el efecto se activa o desactiva. El parámetro enabled contiene el nuevo estado de activación del efecto.

Véase también isEnabled().

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

Devuelve el rectángulo delimitador de la fuente asignada al system dado.

Llamar a esta función con Qt::DeviceCoordinates fuera de QGraphicsEffect::draw() dará resultados indefinidos, ya que no hay contexto de dispositivo disponible.

Véase también draw().

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

Esta función virtual es llamada por QGraphicsEffect para notificar al efecto que la fuente ha cambiado. Si el efecto aplica alguna caché, ésta debe purgarse para reflejar el nuevo aspecto de la fuente.

En flags se describe lo que ha cambiado.

[protected] bool QGraphicsEffect::sourceIsPixmap() const

Devuelve true si la fuente efectivamente es un pixmap, por ejemplo, un QGraphicsPixmapItem.

Esta función es útil para fines de optimización. Por ejemplo, no tiene sentido dibujar la fuente en coordenadas de dispositivo para evitar el escalado del mapa de píxeles si esta función devuelve true - el mapa de píxeles fuente se escalará de todos modos.

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

Devuelve un mapa de píxeles con la fuente pintada en él.

El parámetro system especifica el sistema de coordenadas que se utilizará para la fuente. El parámetro opcional offset devuelve el desplazamiento en el que debe pintarse el mapa de píxeles utilizando el pintor actual. Para controlar cómo se rellena el mapa de píxeles, utilice el parámetro mode.

El mapa de píxeles devuelto se recorta al rectángulo del dispositivo del pintor actual cuando system es Qt::DeviceCoordinates.

Llamar a esta función con Qt::DeviceCoordinates fuera de QGraphicsEffect::draw() dará resultados indefinidos, ya que no hay contexto de dispositivo disponible.

Véase también draw() y boundingRect().

[slot] void QGraphicsEffect::update()

Programa el redibujado del efecto. Llame a esta función siempre que sea necesario redibujar el efecto. Esta función no provoca el redibujado de la fuente.

Véase también updateBoundingRect().

[protected] void QGraphicsEffect::updateBoundingRect()

Esta función notifica al framework del efecto cuando el rectángulo delimitador del efecto ha cambiado. Como autor de efectos personalizados, debes llamar a esta función siempre que cambies algún parámetro que haga que la función virtual boundingRectFor() devuelva un valor diferente.

Esta función llamará a update() si es necesario.

Véase también boundingRectFor(), boundingRect(), y sourceBoundingRect().