QGIS API Documentation  3.8.0-Zanzibar (11aff65)
qgssymbollayer.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgssymbollayer.cpp
3  ---------------------
4  begin : November 2009
5  copyright : (C) 2009 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 "qgssymbollayer.h"
17 #include "qgsclipper.h"
18 #include "qgsexpression.h"
19 #include "qgsrendercontext.h"
20 #include "qgsvectorlayer.h"
21 #include "qgsdxfexport.h"
22 #include "qgsgeometrysimplifier.h"
23 #include "qgspainteffect.h"
24 #include "qgseffectstack.h"
25 #include "qgspainteffectregistry.h"
26 #include "qgsproperty.h"
27 #include "qgsexpressioncontext.h"
28 #include "qgssymbollayerutils.h"
29 
30 #include <QSize>
31 #include <QPainter>
32 #include <QPointF>
33 #include <QPolygonF>
34 
35 QgsPropertiesDefinition QgsSymbolLayer::sPropertyDefinitions;
36 
37 void QgsSymbolLayer::initPropertyDefinitions()
38 {
39  if ( !sPropertyDefinitions.isEmpty() )
40  return;
41 
42  QString origin = QStringLiteral( "symbol" );
43 
44  sPropertyDefinitions = QgsPropertiesDefinition
45  {
46  { QgsSymbolLayer::PropertySize, QgsPropertyDefinition( "size", QObject::tr( "Symbol size" ), QgsPropertyDefinition::Size, origin ) },
47  { QgsSymbolLayer::PropertyAngle, QgsPropertyDefinition( "angle", QObject::tr( "Rotation angle" ), QgsPropertyDefinition::Rotation, origin ) },
48  { QgsSymbolLayer::PropertyName, QgsPropertyDefinition( "name", QObject::tr( "Symbol name" ), QgsPropertyDefinition::String, origin ) },
49  { QgsSymbolLayer::PropertyFillColor, QgsPropertyDefinition( "fillColor", QObject::tr( "Symbol fill color" ), QgsPropertyDefinition::ColorWithAlpha, origin ) },
50  { QgsSymbolLayer::PropertyStrokeColor, QgsPropertyDefinition( "outlineColor", QObject::tr( "Symbol stroke color" ), QgsPropertyDefinition::ColorWithAlpha, origin ) },
51  { QgsSymbolLayer::PropertyStrokeWidth, QgsPropertyDefinition( "outlineWidth", QObject::tr( "Symbol stroke width" ), QgsPropertyDefinition::StrokeWidth, origin ) },
52  { QgsSymbolLayer::PropertyStrokeStyle, QgsPropertyDefinition( "outlineStyle", QObject::tr( "Symbol stroke style" ), QgsPropertyDefinition::LineStyle, origin )},
53  { QgsSymbolLayer::PropertyOffset, QgsPropertyDefinition( "offset", QObject::tr( "Symbol offset" ), QgsPropertyDefinition::Offset, origin )},
54  { QgsSymbolLayer::PropertyCharacter, QgsPropertyDefinition( "char", QObject::tr( "Marker character(s)" ), QgsPropertyDefinition::String, origin )},
55  { QgsSymbolLayer::PropertyWidth, QgsPropertyDefinition( "width", QObject::tr( "Symbol width" ), QgsPropertyDefinition::DoublePositive, origin )},
56  { QgsSymbolLayer::PropertyHeight, QgsPropertyDefinition( "height", QObject::tr( "Symbol height" ), QgsPropertyDefinition::DoublePositive, origin )},
57  { QgsSymbolLayer::PropertyPreserveAspectRatio, QgsPropertyDefinition( "preserveAspectRatio", QObject::tr( "Preserve aspect ratio between width and height" ), QgsPropertyDefinition::Boolean, origin )},
58  { QgsSymbolLayer::PropertyFillStyle, QgsPropertyDefinition( "fillStyle", QObject::tr( "Symbol fill style" ), QgsPropertyDefinition::FillStyle, origin )},
59  { QgsSymbolLayer::PropertyJoinStyle, QgsPropertyDefinition( "joinStyle", QObject::tr( "Outline join style" ), QgsPropertyDefinition::PenJoinStyle, origin )},
60  { QgsSymbolLayer::PropertySecondaryColor, QgsPropertyDefinition( "color2", QObject::tr( "Secondary fill color" ), QgsPropertyDefinition::ColorWithAlpha, origin )},
61  { QgsSymbolLayer::PropertyLineAngle, QgsPropertyDefinition( "lineAngle", QObject::tr( "Angle for line fills" ), QgsPropertyDefinition::Rotation, origin )},
62  { QgsSymbolLayer::PropertyGradientType, QgsPropertyDefinition( "gradientType", QgsPropertyDefinition::DataTypeString, QObject::tr( "Gradient type" ), QObject::tr( "string " ) + QLatin1String( "[<b>linear</b>|<b>radial</b>|<b>conical</b>]" ), origin )},
63  { QgsSymbolLayer::PropertyCoordinateMode, QgsPropertyDefinition( "gradientMode", QgsPropertyDefinition::DataTypeString, QObject::tr( "Gradient mode" ), QObject::tr( "string " ) + QLatin1String( "[<b>feature</b>|<b>viewport</b>]" ), origin )},
64  { QgsSymbolLayer::PropertyGradientSpread, QgsPropertyDefinition( "gradientSpread", QgsPropertyDefinition::DataTypeString, QObject::tr( "Gradient spread" ), QObject::tr( "string " ) + QLatin1String( "[<b>pad</b>|<b>repeat</b>|<b>reflect</b>]" ), origin )},
65  { QgsSymbolLayer::PropertyGradientReference1X, QgsPropertyDefinition( "gradientRef1X", QObject::tr( "Reference point 1 (X)" ), QgsPropertyDefinition::Double0To1, origin )},
66  { QgsSymbolLayer::PropertyGradientReference1Y, QgsPropertyDefinition( "gradientRef1Y", QObject::tr( "Reference point 1 (Y)" ), QgsPropertyDefinition::Double0To1, origin )},
67  { QgsSymbolLayer::PropertyGradientReference2X, QgsPropertyDefinition( "gradientRef2X", QObject::tr( "Reference point 2 (X)" ), QgsPropertyDefinition::Double0To1, origin )},
68  { QgsSymbolLayer::PropertyGradientReference2Y, QgsPropertyDefinition( "gradientRef2Y", QObject::tr( "Reference point 2 (Y)" ), QgsPropertyDefinition::Double0To1, origin )},
69  { QgsSymbolLayer::PropertyGradientReference1IsCentroid, QgsPropertyDefinition( "gradientRef1Centroid", QObject::tr( "Reference point 1 follows feature centroid" ), QgsPropertyDefinition::Boolean, origin )},
70  { QgsSymbolLayer::PropertyGradientReference2IsCentroid, QgsPropertyDefinition( "gradientRef2Centroid", QObject::tr( "Reference point 2 follows feature centroid" ), QgsPropertyDefinition::Boolean, origin )},
71  { QgsSymbolLayer::PropertyBlurRadius, QgsPropertyDefinition( "blurRadius", QgsPropertyDefinition::DataTypeNumeric, QObject::tr( "Blur radius" ), QObject::tr( "Integer between 0 and 18" ), origin )},
72  { QgsSymbolLayer::PropertyLineDistance, QgsPropertyDefinition( "lineDistance", QObject::tr( "Distance between lines" ), QgsPropertyDefinition::DoublePositive, origin )},
73  { QgsSymbolLayer::PropertyShapeburstUseWholeShape, QgsPropertyDefinition( "shapeburstWholeShape", QObject::tr( "Shade whole shape" ), QgsPropertyDefinition::Boolean, origin )},
74  { QgsSymbolLayer::PropertyShapeburstMaxDistance, QgsPropertyDefinition( "shapeburstMaxDist", QObject::tr( "Maximum distance for shapeburst fill" ), QgsPropertyDefinition::DoublePositive, origin )},
75  { QgsSymbolLayer::PropertyShapeburstIgnoreRings, QgsPropertyDefinition( "shapeburstIgnoreRings", QObject::tr( "Ignore rings in feature" ), QgsPropertyDefinition::Boolean, origin )},
76  { QgsSymbolLayer::PropertyFile, QgsPropertyDefinition( "file", QObject::tr( "Symbol file path" ), QgsPropertyDefinition::String, origin )},
77  { QgsSymbolLayer::PropertyDistanceX, QgsPropertyDefinition( "distanceX", QObject::tr( "Horizontal distance between markers" ), QgsPropertyDefinition::DoublePositive, origin )},
78  { QgsSymbolLayer::PropertyDistanceY, QgsPropertyDefinition( "distanceY", QObject::tr( "Vertical distance between markers" ), QgsPropertyDefinition::DoublePositive, origin )},
79  { QgsSymbolLayer::PropertyDisplacementX, QgsPropertyDefinition( "displacementX", QObject::tr( "Horizontal displacement between rows" ), QgsPropertyDefinition::DoublePositive, origin )},
80  { QgsSymbolLayer::PropertyDisplacementY, QgsPropertyDefinition( "displacementY", QObject::tr( "Vertical displacement between columns" ), QgsPropertyDefinition::DoublePositive, origin )},
81  { QgsSymbolLayer::PropertyOpacity, QgsPropertyDefinition( "alpha", QObject::tr( "Opacity" ), QgsPropertyDefinition::Opacity, origin )},
82  { QgsSymbolLayer::PropertyCustomDash, QgsPropertyDefinition( "customDash", QgsPropertyDefinition::DataTypeString, QObject::tr( "Custom dash pattern" ), QObject::tr( "[<b><dash>;<space></b>] e.g. '8;2;1;2'" ), origin )},
83  { QgsSymbolLayer::PropertyCapStyle, QgsPropertyDefinition( "capStyle", QObject::tr( "Line cap style" ), QgsPropertyDefinition::CapStyle, origin )},
84  { QgsSymbolLayer::PropertyPlacement, QgsPropertyDefinition( "placement", QgsPropertyDefinition::DataTypeString, QObject::tr( "Marker placement" ), QObject::tr( "string " ) + "[<b>interval</b>|<b>vertex</b>|<b>lastvertex</b>|<b>firstvertex</b>|<b>centerpoint</b>|<b>curvepoint</b>]", origin )},
85  { QgsSymbolLayer::PropertyInterval, QgsPropertyDefinition( "interval", QObject::tr( "Marker interval" ), QgsPropertyDefinition::DoublePositive, origin )},
86  { QgsSymbolLayer::PropertyOffsetAlongLine, QgsPropertyDefinition( "offsetAlongLine", QObject::tr( "Offset along line" ), QgsPropertyDefinition::DoublePositive, origin )},
87  { QgsSymbolLayer::PropertyAverageAngleLength, QgsPropertyDefinition( "averageAngleLength", QObject::tr( "Average line angles over" ), QgsPropertyDefinition::DoublePositive, origin )},
88  { QgsSymbolLayer::PropertyHorizontalAnchor, QgsPropertyDefinition( "hAnchor", QObject::tr( "Horizontal anchor point" ), QgsPropertyDefinition::HorizontalAnchor, origin )},
89  { QgsSymbolLayer::PropertyVerticalAnchor, QgsPropertyDefinition( "vAnchor", QObject::tr( "Vertical anchor point" ), QgsPropertyDefinition::VerticalAnchor, origin )},
90  { QgsSymbolLayer::PropertyLayerEnabled, QgsPropertyDefinition( "enabled", QObject::tr( "Layer enabled" ), QgsPropertyDefinition::Boolean, origin )},
91  { QgsSymbolLayer::PropertyArrowWidth, QgsPropertyDefinition( "arrowWidth", QObject::tr( "Arrow line width" ), QgsPropertyDefinition::StrokeWidth, origin )},
92  { QgsSymbolLayer::PropertyArrowStartWidth, QgsPropertyDefinition( "arrowStartWidth", QObject::tr( "Arrow line start width" ), QgsPropertyDefinition::StrokeWidth, origin )},
93  { QgsSymbolLayer::PropertyArrowHeadLength, QgsPropertyDefinition( "arrowHeadLength", QObject::tr( "Arrow head length" ), QgsPropertyDefinition::DoublePositive, origin )},
94  { QgsSymbolLayer::PropertyArrowHeadThickness, QgsPropertyDefinition( "arrowHeadThickness", QObject::tr( "Arrow head thickness" ), QgsPropertyDefinition::DoublePositive, origin )},
95  { QgsSymbolLayer::PropertyArrowHeadType, QgsPropertyDefinition( "arrowHeadType", QgsPropertyDefinition::DataTypeString, QObject::tr( "Arrow head type" ), QObject::tr( "string " ) + QLatin1String( "[<b>single</b>|<b>reversed</b>|<b>double</b>]" ) )},
96  { QgsSymbolLayer::PropertyArrowType, QgsPropertyDefinition( "arrowType", QgsPropertyDefinition::DataTypeString, QObject::tr( "Arrow type" ), QObject::tr( "string " ) + QLatin1String( "[<b>plain</b>|<b>lefthalf</b>|<b>righthalf</b>]" ) )},
97 
98  };
99 }
100 
102 {
103  dataDefinedProperties().setProperty( key, property );
104 }
105 
106 bool QgsSymbolLayer::writeDxf( QgsDxfExport &e, double mmMapUnitScaleFactor, const QString &layerName, QgsSymbolRenderContext &context, QPointF shift ) const
107 {
108  Q_UNUSED( e )
109  Q_UNUSED( mmMapUnitScaleFactor )
110  Q_UNUSED( layerName )
111  Q_UNUSED( context )
112  Q_UNUSED( shift )
113  return false;
114 }
115 
117 {
118  Q_UNUSED( e )
119  Q_UNUSED( context )
120  return 1.0;
121 }
122 
124 {
125  Q_UNUSED( e )
126  Q_UNUSED( context )
127  return 0.0;
128 }
129 
131 {
132  Q_UNUSED( context )
133  return color();
134 }
135 
137 {
138  Q_UNUSED( context )
139  return 0.0;
140 }
141 
143 {
144  Q_UNUSED( unit )
145  return QVector<qreal>();
146 }
147 
148 Qt::PenStyle QgsSymbolLayer::dxfPenStyle() const
149 {
150  return Qt::SolidLine;
151 }
152 
154 {
155  Q_UNUSED( context )
156  return color();
157 }
158 
159 Qt::BrushStyle QgsSymbolLayer::dxfBrushStyle() const
160 {
161  return Qt::NoBrush;
162 }
163 
165 {
166  return mPaintEffect;
167 }
168 
170 {
171  delete mPaintEffect;
172  mPaintEffect = effect;
173 }
174 
176  : mType( type )
177  , mEnabled( true )
178  , mLocked( locked )
179 
180 {
182  mPaintEffect->setEnabled( false );
183 }
184 
186 {
188 
189  if ( !context.fields().isEmpty() )
190  {
191  //QgsFields is implicitly shared, so it's cheap to make a copy
192  mFields = context.fields();
193  }
194 }
195 
197 {
199 }
200 
202 {
203  QgsSymbolLayer::initPropertyDefinitions();
204  return sPropertyDefinitions;
205 }
206 
208 {
209  delete mPaintEffect;
210 }
211 
213 {
214  if ( symbol->type() == QgsSymbol::Fill && mType == QgsSymbol::Line )
215  return true;
216 
217  return symbol->type() == mType;
218 }
219 
221 {
223 }
224 
226 {
227  return mRenderingPass;
228 }
229 
230 QSet<QString> QgsSymbolLayer::usedAttributes( const QgsRenderContext &context ) const
231 {
232  QSet<QString> columns = mDataDefinedProperties.referencedFields( context.expressionContext() );
233  return columns;
234 }
235 
236 QgsProperty propertyFromMap( const QgsStringMap &map, const QString &baseName )
237 {
238  QString prefix;
239  if ( !baseName.isEmpty() )
240  {
241  prefix.append( QStringLiteral( "%1_dd_" ).arg( baseName ) );
242  }
243 
244  if ( !map.contains( QStringLiteral( "%1expression" ).arg( prefix ) ) )
245  {
246  //requires at least the expression value
247  return QgsProperty();
248  }
249 
250  bool active = ( map.value( QStringLiteral( "%1active" ).arg( prefix ), QStringLiteral( "1" ) ) != QLatin1String( "0" ) );
251  QString expression = map.value( QStringLiteral( "%1expression" ).arg( prefix ) );
252  bool useExpression = ( map.value( QStringLiteral( "%1useexpr" ).arg( prefix ), QStringLiteral( "1" ) ) != QLatin1String( "0" ) );
253  QString field = map.value( QStringLiteral( "%1field" ).arg( prefix ), QString() );
254 
255  if ( useExpression )
256  return QgsProperty::fromExpression( expression, active );
257  else
258  return QgsProperty::fromField( field, active );
259 }
260 
261 // property string to type upgrade map
262 static const QMap< QString, QgsSymbolLayer::Property > OLD_PROPS
263 {
265  { "arrow_width", QgsSymbolLayer::PropertyArrowWidth },
266  { "arrow_start_width", QgsSymbolLayer::PropertyArrowStartWidth },
267  { "head_length", QgsSymbolLayer::PropertyArrowHeadLength },
268  { "head_thickness", QgsSymbolLayer::PropertyArrowHeadThickness },
269  { "offset", QgsSymbolLayer::PropertyOffset },
270  { "head_type", QgsSymbolLayer::PropertyArrowHeadType },
271  { "arrow_type", QgsSymbolLayer::PropertyArrowType },
272  { "width_field", QgsSymbolLayer::PropertyWidth },
273  { "height_field", QgsSymbolLayer::PropertyHeight },
274  { "rotation_field", QgsSymbolLayer::PropertyAngle },
275  { "outline_width_field", QgsSymbolLayer::PropertyStrokeWidth },
276  { "fill_color_field", QgsSymbolLayer::PropertyFillColor },
277  { "outline_color_field", QgsSymbolLayer::PropertyStrokeColor },
278  { "symbol_name_field", QgsSymbolLayer::PropertyName },
279  { "outline_width", QgsSymbolLayer::PropertyStrokeWidth },
280  { "outline_style", QgsSymbolLayer::PropertyStrokeStyle },
281  { "join_style", QgsSymbolLayer::PropertyJoinStyle },
282  { "fill_color", QgsSymbolLayer::PropertyFillColor },
283  { "outline_color", QgsSymbolLayer::PropertyStrokeColor },
284  { "width", QgsSymbolLayer::PropertyWidth },
285  { "height", QgsSymbolLayer::PropertyHeight },
286  { "symbol_name", QgsSymbolLayer::PropertyName },
287  { "angle", QgsSymbolLayer::PropertyAngle },
288  { "fill_style", QgsSymbolLayer::PropertyFillStyle },
289  { "color_border", QgsSymbolLayer::PropertyStrokeColor },
290  { "width_border", QgsSymbolLayer::PropertyStrokeWidth },
291  { "border_color", QgsSymbolLayer::PropertyStrokeColor },
292  { "border_style", QgsSymbolLayer::PropertyStrokeStyle },
294  { "gradient_type", QgsSymbolLayer::PropertyGradientType },
295  { "coordinate_mode", QgsSymbolLayer::PropertyCoordinateMode },
301  { "reference1_iscentroid", QgsSymbolLayer::PropertyGradientReference1IsCentroid },
302  { "reference2_iscentroid", QgsSymbolLayer::PropertyGradientReference2IsCentroid },
303  { "blur_radius", QgsSymbolLayer::PropertyBlurRadius },
307  { "svgFillColor", QgsSymbolLayer::PropertyFillColor },
308  { "svgOutlineColor", QgsSymbolLayer::PropertyStrokeColor },
309  { "svgOutlineWidth", QgsSymbolLayer::PropertyStrokeWidth },
310  { "svgFile", QgsSymbolLayer::PropertyFile },
311  { "lineangle", QgsSymbolLayer::PropertyLineAngle },
312  { "distance", QgsSymbolLayer::PropertyLineDistance },
313  { "distance_x", QgsSymbolLayer::PropertyDistanceX },
314  { "distance_y", QgsSymbolLayer::PropertyDistanceY },
315  { "displacement_x", QgsSymbolLayer::PropertyDisplacementX },
316  { "displacement_y", QgsSymbolLayer::PropertyDisplacementY },
317  { "file", QgsSymbolLayer::PropertyFile },
318  { "alpha", QgsSymbolLayer::PropertyOpacity },
319  { "customdash", QgsSymbolLayer::PropertyCustomDash },
320  { "line_style", QgsSymbolLayer::PropertyStrokeStyle },
321  { "joinstyle", QgsSymbolLayer::PropertyJoinStyle },
322  { "capstyle", QgsSymbolLayer::PropertyCapStyle },
323  { "placement", QgsSymbolLayer::PropertyPlacement },
324  { "interval", QgsSymbolLayer::PropertyInterval },
325  { "offset_along_line", QgsSymbolLayer::PropertyOffsetAlongLine },
326  { "name", QgsSymbolLayer::PropertyName },
327  { "size", QgsSymbolLayer::PropertySize },
332  { "rotation", QgsSymbolLayer::PropertyAngle },
333  { "horizontal_anchor_point", QgsSymbolLayer::PropertyHorizontalAnchor },
334  { "vertical_anchor_point", QgsSymbolLayer::PropertyVerticalAnchor },
335 };
336 
338 {
339  QgsStringMap::const_iterator propIt = stringMap.constBegin();
340  for ( ; propIt != stringMap.constEnd(); ++propIt )
341  {
342  QgsProperty prop;
343  QString propertyName;
344 
345  if ( propIt.key().endsWith( QLatin1String( "_dd_expression" ) ) )
346  {
347  //found a data defined property
348 
349  //get data defined property name by stripping "_dd_expression" from property key
350  propertyName = propIt.key().left( propIt.key().length() - 14 );
351 
352  prop = propertyFromMap( stringMap, propertyName );
353  }
354  else if ( propIt.key().endsWith( QLatin1String( "_expression" ) ) )
355  {
356  //old style data defined property, upgrade
357 
358  //get data defined property name by stripping "_expression" from property key
359  propertyName = propIt.key().left( propIt.key().length() - 11 );
360 
361  prop = QgsProperty::fromExpression( propIt.value() );
362  }
363 
364  if ( !prop || !OLD_PROPS.contains( propertyName ) )
365  continue;
366 
367  QgsSymbolLayer::Property key = static_cast< QgsSymbolLayer::Property >( OLD_PROPS.value( propertyName ) );
368 
369  if ( type() == QgsSymbol::Line )
370  {
371  //these keys had different meaning for line symbol layers
372  if ( propertyName == QLatin1String( "width" ) )
374  else if ( propertyName == QLatin1String( "color" ) )
376  }
377 
378  setDataDefinedProperty( key, prop );
379  }
380 }
381 
383 {
384  if ( !destLayer )
385  return;
386 
388 }
389 
391 {
392  if ( !destLayer || !mPaintEffect )
393  return;
394 
395  destLayer->setPaintEffect( mPaintEffect->clone() );
396 }
397 
399  : QgsSymbolLayer( QgsSymbol::Marker, locked )
400 {
401 
402 }
403 
405  : QgsSymbolLayer( QgsSymbol::Line, locked )
406 {
407 }
408 
410 {
411  return mRingFilter;
412 }
413 
415 {
416  mRingFilter = filter;
417 }
418 
420  : QgsSymbolLayer( QgsSymbol::Fill, locked )
421 {
422 }
423 
425 {
426  Q_UNUSED( context )
427 }
428 
430 {
431  Q_UNUSED( context )
432 }
433 
435 {
436  startRender( context );
437  QgsPaintEffect *effect = paintEffect();
438  if ( effect && effect->enabled() )
439  {
440  QgsEffectPainter p( context.renderContext(), effect );
441  renderPoint( QPointF( size.width() / 2, size.height() / 2 ), context );
442  }
443  else
444  {
445  renderPoint( QPointF( size.width() / 2, size.height() / 2 ), context );
446  }
447  stopRender( context );
448 }
449 
450 void QgsMarkerSymbolLayer::markerOffset( QgsSymbolRenderContext &context, double &offsetX, double &offsetY ) const
451 {
452  markerOffset( context, mSize, mSize, mSizeUnit, mSizeUnit, offsetX, offsetY, mSizeMapUnitScale, mSizeMapUnitScale );
453 }
454 
455 void QgsMarkerSymbolLayer::markerOffset( QgsSymbolRenderContext &context, double width, double height, double &offsetX, double &offsetY ) const
456 {
457  markerOffset( context, width, height, mSizeUnit, mSizeUnit, offsetX, offsetY, mSizeMapUnitScale, mSizeMapUnitScale );
458 }
459 
460 void QgsMarkerSymbolLayer::markerOffset( QgsSymbolRenderContext &context, double width, double height,
462  double &offsetX, double &offsetY, const QgsMapUnitScale &widthMapUnitScale, const QgsMapUnitScale &heightMapUnitScale ) const
463 {
464  offsetX = mOffset.x();
465  offsetY = mOffset.y();
466 
468  {
471  if ( exprVal.isValid() )
472  {
473  QPointF offset = QgsSymbolLayerUtils::decodePoint( exprVal.toString() );
474  offsetX = offset.x();
475  offsetY = offset.y();
476  }
477  }
478 
479  offsetX = context.renderContext().convertToPainterUnits( offsetX, mOffsetUnit, mOffsetMapUnitScale );
480  offsetY = context.renderContext().convertToPainterUnits( offsetY, mOffsetUnit, mOffsetMapUnitScale );
481 
482  HorizontalAnchorPoint horizontalAnchorPoint = mHorizontalAnchorPoint;
483  VerticalAnchorPoint verticalAnchorPoint = mVerticalAnchorPoint;
485  {
487  if ( exprVal.isValid() )
488  {
489  horizontalAnchorPoint = decodeHorizontalAnchorPoint( exprVal.toString() );
490  }
491  }
493  {
495  if ( exprVal.isValid() )
496  {
497  verticalAnchorPoint = decodeVerticalAnchorPoint( exprVal.toString() );
498  }
499  }
500 
501  //correct horizontal position according to anchor point
502  if ( horizontalAnchorPoint == HCenter && verticalAnchorPoint == VCenter )
503  {
504  return;
505  }
506 
507  double anchorPointCorrectionX = context.renderContext().convertToPainterUnits( width, widthUnit, widthMapUnitScale ) / 2.0;
508  double anchorPointCorrectionY = context.renderContext().convertToPainterUnits( height, heightUnit, heightMapUnitScale ) / 2.0;
509  if ( horizontalAnchorPoint == Left )
510  {
511  offsetX += anchorPointCorrectionX;
512  }
513  else if ( horizontalAnchorPoint == Right )
514  {
515  offsetX -= anchorPointCorrectionX;
516  }
517 
518  //correct vertical position according to anchor point
519  if ( verticalAnchorPoint == Top )
520  {
521  offsetY += anchorPointCorrectionY;
522  }
523  else if ( verticalAnchorPoint == Bottom )
524  {
525  offsetY -= anchorPointCorrectionY;
526  }
527 }
528 
529 QPointF QgsMarkerSymbolLayer::_rotatedOffset( QPointF offset, double angle )
530 {
531  angle = DEG2RAD( angle );
532  double c = std::cos( angle ), s = std::sin( angle );
533  return QPointF( offset.x() * c - offset.y() * s, offset.x() * s + offset.y() * c );
534 }
535 
536 QgsMarkerSymbolLayer::HorizontalAnchorPoint QgsMarkerSymbolLayer::decodeHorizontalAnchorPoint( const QString &str )
537 {
538  if ( str.compare( QLatin1String( "left" ), Qt::CaseInsensitive ) == 0 )
539  {
541  }
542  else if ( str.compare( QLatin1String( "right" ), Qt::CaseInsensitive ) == 0 )
543  {
545  }
546  else
547  {
549  }
550 }
551 
552 QgsMarkerSymbolLayer::VerticalAnchorPoint QgsMarkerSymbolLayer::decodeVerticalAnchorPoint( const QString &str )
553 {
554  if ( str.compare( QLatin1String( "top" ), Qt::CaseInsensitive ) == 0 )
555  {
557  }
558  else if ( str.compare( QLatin1String( "bottom" ), Qt::CaseInsensitive ) == 0 )
559  {
561  }
562  else
563  {
565  }
566 }
567 
569 {
570  mSizeUnit = unit;
571  mOffsetUnit = unit;
572 }
573 
575 {
576  if ( mOffsetUnit != mSizeUnit )
577  {
579  }
580  return mOffsetUnit;
581 }
582 
584 {
585  mSizeMapUnitScale = scale;
586  mOffsetMapUnitScale = scale;
587 }
588 
590 {
591  if ( mSizeMapUnitScale == mOffsetMapUnitScale )
592  {
593  return mSizeMapUnitScale;
594  }
595  return QgsMapUnitScale();
596 }
597 
599 {
600  mWidthUnit = unit;
601 }
602 
604 {
605  return mWidthUnit;
606 }
607 
609 {
610  mWidthMapUnitScale = scale;
611 }
612 
614 {
615  return mWidthMapUnitScale;
616 }
617 
618 
620 {
621  QPolygonF points;
622  // we're adding 0.5 to get rid of blurred preview:
623  // drawing antialiased lines of width 1 at (x,0)-(x,100) creates 2px line
624  points << QPointF( 0, int( size.height() / 2 ) + 0.5 ) << QPointF( size.width(), int( size.height() / 2 ) + 0.5 );
625 
626  startRender( context );
627  QgsPaintEffect *effect = paintEffect();
628  if ( effect && effect->enabled() )
629  {
630  QgsEffectPainter p( context.renderContext(), effect );
631  renderPolyline( points, context );
632  }
633  else
634  {
635  renderPolyline( points, context );
636  }
637  stopRender( context );
638 }
639 
640 void QgsLineSymbolLayer::renderPolygonStroke( const QPolygonF &points, QList<QPolygonF> *rings, QgsSymbolRenderContext &context )
641 {
642  switch ( mRingFilter )
643  {
644  case AllRings:
645  case ExteriorRingOnly:
646  renderPolyline( points, context );
647  break;
648  case InteriorRingsOnly:
649  break;
650  }
651 
652  if ( rings )
653  {
654  switch ( mRingFilter )
655  {
656  case AllRings:
657  case InteriorRingsOnly:
658  {
659  for ( const QPolygonF &ring : qgis::as_const( *rings ) )
660  renderPolyline( ring, context );
661  }
662  break;
663  case ExteriorRingOnly:
664  break;
665  }
666  }
667 }
668 
669 double QgsLineSymbolLayer::width( const QgsRenderContext &context ) const
670 {
671  return context.convertToPainterUnits( mWidth, mWidthUnit, mWidthMapUnitScale );
672 }
673 
675 {
676  Q_UNUSED( context )
677  return width() * e.mapUnitScaleFactor( e.symbologyScale(), widthUnit(), e.mapUnits(), context.renderContext().mapToPixel().mapUnitsPerPixel() );
678 }
679 
680 
682 {
683  QPolygonF poly = QRectF( QPointF( 0, 0 ), QPointF( size.width(), size.height() ) );
684  startRender( context );
685  QgsPaintEffect *effect = paintEffect();
686  if ( effect && effect->enabled() )
687  {
688  QgsEffectPainter p( context.renderContext(), effect );
689  renderPolygon( poly, nullptr, context );
690  }
691  else
692  {
693  renderPolygon( poly, nullptr, context );
694  }
695  stopRender( context );
696 }
697 
698 void QgsFillSymbolLayer::_renderPolygon( QPainter *p, const QPolygonF &points, const QList<QPolygonF> *rings, QgsSymbolRenderContext &context )
699 {
700  if ( !p )
701  {
702  return;
703  }
704 
705  // Disable 'Antialiasing' if the geometry was generalized in the current RenderContext (We known that it must have least #5 points).
706  if ( points.size() <= 5 &&
709  ( p->renderHints() & QPainter::Antialiasing ) )
710  {
711  p->setRenderHint( QPainter::Antialiasing, false );
712  p->drawRect( points.boundingRect() );
713  p->setRenderHint( QPainter::Antialiasing, true );
714  return;
715  }
716 
717  // polygons outlines are sometimes rendered wrongly with drawPolygon, when
718  // clipped (see #13343), so use drawPath instead.
719  if ( !rings && p->pen().style() == Qt::NoPen )
720  {
721  // simple polygon without holes
722  p->drawPolygon( points );
723  }
724  else
725  {
726  // polygon with holes must be drawn using painter path
727  QPainterPath path;
728  path.addPolygon( points );
729 
730  if ( rings )
731  {
732  QList<QPolygonF>::const_iterator it = rings->constBegin();
733  for ( ; it != rings->constEnd(); ++it )
734  {
735  QPolygonF ring = *it;
736  path.addPolygon( ring );
737  }
738  }
739 
740  p->drawPath( path );
741  }
742 }
743 
744 void QgsMarkerSymbolLayer::toSld( QDomDocument &doc, QDomElement &element, const QgsStringMap &props ) const
745 {
746  QDomElement symbolizerElem = doc.createElement( QStringLiteral( "se:PointSymbolizer" ) );
747  if ( !props.value( QStringLiteral( "uom" ), QString() ).isEmpty() )
748  symbolizerElem.setAttribute( QStringLiteral( "uom" ), props.value( QStringLiteral( "uom" ), QString() ) );
749  element.appendChild( symbolizerElem );
750 
751  // <Geometry>
752  QgsSymbolLayerUtils::createGeometryElement( doc, symbolizerElem, props.value( QStringLiteral( "geom" ), QString() ) );
753 
754  writeSldMarker( doc, symbolizerElem, props );
755 }
756 
757 
void setProperty(int key, const QgsProperty &property)
Adds a property to the collection and takes ownership of it.
QgsMapUnitScale mapUnitScale() const override
virtual QVector< qreal > dxfCustomDashPattern(QgsUnitTypes::RenderUnit &unit) const
Gets dash pattern.
RenderRingFilter ringFilter() const
Returns the line symbol layer&#39;s ring filter, which controls which rings are rendered when the line sy...
Gradient reference point 1 is centroid.
double symbologyScale() const
Returns the reference scale for output.
Definition: qgsdxfexport.h:154
QgsLineSymbolLayer(bool locked=false)
void setRenderingPass(int renderingPass)
Specifies the rendering pass in which this symbol layer should be rendered.
void setMapUnitScale(const QgsMapUnitScale &scale) override
const QgsVectorSimplifyMethod & vectorSimplifyMethod() const
Added in QGIS v2.4.
Gradient reference point 1 x.
QgsFields fields() const
Fields of the layer.
Definition: qgssymbol.h:680
QgsUnitTypes::RenderUnit outputUnit() const override
Returns the units to use for sizes and widths within the symbol layer.
QgsPaintEffect * paintEffect() const
Returns the current paint effect for the layer.
1D size (eg marker radius, or square marker height/width)
Definition: qgsproperty.h:69
Abstract base class for all rendered symbols.
Definition: qgssymbol.h:61
virtual double dxfOffset(const QgsDxfExport &e, QgsSymbolRenderContext &context) const
Gets offset.
Align to right side of symbol.
virtual void prepareExpressions(const QgsSymbolRenderContext &context)
Prepares all data defined property expressions for evaluation.
double angle() const
void startRender(QgsSymbolRenderContext &context) override
static QgsProperty fromField(const QString &fieldName, bool isActive=true)
Returns a new FieldBasedProperty created from the specified field name.
static QPointF decodePoint(const QString &string)
Decodes a QSizeF from a string.
#define DEG2RAD(x)
Base class for visual effects which can be applied to QPicture drawings.
static QgsProperty fromExpression(const QString &expression, bool isActive=true)
Returns a new ExpressionBasedProperty created from the specified expression.
void copyPaintEffect(QgsSymbolLayer *destLayer) const
Copies paint effect of this layer to another symbol layer.
Mixed or unknown units.
Definition: qgsunittypes.h:119
void restoreOldDataDefinedProperties(const QgsStringMap &stringMap)
Restores older data defined properties from string map.
void _renderPolygon(QPainter *p, const QPolygonF &points, const QList< QPolygonF > *rings, QgsSymbolRenderContext &context)
Default method to render polygon.
Color with alpha channel.
Definition: qgsproperty.h:64
QgsUnitTypes::DistanceUnit mapUnits() const
Retrieve map units.
virtual double dxfWidth(const QgsDxfExport &e, QgsSymbolRenderContext &context) const
Gets line width.
Line symbol.
Definition: qgssymbol.h:86
Positive double value (including 0)
Definition: qgsproperty.h:58
void drawPreviewIcon(QgsSymbolRenderContext &context, QSize size) override
Align to horizontal center of symbol.
double dxfWidth(const QgsDxfExport &e, QgsSymbolRenderContext &context) const override
Gets line width.
QMap< QString, QString > QgsStringMap
Definition: qgis.h:587
static QString encodePoint(QPointF point)
Encodes a QPointF to a string.
virtual double width() const
Returns the estimated width for the line symbol layer.
Rotation (value between 0-360 degrees)
Definition: qgsproperty.h:60
Name, eg shape name for simple markers.
Gradient reference point 2 y.
Any string value.
Definition: qgsproperty.h:61
virtual QgsPaintEffect * clone() const =0
Duplicates an effect by creating a deep copy of the effect.
bool isActive(int key) const override
Returns true if the collection contains an active property with the specified key.
QgsProperty propertyFromMap(const QgsStringMap &map, const QString &baseName)
virtual bool hasDataDefinedProperties() const
Returns true if the symbol layer (or any of its sub-symbols) contains data defined properties...
QgsSymbolLayer(QgsSymbol::SymbolType type, bool locked=false)
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c
virtual void renderPolygon(const QPolygonF &points, QList< QPolygonF > *rings, QgsSymbolRenderContext &context)=0
SymbolType
Type of the symbol.
Definition: qgssymbol.h:83
QVariant value(int key, const QgsExpressionContext &context, const QVariant &defaultValue=QVariant()) const override
Returns the calculated value of the property with the specified key from within the collection...
void setOriginalValueVariable(const QVariant &value)
Sets the original value variable value for data defined symbology.
Definition: qgssymbol.cpp:1125
bool prepare(const QgsExpressionContext &context=QgsExpressionContext()) const override
Prepares the collection against a specified expression context.
int renderingPass() const
Specifies the rendering pass in which this symbol layer should be rendered.
void setEnabled(bool enabled)
Sets whether the effect is enabled.
Align to bottom of symbol.
static QgsPaintEffect * defaultStack()
Returns a new effect stack consisting of a sensible selection of default effects. ...
QgsUnitTypes::RenderUnit outputUnit() const override
Returns the units to use for sizes and widths within the symbol layer.
The geometries can be rendered with &#39;AntiAliasing&#39; disabled because of it is &#39;1-pixel size&#39;...
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the symbol layer&#39;s property collection, used for data defined overrides...
virtual Qt::BrushStyle dxfBrushStyle() const
Gets brush/fill style.
static double mapUnitScaleFactor(double scale, QgsUnitTypes::RenderUnit symbolUnits, QgsUnitTypes::DistanceUnit mapUnits, double mapUnitsPerPixel=1.0)
Returns scale factor for conversion to map units.
Property requires a numeric value.
Definition: qgsproperty.h:98
virtual QColor color() const
The fill color.
Filename, eg for svg files.
float threshold() const
Gets the simplification threshold of the vector layer managed.
Align to left side of symbol.
void drawPreviewIcon(QgsSymbolRenderContext &context, QSize size) override
void markerOffset(QgsSymbolRenderContext &context, double &offsetX, double &offsetY) const
Calculates the required marker offset, including both the symbol offset and any displacement required...
Shapeburst fill from edge distance.
QgsSymbol::SymbolType type() const
void setPaintEffect(QgsPaintEffect *effect)
Sets the current paint effect for the layer.
bool enabled() const
Returns whether the effect is enabled.
Character, eg for font marker symbol layers.
Align to top of symbol.
double mapUnitsPerPixel() const
Returns current map units per pixel.
A store for object properties.
Definition: qgsproperty.h:229
Fill style (eg solid, lines)
Definition: qgsproperty.h:73
QgsRenderContext & renderContext()
Returns a reference to the context&#39;s render context.
Definition: qgssymbol.h:574
RenderRingFilter
Options for filtering rings when the line symbol layer is being used to render a polygon&#39;s rings...
Definition for a property.
Definition: qgsproperty.h:46
HorizontalAnchorPoint
Symbol horizontal anchor points.
Gradient reference point 1 y.
virtual QColor dxfBrushColor(QgsSymbolRenderContext &context) const
Gets brush/fill color.
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.
VerticalAnchorPoint
Symbol vertical anchor points.
static void createGeometryElement(QDomDocument &doc, QDomElement &element, const QString &geomFunc)
QgsExpressionContext & expressionContext()
Gets the expression context.
virtual Qt::PenStyle dxfPenStyle() const
Gets pen style.
virtual bool isCompatibleWithSymbol(QgsSymbol *symbol) const
Returns if the layer can be used below the specified symbol.
Line angle, or angle of hash lines for hash line symbols.
QSet< QString > referencedFields(const QgsExpressionContext &context=QgsExpressionContext()) const override
Returns the set of any fields referenced by the active properties from the collection.
Stroke style (eg solid, dashed)
Preserve aspect ratio between width and height.
Fill symbol.
Definition: qgssymbol.h:87
virtual QSet< QString > usedAttributes(const QgsRenderContext &context) const
Returns the set of attributes referenced by the layer.
Contains information about the context of a rendering operation.
double convertToPainterUnits(double size, QgsUnitTypes::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale()) const
Converts a size from the specified units to painter units (pixels).
const QgsMapToPixel & mapToPixel() const
Returns the context&#39;s map to pixel transform, which transforms between map coordinates and device coo...
RenderRingFilter mRingFilter
Property requires a string value.
Definition: qgsproperty.h:91
SymbolType type() const
Returns the symbol&#39;s type.
Definition: qgssymbol.h:120
Struct for storing maximum and minimum scales for measurements in map units.
virtual void stopRender(QgsSymbolRenderContext &context)=0
void setMapUnitScale(const QgsMapUnitScale &scale) override
virtual double dxfAngle(QgsSymbolRenderContext &context) const
Gets angle.
QgsMarkerSymbolLayer(bool locked=false)
Constructor for QgsMarkerSymbolLayer.
virtual QColor dxfColor(QgsSymbolRenderContext &context) const
Gets color.
QgsPaintEffect * mPaintEffect
Distance between lines, or length of lines for hash line symbols.
Line style (eg solid/dashed)
Definition: qgsproperty.h:71
void setRingFilter(QgsLineSymbolLayer::RenderRingFilter filter)
Sets the line symbol layer&#39;s ring filter, which controls which rings are rendered when the line symbo...
SimplifyHints simplifyHints() const
Gets the simplification hints of the vector layer managed.
Align to vertical center of symbol.
Secondary color (eg for gradient fills)
bool isEmpty() const
Checks whether the container is empty.
Definition: qgsfields.cpp:128
bool mEnabled
True if layer is enabled and should be drawn.
Horizontal anchor point.
Definition: qgsproperty.h:75
virtual ~QgsSymbolLayer()
virtual void renderPolygonStroke(const QPolygonF &points, QList< QPolygonF > *rings, QgsSymbolRenderContext &context)
Renders the line symbol layer along the outline of polygon, using the given render context...
Length to average symbol angles over.
bool hasActiveProperties() const override
Returns true if the collection has any active properties, or false if all properties within the colle...
QgsFillSymbolLayer(bool locked=false)
void stopRender(QgsSymbolRenderContext &context) override
static QPointF _rotatedOffset(QPointF offset, double angle)
Adjusts a marker offset to account for rotation.
Shapeburst blur radius.
void toSld(QDomDocument &doc, QDomElement &element, const QgsStringMap &props) const override
static const QgsPropertiesDefinition & propertyDefinitions()
Returns the symbol layer property definitions.
virtual bool writeDxf(QgsDxfExport &e, double mmMapUnitScaleFactor, const QString &layerName, QgsSymbolRenderContext &context, QPointF shift=QPointF(0.0, 0.0)) const
write as DXF
static bool isGeneralizableByDeviceBoundingBox(const QgsRectangle &envelope, float mapToPixelTol=1.0f)
Returns whether the device-envelope can be replaced by its BBOX when is applied the specified toleran...
Line cap style (eg round)
Definition: qgsproperty.h:74
Fill style (eg solid, dots)
QgsFields mFields
Whether symbol layer is enabled.
void setOutputUnit(QgsUnitTypes::RenderUnit unit) override
Sets the units to use for sizes and widths within the symbol layer.
Gradient reference point 2 is centroid.
A class to manager painter saving and restoring required for effect drawing.
QgsSymbol::SymbolType mType
Gradient reference point 2 x.
QgsPropertyCollection mDataDefinedProperties
QgsMapUnitScale mapUnitScale() const override
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the symbol layer&#39;s property collection, used for data defined overrides.
void setOutputUnit(QgsUnitTypes::RenderUnit unit) override
Sets the units to use for sizes and widths within the symbol layer.
Property
Data definable properties.
RenderUnit
Rendering size units.
Definition: qgsunittypes.h:111
virtual void setDataDefinedProperty(Property key, const QgsProperty &property)
Sets a data defined property for the layer.
void copyDataDefinedProperties(QgsSymbolLayer *destLayer) const
Copies all data defined properties of this layer to another symbol layer.
virtual void startRender(QgsSymbolRenderContext &context)=0
Horizontal distance between points.
void drawPreviewIcon(QgsSymbolRenderContext &context, QSize size) override
Vertical distance between points.
Double value between 0-1 (inclusive)
Definition: qgsproperty.h:59