qgspointdisplacementrenderer.h

Go to the documentation of this file.

/***************************************************************************
                              qgspointdisplacementrenderer.cpp
                              --------------------------------
  begin                : January 26, 2010
  copyright            : (C) 2010 by Marco Hugentobler
  email                : marco at hugis dot net
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSPOINTDISPLACEMENTRENDERER_H
#define QGSPOINTDISPLACEMENTRENDERER_H
 
#include "qgis_core.h"
#include "qgis.h"
#include "qgspointdistancerenderer.h"
 
class CORE_EXPORT QgsPointDisplacementRenderer: public QgsPointDistanceRenderer
{
  public:
 
    enum Placement
    {
      Ring, 
      ConcentricRings, 
      Grid 
    };
 
    QgsPointDisplacementRenderer( const QString &labelAttributeName = QString() );
 
    Qgis::FeatureRendererFlags flags() const override;
    QgsPointDisplacementRenderer *clone() const override SIP_FACTORY;
    void startRender( QgsRenderContext &context, const QgsFields &fields ) override;
    void stopRender( QgsRenderContext &context ) override;
    QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) override;
    QSet<QString> usedAttributes( const QgsRenderContext &context ) const override;
    bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;
 
    static QgsFeatureRenderer *create( QDomElement &symbologyElem, const QgsReadWriteContext &context ) SIP_FACTORY;
 
    void setCircleWidth( double width ) { mCircleWidth = width; }
 
    double circleWidth() const { return mCircleWidth; }
 
    void setCircleColor( const QColor &color ) { mCircleColor = color; }
 
    QColor circleColor() const { return mCircleColor; }
 
    void setCircleRadiusAddition( double distance ) { mCircleRadiusAddition = distance; }
 
    double circleRadiusAddition() const { return mCircleRadiusAddition; }
 
    void setLabelDistanceFactor( double factor ) { mLabelDistanceFactor = factor; }
 
    double labelDistanceFactor() const { return mLabelDistanceFactor; }
 
    Placement placement() const { return mPlacement; }
 
    void setPlacement( Placement placement ) { mPlacement = placement; }
 
    QgsMarkerSymbol *centerSymbol();
 
    void setCenterSymbol( QgsMarkerSymbol *symbol SIP_TRANSFER );
 
    static QgsPointDisplacementRenderer *convertFromRenderer( const QgsFeatureRenderer *renderer ) SIP_FACTORY;
 
  private:
#ifdef SIP_RUN
    QgsPointDisplacementRenderer( const QgsPointDisplacementRenderer & );
    QgsPointDisplacementRenderer &operator=( const QgsPointDisplacementRenderer & );
#endif
 
    std::unique_ptr< QgsMarkerSymbol > mCenterSymbol;
 
    Placement mPlacement = Ring;
 
    double mCircleWidth = 0.4;
    QColor mCircleColor;
    double mCircleRadiusAddition = 0;
    double mLabelDistanceFactor = 0.5;
 
    void drawGroup( QPointF centerPoint, QgsRenderContext &context, const QgsPointDistanceRenderer::ClusteredGroup &group ) const override SIP_FORCE;
 
    //helper functions
    void calculateSymbolAndLabelPositions( QgsSymbolRenderContext &symbolContext, QPointF centerPoint, int nPosition, double symbolDiagonal, QList<QPointF> &symbolPositions, QList<QPointF> &labelShifts, double &circleRadius,
                                           double &gridRadius, int &gridSize, QVector<double> &diagonals ) const;
    void drawCircle( double radiusPainterUnits, QgsSymbolRenderContext &context, QPointF centerPoint, int nSymbols ) const;
    void drawSymbols( const ClusteredGroup &group, QgsRenderContext &context, const QList<QPointF> &symbolPositions ) const;
    void drawGrid( int gridSizeUnits, QgsSymbolRenderContext &context,
                   QList<QPointF> pointSymbolPositions, int nSymbols ) const;
    void centralizeGrid( QList<QPointF> &pointSymbolPositions, double radius, int size ) const;
};
 
#endif // QGSPOINTDISPLACEMENTRENDERER_H