16#include <QDomDocument> 
   54  , mAttrName( attrName )
 
   61  const auto constRanges = 
ranges;
 
 
   78  auto catIt = 
mRanges.constBegin();
 
   79  for ( ; catIt != 
mRanges.constEnd(); ++catIt )
 
   81    if ( 
QgsSymbol *catSymbol = catIt->symbol() )
 
 
   95    if ( range.lowerValue() <= value && range.upperValue() >= value )
 
 
  124    return range->symbol();
 
 
  134      if ( matchingRange == &range )
 
 
  164  QVariant value = valueForFeature( feature, context );
 
 
  191    if ( !range.symbol() )
 
  194    range.symbol()->startRender( context, fields );
 
 
  204    if ( !range.symbol() )
 
  207    range.symbol()->stopRender( context );
 
 
  213  QSet<QString> attributes;
 
  225  QgsRangeList::const_iterator range_it = 
mRanges.constBegin();
 
  226  for ( ; range_it != 
mRanges.constEnd(); ++range_it )
 
 
  252  if ( rangeIndex < 0 || rangeIndex >= 
mRanges.size() )
 
  254  mRanges[rangeIndex].setSymbol( symbol );
 
 
  260  if ( rangeIndex < 0 || rangeIndex >= 
mRanges.size() )
 
  262  mRanges[rangeIndex].setLabel( label );
 
 
  268  if ( rangeIndex < 0 || rangeIndex >= 
mRanges.size() )
 
  272  if ( rangeIndex == 0 )
 
  274  else if ( rangeIndex == 
mRanges.count() )
 
  279  if ( isDefaultLabel )
 
 
  287  if ( rangeIndex < 0 || rangeIndex >= 
mRanges.size() )
 
  292  if ( rangeIndex == 0 )
 
  294  else if ( rangeIndex == 
mRanges.count() )
 
  299  if ( isDefaultLabel )
 
 
  307  if ( rangeIndex < 0 || rangeIndex >= 
mRanges.size() )
 
  309  mRanges[rangeIndex].setRenderState( value );
 
 
  315  QString s = QStringLiteral( 
"GRADUATED: attr %1\n" ).arg( 
mAttrName );
 
  316  for ( 
int i = 0; i < 
mRanges.count(); i++ )
 
 
  343  toSld( doc, element, context );
 
 
  349  QVariantMap newProps = oldProps;
 
  350  newProps[ QStringLiteral( 
"attribute" )] = 
mAttrName;
 
  357  for ( QgsRangeList::const_iterator it = 
mRanges.constBegin(); it != 
mRanges.constEnd(); ++it )
 
  359    if ( !it->toSld( doc, element, 
mAttrName, context, first ) )
 
 
  371  lst.reserve( 
mRanges.count() );
 
  374    lst.append( range.symbol() );
 
 
  407  QList<QgsClassificationRange> _classes = method.
classes( minimum, maximum, classes );
 
 
  414  const QString &attrName,
 
  420  bool useSymmetricMode,
 
  421  double symmetryPoint,
 
  422  const QStringList &listForCboPrettyBreaks,
 
  426  Q_UNUSED( listForCboPrettyBreaks )
 
  429  auto r = std::make_unique< QgsGraduatedSymbolRenderer >( attrName, 
ranges );
 
  430  r->setSourceSymbol( symbol->
clone() );
 
  431  r->setSourceColorRamp( ramp->
clone() );
 
  433  QString methodId = methodIdFromMode( 
mode );
 
  443  r->setClassificationMethod( method.release() );
 
  446  r->updateClasses( vlayer, classes, error );
 
 
  454    bool useSymmetricMode, 
