QGIS API Documentation 3.41.0-Master (45a0abf3bec)
|
A paint effect which draws the source picture with minor or no alterations. More...
#include <qgspainteffect.h>
Public Member Functions | |
QgsDrawSourceEffect ()=default | |
QPainter::CompositionMode | blendMode () const |
Returns the blend mode for the effect. | |
QgsDrawSourceEffect * | clone () const override |
Duplicates an effect by creating a deep copy of the effect. | |
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 | setOpacity (const double opacity) |
Sets the opacity for the effect. | |
QString | type () const override |
Returns the effect type. | |
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. | |
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. | |
Static Public Member Functions | |
static QgsPaintEffect * | create (const QVariantMap &map) |
Creates a new QgsDrawSource effect from a properties string map. | |
Protected Member Functions | |
void | draw (QgsRenderContext &context) override |
Handles drawing of the effect's result on to the specified render context. | |
Protected Member Functions inherited from QgsPaintEffect | |
virtual QRectF | boundingRect (const QRectF &rect, const QgsRenderContext &context) const |
Returns the bounding rect required for drawing the effect. | |
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. | |
Additional Inherited Members | |
Public Types inherited from QgsPaintEffect | |
enum | DrawMode { Modifier , Render , ModifyAndRender } |
Drawing modes for effects. More... | |
Protected Attributes inherited from QgsPaintEffect | |
DrawMode | mDrawMode = ModifyAndRender |
bool | mEnabled = true |
bool | requiresQPainterDpiFix = true |
A paint effect which draws the source picture with minor or no alterations.
The draw source effect can be used to draw an unaltered copy of the original source picture. Minor changes like lowering the opacity and applying a blend mode are supported, however these changes will force the resultant output to be rasterized. If no alterations are performed then the original picture will be rendered as a vector.
Definition at line 324 of file qgspainteffect.h.
|
default |
|
inline |
Returns the blend mode for the effect.
Definition at line 372 of file qgspainteffect.h.
|
overridevirtual |
Duplicates an effect by creating a deep copy of the effect.
Implements QgsPaintEffect.
Definition at line 223 of file qgspainteffect.cpp.
|
static |
Creates a new QgsDrawSource effect from a properties string map.
map | encoded properties string map |
Definition at line 193 of file qgspainteffect.cpp.
|
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 200 of file qgspainteffect.cpp.
|
inline |
Returns the opacity for the effect.
Definition at line 356 of file qgspainteffect.h.
|
overridevirtual |
Returns the properties describing the paint effect encoded in a string format.
Implements QgsPaintEffect.
Definition at line 228 of file qgspainteffect.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 238 of file qgspainteffect.cpp.
|
inline |
Sets the blend mode for the effect.
mode | blend mode used for drawing the source on to a destination paint device |
Definition at line 364 of file qgspainteffect.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 348 of file qgspainteffect.h.
|
inlineoverridevirtual |
Returns the effect type.
Implements QgsPaintEffect.
Definition at line 337 of file qgspainteffect.h.