QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgspainting.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgspainting.cpp
3 ---------------------
4 begin : July 2016
5 copyright : (C) 2016 by Martin Dobias
6 email : wonder dot sk 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
16#include "qgspainting.h"
17#include "qgslogger.h"
18
19#include <QTransform>
20
21QPainter::CompositionMode QgsPainting::getCompositionMode( Qgis::BlendMode blendMode )
22{
23 // Map Qgis::BlendMode::Normal to QPainter::CompositionMode
24 switch ( blendMode )
25 {
26 case Qgis::BlendMode::Normal:
27 return QPainter::CompositionMode_SourceOver;
28 case Qgis::BlendMode::Lighten:
29 return QPainter::CompositionMode_Lighten;
30 case Qgis::BlendMode::Screen:
31 return QPainter::CompositionMode_Screen;
32 case Qgis::BlendMode::Dodge:
33 return QPainter::CompositionMode_ColorDodge;
34 case Qgis::BlendMode::Addition:
35 return QPainter::CompositionMode_Plus;
36 case Qgis::BlendMode::Darken:
37 return QPainter::CompositionMode_Darken;
38 case Qgis::BlendMode::Multiply:
39 return QPainter::CompositionMode_Multiply;
40 case Qgis::BlendMode::Burn:
41 return QPainter::CompositionMode_ColorBurn;
42 case Qgis::BlendMode::Overlay:
43 return QPainter::CompositionMode_Overlay;
44 case Qgis::BlendMode::SoftLight:
45 return QPainter::CompositionMode_SoftLight;
46 case Qgis::BlendMode::HardLight:
47 return QPainter::CompositionMode_HardLight;
48 case Qgis::BlendMode::Difference:
49 return QPainter::CompositionMode_Difference;
50 case Qgis::BlendMode::Subtract:
51 return QPainter::CompositionMode_Exclusion;
52 case Qgis::BlendMode::Source:
53 return QPainter::CompositionMode_Source;
54 case Qgis::BlendMode::DestinationOver:
55 return QPainter::CompositionMode_DestinationOver;
56 case Qgis::BlendMode::Clear:
57 return QPainter::CompositionMode_Clear;
58 case Qgis::BlendMode::Destination:
59 return QPainter::CompositionMode_Destination;
60 case Qgis::BlendMode::SourceIn:
61 return QPainter::CompositionMode_SourceIn;
62 case Qgis::BlendMode::DestinationIn:
63 return QPainter::CompositionMode_DestinationIn;
64 case Qgis::BlendMode::SourceOut:
65 return QPainter::CompositionMode_SourceOut;
66 case Qgis::BlendMode::DestinationOut:
67 return QPainter::CompositionMode_DestinationOut;
68 case Qgis::BlendMode::SourceAtop:
69 return QPainter::CompositionMode_SourceAtop;
70 case Qgis::BlendMode::DestinationAtop:
71 return QPainter::CompositionMode_DestinationAtop;
72 case Qgis::BlendMode::Xor:
73 return QPainter::CompositionMode_Xor;
74 default:
75 QgsDebugError( QStringLiteral( "Blend mode %1 mapped to SourceOver" ).arg( qgsEnumValueToKey( blendMode ) ) );
76 return QPainter::CompositionMode_SourceOver;
77 }
78}
79
80
81Qgis::BlendMode QgsPainting::getBlendModeEnum( QPainter::CompositionMode blendMode )
82{
83 // Map QPainter::CompositionMode to Qgis::BlendMode::Normal
84 switch ( blendMode )
85 {
86 case QPainter::CompositionMode_SourceOver:
87 return Qgis::BlendMode::Normal;
88 case QPainter::CompositionMode_Lighten:
89 return Qgis::BlendMode::Lighten;
90 case QPainter::CompositionMode_Screen:
91 return Qgis::BlendMode::Screen;
92 case QPainter::CompositionMode_ColorDodge:
93 return Qgis::BlendMode::Dodge;
94 case QPainter::CompositionMode_Plus:
95 return Qgis::BlendMode::Addition;
96 case QPainter::CompositionMode_Darken:
97 return Qgis::BlendMode::Darken;
98 case QPainter::CompositionMode_Multiply:
99 return Qgis::BlendMode::Multiply;
100 case QPainter::CompositionMode_ColorBurn:
101 return Qgis::BlendMode::Burn;
102 case QPainter::CompositionMode_Overlay:
103 return Qgis::BlendMode::Overlay;
104 case QPainter::CompositionMode_SoftLight:
105 return Qgis::BlendMode::SoftLight;
106 case QPainter::CompositionMode_HardLight:
107 return Qgis::BlendMode::HardLight;
108 case QPainter::CompositionMode_Difference:
109 return Qgis::BlendMode::Difference;
110 case QPainter::CompositionMode_Exclusion:
111 return Qgis::BlendMode::Subtract;
112 case QPainter::CompositionMode_Source:
113 return Qgis::BlendMode::Source;
114 case QPainter::CompositionMode_DestinationOver:
115 return Qgis::BlendMode::DestinationOver;
116 case QPainter::CompositionMode_Clear:
117 return Qgis::BlendMode::Clear;
118 case QPainter::CompositionMode_Destination:
119 return Qgis::BlendMode::Destination;
120 case QPainter::CompositionMode_SourceIn:
121 return Qgis::BlendMode::SourceIn;
122 case QPainter::CompositionMode_DestinationIn:
123 return Qgis::BlendMode::DestinationIn;
124 case QPainter::CompositionMode_SourceOut:
125 return Qgis::BlendMode::SourceOut;
126 case QPainter::CompositionMode_DestinationOut:
127 return Qgis::BlendMode::DestinationOut;
128 case QPainter::CompositionMode_SourceAtop:
129 return Qgis::BlendMode::SourceAtop;
130 case QPainter::CompositionMode_DestinationAtop:
131 return Qgis::BlendMode::DestinationAtop;
132 case QPainter::CompositionMode_Xor:
133 return Qgis::BlendMode::Xor;
134 default:
135 QgsDebugError( QStringLiteral( "Composition mode %1 mapped to Normal" ).arg( blendMode ) );
136 return Qgis::BlendMode::Normal;
137 }
138}
139
140bool QgsPainting::isClippingMode( Qgis::BlendMode mode )
141{
142 switch ( mode )
143 {
144 case Qgis::BlendMode::Normal:
145 case Qgis::BlendMode::Lighten:
146 case Qgis::BlendMode::Screen:
147 case Qgis::BlendMode::Dodge:
148 case Qgis::BlendMode::Addition:
149 case Qgis::BlendMode::Darken:
150 case Qgis::BlendMode::Multiply:
151 case Qgis::BlendMode::Burn:
152 case Qgis::BlendMode::Overlay:
153 case Qgis::BlendMode::SoftLight:
154 case Qgis::BlendMode::HardLight:
155 case Qgis::BlendMode::Difference:
156 case Qgis::BlendMode::Subtract:
157 case Qgis::BlendMode::Source:
158 case Qgis::BlendMode::DestinationOver:
159 case Qgis::BlendMode::Clear:
160 case Qgis::BlendMode::Destination:
161 return false;
162
163 case Qgis::BlendMode::SourceIn:
164 case Qgis::BlendMode::DestinationIn:
165 case Qgis::BlendMode::SourceOut:
166 case Qgis::BlendMode::DestinationOut:
167 case Qgis::BlendMode::SourceAtop:
168 case Qgis::BlendMode::DestinationAtop:
169 case Qgis::BlendMode::Xor:
170 return true;
171 }
172 return false;
173}
174
175QTransform QgsPainting::triangleToTriangleTransform( double inX1, double inY1, double inX2, double inY2, double inX3, double inY3, double outX1, double outY1, double outX2, double outY2, double outX3, double outY3, bool &ok )
176{
177 // QTransform maps points using X' = X * T (not X' = T * X !)
178 // So we are trying to solve the equation: U * T = V, where U = input triangle and V = output triangle
179 // Hence T = U^(-1) * V
180
181 const QTransform U(
182 inX1, inY1, 1,
183 inX2, inY2, 1,
184 inX3, inY3, 1 );
185
186 const QTransform V(
187 outX1, outY1, 1,
188 outX2, outY2, 1,
189 outX3, outY3, 1
190 );
191
192 return ( U.inverted( &ok ) ) * V;
193}
194
195bool QgsPainting::drawTriangleUsingTexture( QPainter *painter, const QPolygonF &triangle, const QImage &textureImage, float textureX1, float textureY1, float textureX2, float textureY2, float textureX3, float textureY3 )
196{
197 bool ok = false;
198 const QTransform brushTransform = triangleToTriangleTransform(
199 textureX1 * ( textureImage.width() - 1 ), textureY1 * ( textureImage.height() - 1 ),
200 textureX2 * ( textureImage.width() - 1 ), textureY2 * ( textureImage.height() - 1 ),
201 textureX3 * ( textureImage.width() - 1 ), textureY3 * ( textureImage.height() - 1 ),
202 triangle.at( 0 ).x(), triangle.at( 0 ).y(),
203 triangle.at( 1 ).x(), triangle.at( 1 ).y(),
204 triangle.at( 2 ).x(), triangle.at( 2 ).y(),
205 ok
206 );
207 if ( !ok )
208 return false;
209
210 // only store/restore the painter's current brush -- this is cheaper than saving/restoring the whole painter state
211 const QBrush previousBrush = painter->brush();
212
213 QBrush textureBrush( textureImage );
214 textureBrush.setTransform( brushTransform );
215
216 painter->setBrush( textureBrush );
217 painter->drawPolygon( triangle );
218 painter->setBrush( previousBrush );
219
220 return true;
221}
Qgis::BlendMode
BlendMode
Blending modes defining the available composition modes that can be used when painting.
Definition: qgis.h:4041
Qgis::BlendMode::SoftLight
@ SoftLight
Soft light.
Qgis::BlendMode::Destination
@ Destination
Destination.
Qgis::BlendMode::Lighten
@ Lighten
Lighten.
Qgis::BlendMode::Subtract
@ Subtract
Subtract.
Qgis::BlendMode::Difference
@ Difference
Difference.
Qgis::BlendMode::SourceOut
@ SourceOut
Source out.
Qgis::BlendMode::DestinationOut
@ DestinationOut
Destination out.
Qgis::BlendMode::DestinationIn
@ DestinationIn
Destination in.
Qgis::BlendMode::Overlay
@ Overlay
Overlay.
Qgis::BlendMode::SourceIn
@ SourceIn
Source in.
Qgis::BlendMode::Addition
@ Addition
Addition.
Qgis::BlendMode::DestinationOver
@ DestinationOver
Destination over.
Qgis::BlendMode::SourceAtop
@ SourceAtop
Source atop.
Qgis::BlendMode::DestinationAtop
@ DestinationAtop
Destination atop.
Qgis::BlendMode::HardLight
@ HardLight
Hard light.
Qgis::BlendMode::Multiply
@ Multiply
Multiple.
QgsPainting::drawTriangleUsingTexture
static bool drawTriangleUsingTexture(QPainter *painter, const QPolygonF &triangle, const QImage &textureImage, float textureX1, float textureY1, float textureX2, float textureY2, float textureX3, float textureY3)
Draws a triangle onto a painter using a mapped texture image.
Definition: qgspainting.cpp:195
QgsPainting::getBlendModeEnum
static Qgis::BlendMode getBlendModeEnum(QPainter::CompositionMode blendMode)
Returns a Qgis::BlendMode corresponding to a QPainter::CompositionMode.
Definition: qgspainting.cpp:81
QgsPainting::isClippingMode
static bool isClippingMode(Qgis::BlendMode mode)
Returns true if mode is a clipping blend mode.
Definition: qgspainting.cpp:140
QgsPainting::triangleToTriangleTransform
static QTransform triangleToTriangleTransform(double inX1, double inY1, double inX2, double inY2, double inX3, double inY3, double outX1, double outY1, double outX2, double outY2, double outX3, double outY3, bool &ok)
Calculates the QTransform which maps the triangle defined by the points (inX1, inY1),...
Definition: qgspainting.cpp:175
QgsPainting::getCompositionMode
static QPainter::CompositionMode getCompositionMode(Qgis::BlendMode blendMode)
Returns a QPainter::CompositionMode corresponding to a Qgis::BlendMode.
Definition: qgspainting.cpp:21
qgsEnumValueToKey
QString qgsEnumValueToKey(const T &value, bool *returnOk=nullptr)
Returns the value for the given key of an enum.
Definition: qgis.h:5398
QgsDebugError
#define QgsDebugError(str)
Definition: qgslogger.h:38
Generated by doxygen 1.9.4