double symmetryPoint, 
bool astride )
 
  459  QString methodId = methodIdFromMode( 
mode );
 
 
  479  for ( QList<QgsClassificationRange>::iterator it = classes.begin(); it != classes.end(); ++it )
 
 
  496  QDomElement symbolsElem = element.firstChildElement( QStringLiteral( 
"symbols" ) );
 
  497  if ( symbolsElem.isNull() )
 
  500  QDomElement rangesElem = element.firstChildElement( QStringLiteral( 
"ranges" ) );
 
  501  if ( rangesElem.isNull() )
 
  507  QDomElement rangeElem = rangesElem.firstChildElement();
 
  509  QSet<QString> usedUuids;
 
  510  while ( !rangeElem.isNull() )
 
  512    if ( rangeElem.tagName() == QLatin1String( 
"range" ) )
 
  514      double lowerValue = rangeElem.attribute( QStringLiteral( 
"lower" ) ).toDouble();
 
  515      double upperValue = rangeElem.attribute( QStringLiteral( 
"upper" ) ).toDouble();
 
  516      QString symbolName = rangeElem.attribute( QStringLiteral( 
"symbol" ) );
 
  517      QString label = rangeElem.attribute( QStringLiteral( 
"label" ) );
 
  518      bool render = rangeElem.attribute( QStringLiteral( 
"render" ), QStringLiteral( 
"true" ) ) != QLatin1String( 
"false" );
 
  519      QString uuid = rangeElem.attribute( QStringLiteral( 
"uuid" ), QString::number( i++ ) );
 
  520      while ( usedUuids.contains( uuid ) )
 
  522        uuid = QUuid::createUuid().toString();
 
  524      if ( symbolMap.contains( symbolName ) )
 
  526        QgsSymbol *symbol = symbolMap.take( symbolName );
 
  531    rangeElem = rangeElem.nextSiblingElement();
 
  534  QString attrName = element.attribute( QStringLiteral( 
"attr" ) );
 
  536  auto r = std::make_unique< QgsGraduatedSymbolRenderer >( attrName, 
ranges );
 
  538  QString attrMethod = element.attribute( QStringLiteral( 
"graduatedMethod" ) );
 
  539  if ( !attrMethod.isEmpty() )
 
  552  QDomElement sourceSymbolElem = element.firstChildElement( QStringLiteral( 
"source-symbol" ) );
 
  553  if ( !sourceSymbolElem.isNull() )
 
  556    if ( sourceSymbolMap.contains( QStringLiteral( 
"0" ) ) )
 
  558      r->setSourceSymbol( sourceSymbolMap.take( QStringLiteral( 
"0" ) ) );
 
  564  QDomElement sourceColorRampElem = element.firstChildElement( QStringLiteral( 
"colorramp" ) );
 
  565  if ( !sourceColorRampElem.isNull() && sourceColorRampElem.attribute( QStringLiteral( 
"name" ) ) == QLatin1String( 
"[source]" ) )
 
  572  QDomElement modeElem = element.firstChildElement( QStringLiteral( 
"mode" ) ); 
 
  573  QDomElement methodElem = element.firstChildElement( QStringLiteral( 
"classificationMethod" ) );
 
  574  std::unique_ptr< QgsClassificationMethod > method;
 
  578  if ( !modeElem.isNull() )
 
  580    QString modeString = modeElem.attribute( QStringLiteral( 
"name" ) );
 
  583    if ( modeString == QLatin1String( 
"equal" ) )
 
  584      methodId = QStringLiteral( 
"EqualInterval" );
 
  585    else if ( modeString == QLatin1String( 
"quantile" ) )
 
  586      methodId = QStringLiteral( 
"Quantile" );
 
  587    else if ( modeString == QLatin1String( 
"jenks" ) )
 
  588      methodId = QStringLiteral( 
"Jenks" );
 
  589    else if ( modeString == QLatin1String( 
"stddev" ) )
 
  590      methodId = QStringLiteral( 
"StdDev" );
 
  591    else if ( modeString == QLatin1String( 
"pretty" ) )
 
  592      methodId = QStringLiteral( 
"Pretty" );
 
  597    QDomElement symmetricModeElem = element.firstChildElement( QStringLiteral( 
"symmetricMode" ) );
 
  598    if ( !symmetricModeElem.isNull() )
 
  601      QString symmetricEnabled = symmetricModeElem.attribute( QStringLiteral( 
"enabled" ) );
 
  602      QString symmetricPointString = symmetricModeElem.attribute( QStringLiteral( 
"symmetryPoint" ) );
 
  603      QString astrideEnabled = symmetricModeElem.attribute( QStringLiteral( 
"astride" ) );
 
  604      method->setSymmetricMode( symmetricEnabled == QLatin1String( 
"true" ), symmetricPointString.toDouble(), astrideEnabled == QLatin1String( 
"true" ) );
 
  606    QDomElement labelFormatElem = element.firstChildElement( QStringLiteral( 
"labelformat" ) );
 
  607    if ( !labelFormatElem.isNull() )
 
  610      QString format = labelFormatElem.attribute( QStringLiteral( 
"format" ), 
"%1" + QStringLiteral( 
" - " ) + 
"%2" );
 
  611      int precision = labelFormatElem.attribute( QStringLiteral( 
"decimalplaces" ), QStringLiteral( 
"4" ) ).toInt();
 
  612      bool trimTrailingZeroes = labelFormatElem.attribute( QStringLiteral( 
"trimtrailingzeroes" ), QStringLiteral( 
"false" ) ) == QLatin1String( 
"true" );
 
  613      method->setLabelFormat( format );
 
  615      method->setLabelTrimTrailingZeroes( trimTrailingZeroes );
 
  626  r->setClassificationMethod( method.release() );
 
  628  QDomElement rotationElem = element.firstChildElement( QStringLiteral( 
"rotation" ) );
 
  629  if ( !rotationElem.isNull() && !rotationElem.attribute( QStringLiteral( 
"field" ) ).isEmpty() )
 
  635    if ( r->mSourceSymbol )
 
  637      convertSymbolRotation( r->mSourceSymbol.get(), rotationElem.attribute( QStringLiteral( 
"field" ) ) );
 
  640  QDomElement sizeScaleElem = element.firstChildElement( QStringLiteral( 
"sizescale" ) );
 
  641  if ( !sizeScaleElem.isNull() && !sizeScaleElem.attribute( QStringLiteral( 
"field" ) ).isEmpty() )
 
  647                              sizeScaleElem.attribute( QStringLiteral( 
"field" ) ) );
 
  653                              sizeScaleElem.attribute( QStringLiteral( 
"field" ) ) );
 
  657  QDomElement ddsLegendSizeElem = element.firstChildElement( QStringLiteral( 
"data-defined-size-legend" ) );
 
  658  if ( !ddsLegendSizeElem.isNull() )
 
 
  669  rendererElem.setAttribute( QStringLiteral( 
"type" ), QStringLiteral( 
"graduatedSymbol" ) );
 
  670  rendererElem.setAttribute( QStringLiteral( 
"attr" ), 
mAttrName );
 
  676  QDomElement rangesElem = doc.createElement( QStringLiteral( 
"ranges" ) );
 
  677  QgsRangeList::const_iterator it = 
