Base class for paint effect which draw a glow inside or outside a picture. More...

#include <qgsgloweffect.h>

Inheritance diagram for QgsGlowEffect:

[legend]

Public Types
enum	GlowColorType { SingleColor , ColorRamp }
	Color sources for the glow. More...

Public Types inherited from QgsPaintEffect
enum	DrawMode { Modifier , Render , ModifyAndRender }
	Drawing modes for effects. More...

Public Member Functions
	QgsGlowEffect ()

	QgsGlowEffect (const QgsGlowEffect &other)

	~QgsGlowEffect () override

QPainter::CompositionMode	blendMode () const
	Returns the blend mode for the effect.

double	blurLevel () const
	Returns the blur level (radius) for the glow.

const QgsMapUnitScale &	blurMapUnitScale () const
	Returns the map unit scale used for the glow blur strength (radius).

Qgis::RenderUnit	blurUnit () const
	Returns the units used for the glow blur level (radius).

QColor	color () const
	Returns the color for the glow.

GlowColorType	colorType () const
	Returns the color mode used for the glow.

double	opacity () const
	Returns the opacity for the effect.

QgsGlowEffect &	operator= (const QgsGlowEffect &rhs)

QVariantMap	properties () const override
	Returns the properties describing the paint effect encoded in a string format.

QgsColorRamp *	ramp () const
	Returns the color ramp used for the glow.

void	readProperties (const QVariantMap &props) override
	Reads a string map of an effect's properties and restores the effect to the state described by the properties map.

void	setBlendMode (const QPainter::CompositionMode mode)
	Sets the blend mode for the effect.

void	setBlurLevel (const double level)
	Sets blur level (radius) for the glow.

void	setBlurMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale used for the glow blur strength (radius).

void	setBlurUnit (const Qgis::RenderUnit unit)
	Sets the units used for the glow blur level (radius).

void	setColor (const QColor &color)
	Sets the color for the glow.

void	setColorType (GlowColorType colorType)
	Sets the color mode to use for the glow.

void	setOpacity (const double opacity)
	Sets the opacity for the effect.

void	setRamp (QgsColorRamp *ramp)
	Sets the color ramp for the glow.

void	setSpread (const double spread)
	Sets the spread distance for drawing the glow effect.

void	setSpreadMapUnitScale (const QgsMapUnitScale &scale)
	Sets the map unit scale used for the spread distance.

void	setSpreadUnit (const Qgis::RenderUnit unit)
	Sets the units used for the glow spread distance.

double	spread () const
	Returns the spread distance used for drawing the glow effect.

const QgsMapUnitScale &	spreadMapUnitScale () const
	Returns the map unit scale used for the spread distance.

Qgis::RenderUnit	spreadUnit () const
	Returns the units used for the glow spread distance.

Public Member Functions inherited from QgsPaintEffect
	QgsPaintEffect ()=default

	QgsPaintEffect (const QgsPaintEffect &other)

virtual	~QgsPaintEffect ()

virtual void	begin (QgsRenderContext &context)
	Begins intercepting paint operations to a render context.

virtual QgsPaintEffect *	clone () const =0
	Duplicates an effect by creating a deep copy of the effect.

DrawMode	drawMode () const
	Returns the draw mode for the effect.

bool	enabled () const
	Returns whether the effect is enabled.

virtual void	end (QgsRenderContext &context)
	Ends interception of paint operations to a render context, and draws the result to the render context after being modified by the effect.

virtual bool	readProperties (const QDomElement &element)
	Restores the effect to the state described by a DOM element.

virtual void	render (QPicture &picture, QgsRenderContext &context)
	Renders a picture using the effect.

virtual bool	saveProperties (QDomDocument &doc, QDomElement &element) const
	Saves the current state of the effect to a DOM element.

void	setDrawMode (DrawMode drawMode)
	Sets the draw mode for the effect.

void	setEnabled (bool enabled)
	Sets whether the effect is enabled.

