QGIS API Documentation  3.16.0-Hannover (43b64b13f3)
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsOuterGlowEffect Class Reference

A paint effect which draws a glow outside of a picture. More...

#include <qgsgloweffect.h>

Inheritance diagram for QgsOuterGlowEffect:
Inheritance graph
[legend]

Public Member Functions

 QgsOuterGlowEffect ()
 
QgsOuterGlowEffectclone () const override
 Duplicates an effect by creating a deep copy of the effect. More...
 
QString type () const override
 Returns the effect type. More...
 
- Public Member Functions inherited from QgsGlowEffect
 QgsGlowEffect ()
 
 QgsGlowEffect (const QgsGlowEffect &other)
 
 ~QgsGlowEffect () override
 
QPainter::CompositionMode blendMode () const
 Returns the blend mode for the effect. More...
 
double blurLevel () const
 Returns the blur level (radius) for the glow. More...
 
const QgsMapUnitScaleblurMapUnitScale () const
 Returns the map unit scale used for the glow blur strength (radius). More...
 
QgsUnitTypes::RenderUnit blurUnit () const
 Returns the units used for the glow blur level (radius). More...
 
QColor color () const
 Returns the color for the glow. More...
 
GlowColorType colorType () const
 Returns the color mode used for the glow. More...
 
double opacity () const
 Returns the opacity for the effect. More...
 
QgsGlowEffectoperator= (const QgsGlowEffect &rhs)
 
QgsStringMap properties () const override
 Returns the properties describing the paint effect encoded in a string format. More...
 
QgsColorRampramp () const
 Returns the color ramp used for the glow. More...
 
void readProperties (const QgsStringMap &props) override
 Reads a string map of an effect's properties and restores the effect to the state described by the properties map. More...
 
void setBlendMode (const QPainter::CompositionMode mode)
 Sets the blend mode for the effect. More...
 
void setBlurLevel (const double level)
 Sets blur level (radius) for the glow. More...
 
void setBlurMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale used for the glow blur strength (radius). More...
 
void setBlurUnit (const QgsUnitTypes::RenderUnit unit)
 Sets the units used for the glow blur level (radius). More...
 
void setColor (const QColor &color)
 Sets the color for the glow. More...
 
void setColorType (GlowColorType colorType)
 Sets the color mode to use for the glow. More...
 
void setOpacity (const double opacity)
 Sets the opacity for the effect. More...
 
void setRamp (QgsColorRamp *ramp)
 Sets the color ramp for the glow. More...
 
void setSpread (const double spread)
 Sets the spread distance for drawing the glow effect. More...
 
void setSpreadMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale used for the spread distance. More...
 
void setSpreadUnit (const QgsUnitTypes::RenderUnit unit)
 Sets the units used for the glow spread distance. More...
 
double spread () const
 Returns the spread distance used for drawing the glow effect. More...
 
const QgsMapUnitScalespreadMapUnitScale () const
 Returns the map unit scale used for the spread distance. More...
 
QgsUnitTypes::RenderUnit spreadUnit () const
 Returns the units used for the glow spread distance. More...
 
- Public Member Functions inherited from QgsPaintEffect
 QgsPaintEffect ()=default
 Constructor for QgsPaintEffect. More...
 
 QgsPaintEffect (const QgsPaintEffect &other)
 
virtual ~QgsPaintEffect ()
 
virtual void begin (QgsRenderContext &context)
 Begins intercepting paint operations to a render context. More...
 
DrawMode drawMode () const
 Returns the draw mode for the effect. More...
 
bool enabled () const
 Returns whether the effect is enabled. More...
 
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. More...
 
virtual bool readProperties (const QDomElement &element)
 Restores the effect to the state described by a DOM element. More...
 
virtual void render (QPicture &picture, QgsRenderContext &context)
 Renders a picture using the effect. More...
 
virtual bool saveProperties (QDomDocument &doc, QDomElement &element) const
 Saves the current state of the effect to a DOM element. More...
 
