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() );

    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;

    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 ) 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 );
    void drawSymbols( const ClusteredGroup &group, QgsRenderContext &context, const QList<QPointF> &symbolPositions );
    void drawGrid( int gridSizeUnits, QgsSymbolRenderContext &context,
                   QList<QPointF> pointSymbolPositions, int nSymbols );
    void centralizeGrid( QList<QPointF> &pointSymbolPositions, double radius, int size ) const;
};

#endif // QGSPOINTDISPLACEMENTRENDERER_H