virtual QString	type () const =0
	Returns the effect type.

Protected Member Functions
QRectF	boundingRect (const QRectF &rect, const QgsRenderContext &context) const override
	Returns the bounding rect required for drawing the effect.

void	draw (QgsRenderContext &context) override
	Handles drawing of the effect's result on to the specified render context.

virtual bool	shadeExterior () const =0
	Specifies whether the glow is drawn outside the picture or within the picture.

Protected Member Functions inherited from QgsPaintEffect
void	drawSource (QPainter &painter)
	Draws the source QPicture onto the specified painter.

Q_DECL_DEPRECATED void	fixQPictureDpi (QPainter *painter) const
	Applies a workaround to a QPainter to avoid an issue with incorrect scaling when drawing QPictures.

QPointF	imageOffset (const QgsRenderContext &context) const
	Returns the offset which should be used when drawing the source image on to a destination render context.

const QPicture *	source () const
	Returns the source QPicture.

QImage *	sourceAsImage (QgsRenderContext &context)
	Returns the source QPicture rendered to a new QImage.

Protected Attributes
QPainter::CompositionMode	mBlendMode = QPainter::CompositionMode_SourceOver

double	mBlurLevel = 2.645

QgsMapUnitScale	mBlurMapUnitScale

Qgis::RenderUnit	mBlurUnit = Qgis::RenderUnit::Millimeters

QColor	mColor

GlowColorType	mColorType = SingleColor

double	mOpacity = 0.5

QgsColorRamp *	mRamp = nullptr

double	mSpread = 2.0

QgsMapUnitScale	mSpreadMapUnitScale

Qgis::RenderUnit	mSpreadUnit = Qgis::RenderUnit::Millimeters

Protected Attributes inherited from QgsPaintEffect
DrawMode	mDrawMode = ModifyAndRender

bool	mEnabled = true

bool	requiresQPainterDpiFix = true

Detailed Description

Base class for paint effect which draw a glow inside or outside a picture.

Definition at line 37 of file qgsgloweffect.h.

Member Enumeration Documentation

◆ GlowColorType

enum QgsGlowEffect::GlowColorType

Color sources for the glow.

Enumerator
SingleColor	Use a single color and fade the color to totally transparent.
ColorRamp	Use colors from a color ramp.

Definition at line 43 of file qgsgloweffect.h.

Constructor & Destructor Documentation

◆ QgsGlowEffect() [1/2]

QgsGlowEffect::QgsGlowEffect ( )

Definition at line 25 of file qgsgloweffect.cpp.

◆ QgsGlowEffect() [2/2]

QgsGlowEffect::QgsGlowEffect ( const QgsGlowEffect & other )

Definition at line 31 of file qgsgloweffect.cpp.

◆ ~QgsGlowEffect()

QgsGlowEffect::~QgsGlowEffect ( )

override

Definition at line 37 of file qgsgloweffect.cpp.

Member Function Documentation

◆ blendMode()

QPainter::CompositionMode QgsGlowEffect::blendMode ( ) const

inline

Returns the blend mode for the effect.

Returns: blend mode used for drawing the effect on to a destination paint device

See also: setBlendMode

Definition at line 237 of file qgsgloweffect.h.

◆ blurLevel()

double QgsGlowEffect::blurLevel ( ) const

inline

Returns the blur level (radius) for the glow.

Returns: blur level.

See also: setBlurLevel; blurUnit; blurMapUnitScale

Definition at line 127 of file qgsgloweffect.h.

◆ blurMapUnitScale()

const QgsMapUnitScale & QgsGlowEffect::blurMapUnitScale ( ) const

inline

Returns the map unit scale used for the glow blur strength (radius).

Returns: map unit scale for blur strength

See also: setBlurMapUnitScale; blurLevel; blurUnit

Since: QGIS 3.4.9

Definition at line 167 of file qgsgloweffect.h.

◆ blurUnit()

Qgis::RenderUnit QgsGlowEffect::blurUnit ( ) const

inline

