QGraphicsColorizeEffect Class

The QGraphicsColorizeEffect class provides a colorize effect. More...

Header: #include <QGraphicsColorizeEffect>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QGraphicsEffect

Properties

Public Functions

QGraphicsColorizeEffect(QObject *parent = nullptr)
virtual ~QGraphicsColorizeEffect()
QColor color() const
qreal strength() const

Public Slots

void setColor(const QColor &c)
void setStrength(qreal strength)

Signals

void colorChanged(const QColor &color)
void strengthChanged(qreal strength)

Reimplemented Protected Functions

virtual void draw(QPainter *painter) override

Detailed Description

A colorize effect renders the source with a tint of its color(). The color can be modified using the setColor() function.

By default, the color is light blue (QColor(0, 0, 192)).

Blue color effect on an image of a fish

See also QGraphicsDropShadowEffect, QGraphicsBlurEffect, and QGraphicsOpacityEffect.

Property Documentation

color : QColor

This property holds the color of the effect.

By default, the color is light blue (QColor(0, 0, 192)).

Access functions:

QColor color() const
void setColor(const QColor &c)

Notifier signal:

void colorChanged(const QColor &color)

strength : qreal

This property holds the strength of the effect.

By default, the strength is 1.0. A strength 0.0 equals to no effect, while 1.0 means full colorization.

Access functions:

qreal strength() const
void setStrength(qreal strength)

Notifier signal:

void strengthChanged(qreal strength)

Member Function Documentation

QGraphicsColorizeEffect::QGraphicsColorizeEffect(QObject *parent = nullptr)

Constructs a new QGraphicsColorizeEffect instance. The parent parameter is passed to QGraphicsEffect's constructor.

[virtual noexcept] QGraphicsColorizeEffect::~QGraphicsColorizeEffect()

Destroys the effect.

[signal] void QGraphicsColorizeEffect::colorChanged(const QColor &color)

This signal is emitted whenever the effect's color changes. The color parameter holds the effect's new color.

Note: Notifier signal for property color.

[override virtual protected] void QGraphicsColorizeEffect::draw(QPainter *painter)

Reimplements: QGraphicsEffect::draw(QPainter *painter).

[signal] void QGraphicsColorizeEffect::strengthChanged(qreal strength)

This signal is emitted whenever setStrength() changes the colorize strength property. strength contains the new strength value of the colorize effect.

Note: Notifier signal for property strength.