mRanges.constBegin();
 
  678  for ( ; it != 
mRanges.constEnd(); ++it )
 
  681    QString symbolName = QString::number( i );
 
  684    QDomElement rangeElem = doc.createElement( QStringLiteral( 
"range" ) );
 
  685    rangeElem.setAttribute( QStringLiteral( 
"lower" ), QString::number( range.
lowerValue(), 
'f', 15 ) );
 
  686    rangeElem.setAttribute( QStringLiteral( 
"upper" ), QString::number( range.
upperValue(), 
'f', 15 ) );
 
  687    rangeElem.setAttribute( QStringLiteral( 
"symbol" ), symbolName );
 
  688    rangeElem.setAttribute( QStringLiteral( 
"label" ), range.
label() );
 
  689    rangeElem.setAttribute( QStringLiteral( 
"render" ), range.
renderState() ? QStringLiteral( 
"true" ) : QStringLiteral( 
"false" ) );
 
  690    rangeElem.setAttribute( QStringLiteral( 
"uuid" ), range.
uuid() );
 
  691    rangesElem.appendChild( rangeElem );
 
  695  rendererElem.appendChild( rangesElem );
 
  699  rendererElem.appendChild( symbolsElem );
 
  705    sourceSymbols.insert( QStringLiteral( 
"0" ), 
mSourceSymbol.get() );
 
  707    rendererElem.appendChild( sourceSymbolElem );
 
  714    rendererElem.appendChild( colorRampElem );
 
  719  rendererElem.appendChild( classificationMethodElem );
 
  721  QDomElement rotationElem = doc.createElement( QStringLiteral( 
"rotation" ) );
 
  722  rendererElem.appendChild( rotationElem );
 
  724  QDomElement sizeScaleElem = doc.createElement( QStringLiteral( 
"sizescale" ) );
 
  725  rendererElem.appendChild( sizeScaleElem );
 
  729    QDomElement ddsLegendElem = doc.createElement( QStringLiteral( 
"data-defined-size-legend" ) );
 
  731    rendererElem.appendChild( ddsLegendElem );
 
 
  756      return QStringLiteral( 
"EqualInterval" );
 
  758      return QStringLiteral( 
"Quantile" );
 
  760      return QStringLiteral( 
"Jenks" );
 
  762      return QStringLiteral( 
"StdDev" );
 
  764      return QStringLiteral( 
"Pretty" );
 
  773  if ( methodId == QLatin1String( 
"EqualInterval" ) )
 
  775  if ( methodId == QLatin1String( 
"Quantile" ) )
 
  777  if ( methodId == QLatin1String( 
"Jenks" ) )
 
  779  if ( methodId == QLatin1String( 
"StdDev" ) )
 
  781  if ( methodId == QLatin1String( 
"Pretty" ) )
 
  800        if ( sSize && sSize != ddSize )
 
  803          return baseLegendSymbolItems();
 
  820      lst += baseLegendSymbolItems();
 
  825  return baseLegendSymbolItems();
 
 
  830  QVariant value = valueForFeature( feature, context );
 
  834    return QSet< QString >();
 
  839    return QSet< QString >() << key;
 
  841    return QSet< QString >();
 
 
  848  for ( i = 0; i < 
mRanges.size(); i++ )
 
  850    if ( 
mRanges[i].uuid() == key )
 
 
  905  double min = std::numeric_limits<double>::max();
 
  906  for ( 
int i = 0; i < 
mRanges.count(); i++ )
 
  913    min = std::min( sz, min );
 
 
  920  double max = std::numeric_limits<double>::min();
 
  921  for ( 
int i = 0; i < 
mRanges.count(); i++ )
 
  928    max = std::max( sz, max );
 
 
  935  for ( 
int i = 0; i < 
mRanges.count(); i++ )
 
  937    std::unique_ptr<QgsSymbol> symbol( 
mRanges.at( i ).symbol() ? 
mRanges.at( i ).symbol()->clone() : nullptr );
 
  938    const double size = 
mRanges.count() > 1
 
  939                        ? minSize + i * ( maxSize - minSize ) / ( 
mRanges.count() - 1 )
 
  940                        : .5 * ( maxSize + minSize );
 
  944      static_cast< QgsLineSymbol * 
>( symbol.get() )->setWidth( size );
 
 
  961      QgsSymbol *symbol = range.symbol() ? range.symbol()->