Returns the units used for the glow blur level (radius).

Returns: units for blur level

See also: setBlurUnit; blurLevel; blurMapUnitScale

Since: QGIS 3.4.9

Definition at line 147 of file qgsgloweffect.h.

◆ boundingRect()

QRectF QgsGlowEffect::boundingRect	(	const QRectF &	rect,
		const QgsRenderContext &	context
	)		const

overrideprotectedvirtual

Returns the bounding rect required for drawing the effect.

This method can be used to expand the bounding rect of a source picture to account for offset or blurring effects.

Parameters

rect	original source bounding rect
context	destination render context

Returns: modified bounding rect

See also: sourceAsImage

Reimplemented from QgsPaintEffect.

Definition at line 230 of file qgsgloweffect.cpp.

◆ color()

QColor QgsGlowEffect::color ( ) const

inline

Returns the color for the glow.

This only applies if the colorType() is set to SingleColor. The glow will fade between the specified color and a totally transparent version of the color.

Returns: glow color

See also: setColor; colorType

Definition at line 203 of file qgsgloweffect.h.

◆ colorType()

GlowColorType QgsGlowEffect::colorType ( ) const

inline

Returns the color mode used for the glow.

The glow can either be drawn using a QgsColorRamp color ramp or by specificing a single color.

Returns: current color mode used for the glow

See also: setColorType; color; ramp

Definition at line 258 of file qgsgloweffect.h.

◆ draw()

void QgsGlowEffect::draw ( QgsRenderContext & context )

overrideprotectedvirtual

Handles drawing of the effect's result on to the specified render context.

Derived classes must reimplement this method to apply any transformations to the source QPicture and draw the result using the context's painter.

Parameters

context destination render context

See also: drawSource

Implements QgsPaintEffect.

Definition at line 42 of file qgsgloweffect.cpp.

◆ opacity()

double QgsGlowEffect::opacity ( ) const

inline

Returns the opacity for the effect.

Returns: opacity value between 0 and 1 inclusive, where 0 is fully transparent and 1 is fully opaque

See also: setOpacity().

Definition at line 183 of file qgsgloweffect.h.

◆ operator=()

QgsGlowEffect & QgsGlowEffect::operator= ( const QgsGlowEffect & rhs )

Definition at line 208 of file qgsgloweffect.cpp.

◆ properties()

QVariantMap QgsGlowEffect::properties ( ) const

overridevirtual

Returns the properties describing the paint effect encoded in a string format.

Returns: string map of properties, in the form property key, value

See also: readProperties; saveProperties

Implements QgsPaintEffect.

Definition at line 111 of file qgsgloweffect.cpp.

◆ ramp()

QgsColorRamp * QgsGlowEffect::ramp ( ) const

inline

Returns the color ramp used for the glow.

This only applies if the colorType() is set to ColorRamp. The glow will utilize colors from the ramp.

Returns: color ramp for glow

See also: setRamp; colorType

Definition at line 221 of file qgsgloweffect.h.

◆ readProperties()

void QgsGlowEffect::readProperties ( const QVariantMap & props )

overridevirtual

Reads a string map of an effect's properties and restores the effect to the state described by the properties map.

Parameters

props effect properties encoded in a string map

See also: properties

Implements QgsPaintEffect.

Definition at line 135 of file qgsgloweffect.cpp.

◆ setBlendMode()

void QgsGlowEffect::setBlendMode ( const QPainter::CompositionMode mode )

inline

Sets the blend mode for the effect.

Parameters

mode	blend mode used for drawing the effect on to a destination paint device

See also: blendMode

Definition at line 229 of file qgsgloweffect.h.

◆ setBlurLevel()

void QgsGlowEffect::setBlurLevel ( const double level )

inline

Sets blur level (radius) for the glow.

This can be used to smooth the output from the glow effect.

Parameters

level blur level.

See also: blurLevel; setBlurUnit; setBlurMapUnitScale

Definition at line 118 of file qgsgloweffect.h.

