QGIS API Documentation  2.12.0-Lyon
Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsDropShadowEffect Class Reference

A paint effect which draws an offset and optionally blurred drop shadow. More...

#include <qgsshadoweffect.h>

Inheritance diagram for QgsDropShadowEffect:
Inheritance graph
[legend]

Public Member Functions

 QgsDropShadowEffect ()
 
virtual ~QgsDropShadowEffect ()
 
virtual QgsPaintEffectclone () const override
 Duplicates an effect by creating a deep copy of the effect. More...
 
virtual QString type () const override
 Returns the effect type. More...
 
- Public Member Functions inherited from QgsShadowEffect
 QgsShadowEffect ()
 
virtual ~QgsShadowEffect ()
 
QPainter::CompositionMode blendMode () const
 Returns the blend mode for the effect. More...
 
int blurLevel () const
 Returns the blur level (strength) for the shadow. More...
 
QColor color () const
 Returns the color used for the shadow. More...
 
int offsetAngle () const
 Returns the angle used for offsetting the shadow. More...
 
double offsetDistance () const
 Returns the distance used for offsetting the shadow. More...
 
const QgsMapUnitScaleoffsetMapUnitScale () const
 Returns the map unit scale used for the shadow offset distance. More...
 
QgsSymbolV2::OutputUnit offsetUnit () const
 Returns the units used for the shadow offset distance. More...
 
virtual QgsStringMap properties () const override
 Returns the properties describing the paint effect encoded in a string format. More...
 
virtual 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 int level)
 Sets blur level (strength) for the shadow. More...
 
void setColor (const QColor &color)
 Sets the color for the shadow. More...
 
void setOffsetAngle (const int angle)
 Sets the angle for offsetting the shadow. More...
 
void setOffsetDistance (const double distance)
 Sets the distance for offsetting the shadow. More...
 
void setOffsetMapUnitScale (const QgsMapUnitScale &scale)
 Sets the map unit scale used for the shadow offset distance. More...
 
void setOffsetUnit (const QgsSymbolV2::OutputUnit unit)
 Sets the units used for the shadow offset distance. More...
 
void setTransparency (const double transparency)
 Sets the transparency for the effect. More...
 
double transparency () const
 Returns the transparency for the effect. More...
 
- Public Member Functions inherited from QgsPaintEffect
 QgsPaintEffect ()
 
 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 (const DrawMode drawMode)
 Sets the draw mode for the effect. More...
 
void setEnabled (const bool enabled)
 Sets whether the effect is enabled. More...
 

Static Public Member Functions

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

Protected Member Functions

virtual bool exteriorShadow () const override
 Specifies whether the shadow is drawn outside the picture or within the picture. More...
 
- Protected Member Functions inherited from QgsShadowEffect
virtual QRectF boundingRect (const QRectF &rect, const QgsRenderContext &context) const override
 Returns the bounding rect required for drawing the effect. More...
 
virtual 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 QPicturesource () const
 Returns the source QPicture. More...
 
QImagesourceAsImage (QgsRenderContext &context)
 Returns the source QPicture rendered to a new QImage. More...
 

Additional Inherited Members

- Public Types inherited from QgsPaintEffect
enum  DrawMode { Modifier, Render, ModifyAndRender }
 Drawing modes for effects. More...
 
- Protected Attributes inherited from QgsShadowEffect
QPainter::CompositionMode mBlendMode
 
int mBlurLevel
 
QColor mColor
 
int mOffsetAngle
 
double mOffsetDist
 
QgsMapUnitScale mOffsetMapUnitScale
 
QgsSymbolV2::OutputUnit mOffsetUnit
 
double mTransparency
 
- Protected Attributes inherited from QgsPaintEffect
DrawMode mDrawMode
 
bool mEnabled
 
bool requiresQPainterDpiFix
 

Detailed Description

A paint effect which draws an offset and optionally blurred drop shadow.

Note
Added in version 2.9

Definition at line 189 of file qgsshadoweffect.h.

Constructor & Destructor Documentation

QgsDropShadowEffect::QgsDropShadowEffect ( )

Definition at line 170 of file qgsshadoweffect.cpp.

QgsDropShadowEffect::~QgsDropShadowEffect ( )
virtual

Definition at line 176 of file qgsshadoweffect.cpp.

Member Function Documentation

QgsPaintEffect * QgsDropShadowEffect::clone ( ) const
overridevirtual

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

Returns
clone of paint effect

Implements QgsPaintEffect.

Definition at line 181 of file qgsshadoweffect.cpp.

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

Creates a new QgsDropShadowEffect effect from a properties string map.

Parameters
mapencoded properties string map
Returns
new QgsDropShadowEffect

Definition at line 163 of file qgsshadoweffect.cpp.

virtual bool QgsDropShadowEffect::exteriorShadow ( ) const
inlineoverrideprotectedvirtual

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

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

Implements QgsShadowEffect.

Definition at line 208 of file qgsshadoweffect.h.

virtual QString QgsDropShadowEffect::type ( ) const
inlineoverridevirtual

Returns the effect type.

Returns
unique string representation of the effect type

Implements QgsPaintEffect.

Definition at line 203 of file qgsshadoweffect.h.


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