clone() : 
nullptr;
 
  965        colorValue = ( 
mRanges.count() > 1 ? 
static_cast< double >( i ) / ( 
mRanges.count() - 1 ) : 0 );
 
 
  983    std::unique_ptr<QgsSymbol> symbol( sym->
clone() );
 
  988        symbol->setColor( range.symbol()->color() );
 
 
 1017    if ( range.uuid() == key )
 
 1019      return range.renderState();
 
 
 1027  for ( 
int i = 0; i < 
mRanges.size(); i++ )
 
 1029    if ( 
mRanges[i].uuid() == key )
 
 
 1041  for ( i = 0; i < 
mRanges.size(); i++ )
 
 1043    if ( 
mRanges[i].uuid() == key )
 
 
 1059  QString label = QStringLiteral( 
"0.0 - 0.0" );
 
 
 1072  QMutableListIterator< QgsRendererRange > it( 
mRanges );
 
 1073  while ( it.hasNext() )
 
 1087      if ( isDefaultLabel )
 
 1089      it.setValue( range );
 
 1091      it.insert( newRange );
 
 
 1141  for ( 
int i = 0; i < 
mRanges.count(); i++ )
 
 1146    else if ( i == 
mRanges.count() - 1 )
 
 
 1155  double minClassRange = 0.0;
 
 1158    double range = rendererRange.upperValue() - rendererRange.lowerValue();
 
 1161    if ( minClassRange == 0.0 || range < minClassRange )
 
 1162      minClassRange = range;
 
 1164  if ( minClassRange <= 0.0 )
 
 1171  double nextDpMinRange = 0.0000000099;
 
 1172  while ( ndp > 0 && nextDpMinRange < minClassRange )
 
 1175    nextDpMinRange *= 10.0;
 
 
 1184  if ( from < 0 || from >= 
mRanges.size() || to < 0 || to >= 
mRanges.size() )
 
 
 1201  if ( order == Qt::AscendingOrder )
 
 
 1214  std::sort( sortedRanges.begin(), sortedRanges.end(), 
valueLessThan );
 
 1216  QgsRangeList::const_iterator it = sortedRanges.constBegin();
 
 1217  if ( it == sortedRanges.constEnd() )
 
 1220  if ( ( *it ).upperValue() < ( *it ).lowerValue() )
 
 1223  double prevMax = ( *it ).upperValue();
 
 1226  for ( ; it != sortedRanges.constEnd(); ++it )
 
 1228    if ( ( *it ).upperValue() < ( *it ).lowerValue() )
 
 1231    if ( ( *it ).lowerValue() < prevMax )
 
 1234    prevMax = ( *it ).upperValue();
 
 
 1242  std::sort( sortedRanges.begin(), sortedRanges.end(), 
valueLessThan );
 
 1244  QgsRangeList::const_iterator it = sortedRanges.constBegin();
 
 1245  if ( it == sortedRanges.constEnd() )
 
 1248  double prevMax = ( *it ).upperValue();
 
 1251  for ( ; it != sortedRanges.constEnd(); ++it )
 
 1256    prevMax = ( *it ).upperValue();
 
 
 1263  return QString::localeAwareCompare( r1.
label(), r2.
label() ) < 0;
 
 
 1273  if ( order == Qt::AscendingOrder )
 
 
 1295  QString methodId = methodIdFromMode( 
mode );
 
 
 1302  mClassificationMethod->setSymmetricMode( useSymmetricMode, mClassificationMethod->symmetryPoint(), mClassificationMethod->symmetryAstride() );
 
 
 1307  mClassificationMethod->setSymmetricMode( mClassificationMethod->symmetricModeEnabled(), symmetryPoint, mClassificationMethod->symmetryAstride() );
 
 
 1312  mClassificationMethod->setSymmetricMode( mClassificationMethod->symmetricModeEnabled(), mClassificationMethod->symmetryPoint(), astride );
 
 
 1317  std::unique_ptr< QgsGraduatedSymbolRenderer > r;
 
 1318  if ( renderer->
type() == QLatin1String( 
"graduatedSymbol" ) )
 
 1322  else if ( renderer->
type() == QLatin1String( 
"categorizedSymbol" ) )
 
 1325    if ( categorizedSymbolRenderer )
 
 1327      r = std::make_unique< QgsGraduatedSymbolRenderer >( QString(), 
QgsRangeList() );
 
 1337      r->setClassAttribute( categorizedSymbolRenderer->
classAttribute() );
 
 1340  else if ( renderer->
type() == QLatin1String( 
"pointDisplacement" ) || renderer->
type() == QLatin1String( 
"pointCluster" ) )
 
 1343    if ( pointDistanceRenderer )
 
 1346  else if ( renderer->
type() == QLatin1String( 
"invertedPolygonRenderer" ) )
 
 1349    if ( invertedPolygonRenderer )
 
 1358    r = std::make_unique< QgsGraduatedSymbolRenderer >( QString(), 
QgsRangeList() );
 
 1363      r->setSourceSymbol( 
symbols.at( 0 )->clone() );
 
 
 1387      return QStringLiteral( 
"GraduatedColor" );
 
 1389      return QStringLiteral( 
"GraduatedSize" );
 
 
QFlags< FeatureRendererFlag > FeatureRendererFlags
Flags controlling behavior of vector feature renderers.
 