◆ setBlurMapUnitScale()

void QgsGlowEffect::setBlurMapUnitScale ( const QgsMapUnitScale & scale )

inline

Sets the map unit scale used for the glow blur strength (radius).

Parameters

scale map unit scale for blur strength

See also: blurMapUnitScale; setBlurLevel; setBlurUnit

Since: QGIS 3.4.9

Definition at line 157 of file qgsgloweffect.h.

◆ setBlurUnit()

void QgsGlowEffect::setBlurUnit ( const Qgis::RenderUnit unit )

inline

Sets the units used for the glow blur level (radius).

Parameters

unit	units for blur level

See also: blurUnit; setBlurLevel; setBlurMapUnitScale

Since: QGIS 3.4.9

Definition at line 137 of file qgsgloweffect.h.

◆ setColor()

void QgsGlowEffect::setColor ( const QColor & color )

inline

Sets the color for the glow.

This only applies if the colorType() is set to SingleColor. The glow will fade between the specified color and a totally transparent version of the color.

Parameters

color glow color

See also: color; setColorType

Definition at line 193 of file qgsgloweffect.h.

◆ setColorType()

void QgsGlowEffect::setColorType ( GlowColorType colorType )

inline

Sets the color mode to use for the glow.

The glow can either be drawn using a QgsColorRamp color ramp or by simply specificing a single color. setColorType is used to specify which mode to use for the glow.

Parameters

colorType color type to use for glow

See also: colorType; setColor; setRamp

Definition at line 248 of file qgsgloweffect.h.

◆ setOpacity()

void QgsGlowEffect::setOpacity ( const double opacity )

inline

Sets the opacity for the effect.

Parameters

opacity double between 0 and 1 inclusive, where 0 is fully transparent and 1 is fully opaque

See also: opacity()

Definition at line 175 of file qgsgloweffect.h.

◆ setRamp()

void QgsGlowEffect::setRamp ( QgsColorRamp * ramp )

Sets the color ramp for the glow.

This only applies if the colorType() is set to ColorRamp. The glow will utilize colors from the ramp.

Parameters

ramp	color ramp for glow. Ownership of the ramp is transferred to the effect.

See also: ramp; setColorType

Definition at line 202 of file qgsgloweffect.cpp.

◆ setSpread()

void QgsGlowEffect::setSpread ( const double spread )

inline

Sets the spread distance for drawing the glow effect.

Parameters

spread spread distance. Units are specified via setSpreadUnit()

See also: spread; setSpreadUnit; setSpreadMapUnitScale

Definition at line 63 of file qgsgloweffect.h.

◆ setSpreadMapUnitScale()

void QgsGlowEffect::setSpreadMapUnitScale ( const QgsMapUnitScale & scale )

inline

Sets the map unit scale used for the spread distance.

Parameters

scale map unit scale for spread distance

See also: spreadMapUnitScale; setSpread; setSpreadUnit

Definition at line 99 of file qgsgloweffect.h.

◆ setSpreadUnit()

void QgsGlowEffect::setSpreadUnit ( const Qgis::RenderUnit unit )

inline

Sets the units used for the glow spread distance.

Parameters

unit	units for spread distance

See also: spreadUnit; setSpread; setSpreadMapUnitScale

Definition at line 81 of file qgsgloweffect.h.

◆ shadeExterior()

virtual bool QgsGlowEffect::shadeExterior ( ) const

protectedpure virtual

Specifies whether the glow is drawn outside the picture or within the picture.

Returns: true if glow is to be drawn outside the picture, or false to draw glow within the picture

Implemented in QgsOuterGlowEffect, and QgsInnerGlowEffect.

◆ spread()

double QgsGlowEffect::spread ( ) const

inline

Returns the spread distance used for drawing the glow effect.

Returns: spread distance. Units are retrieved via spreadUnit()

See also: setSpread; spreadUnit; spreadMapUnitScale

Definition at line 72 of file qgsgloweffect.h.

