QGIS API Documentation 3.99.0-Master (8e76e220402)
Loading...
Searching...
No Matches
qgspainteffectregistry.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgspainteffectregistry.cpp
3 ------------------------
4 begin : January 2015
5 copyright : (C) 2015 Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
17
18#include "qgsapplication.h"
19#include "qgsblureffect.h"
20#include "qgscoloreffect.h"
21#include "qgseffectstack.h"
22#include "qgsgloweffect.h"
23#include "qgsshadoweffect.h"
24#include "qgstransformeffect.h"
25
26#include <QString>
27
28using namespace Qt::StringLiterals;
29
36
38{
39 //init registry with known effects
40 addEffectType( new QgsPaintEffectMetadata( u"blur"_s, QObject::tr( "Blur" ),
41 QgsBlurEffect::create, nullptr ) );
42 addEffectType( new QgsPaintEffectMetadata( u"dropShadow"_s, QObject::tr( "Drop Shadow" ),
43 QgsDropShadowEffect::create, nullptr ) );
44 addEffectType( new QgsPaintEffectMetadata( u"innerShadow"_s, QObject::tr( "Inner Shadow" ),
46 addEffectType( new QgsPaintEffectMetadata( u"effectStack"_s, QObject::tr( "Stack" ),
47 QgsEffectStack::create, nullptr ) );
48 addEffectType( new QgsPaintEffectMetadata( u"outerGlow"_s, QObject::tr( "Outer Glow" ),
49 QgsOuterGlowEffect::create, nullptr ) );
50 addEffectType( new QgsPaintEffectMetadata( u"innerGlow"_s, QObject::tr( "Inner Glow" ),
51 QgsInnerGlowEffect::create, nullptr ) );
52 addEffectType( new QgsPaintEffectMetadata( u"drawSource"_s, QObject::tr( "Source" ),
53 QgsDrawSourceEffect::create, nullptr ) );
54 addEffectType( new QgsPaintEffectMetadata( u"transform"_s, QObject::tr( "Transform" ),
55 QgsTransformEffect::create, nullptr ) );
56 addEffectType( new QgsPaintEffectMetadata( u"color"_s, QObject::tr( "Colorise" ),
57 QgsColorEffect::create, nullptr ) );
58}
59
61{
62 qDeleteAll( mMetadata );
63}
64
66{
67 if ( mMetadata.contains( name ) )
68 return mMetadata.value( name );
69 else
70 return nullptr;
71}
72
74{
75 if ( !metadata || mMetadata.contains( metadata->name() ) )
76 return false;
77
78 mMetadata[metadata->name()] = metadata;
79 return true;
80}
81
82QgsPaintEffect *QgsPaintEffectRegistry::createEffect( const QString &name, const QVariantMap &properties ) const
83{
84 if ( !mMetadata.contains( name ) )
85 return nullptr;
86
87 QgsPaintEffect *effect = mMetadata[name]->createPaintEffect( properties );
88 return effect;
89}
90
91QgsPaintEffect *QgsPaintEffectRegistry::createEffect( const QDomElement &element ) const
92{
93 if ( element.isNull() )
94 {
95 return nullptr;
96 }
97
98 const QString type = element.attribute( u"type"_s );
99
101 if ( !effect )
102 return nullptr;
103
104 effect->readProperties( element );
105 return effect;
106}
107
109{
110 QStringList lst;
111 QMap<QString, QgsPaintEffectAbstractMetadata *>::ConstIterator it = mMetadata.begin();
112 for ( ; it != mMetadata.end(); ++it )
113 {
114 lst.append( it.key() );
115 }
116 return lst;
117}
118
120{
121 //NOTE - also remember to update isDefaultStack below if making changes to this list
122 QgsEffectStack *stack = new QgsEffectStack();
123 QgsDropShadowEffect *dropShadow = new QgsDropShadowEffect();
124 dropShadow->setEnabled( false );
125 stack->appendEffect( dropShadow );
126 QgsOuterGlowEffect *outerGlow = new QgsOuterGlowEffect();
127 outerGlow->setEnabled( false );
128 stack->appendEffect( outerGlow );
129 stack->appendEffect( new QgsDrawSourceEffect() );
130 QgsInnerShadowEffect *innerShadow = new QgsInnerShadowEffect();
131 innerShadow->setEnabled( false );
132 stack->appendEffect( innerShadow );
133 QgsInnerGlowEffect *innerGlow = new QgsInnerGlowEffect();
134 innerGlow->setEnabled( false );
135 stack->appendEffect( innerGlow );
136 return stack;
137}
138
140{
141 QgsEffectStack *effectStack = dynamic_cast< QgsEffectStack * >( effect );
142 if ( !effectStack )
143 return false;
144
145 if ( effectStack->count() != 5 )
146 return false;
147
148 for ( int i = 0; i < 5; ++i )
149 {
150 //only the third effect should be enabled
151 if ( effectStack->effect( i )->enabled() != ( i == 2 ) )
152 return false;
153 }
154
155 if ( !dynamic_cast< QgsDropShadowEffect * >( effectStack->effect( 0 ) ) )
156 return false;
157 if ( !dynamic_cast< QgsOuterGlowEffect * >( effectStack->effect( 1 ) ) )
158 return false;
159 if ( !dynamic_cast< QgsDrawSourceEffect * >( effectStack->effect( 2 ) ) )
160 return false;
161 if ( !dynamic_cast< QgsInnerShadowEffect * >( effectStack->effect( 3 ) ) )
162 return false;
163 if ( !dynamic_cast< QgsInnerGlowEffect * >( effectStack->effect( 4 ) ) )
164 return false;
165
166 QgsDrawSourceEffect *sourceEffect = static_cast< QgsDrawSourceEffect * >( effectStack->effect( 2 ) );
167 if ( !qgsDoubleNear( sourceEffect->opacity(), 1.0 ) )
168 return false;
169 if ( sourceEffect->blendMode() != QPainter::CompositionMode_SourceOver )
170 return false;
171
172 //we don't go as far as to check disabled effect's properties
173 return true;
174}
static QgsPaintEffectRegistry * paintEffectRegistry()
Returns the application's paint effect registry, used for managing paint effects.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsBlurEffect effect from a properties string map.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsColorEffect effect from a properties string map.
A paint effect which draws the source picture with minor or no alterations.
QPainter::CompositionMode blendMode() const
Returns the blend mode for the effect.
double opacity() const
Returns the opacity for the effect.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsDrawSource effect from a properties string map.
A paint effect which draws an offset and optionally blurred drop shadow.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsDropShadowEffect effect from a properties string map.
A paint effect which consists of a stack of other chained paint effects.
void appendEffect(QgsPaintEffect *effect)
Appends an effect to the end of the stack.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsEffectStack effect.
int count() const
Returns count of effects contained by the stack.
QgsPaintEffect * effect(int index) const
Returns a pointer to the effect at a specified index within the stack.
A paint effect which draws a glow within a picture.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsInnerGlowEffect effect from a properties string map.
A paint effect which draws an offset and optionally blurred drop shadow within a picture.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsInnerShadowEffect effect from a properties string map.
A paint effect which draws a glow outside of a picture.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsOuterGlowEffect effect from a properties string map.
Stores metadata about a paint effect class.
QString visibleName() const
Returns the user visible string representing the paint effect class.
QString name() const
Returns the unique string representing the paint effect class.
QgsPaintEffectAbstractMetadata(const QString &name, const QString &visibleName)
Construct a new QgsPaintEffectAbstractMetadata.
Convenience metadata class that uses static functions to create an effect and its widget.
QgsPaintEffectAbstractMetadata * effectMetadata(const QString &name) const
Returns the metadata for a specific effect.
QStringList effects() const
Returns a list of known paint effects.
static QgsPaintEffect * defaultStack()
Returns a new effect stack consisting of a sensible selection of default effects.
static bool isDefaultStack(QgsPaintEffect *effect)
Tests whether a paint effect matches the default effects stack.
QgsPaintEffect * createEffect(const QString &name, const QVariantMap &properties=QVariantMap()) const
Creates a new paint effect given the effect name and properties map.
bool addEffectType(QgsPaintEffectAbstractMetadata *metadata)
Registers a new effect type.
Base class for visual effects which can be applied to QPicture drawings.
void setEnabled(bool enabled)
Sets whether the effect is enabled.
virtual void readProperties(const QVariantMap &props)=0
Reads a string map of an effect's properties and restores the effect to the state described by the pr...
virtual void begin(QgsRenderContext &context)
Begins intercepting paint operations to a render context.
bool enabled() const
Returns whether the effect is enabled.
static QgsPaintEffect * create(const QVariantMap &map)
Creates a new QgsTransformEffect effect from a properties string map.
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference).
Definition qgis.h:6935