GraduatedMethod
Methods for modifying symbols by range in a graduated symbol renderer.
 
@ Size
Alter size of symbols.
 
@ Color
Alter color of symbols.
 
@ AffectsLabeling
If present, indicates that the renderer will participate in the map labeling problem.
 
@ AffectsLabeling
If present, indicates that the symbol will participate in the map labeling problem.
 
static QgsClassificationMethodRegistry * classificationMethodRegistry()
Returns the application's classification methods registry, used in graduated renderer.
 
A feature renderer which represents features using a list of renderer categories.
 
QgsSymbol * sourceSymbol()
Returns the renderer's source symbol, which is the base symbol used for the each categories' symbol b...
 
QString classAttribute() const
Returns the class attribute for the renderer, which is the field name or expression string from the l...
 
QgsColorRamp * sourceColorRamp()
Returns the source color ramp, from which each categories' color is derived.
 
A dummy implementation class method which does not compute any breaks.
 
static const QString METHOD_ID
 
A classification method which uses equal width intervals.
 
std::unique_ptr< QgsClassificationMethod > method(const QString &id)
Returns a new instance of the method for the given id.
 
An abstract class for implementations of classification methods.
 
static void makeBreaksSymmetric(QList< double > &breaks, double symmetryPoint, bool astride)
Remove the breaks that are above the existing opposite sign classes to keep colors symmetrically bala...
 
static std::unique_ptr< QgsClassificationMethod > create(const QDomElement &element, const QgsReadWriteContext &context)
Reads the DOM element and return a new classification method from it.
 
Q_DECL_DEPRECATED QList< QgsClassificationRange > classes(const QgsVectorLayer *layer, const QString &expression, int nclasses)
This will calculate the classes for a given layer to define the classes.
 
void setSymmetricMode(bool enabled, double symmetryPoint=0, bool symmetryAstride=false)
Defines if the symmetric mode is enables and configures its parameters.
 
ClassPosition
Defines the class position.
 
@ LowerBound
The class is at the lower bound.
 
@ UpperBound
The class is at the upper bound.
 
@ Inner
The class is not at a bound.
 
static QList< double > rangesToBreaks(const QList< QgsClassificationRange > &classes)
Transforms a list of classes to a list of breaks.
 
Abstract base class for color ramps.
 
virtual QgsColorRamp * clone() const =0
Creates a clone of the color ramp.
 
Object that keeps configuration of appearance of marker symbol's data-defined size in legend.
 
static QgsDataDefinedSizeLegend * readXml(const QDomElement &elem, const QgsReadWriteContext &context) SIP_FACTORY
Creates instance from given element and returns it (caller takes ownership). Returns nullptr on error...
 
void updateFromSymbolAndProperty(const QgsMarkerSymbol *symbol, const QgsProperty &ddSize)
Updates the list of classes, source symbol and title label from given symbol and property.
 
QgsLegendSymbolList legendSymbolList() const
Generates legend symbol items according to the configuration.
 
static QList< QgsExpressionContextScope * > globalProjectLayerScopes(const QgsMapLayer *layer)
Creates a list of three scopes: global, layer's project and layer.
 
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
 
void appendScopes(const QList< QgsExpressionContextScope * > &scopes)
Appends a list of scopes to the end of the context.
 
Handles parsing and evaluation of expressions (formerly called "search strings").
 
bool prepare(const QgsExpressionContext *context)
Gets the expression ready for evaluation - find out column indexes.
 
static QString quotedValue(const QVariant &value)
Returns a string representation of a literal value, including appropriate quotations where required.
 
static QString quoteFieldExpression(const QString &expression, const QgsVectorLayer *layer)
Validate if the expression is a field in the layer and ensure it is quoted.
 
bool hasParserError() const
Returns true if an error occurred when parsing the input expression.
 
QSet< QString > referencedColumns() const
Gets list of columns referenced by the expression.
 
bool needsGeometry() const
Returns true if the expression uses feature geometry for some computation.
 
Abstract base class for all 2D vector feature renderers.
 
virtual void stopRender(QgsRenderContext &context)
Must be called when a render cycle has finished, to allow the renderer to clean up.
 
void copyRendererData(QgsFeatureRenderer *destRenderer) const
Clones generic renderer data to another renderer.
 
static void convertSymbolRotation(QgsSymbol *symbol, const QString &field)
Converts old rotation expressions to symbol level data defined angles.
 
void saveRendererData(QDomDocument &doc, QDomElement &element, const QgsReadWriteContext &context)
Saves generic renderer data into the specified element.
 
virtual void startRender(QgsRenderContext &context, const QgsFields &fields)
Must be called when a new render cycle is started.
 
static void convertSymbolSizeScale(QgsSymbol *symbol, Qgis::ScaleMethod method, const QString &field)
Converts old sizeScale expressions to symbol level data defined sizes.
 