◆ spreadMapUnitScale()

const QgsMapUnitScale & QgsGlowEffect::spreadMapUnitScale ( ) const

inline

Returns the map unit scale used for the spread distance.

Returns: map unit scale for spread distance

See also: setSpreadMapUnitScale; spread; spreadUnit

Definition at line 108 of file qgsgloweffect.h.

◆ spreadUnit()

Qgis::RenderUnit QgsGlowEffect::spreadUnit ( ) const

inline

Returns the units used for the glow spread distance.

Returns: units for spread distance

See also: setSpreadUnit; spread; spreadMapUnitScale

Definition at line 90 of file qgsgloweffect.h.

Member Data Documentation

◆ mBlendMode

QPainter::CompositionMode QgsGlowEffect::mBlendMode = QPainter::CompositionMode_SourceOver

protected

Definition at line 284 of file qgsgloweffect.h.

◆ mBlurLevel

double QgsGlowEffect::mBlurLevel = 2.645

protected

Definition at line 279 of file qgsgloweffect.h.

◆ mBlurMapUnitScale

QgsMapUnitScale QgsGlowEffect::mBlurMapUnitScale

protected

Definition at line 281 of file qgsgloweffect.h.

◆ mBlurUnit

Qgis::RenderUnit QgsGlowEffect::mBlurUnit = Qgis::RenderUnit::Millimeters

protected

Definition at line 280 of file qgsgloweffect.h.

◆ mColor

QColor QgsGlowEffect::mColor

protected

Definition at line 283 of file qgsgloweffect.h.

◆ mColorType

GlowColorType QgsGlowEffect::mColorType = SingleColor

protected

Definition at line 285 of file qgsgloweffect.h.

◆ mOpacity

double QgsGlowEffect::mOpacity = 0.5

protected

Definition at line 282 of file qgsgloweffect.h.

◆ mRamp

QgsColorRamp* QgsGlowEffect::mRamp = nullptr

protected

Definition at line 278 of file qgsgloweffect.h.

◆ mSpread

double QgsGlowEffect::mSpread = 2.0

protected

Definition at line 275 of file qgsgloweffect.h.

◆ mSpreadMapUnitScale

QgsMapUnitScale QgsGlowEffect::mSpreadMapUnitScale

protected

Definition at line 277 of file qgsgloweffect.h.

◆ mSpreadUnit

Qgis::RenderUnit QgsGlowEffect::mSpreadUnit = Qgis::RenderUnit::Millimeters

protected

Definition at line 276 of file qgsgloweffect.h.

The documentation for this class was generated from the following files:

/build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/core/effects/qgsgloweffect.h
/build/qgis-3.41.0+git20241214+cea29feecf2+99sid/src/core/effects/qgsgloweffect.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ GlowColorType

Constructor & Destructor Documentation

◆ QgsGlowEffect() [1/2]

◆ QgsGlowEffect() [2/2]

◆ ~QgsGlowEffect()

Member Function Documentation

◆ blendMode()

◆ blurLevel()

◆ blurMapUnitScale()

◆ blurUnit()

◆ boundingRect()

◆ color()

◆ colorType()

◆ draw()

◆ opacity()

◆ operator=()

◆ properties()

◆ ramp()

◆ readProperties()

◆ setBlendMode()

◆ setBlurLevel()

◆ setBlurMapUnitScale()

◆ setBlurUnit()

◆ setColor()

◆ setColorType()

◆ setOpacity()

◆ setRamp()

◆ setSpread()

◆ setSpreadMapUnitScale()

◆ setSpreadUnit()

◆ shadeExterior()

◆ spread()

◆ spreadMapUnitScale()

◆ spreadUnit()

Member Data Documentation

◆ mBlendMode

◆ mBlurLevel

◆ mBlurMapUnitScale

◆ mBlurUnit

◆ mColor

◆ mColorType

◆ mOpacity

◆ mRamp

◆ mSpread

◆ mSpreadMapUnitScale

◆ mSpreadUnit