mirror of
https://github.com/qgis/QGIS.git
synced 2025-03-09 00:35:20 -05:00
590d1aae9d
Adds a new visitor pattern API for creation of visitors which visit all the style entities (symbols, color ramps, text formats, and label styles) associated with different objects. Can be used on a renderer, map layer, or project wide level. E.g. on a project wide level, allows collection of ALL the style symbols/color ramps/text settings inside a project, including those in layouts or annotations!
153 lines
5.5 KiB
Plaintext
153 lines
5.5 KiB
Plaintext
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/symbology/qgsinvertedpolygonrenderer.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|
|
|
|
|
|
class QgsInvertedPolygonRenderer : QgsFeatureRenderer
|
|
{
|
|
%Docstring
|
|
QgsInvertedPolygonRenderer is a polygon-only feature renderer used to
|
|
display features inverted, where the exterior is turned to an interior
|
|
and where the exterior theoretically spans the entire plane, allowing
|
|
to mask the surroundings of some features.
|
|
|
|
It is designed on top of another feature renderer, which is called "embedded"
|
|
Most of the methods are then only proxies to the embedded renderer.
|
|
|
|
Features are collected to form one "inverted" polygon
|
|
during renderFeature() and rendered on stopRender().
|
|
|
|
.. versionadded:: 2.4
|
|
%End
|
|
|
|
%TypeHeaderCode
|
|
#include "qgsinvertedpolygonrenderer.h"
|
|
%End
|
|
public:
|
|
|
|
QgsInvertedPolygonRenderer( QgsFeatureRenderer *embeddedRenderer /Transfer/ = 0 );
|
|
%Docstring
|
|
Constructor
|
|
|
|
:param embeddedRenderer: optional embeddedRenderer. If ``None``, a default one will be assigned.
|
|
Ownership will be transferred.
|
|
%End
|
|
|
|
|
|
virtual QgsInvertedPolygonRenderer *clone() const /Factory/;
|
|
|
|
%Docstring
|
|
Direct copies are forbidden. Use clone() instead.
|
|
%End
|
|
virtual void startRender( QgsRenderContext &context, const QgsFields &fields );
|
|
|
|
|
|
virtual bool renderFeature( const QgsFeature &feature, QgsRenderContext &context, int layer = -1, bool selected = false, bool drawVertexMarker = false ) throw( QgsCsException );
|
|
|
|
%Docstring
|
|
Renders a given feature.
|
|
This will here collect features. The actual rendering will be postponed to stopRender()
|
|
|
|
:param feature: the feature to render
|
|
:param context: the rendering context
|
|
:param layer: the symbol layer to render, if that makes sense
|
|
:param selected: whether this feature has been selected (this will add decorations)
|
|
:param drawVertexMarker: whether this feature has vertex markers (in edit mode usually)
|
|
|
|
:return: ``True`` if the rendering was OK
|
|
%End
|
|
|
|
virtual void stopRender( QgsRenderContext &context );
|
|
|
|
%Docstring
|
|
The actual rendering will take place here.
|
|
Features collected during renderFeature() are rendered using the embedded feature renderer
|
|
%End
|
|
|
|
virtual QString dump() const;
|
|
|
|
virtual QSet<QString> usedAttributes( const QgsRenderContext &context ) const;
|
|
|
|
virtual bool filterNeedsGeometry() const;
|
|
|
|
virtual QgsFeatureRenderer::Capabilities capabilities();
|
|
|
|
virtual QgsSymbolList symbols( QgsRenderContext &context ) const;
|
|
|
|
virtual QgsSymbol *symbolForFeature( const QgsFeature &feature, QgsRenderContext &context ) const;
|
|
|
|
virtual QgsSymbol *originalSymbolForFeature( const QgsFeature &feature, QgsRenderContext &context ) const;
|
|
|
|
virtual QgsSymbolList symbolsForFeature( const QgsFeature &feature, QgsRenderContext &context ) const;
|
|
|
|
virtual QgsSymbolList originalSymbolsForFeature( const QgsFeature &feature, QgsRenderContext &context ) const;
|
|
|
|
virtual QgsLegendSymbolList legendSymbolItems() const;
|
|
|
|
virtual bool willRenderFeature( const QgsFeature &feature, QgsRenderContext &context ) const;
|
|
|
|
|
|
static QgsFeatureRenderer *create( QDomElement &element, const QgsReadWriteContext &context ) /Factory/;
|
|
%Docstring
|
|
Creates a renderer out of an XML, for loading
|
|
%End
|
|
|
|
virtual QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context );
|
|
|
|
|
|
virtual void setEmbeddedRenderer( QgsFeatureRenderer *subRenderer /Transfer/ );
|
|
|
|
virtual const QgsFeatureRenderer *embeddedRenderer() const;
|
|
|
|
|
|
virtual void setLegendSymbolItem( const QString &key, QgsSymbol *symbol );
|
|
|
|
|
|
virtual bool legendSymbolItemsCheckable() const;
|
|
|
|
virtual bool legendSymbolItemChecked( const QString &key );
|
|
|
|
virtual void checkLegendSymbolItem( const QString &key, bool state = true );
|
|
|
|
virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
|
|
|
|
|
|
bool preprocessingEnabled() const;
|
|
%Docstring
|
|
|
|
:return: ``True`` if the geometries are to be preprocessed (merged with an union) before rendering.
|
|
%End
|
|
|
|
void setPreprocessingEnabled( bool enabled );
|
|
%Docstring
|
|
|
|
:param enabled: enables or disables the preprocessing.
|
|
When enabled, geometries will be merged with an union before being rendered.
|
|
It allows fixing some rendering artifacts (when rendering overlapping polygons for instance).
|
|
This will involve some CPU-demanding computations and is thus disabled by default.
|
|
%End
|
|
|
|
static QgsInvertedPolygonRenderer *convertFromRenderer( const QgsFeatureRenderer *renderer ) /Factory/;
|
|
%Docstring
|
|
Creates a QgsInvertedPolygonRenderer by a conversion from an existing renderer.
|
|
|
|
:return: a new renderer if the conversion was possible, otherwise 0.
|
|
|
|
.. versionadded:: 2.5
|
|
%End
|
|
|
|
};
|
|
|
|
|
|
/************************************************************************
|
|
* This file has been generated automatically from *
|
|
* *
|
|
* src/core/symbology/qgsinvertedpolygonrenderer.h *
|
|
* *
|
|
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
|
|
************************************************************************/
|