virtual QgsFeatureRenderer * clone() const =0
Create a deep copy of this renderer.
 
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
 
Container of fields for a vector layer.
 
Q_INVOKABLE int lookupField(const QString &fieldName) const
Looks up field's index from the field name.
 
A vector feature renderer which uses numeric attributes to classify features into different ranges.
 
QgsLegendSymbolList legendSymbolItems() const override
Returns a list of symbology items for the legend.
 
QgsSymbol * sourceSymbol()
Returns the renderer's source symbol, which is the base symbol used for the each classes' symbol befo...
 
QDomElement save(QDomDocument &doc, const QgsReadWriteContext &context) override
Stores renderer properties to an XML element.
 
~QgsGraduatedSymbolRenderer() override
 
void updateSymbols(QgsSymbol *sym)
Update all the symbols but leave breaks and colors.
 
const QgsRendererRange * rangeForValue(double value) const
Returns the renderer range matching the provided value, or nullptr if no range matches the value.
 
QgsColorRamp * sourceColorRamp()
Returns the source color ramp, from which each classes' color is derived.
 
bool updateRangeSymbol(int rangeIndex, QgsSymbol *symbol)
 
void addBreak(double breakValue, bool updateSymbols=true)
Add a breakpoint by splitting existing classes so that the specified value becomes a break between tw...
 
Q_DECL_DEPRECATED void setAstride(bool astride)
Set if we want a central class astride the pivot value.
 
void setClassificationMethod(QgsClassificationMethod *method)
Defines the classification method This will take ownership of the method.
 
static Q_DECL_DEPRECATED QList< double > calcEqualIntervalBreaks(double minimum, double maximum, int classes, bool useSymmetricMode, double symmetryPoint, bool astride)
Compute the equal interval classification.
 
QgsGraduatedSymbolRenderer * clone() const override
Create a deep copy of this renderer.
 
std::unique_ptr< QgsDataDefinedSizeLegend > mDataDefinedSizeLegend
 
static Q_DECL_DEPRECATED void makeBreaksSymmetric(QList< double > &breaks, double symmetryPoint, bool astride)
Remove the breaks that are above the existing opposite sign classes to keep colors symmetrically bala...
 
void startRender(QgsRenderContext &context, const QgsFields &fields) override
Must be called when a new render cycle is started.
 
double maxSymbolSize() const
Returns the max symbol size when graduated by size.
 
Q_DECL_DEPRECATED bool useSymmetricMode() const
Returns if we want to classify symmetric around a given value.
 
bool updateRangeLabel(int rangeIndex, const QString &label)
 
void addClass(QgsSymbol *symbol)
Adds a class to the renderer, with the specified symbol.
 
QgsClassificationMethod * classificationMethod() const
Returns the classification method.
 
QgsSymbol * originalSymbolForFeature(const QgsFeature &feature, QgsRenderContext &context) const override
Returns symbol for feature.
 
void sortByValue(Qt::SortOrder order=Qt::AscendingOrder)
 
Q_DECL_DEPRECATED void toSld(QDomDocument &doc, QDomElement &element, const QVariantMap &props=QVariantMap()) const override
Used from subclasses to create SLD Rule elements following SLD v1.1 specs.
 
void checkLegendSymbolItem(const QString &key, bool state=true) override
Sets whether the legend symbology item with the specified ley should be checked.
 
std::unique_ptr< QgsSymbol > mSourceSymbol
 
void setLegendSymbolItem(const QString &key, QgsSymbol *symbol) override
Sets the symbol to be used for a legend symbol item.
 
Qgis::FeatureRendererFlags flags() const override
Returns flags associated with the renderer.
 
void setGraduatedMethod(Qgis::GraduatedMethod method)
Set the method used for graduation (either size or color).
 
static QgsFeatureRenderer * create(QDomElement &element, const QgsReadWriteContext &context)
create renderer from XML element
 
Q_DECL_DEPRECATED void setMode(Mode mode)
 
QSet< QString > legendKeysForFeature(const QgsFeature &feature, QgsRenderContext &context) const override
Returns legend keys matching a specified feature.
 
bool rangesOverlap() const
Tests whether classes assigned to the renderer have ranges which overlap.
 
std::shared_ptr< QgsClassificationMethod > mClassificationMethod
 
Q_DECL_DEPRECATED bool astride() const
Returns if we want to have a central class astride the pivot value.
 
Q_DECL_DEPRECATED void setLabelFormat(const QgsRendererRangeLabelFormat &labelFormat, bool updateRanges=false)
Set the label format used to generate default classification labels.
 
Q_DECL_DEPRECATED void updateClasses(QgsVectorLayer *vlayer, Mode mode, int nclasses, bool useSymmetricMode=false, double symmetryPoint=0.0, bool astride=false)
Recalculate classes for a layer.
 
QString dump() const override
Returns debug information about this renderer.
 
bool updateRangeUpperValue(int rangeIndex, double value)
 
QString legendKeyToExpression(const QString &key, QgsVectorLayer *layer, bool &ok) const override
Attempts to convert the specified legend rule key to a QGIS expression matching the features displaye...
 