void setDrawMode (DrawMode drawMode)
 Sets the draw mode for the effect. More...
 
void setEnabled (bool enabled)
 Sets whether the effect is enabled. More...
 

Static Public Member Functions

static QgsPaintEffectcreate (const QgsStringMap &map)
 Creates a new QgsOuterGlowEffect effect from a properties string map. More...
 

Protected Member Functions

bool shadeExterior () const override
 Specifies whether the glow is drawn outside the picture or within the picture. More...
 
- Protected Member Functions inherited from QgsGlowEffect
QRectF boundingRect (const QRectF &rect, const QgsRenderContext &context) const override
 Returns the bounding rect required for drawing the effect. More...
 
void draw (QgsRenderContext &context) override
 Handles drawing of the effect's result on to the specified render context. More...
 
- Protected Member Functions inherited from QgsPaintEffect
void drawSource (QPainter &painter)
 Draws the source QPicture onto the specified painter. More...
 
void fixQPictureDpi (QPainter *painter) const
 Applies a workaround to a QPainter to avoid an issue with incorrect scaling when drawing QPictures. More...
 
QPointF imageOffset (const QgsRenderContext &context) const
 Returns the offset which should be used when drawing the source image on to a destination render context. More...
 
const QPicture * source () const
 Returns the source QPicture. More...
 
QImage * sourceAsImage (QgsRenderContext &context)
 Returns the source QPicture rendered to a new QImage. More...
 

Additional Inherited Members

- Public Types inherited from QgsGlowEffect
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...
 
- Protected Attributes inherited from QgsGlowEffect
QPainter::CompositionMode mBlendMode = QPainter::CompositionMode_SourceOver
 
double mBlurLevel = 2.645
 
QgsMapUnitScale mBlurMapUnitScale
 
QgsUnitTypes::RenderUnit mBlurUnit = QgsUnitTypes::RenderMillimeters
 
QColor mColor
 
GlowColorType mColorType = SingleColor
 
double mOpacity = 0.5
 
QgsColorRampmRamp = nullptr
 
double mSpread = 2.0
 
QgsMapUnitScale mSpreadMapUnitScale
 
QgsUnitTypes::RenderUnit mSpreadUnit = QgsUnitTypes::RenderMillimeters
 
- Protected Attributes inherited from QgsPaintEffect
DrawMode mDrawMode = ModifyAndRender
 
bool mEnabled = true
 
bool requiresQPainterDpiFix = true
 

Detailed Description

A paint effect which draws a glow outside of a picture.

Since
QGIS 2.9

Definition at line 299 of file qgsgloweffect.h.

Constructor & Destructor Documentation

◆ QgsOuterGlowEffect()

QgsOuterGlowEffect::QgsOuterGlowEffect ( )

Definition at line 238 of file qgsgloweffect.cpp.

Member Function Documentation

◆ clone()

QgsOuterGlowEffect * QgsOuterGlowEffect::clone ( ) const
overridevirtual

Duplicates an effect by creating a deep copy of the effect.

Returns
clone of paint effect

Implements QgsPaintEffect.

Definition at line 251 of file qgsgloweffect.cpp.

◆ create()

QgsPaintEffect * QgsOuterGlowEffect::create ( const QgsStringMap map)
static

Creates a new QgsOuterGlowEffect effect from a properties string map.

Parameters
mapencoded properties string map
Returns
new QgsOuterGlowEffect

Definition at line 244 of file qgsgloweffect.cpp.

◆ shadeExterior()

bool QgsOuterGlowEffect::shadeExterior ( ) const
inlineoverrideprotectedvirtual

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

Implements QgsGlowEffect.

Definition at line 318 of file qgsgloweffect.h.

◆ type()

QString QgsOuterGlowEffect::type ( ) const
inlineoverridevirtual

Returns the effect type.

Returns
unique string representation of the effect type

Implements QgsPaintEffect.

Definition at line 313 of file qgsgloweffect.h.


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