QGIS API Documentation 3.39.0-Master (8f4da32b6b8)
|
Base class for paint effects which offset, blurred shadows. More...
#include <qgsshadoweffect.h>
Public Member Functions | |
QgsShadowEffect () | |
QPainter::CompositionMode | blendMode () const |
Returns the blend mode for the effect. | |
double | blurLevel () const |
Returns the blur level (radius) for the shadow. | |
const QgsMapUnitScale & | blurMapUnitScale () const |
Returns the map unit scale used for the shadow blur strength (radius). | |
Qgis::RenderUnit | blurUnit () const |
Returns the units used for the shadow blur level (radius). | |
QColor | color () const |
Returns the color used for the shadow. | |
int | offsetAngle () const |
Returns the angle used for offsetting the shadow. | |
double | offsetDistance () const |
Returns the distance used for offsetting the shadow. | |
const QgsMapUnitScale & | offsetMapUnitScale () const |
Returns the map unit scale used for the shadow offset distance. | |
Qgis::RenderUnit | offsetUnit () const |
Returns the units used for the shadow offset distance. | |
double | opacity () const |
Returns the opacity for the effect. | |
QVariantMap | properties () const override |
Returns the properties describing the paint effect encoded in a string format. | |
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 shadow. | |
void | setBlurMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale used for the shadow blur strength (radius). | |
void | setBlurUnit (const Qgis::RenderUnit unit) |
Sets the units used for the shadow blur level (radius). | |
void | setColor (const QColor &color) |
Sets the color for the shadow. | |
void | setOffsetAngle (const int angle) |
Sets the angle for offsetting the shadow. | |
void | setOffsetDistance (const double distance) |
Sets the distance for offsetting the shadow. | |
void | setOffsetMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale used for the shadow offset distance. | |
void | setOffsetUnit (const Qgis::RenderUnit unit) |
Sets the units used for the shadow offset distance. | |
void | setOpacity (const double opacity) |
Sets the opacity for the effect. | |
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 | exteriorShadow () const =0 |
Specifies whether the shadow 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_Multiply |
double | mBlurLevel = 2.645 |
QgsMapUnitScale | mBlurMapUnitScale |
Qgis::RenderUnit | mBlurUnit = Qgis::RenderUnit::Millimeters |
QColor | mColor |
int | mOffsetAngle = 135 |
double | mOffsetDist = 2.0 |
QgsMapUnitScale | mOffsetMapUnitScale |
Qgis::RenderUnit | mOffsetUnit = Qgis::RenderUnit::Millimeters |
double | mOpacity = 1.0 |
Protected Attributes inherited from QgsPaintEffect | |
DrawMode | mDrawMode = ModifyAndRender |
bool | mEnabled = true |
bool | requiresQPainterDpiFix = true |
Additional Inherited Members | |
Public Types inherited from QgsPaintEffect | |
enum | DrawMode { Modifier , Render , ModifyAndRender } |
Drawing modes for effects. More... | |
Base class for paint effects which offset, blurred shadows.
Definition at line 35 of file qgsshadoweffect.h.
QgsShadowEffect::QgsShadowEffect | ( | ) |
Definition at line 24 of file qgsshadoweffect.cpp.
|
inline |
Returns the blend mode for the effect.
Definition at line 219 of file qgsshadoweffect.h.
|
inline |
Returns the blur level (radius) for the shadow.
Definition at line 63 of file qgsshadoweffect.h.
|
inline |
Returns the map unit scale used for the shadow blur strength (radius).
Definition at line 103 of file qgsshadoweffect.h.
|
inline |
Returns the units used for the shadow blur level (radius).
Definition at line 83 of file qgsshadoweffect.h.
|
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.
rect | original source bounding rect |
context | destination render context |
Reimplemented from QgsPaintEffect.
Definition at line 175 of file qgsshadoweffect.cpp.
|
inline |
Returns the color used for the shadow.
Definition at line 187 of file qgsshadoweffect.h.
|
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.
context | destination render context |
Implements QgsPaintEffect.
Definition at line 30 of file qgsshadoweffect.cpp.
|
protectedpure virtual |
Specifies whether the shadow is drawn outside the picture or within the picture.
true
if shadow is to be drawn outside the picture, or false
to draw shadow within the picture Implemented in QgsDropShadowEffect, and QgsInnerShadowEffect.
|
inline |
Returns the angle used for offsetting the shadow.
Definition at line 119 of file qgsshadoweffect.h.
|
inline |
Returns the distance used for offsetting the shadow.
Definition at line 137 of file qgsshadoweffect.h.
|
inline |
Returns the map unit scale used for the shadow offset distance.
Definition at line 173 of file qgsshadoweffect.h.
|
inline |
Returns the units used for the shadow offset distance.
Definition at line 155 of file qgsshadoweffect.h.
|
inline |
Returns the opacity for the effect.
Definition at line 203 of file qgsshadoweffect.h.
|
overridevirtual |
Returns the properties describing the paint effect encoded in a string format.
Implements QgsPaintEffect.
Definition at line 101 of file qgsshadoweffect.cpp.
|
overridevirtual |
Reads a string map of an effect's properties and restores the effect to the state described by the properties map.
props | effect properties encoded in a string map |
Implements QgsPaintEffect.
Definition at line 119 of file qgsshadoweffect.cpp.
|
inline |
Sets the blend mode for the effect.
mode | blend mode used for drawing the effect on to a destination paint device |
Definition at line 211 of file qgsshadoweffect.h.
|
inline |
Sets blur level (radius) for the shadow.
level | blur level. values indicating greater blur strength. |
Definition at line 53 of file qgsshadoweffect.h.
|
inline |
Sets the map unit scale used for the shadow blur strength (radius).
scale | map unit scale for blur strength |
Definition at line 93 of file qgsshadoweffect.h.
|
inline |
Sets the units used for the shadow blur level (radius).
unit | units for blur level |
Definition at line 73 of file qgsshadoweffect.h.
|
inline |
Sets the color for the shadow.
color | shadow color |
Definition at line 180 of file qgsshadoweffect.h.
|
inline |
Sets the angle for offsetting the shadow.
angle | offset angle in degrees clockwise from North |
Definition at line 111 of file qgsshadoweffect.h.
|
inline |
Sets the distance for offsetting the shadow.
distance | offset distance. Units are specified via setOffsetUnit() |
Definition at line 128 of file qgsshadoweffect.h.
|
inline |
Sets the map unit scale used for the shadow offset distance.
scale | map unit scale for offset distance |
Definition at line 164 of file qgsshadoweffect.h.
|
inline |
Sets the units used for the shadow offset distance.
unit | units for offset distance |
Definition at line 146 of file qgsshadoweffect.h.
|
inline |
Sets the opacity for the effect.
opacity | double between 0 and 1 inclusive, where 0 is fully transparent and 1 is fully opaque |
Definition at line 195 of file qgsshadoweffect.h.
|
protected |
Definition at line 243 of file qgsshadoweffect.h.
|
protected |
Definition at line 234 of file qgsshadoweffect.h.
|
protected |
Definition at line 236 of file qgsshadoweffect.h.
|
protected |
Definition at line 235 of file qgsshadoweffect.h.
|
protected |
Definition at line 242 of file qgsshadoweffect.h.
|
protected |
Definition at line 237 of file qgsshadoweffect.h.
|
protected |
Definition at line 238 of file qgsshadoweffect.h.
|
protected |
Definition at line 240 of file qgsshadoweffect.h.
|
protected |
Definition at line 239 of file qgsshadoweffect.h.
|
protected |
Definition at line 241 of file qgsshadoweffect.h.