QString legendKeyForValue(double value) const
Returns the matching legend key for a value.
 
void setSourceColorRamp(QgsColorRamp *ramp)
Sets the source color ramp.
 
void setSourceSymbol(QgsSymbol *sym)
Sets the source symbol for the renderer, which is the base symbol used for the each classes' symbol b...
 
bool legendSymbolItemChecked(const QString &key) override
Returns true if the legend symbology item with the specified key is checked.
 
bool updateRangeLowerValue(int rangeIndex, double value)
 
void stopRender(QgsRenderContext &context) override
Must be called when a render cycle has finished, to allow the renderer to clean up.
 
static QgsGraduatedSymbolRenderer * convertFromRenderer(const QgsFeatureRenderer *renderer)
creates a QgsGraduatedSymbolRenderer from an existing renderer.
 
bool legendSymbolItemsCheckable() const override
Returns true if symbology items in legend are checkable.
 
void moveClass(int from, int to)
Moves the category at index position from to index position to.
 
void sortByLabel(Qt::SortOrder order=Qt::AscendingOrder)
 
QSet< QString > usedAttributes(const QgsRenderContext &context) const override
Returns a list of attributes required by this renderer.
 
void updateRangeLabels()
Updates the labels of the ranges.
 
bool updateRangeRenderState(int rangeIndex, bool render)
 
QgsSymbol * symbolForFeature(const QgsFeature &feature, QgsRenderContext &context) const override
To be overridden.
 
std::unique_ptr< QgsColorRamp > mSourceColorRamp
 
QgsSymbolList symbols(QgsRenderContext &context) const override
Returns list of symbols used by the renderer.
 
bool accept(QgsStyleEntityVisitorInterface *visitor) const override
Accepts the specified symbology visitor, causing it to visit all symbols associated with the renderer...
 
QgsDataDefinedSizeLegend * dataDefinedSizeLegend() const
Returns configuration of appearance of legend when using data-defined size for marker symbols.
 
void updateColorRamp(QgsColorRamp *ramp=nullptr)
Update the color ramp used.
 
Q_DECL_DEPRECATED Mode mode() const
 
void deleteClass(int idx)
 
QgsGraduatedSymbolRenderer(const QString &attrName=QString(), const QgsRangeList &ranges=QgsRangeList())
 
Qgis::GraduatedMethod mGraduatedMethod
 
double minSymbolSize() const
Returns the min symbol size when graduated by size.
 
Qgis::GraduatedMethod graduatedMethod() const
Returns the method used for graduation (either size or color).
 
bool filterNeedsGeometry() const override
Returns true if this renderer requires the geometry to apply the filter.
 
int mAttrNum
attribute index (derived from attribute name in startRender)
 
Q_DECL_DEPRECATED void setSymmetryPoint(double symmetryPoint)
Set the pivot point.
 
std::unique_ptr< QgsExpression > mExpression
 
static QString graduatedMethodStr(Qgis::GraduatedMethod method)
 
void setSymbolSizes(double minSize, double maxSize)
set varying symbol size for classes
 
void calculateLabelPrecision(bool updateRanges=true)
Reset the label decimal places to a numberbased on the minimum class interval.
 
void setDataDefinedSizeLegend(QgsDataDefinedSizeLegend *settings)
Configures appearance of legend when renderer is configured to use data-defined size for marker symbo...
 
const QgsRangeList & ranges() const
Returns a list of all ranges used in the classification.
 
Q_DECL_DEPRECATED QgsRendererRangeLabelFormat labelFormat() const
Returns the label format used to generate default classification labels.
 
static Q_DECL_DEPRECATED QgsGraduatedSymbolRenderer * createRenderer(QgsVectorLayer *vlayer, const QString &attrName, int classes, Mode mode, QgsSymbol *symbol, QgsColorRamp *ramp, const QgsRendererRangeLabelFormat &legendFormat=QgsRendererRangeLabelFormat(), bool useSymmetricMode=false, double symmetryPoint=0.0, const QStringList &listForCboPrettyBreaks=QStringList(), bool astride=false)
Creates a new graduated renderer.
 
Q_DECL_DEPRECATED double symmetryPoint() const
Returns the pivot value for symmetric classification.
 
Q_DECL_DEPRECATED void setUseSymmetricMode(bool useSymmetricMode)
Set if we want to classify symmetric around a given value.
 
QgsSymbol * symbolForValue(double value) const
Gets the symbol which is used to represent value.
 
bool rangesHaveGaps() const
Tests whether classes assigned to the renderer have gaps between the ranges.
 
A polygon-only feature renderer used to display features inverted.
 
Stores information about one class/rule of a vector layer renderer in a unified way that can be used ...
 
Constrained random color ramp, which returns random colors based on preset parameters.
 
A line symbol type, for rendering LineString and MultiLineString geometries.
 
double width() const
Returns the estimated width for the whole symbol, which is the maximum width of all marker symbol lay...
 
A marker symbol type, for rendering Point and MultiPoint geometries.
 
double size() const
Returns the estimated size for the whole symbol, which is the maximum size of all marker symbol layer...
 
