QGIS API Documentation
2.12.0-Lyon
|
A renderer that automatically displaces points with the same position. More...
#include <qgspointdisplacementrenderer.h>
Public Types | |
enum | Placement { Ring, ConcentricRings } |
Placement methods for dispersing points. More... | |
Public Types inherited from QgsFeatureRendererV2 | |
enum | Capabilities { SymbolLevels = 1, RotationField = 1 << 1, MoreSymbolsPerFeature = 1 << 2, Filter = 1 << 3, ScaleDependent = 1 << 4 } |
Public Member Functions | |
QgsPointDisplacementRenderer (const QString &labelAttributeName="") | |
~QgsPointDisplacementRenderer () | |
virtual int | capabilities () override |
Proxy that will call this method on the embedded renderer. More... | |
QgsMarkerSymbolV2 * | centerSymbol () |
Returns the symbol for the center of a displacement group (but not ownership of the symbol) More... | |
QColor | circleColor () const |
double | circleRadiusAddition () const |
double | circleWidth () const |
QgsFeatureRendererV2 * | clone () const override |
QgsFeatureRendererV2 * | embeddedRenderer () const |
QString | labelAttributeName () const |
QColor | labelColor () const |
QFont | labelFont () const |
QgsLegendSymbolList | legendSymbolItems (double scaleDenominator=-1, const QString &rule="") override |
QgsLegendSymbologyList | legendSymbologyItems (QSize iconSize) override |
return a list of symbology items for the legend More... | |
double | maxLabelScaleDenominator () const |
virtual QgsSymbolV2 * | originalSymbolForFeature (QgsFeature &feat, QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
virtual QgsSymbolV2List | originalSymbolsForFeature (QgsFeature &feat, QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
Placement | placement () const |
Returns the placement method used for dispersing the points. More... | |
bool | renderFeature (QgsFeature &feature, QgsRenderContext &context, int layer=-1, bool selected=false, bool drawVertexMarker=false) override |
Reimplemented from QgsFeatureRendererV2. More... | |
QDomElement | save (QDomDocument &doc) override |
store renderer info to XML element More... | |
void | setCenterSymbol (QgsMarkerSymbolV2 *symbol) |
Sets the center symbol (takes ownership) More... | |
void | setCircleColor (const QColor &c) |
void | setCircleRadiusAddition (double d) |
void | setCircleWidth (double w) |
Q_DECL_DEPRECATED void | setDisplacementGroups (const QList< QMap< QgsFeatureId, QgsFeature > > &list) |
not available in python bindings More... | |
void | setEmbeddedRenderer (QgsFeatureRendererV2 *r) |
Sets embedded renderer (takes ownership) More... | |
void | setLabelAttributeName (const QString &name) |
void | setLabelColor (const QColor &c) |
void | setLabelFont (const QFont &f) |
void | setMaxLabelScaleDenominator (double d) |
void | setPlacement (Placement placement) |
Sets the placement method used for dispersing the points. More... | |
void | setTolerance (double t) |
Sets the tolerance distance for grouping points. More... | |
void | setToleranceMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale object for the distance tolerance. More... | |
void | setToleranceUnit (QgsSymbolV2::OutputUnit unit) |
Sets the units for the tolerance distance. More... | |
virtual void | startRender (QgsRenderContext &context, const QgsFields &fields) override |
Needs to be called when a new render cycle is started. More... | |
void | stopRender (QgsRenderContext &context) override |
virtual QgsSymbolV2 * | symbolForFeature (QgsFeature &feature, QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
virtual QgsSymbolV2List | symbols (QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
virtual QgsSymbolV2List | symbolsForFeature (QgsFeature &feat, QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
double | tolerance () const |
Returns the tolerance distance for grouping points. More... | |
const QgsMapUnitScale & | toleranceMapUnitScale () const |
Returns the map unit scale object for the distance tolerance. More... | |
QgsSymbolV2::OutputUnit | toleranceUnit () const |
Returns the units for the tolerance distance. More... | |
virtual void | toSld (QDomDocument &doc, QDomElement &element) const override |
used from subclasses to create SLD Rule elements following SLD v1.1 specs More... | |
virtual QList< QString > | usedAttributes () override |
Partial proxy that will call this method on the embedded renderer. More... | |
virtual bool | willRenderFeature (QgsFeature &feat, QgsRenderContext &context) override |
Proxy that will call this method on the embedded renderer. More... | |
Public Member Functions inherited from QgsFeatureRendererV2 | |
virtual | ~QgsFeatureRendererV2 () |
virtual void | checkLegendSymbolItem (const QString &key, bool state=true) |
item in symbology was checked More... | |
virtual QString | dump () const |
for debugging More... | |
virtual QString | filter () |
If a renderer does not require all the features this method may be overridden and return an expression used as where clause. More... | |
bool | forceRasterRender () const |
Returns whether the renderer must render as a raster. More... | |
virtual QString | legendClassificationAttribute () const |
If supported by the renderer, return classification attribute for the use in legend. More... | |
virtual bool | legendSymbolItemChecked (const QString &key) |
items of symbology items in legend is checked More... | |
virtual bool | legendSymbolItemsCheckable () const |
items of symbology items in legend should be checkable More... | |
virtual QgsLegendSymbolListV2 | legendSymbolItemsV2 () const |
Return a list of symbology items for the legend. More... | |
virtual void | modifyRequestExtent (QgsRectangle &extent, QgsRenderContext &context) |
Allows for a renderer to modify the extent of a feature request prior to rendering. More... | |
virtual Q_DECL_DEPRECATED QgsSymbolV2 * | originalSymbolForFeature (QgsFeature &feature) |
Return symbol for feature. More... | |
virtual Q_DECL_DEPRECATED QgsSymbolV2List | originalSymbolsForFeature (QgsFeature &feat) |
Equivalent of originalSymbolsForFeature() call extended to support renderers that may use more symbols per feature - similar to symbolsForFeature() More... | |
QgsPaintEffect * | paintEffect () const |
Returns the current paint effect for the renderer. More... | |
virtual Q_DECL_DEPRECATED QString | rotationField () const |
return rotation field name (or empty string if not set or not supported by renderer) More... | |
void | setForceRasterRender (bool forceRaster) |
Sets whether the renderer should be rendered to a raster destination. More... | |
void | setPaintEffect (QgsPaintEffect *effect) |
Sets the current paint effect for the renderer. More... | |
virtual Q_DECL_DEPRECATED void | setRotationField (const QString &fieldName) |
sets rotation field of renderer (if supported by the renderer) More... | |
void | setUsingSymbolLevels (bool usingSymbolLevels) |
void | setVertexMarkerAppearance (int type, int size) |
set type and size of editing vertex markers for subsequent rendering More... | |
virtual Q_DECL_DEPRECATED void | startRender (QgsRenderContext &context, const QgsVectorLayer *vlayer) |
virtual Q_DECL_DEPRECATED QgsSymbolV2 * | symbolForFeature (QgsFeature &feature) |
To be overridden. More... | |
virtual Q_DECL_DEPRECATED QgsSymbolV2List | symbols () |
for symbol levels More... | |
virtual Q_DECL_DEPRECATED QgsSymbolV2List | symbolsForFeature (QgsFeature &feat) |
return list of symbols used for rendering the feature. More... | |
QString | type () const |
bool | usingSymbolLevels () const |
virtual Q_DECL_DEPRECATED bool | willRenderFeature (QgsFeature &feat) |
return whether the renderer will render a feature or not. More... | |
virtual Q_DECL_DEPRECATED QDomElement | writeSld (QDomDocument &doc, const QgsVectorLayer &layer) const |
create the SLD UserStyle element following the SLD v1.1 specs More... | |
virtual QDomElement | writeSld (QDomDocument &doc, const QString &styleName) const |
create the SLD UserStyle element following the SLD v1.1 specs with the given name More... | |
Static Public Member Functions | |
static QgsPointDisplacementRenderer * | convertFromRenderer (const QgsFeatureRendererV2 *renderer) |
creates a QgsPointDisplacementRenderer from an existing renderer. More... | |
static QgsFeatureRendererV2 * | create (QDomElement &symbologyElem) |
create a renderer from XML element More... | |
Static Public Member Functions inherited from QgsFeatureRendererV2 | |
static QgsFeatureRendererV2 * | defaultRenderer (QGis::GeometryType geomType) |
return a new renderer - used by default in vector layers More... | |
static QgsFeatureRendererV2 * | load (QDomElement &symbologyElem) |
create a renderer from XML element More... | |
static QgsFeatureRendererV2 * | loadSld (const QDomNode &node, QGis::GeometryType geomType, QString &errorMessage) |
Create a new renderer according to the information contained in the UserStyle element of a SLD style document. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from QgsFeatureRendererV2 | |
QgsFeatureRendererV2 (const QString &type) | |
void | copyPaintEffect (QgsFeatureRendererV2 *destRenderer) const |
Copies paint effect of this renderer to another renderer. More... | |
void | renderFeatureWithSymbol (QgsFeature &feature, QgsSymbolV2 *symbol, QgsRenderContext &context, int layer, bool selected, bool drawVertexMarker) |
void | renderVertexMarker (const QPointF &pt, QgsRenderContext &context) |
render editing vertex marker at specified point More... | |
void | renderVertexMarkerPolygon (QPolygonF &pts, QList< QPolygonF > *rings, QgsRenderContext &context) |
render editing vertex marker for a polygon More... | |
void | renderVertexMarkerPolyline (QPolygonF &pts, QgsRenderContext &context) |
render editing vertex marker for a polyline More... | |
void | setScaleMethodToSymbol (QgsSymbolV2 *symbol, int scaleMethod) |
Static Protected Member Functions inherited from QgsFeatureRendererV2 | |
static const unsigned char * | _getLineString (QPolygonF &pts, QgsRenderContext &context, const unsigned char *wkb, bool clipToExtent=true) |
static const unsigned char * | _getPoint (QPointF &pt, QgsRenderContext &context, const unsigned char *wkb) |
static const unsigned char * | _getPolygon (QPolygonF &pts, QList< QPolygonF > &holes, QgsRenderContext &context, const unsigned char *wkb, bool clipToExtent=true) |
static void | convertSymbolRotation (QgsSymbolV2 *symbol, const QString &field) |
static void | convertSymbolSizeScale (QgsSymbolV2 *symbol, QgsSymbolV2::ScaleMethod method, const QString &field) |
Protected Attributes inherited from QgsFeatureRendererV2 | |
int | mCurrentVertexMarkerSize |
The current size of editing marker. More... | |
int | mCurrentVertexMarkerType |
The current type of editing marker. More... | |
bool | mForceRaster |
QgsPaintEffect * | mPaintEffect |
QString | mType |
bool | mUsingSymbolLevels |
A renderer that automatically displaces points with the same position.
Definition at line 31 of file qgspointdisplacementrenderer.h.
Placement methods for dispersing points.
Enumerator | |
---|---|
Ring |
Place points in a single ring around group |
ConcentricRings |
Place points in concentric rings around group |
Definition at line 37 of file qgspointdisplacementrenderer.h.
QgsPointDisplacementRenderer::QgsPointDisplacementRenderer | ( | const QString & | labelAttributeName = "" | ) |
Definition at line 41 of file qgspointdisplacementrenderer.cpp.
QgsPointDisplacementRenderer::~QgsPointDisplacementRenderer | ( | ) |
Definition at line 59 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 236 of file qgspointdisplacementrenderer.cpp.
|
inline |
Returns the symbol for the center of a displacement group (but not ownership of the symbol)
Definition at line 126 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 101 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 107 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 98 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
Implements QgsFeatureRendererV2.
Definition at line 65 of file qgspointdisplacementrenderer.cpp.
|
static |
creates a QgsPointDisplacementRenderer from an existing renderer.
Definition at line 647 of file qgspointdisplacementrenderer.cpp.
|
static |
create a renderer from XML element
Definition at line 352 of file qgspointdisplacementrenderer.cpp.
|
inline |
Definition at line 88 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 84 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 104 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 95 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
Reimplemented from QgsFeatureRendererV2.
Definition at line 431 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
return a list of symbology items for the legend
Reimplemented from QgsFeatureRendererV2.
Definition at line 422 of file qgspointdisplacementrenderer.cpp.
|
inline |
Definition at line 110 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 263 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 279 of file qgspointdisplacementrenderer.cpp.
|
inline |
Returns the placement method used for dispersing the points.
Definition at line 116 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
Reimplemented from QgsFeatureRendererV2.
Reimplemented from QgsFeatureRendererV2.
Definition at line 93 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
store renderer info to XML element
Reimplemented from QgsFeatureRendererV2.
Definition at line 388 of file qgspointdisplacementrenderer.cpp.
void QgsPointDisplacementRenderer::setCenterSymbol | ( | QgsMarkerSymbolV2 * | symbol | ) |
Sets the center symbol (takes ownership)
Definition at line 472 of file qgspointdisplacementrenderer.cpp.
|
inline |
Definition at line 100 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 106 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 97 of file qgspointdisplacementrenderer.h.
|
inline |
not available in python bindings
Definition at line 92 of file qgspointdisplacementrenderer.h.
void QgsPointDisplacementRenderer::setEmbeddedRenderer | ( | QgsFeatureRendererV2 * | r | ) |
Sets embedded renderer (takes ownership)
Definition at line 216 of file qgspointdisplacementrenderer.cpp.
|
inline |
Definition at line 83 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 103 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 94 of file qgspointdisplacementrenderer.h.
|
inline |
Definition at line 109 of file qgspointdisplacementrenderer.h.
|
inline |
Sets the placement method used for dispersing the points.
placement | placement method |
Definition at line 123 of file qgspointdisplacementrenderer.h.
|
inline |
Sets the tolerance distance for grouping points.
Units are specified using setToleranceUnit().
t | tolerance distance |
Definition at line 136 of file qgspointdisplacementrenderer.h.
|
inline |
Sets the map unit scale object for the distance tolerance.
This is only used if the toleranceUnit() is set to QgsSymbolV2::MapUnit.
scale | scale for distance tolerance |
Definition at line 166 of file qgspointdisplacementrenderer.h.
|
inline |
Sets the units for the tolerance distance.
unit | tolerance distance units |
Definition at line 151 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
Needs to be called when a new render cycle is started.
context | Additional information passed to the renderer about the job which will be rendered |
fields | The fields available for rendering |
Implements QgsFeatureRendererV2.
Definition at line 296 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Implements QgsFeatureRendererV2.
Definition at line 330 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 254 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 245 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 270 of file qgspointdisplacementrenderer.cpp.
|
inline |
Returns the tolerance distance for grouping points.
Units are retrieved using toleranceUnit().
Definition at line 143 of file qgspointdisplacementrenderer.h.
|
inline |
Returns the map unit scale object for the distance tolerance.
This is only used if the toleranceUnit() is set to QgsSymbolV2::MapUnit.
Definition at line 173 of file qgspointdisplacementrenderer.h.
|
inline |
Returns the units for the tolerance distance.
Definition at line 158 of file qgspointdisplacementrenderer.h.
|
overridevirtual |
used from subclasses to create SLD Rule elements following SLD v1.1 specs
Reimplemented from QgsFeatureRendererV2.
Definition at line 87 of file qgspointdisplacementrenderer.cpp.
Partial proxy that will call this method on the embedded renderer.
Implements QgsFeatureRendererV2.
Definition at line 222 of file qgspointdisplacementrenderer.cpp.
|
overridevirtual |
Proxy that will call this method on the embedded renderer.
Reimplemented from QgsFeatureRendererV2.
Definition at line 286 of file qgspointdisplacementrenderer.cpp.