QgsProperty dataDefinedSize() const
Returns data defined size for whole symbol (including all symbol layers).
 
const QgsFeatureRenderer * embeddedRenderer() const override
Returns the current embedded renderer (subrenderer) for this feature renderer.
 
An abstract base class for distance based point renderers (e.g., clusterer and displacement renderers...
 
const QgsFeatureRenderer * embeddedRenderer() const override
Returns the current embedded renderer (subrenderer) for this feature renderer.
 
A store for object properties.
 
bool isActive() const
Returns whether the property is currently active.
 
A color ramp consisting of random colors, constrained within component ranges.
 
A container for the context for various read/write operations on objects.
 
Contains information about the context of a rendering operation.
 
double rendererScale() const
Returns the renderer map scale.
 
QgsExpressionContext & expressionContext()
Gets the expression context.
 
Represents a value range for a QgsGraduatedSymbolRenderer.
 
void setUpperValue(double upperValue)
Sets the upper bound of the range.
 
QString label() const
Returns the label used for the range.
 
void setSymbol(QgsSymbol *s)
Sets the symbol used for the range.
 
QgsSymbol * symbol() const
Returns the symbol used for the range.
 
void setLabel(const QString &label)
Sets the label used for the range.
 
bool renderState() const
Returns true if the range should be rendered.
 
double upperValue() const
Returns the upper bound of the range.
 
void setLowerValue(double lowerValue)
Sets the lower bound of the range.
 
QString uuid() const
Returns the unique identifier for this range.
 
double lowerValue() const
Returns the lower bound of the range.
 
Holds SLD export options and other information related to SLD export of a QGIS layer style.
 
void setExtraProperties(const QVariantMap &properties)
Sets the open ended set of properties that can drive/inform the SLD encoding.
 
QVariantMap extraProperties() const
Returns the open ended set of properties that can drive/inform the SLD encoding.
 
A color ramp entity for QgsStyle databases.
 
An interface for classes which can visit style entity (e.g.
 
virtual bool visit(const QgsStyleEntityVisitorInterface::StyleLeaf &entity)
Called when the visitor will visit a style entity.
 
A symbol entity for QgsStyle databases.
 
static std::unique_ptr< QgsColorRamp > loadColorRamp(QDomElement &element)
Creates a color ramp from the settings encoded in an XML element.
 
static Qgis::ScaleMethod decodeScaleMethod(const QString &str)
Decodes a symbol scale method from a string.
 
static QDomElement saveColorRamp(const QString &name, const QgsColorRamp *ramp, QDomDocument &doc)
Encodes a color ramp's settings to an XML element.
 
static void clearSymbolMap(QgsSymbolMap &symbols)
 
static QgsSymbolMap loadSymbols(QDomElement &element, const QgsReadWriteContext &context)
Reads a collection of symbols from XML and returns them in a map. Caller is responsible for deleting ...
 
static QDomElement saveSymbols(QgsSymbolMap &symbols, const QString &tagName, QDomDocument &doc, const QgsReadWriteContext &context)
Writes a collection of symbols to XML with specified tagName for the top-level element.
 
Abstract base class for all rendered symbols.
 
void setColor(const QColor &color) const
Sets the color for the symbol.
 
QSet< QString > usedAttributes(const QgsRenderContext &context) const
Returns a list of attributes required to render this feature.
 
virtual QgsSymbol * clone() const =0
Returns a deep copy of this symbol.
 
static QgsSymbol * defaultSymbol(Qgis::GeometryType geomType)
Returns a new default symbol for the specified geometry type.
 
static bool isNull(const QVariant &variant, bool silenceNullWarnings=false)
Returns true if the specified variant should be considered a NULL value.
 
Represents a vector layer which manages a vector based dataset.
 
Q_INVOKABLE Qgis::GeometryType geometryType() const
Returns point, line or polygon.
 
#define Q_NOWARN_DEPRECATED_POP
 
#define Q_NOWARN_DEPRECATED_PUSH
 
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference)
 
bool labelGreaterThan(const QgsRendererCategory &c1, const QgsRendererCategory &c2)
 
bool valueLessThan(const QgsRendererCategory &c1, const QgsRendererCategory &c2)
 
bool valueGreaterThan(const QgsRendererCategory &c1, const QgsRendererCategory &c2)
 
bool labelLessThan(const QgsRendererCategory &c1, const QgsRendererCategory &c2)
 
bool valueLessThan(const QgsRendererRange &r1, const QgsRendererRange &r2)
 
bool labelGreaterThan(const QgsRendererRange &r1, const QgsRendererRange &r2)
 
bool labelLessThan(const QgsRendererRange &r1, const QgsRendererRange &r2)
 
bool valueGreaterThan(const QgsRendererRange &r1, const QgsRendererRange &r2)
 
QList< QgsLegendSymbolItem > QgsLegendSymbolList
 
#define RENDERER_TAG_NAME
 
QMap< QString, QgsSymbol * > QgsSymbolMap
 
QList< QgsSymbol * > QgsSymbolList
 
QList< QgsRendererRange > QgsRangeList
 
Contains information relating to the style entity currently being visited.