#include <qgsrendererv2.h>

Inheritance diagram for QgsFeatureRendererV2:

Public Types
enum	Capabilities { SymbolLevels = 1, RotationField = 1 << 1, MoreSymbolsPerFeature = 1 << 2, Filter = 1 << 3, ScaleDependent = 1 << 4 }
Public Member Functions
virtual	~QgsFeatureRendererV2 ()
virtual int	capabilities ()
	returns bitwise OR-ed capabilities of the renderer
virtual QgsFeatureRendererV2 *	clone ()=0
virtual QString	dump ()
	for debugging
virtual QgsLegendSymbolList	legendSymbolItems ()
	return a list of item text / symbol
virtual QgsLegendSymbologyList	legendSymbologyItems (QSize iconSize)
	return a list of symbology items for the legend
virtual bool	renderFeature (QgsFeature &feature, QgsRenderContext &context, int layer=-1, bool selected=false, bool drawVertexMarker=false)
virtual QString	rotationField () const
	return rotation field name (or empty string if not set or not supported by renderer)
virtual QDomElement	save (QDomDocument &doc)
	store renderer info to XML element
virtual void	setRotationField (QString fieldName)
	sets rotation field of renderer (if supported by the renderer)
void	setUsingSymbolLevels (bool usingSymbolLevels)
void	setVertexMarkerAppearance (int type, int size)
	set type and size of editing vertex markers for subsequent rendering
virtual void	startRender (QgsRenderContext &context, const QgsVectorLayer *vlayer)=0
virtual void	stopRender (QgsRenderContext &context)=0
virtual QgsSymbolV2 *	symbolForFeature (QgsFeature &feature)=0
	to be overridden
virtual QgsSymbolV2List	symbols ()=0
	for symbol levels
virtual QgsSymbolV2List	symbolsForFeature (QgsFeature &feat)
	return list of symbols used for rendering the feature.
virtual void	toSld (QDomDocument &doc, QDomElement &element) const
	used from subclasses to create SLD Rule elements following SLD v1.1 specs
QString	type () const
virtual QList< QString >	usedAttributes ()=0
bool	usingSymbolLevels () const
virtual bool	willRenderFeature (QgsFeature &feat)
	return whether the renderer will render a feature or not.
virtual QDomElement	writeSld (QDomDocument &doc, const QgsVectorLayer &layer) const
	create the SLD UserStyle element following the SLD v1.1 specs
Static Public Member Functions
static QgsFeatureRendererV2 *	defaultRenderer (QGis::GeometryType geomType)
	return a new renderer - used by default in vector layers
static QgsFeatureRendererV2 *	load (QDomElement &symbologyElem)
	create a renderer from XML element
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
Protected Member Functions
	QgsFeatureRendererV2 (QString type)
void	renderFeatureWithSymbol (QgsFeature &feature, QgsSymbolV2 *symbol, QgsRenderContext &context, int layer, bool selected, bool drawVertexMarker)
void	renderVertexMarker (QPointF &pt, QgsRenderContext &context)
	render editing vertex marker at specified point
void	renderVertexMarkerPolygon (QPolygonF &pts, QList< QPolygonF > *rings, QgsRenderContext &context)
	render editing vertex marker for a polygon
void	renderVertexMarkerPolyline (QPolygonF &pts, QgsRenderContext &context)
	render editing vertex marker for a polyline
void	setScaleMethodToSymbol (QgsSymbolV2 *symbol, int scaleMethod)
Static Protected Member Functions
static unsigned char *	_getLineString (QPolygonF &pts, QgsRenderContext &context, unsigned char *wkb)
static unsigned char *	_getPoint (QPointF &pt, QgsRenderContext &context, unsigned char *wkb)
static unsigned char *	_getPolygon (QPolygonF &pts, QList< QPolygonF > &holes, QgsRenderContext &context, unsigned char *wkb)
Protected Attributes
int	mCurrentVertexMarkerSize
	The current size of editing marker.
int	mCurrentVertexMarkerType
	The current type of editing marker.
QString	mType
bool	mUsingSymbolLevels

Detailed Description

Definition at line 68 of file qgsrendererv2.h.

Member Enumeration Documentation

enum QgsFeatureRendererV2::Capabilities

Enumerator:

SymbolLevels
RotationField
MoreSymbolsPerFeature
Filter
ScaleDependent

Definition at line 99 of file qgsrendererv2.h.

Constructor & Destructor Documentation

virtual QgsFeatureRendererV2::~QgsFeatureRendererV2 ( ) [inline, virtual]

Definition at line 90 of file qgsrendererv2.h.

QgsFeatureRendererV2::QgsFeatureRendererV2 ( QString type ) [protected]

Definition at line 202 of file qgsrendererv2.cpp.

Member Function Documentation

unsigned char * QgsFeatureRendererV2::_getLineString	(	QPolygonF &	pts,
		QgsRenderContext &	context,
		unsigned char *	wkb
	)		`[static, protected]`

Definition at line 61 of file qgsrendererv2.cpp.

References QgsClipper::clippedLineWKB(), QgsRenderContext::coordinateTransform(), QgsRenderContext::extent(), QgsRectangle::height(), QgsRenderContext::mapToPixel(), QgsMapToPixel::transformInPlace(), QgsCoordinateTransform::transformPolygon(), QgsRectangle::width(), QGis::WKBLineString25D, QgsRectangle::xMaximum(), QgsRectangle::xMinimum(), QgsRectangle::yMaximum(), and QgsRectangle::yMinimum().

Referenced by renderFeatureWithSymbol().

unsigned char * QgsFeatureRendererV2::_getPoint	(	QPointF &	pt,
		QgsRenderContext &	context,
		unsigned char *	wkb
	)		`[static, protected]`

Definition at line 37 of file qgsrendererv2.cpp.

References QgsRenderContext::coordinateTransform(), QgsRenderContext::mapToPixel(), QgsMapToPixel::transformInPlace(), QgsCoordinateTransform::transformInPlace(), and QGis::WKBPolygon25D.

Referenced by QgsPointDisplacementRenderer::renderFeature(), and renderFeatureWithSymbol().

unsigned char * QgsFeatureRendererV2::_getPolygon	(	QPolygonF &	pts,
		QList< QPolygonF > &	holes,
		QgsRenderContext &	context,
		unsigned char *	wkb
	)		`[static, protected]`

Definition at line 117 of file qgsrendererv2.cpp.

References QgsRenderContext::coordinateTransform(), QgsRenderContext::extent(), QgsRectangle::height(), QgsRenderContext::mapToPixel(), QgsMapToPixel::transformInPlace(), QgsCoordinateTransform::transformPolygon(), QgsClipper::trimPolygon(), QgsRectangle::width(), QGis::WKBPolygon25D, QgsRectangle::xMaximum(), QgsRectangle::xMinimum(), QgsRectangle::yMaximum(), and QgsRectangle::yMinimum().

Referenced by renderFeatureWithSymbol().

virtual int QgsFeatureRendererV2::capabilities ( ) [inline, virtual]

returns bitwise OR-ed capabilities of the renderer

Note:: added in 2.0

Reimplemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, and QgsSingleSymbolRendererV2.

Definition at line 110 of file qgsrendererv2.h.

Referenced by QgsVectorLayer::draw(), QgsAttributeTableFilterModel::generateListOfVisibleFeatures(), QgsMapToolIdentify::identifyVectorLayer(), and QgsVectorFileWriter::writeAsVectorFormat().

virtual QgsFeatureRendererV2* QgsFeatureRendererV2::clone ( ) [pure virtual]

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Referenced by QgsRendererV2PropertiesDialog::apply(), QgsPointDisplacementRenderer::clone(), QgsPointDisplacementRendererWidget::on_mRendererComboBox_currentIndexChanged(), QgsPointDisplacementRendererWidget::QgsPointDisplacementRendererWidget(), QgsPointDisplacementRendererWidget::renderer(), and QgsRendererV2PropertiesDialog::rendererChanged().

QgsFeatureRendererV2 * QgsFeatureRendererV2::defaultRenderer ( QGis::GeometryType geomType ) [static]

return a new renderer - used by default in vector layers

Definition at line 209 of file qgsrendererv2.cpp.

References QgsSymbolV2::defaultSymbol().

Referenced by QgsPointDisplacementRenderer::QgsPointDisplacementRenderer(), QgsVectorLayer::QgsVectorLayer(), and QgsVectorLayer::readSymbology().

QString QgsFeatureRendererV2::dump ( ) [virtual]

for debugging

Reimplemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, and QgsSingleSymbolRendererV2.

Definition at line 365 of file qgsrendererv2.cpp.

Referenced by QgsVectorLayer::draw().

QgsLegendSymbolList QgsFeatureRendererV2::legendSymbolItems ( ) [virtual]

return a list of item text / symbol

Note:: : this method was added in version 1.5; : not available in python bindings

Reimplemented in QgsRuleBasedRendererV2, QgsGraduatedSymbolRendererV2, QgsCategorizedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Definition at line 510 of file qgsrendererv2.cpp.

Referenced by QgsLegendModel::addVectorLayerItemsV2(), QgsVectorLayer::countSymbolFeatures(), QgsPointDisplacementRenderer::legendSymbolItems(), QgsComposerLayerItem::setDefaultStyle(), QgsRendererV2Widget::showSymbolLevelsDialog(), and QgsLegendModel::updateSymbolV2ItemText().

QgsLegendSymbologyList QgsFeatureRendererV2::legendSymbologyItems ( QSize iconSize ) [virtual]

return a list of symbology items for the legend

Reimplemented in QgsRuleBasedRendererV2, QgsGraduatedSymbolRendererV2, QgsCategorizedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Definition at line 503 of file qgsrendererv2.cpp.

Referenced by QgsPointDisplacementRenderer::legendSymbologyItems().

QgsFeatureRendererV2 * QgsFeatureRendererV2::load ( QDomElement & symbologyElem ) [static]

create a renderer from XML element

Definition at line 371 of file qgsrendererv2.cpp.

References QgsRendererV2AbstractMetadata::createRenderer(), QgsRendererV2Registry::instance(), QgsRendererV2Registry::rendererMetadata(), and setUsingSymbolLevels().

Referenced by QgsPointDisplacementRenderer::create(), and QgsVectorLayer::readSymbology().

QgsFeatureRendererV2 * QgsFeatureRendererV2::loadSld	(	const QDomNode &	node,
		QGis::GeometryType	geomType,
		QString &	errorMessage
	)		`[static]`

create a new renderer according to the information contained in the UserStyle element of a SLD style document

Parameters:

node	the node in the SLD document whose the UserStyle element is a child
geomType	the geometry type of the features, used to convert Symbolizer elements
errorMessage	it will contain the error message if something went wrong

Returns:: the renderer

Note:: added in 1.9

Definition at line 399 of file qgsrendererv2.cpp.

References QgsRendererV2AbstractMetadata::createRendererFromSld(), QgsRendererV2Registry::instance(), QgsDebugMsg, and QgsRendererV2Registry::rendererMetadata().

Referenced by QgsVectorLayer::readSld().

bool QgsFeatureRendererV2::renderFeature	(	QgsFeature &	feature,
		QgsRenderContext &	context,
		int	layer = `-1`,
		bool	selected = `false`,
		bool	drawVertexMarker = `false`
	)		`[virtual]`

Reimplemented in QgsRuleBasedRendererV2, and QgsPointDisplacementRenderer.

Definition at line 215 of file qgsrendererv2.cpp.

References renderFeatureWithSymbol(), and symbolForFeature().

Referenced by QgsVectorLayer::drawRendererV2(), and QgsVectorLayer::drawRendererV2Levels().

void QgsFeatureRendererV2::renderFeatureWithSymbol	(	QgsFeature &	feature,
		QgsSymbolV2 *	symbol,
		QgsRenderContext &	context,
		int	layer,
		bool	selected,
		bool	drawVertexMarker
	)		`[protected]`

void QgsFeatureRendererV2::renderVertexMarker	(	QPointF &	pt,
		QgsRenderContext &	context
	)		`[protected]`

render editing vertex marker at specified point

Definition at line 521 of file qgsrendererv2.cpp.

References QgsVectorLayer::drawVertexMarker(), mCurrentVertexMarkerSize, mCurrentVertexMarkerType, and QgsRenderContext::painter().

Referenced by renderVertexMarkerPolygon(), and renderVertexMarkerPolyline().

void QgsFeatureRendererV2::renderVertexMarkerPolygon	(	QPolygonF &	pts,
		QList< QPolygonF > *	rings,
		QgsRenderContext &	context
	)		`[protected]`

render editing vertex marker for a polygon

Definition at line 534 of file qgsrendererv2.cpp.

References renderVertexMarker().

Referenced by renderFeatureWithSymbol().

void QgsFeatureRendererV2::renderVertexMarkerPolyline	(	QPolygonF &	pts,
		QgsRenderContext &	context
	)		`[protected]`

render editing vertex marker for a polyline

Definition at line 528 of file qgsrendererv2.cpp.

References renderVertexMarker().

Referenced by renderFeatureWithSymbol().

virtual QString QgsFeatureRendererV2::rotationField ( ) const [inline, virtual]

return rotation field name (or empty string if not set or not supported by renderer)

Note:: added in 1.9

Reimplemented in QgsGraduatedSymbolRendererV2, QgsCategorizedSymbolRendererV2, and QgsSingleSymbolRendererV2.

Definition at line 159 of file qgsrendererv2.h.

QDomElement QgsFeatureRendererV2::save ( QDomDocument & doc ) [virtual]

store renderer info to XML element

Reimplemented in QgsRuleBasedRendererV2, QgsGraduatedSymbolRendererV2, QgsCategorizedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Definition at line 393 of file qgsrendererv2.cpp.

References RENDERER_TAG_NAME.

Referenced by QgsPointDisplacementRenderer::save(), and QgsVectorLayer::writeSymbology().

virtual void QgsFeatureRendererV2::setRotationField ( QString fieldName ) [inline, virtual]

sets rotation field of renderer (if supported by the renderer)

Note:: added in 1.9

Reimplemented in QgsGraduatedSymbolRendererV2, QgsCategorizedSymbolRendererV2, and QgsSingleSymbolRendererV2.

Definition at line 162 of file qgsrendererv2.h.

void QgsFeatureRendererV2::setScaleMethodToSymbol	(	QgsSymbolV2 *	symbol,
		int	scaleMethod
	)		`[protected]`

Definition at line 186 of file qgsrendererv2.cpp.

References QgsSymbolV2::Marker, QgsMarkerSymbolV2::setScaleMethod(), and QgsSymbolV2::type().

Referenced by QgsSingleSymbolRendererV2::setScaleMethod(), QgsCategorizedSymbolRendererV2::setScaleMethod(), and QgsGraduatedSymbolRendererV2::setScaleMethod().

void QgsFeatureRendererV2::setUsingSymbolLevels ( bool usingSymbolLevels ) [inline]

Definition at line 116 of file qgsrendererv2.h.

Referenced by QgsSingleSymbolRendererV2::clone(), QgsGraduatedSymbolRendererV2::clone(), QgsCategorizedSymbolRendererV2::clone(), QgsRuleBasedRendererV2::clone(), load(), and QgsRendererV2Widget::showSymbolLevelsDialog().

void QgsFeatureRendererV2::setVertexMarkerAppearance	(	int	type,
		int	size
	)

set type and size of editing vertex markers for subsequent rendering

Definition at line 515 of file qgsrendererv2.cpp.

References mCurrentVertexMarkerSize, mCurrentVertexMarkerType, size, and type().

Referenced by QgsVectorLayer::draw(), and QgsVectorLayer::drawRendererV2Levels().

virtual void QgsFeatureRendererV2::startRender	(	QgsRenderContext &	context,
		const QgsVectorLayer *	vlayer
	)		`[pure virtual]`

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsPointDisplacementRenderer, and QgsSingleSymbolRendererV2.

Referenced by QgsVectorLayer::countSymbolFeatures(), QgsVectorLayer::draw(), QgsVectorLayer::drawLabels(), QgsAttributeTableFilterModel::generateListOfVisibleFeatures(), QgsMapToolIdentify::identifyVectorLayer(), QgsPointDisplacementRenderer::startRender(), and QgsVectorFileWriter::startRender().

virtual void QgsFeatureRendererV2::stopRender ( QgsRenderContext & context ) [pure virtual]

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsPointDisplacementRenderer, and QgsSingleSymbolRendererV2.

Referenced by QgsVectorLayer::countSymbolFeatures(), QgsVectorLayer::drawLabels(), QgsAttributeTableFilterModel::generateListOfVisibleFeatures(), QgsMapToolIdentify::identifyVectorLayer(), QgsPointDisplacementRenderer::stopRender(), QgsVectorFileWriter::stopRender(), and QgsVectorLayer::stopRendererV2().

virtual QgsSymbolV2* QgsFeatureRendererV2::symbolForFeature ( QgsFeature & feature ) [pure virtual]

to be overridden

Parameters:

feature feature

Returns:: returns pointer to symbol or 0 if symbol was not found

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsPointDisplacementRenderer, and QgsSingleSymbolRendererV2.

Referenced by QgsVectorLayer::drawRendererV2Levels(), QgsVectorFileWriter::exportFeaturesSymbolLevels(), renderFeature(), and symbolsForFeature().

virtual QgsSymbolV2List QgsFeatureRendererV2::symbols ( ) [pure virtual]

for symbol levels

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Referenced by QgsVectorFileWriter::createSymbolLayerTable(), QgsVectorLayer::drawRendererV2Levels(), QgsVectorFileWriter::exportFeaturesSymbolLevels(), and QgsPointDisplacementRenderer::symbols().

QgsSymbolV2List QgsFeatureRendererV2::symbolsForFeature ( QgsFeature & feat ) [virtual]

return list of symbols used for rendering the feature.

For renderers that do not support MoreSymbolsPerFeature it is more efficient to use symbolForFeature()

Note:: added in 1.9

Reimplemented in QgsRuleBasedRendererV2.

Definition at line 549 of file qgsrendererv2.cpp.

References symbolForFeature().

Referenced by QgsVectorFileWriter::addFeature(), QgsVectorLayer::countSymbolFeatures(), and QgsPointDisplacementRenderer::firstSymbolForFeature().

virtual void QgsFeatureRendererV2::toSld	(	QDomDocument &	doc,
		QDomElement &	element
	)		const `[inline, virtual]`

used from subclasses to create SLD Rule elements following SLD v1.1 specs

Note:: added in 1.9

Reimplemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsSingleSymbolRendererV2, and QgsPointDisplacementRenderer.

Definition at line 143 of file qgsrendererv2.h.

Referenced by QgsPointDisplacementRenderer::toSld(), and writeSld().

QString QgsFeatureRendererV2::type ( ) const [inline]

Definition at line 76 of file qgsrendererv2.h.

Referenced by QgsCategorizedSymbolRendererV2Widget::QgsCategorizedSymbolRendererV2Widget(), QgsGraduatedSymbolRendererV2Widget::QgsGraduatedSymbolRendererV2Widget(), QgsPointDisplacementRendererWidget::QgsPointDisplacementRendererWidget(), QgsRendererV2PropertiesDialog::QgsRendererV2PropertiesDialog(), QgsRuleBasedRendererV2Widget::QgsRuleBasedRendererV2Widget(), QgsSingleSymbolRendererV2Widget::QgsSingleSymbolRendererV2Widget(), and setVertexMarkerAppearance().

virtual QList<QString> QgsFeatureRendererV2::usedAttributes ( ) [pure virtual]

Implemented in QgsRuleBasedRendererV2, QgsCategorizedSymbolRendererV2, QgsGraduatedSymbolRendererV2, QgsPointDisplacementRenderer, and QgsSingleSymbolRendererV2.

Referenced by QgsVectorFileWriter::addRendererAttributes(), QgsVectorLayer::draw(), QgsVectorLayer::drawLabels(), and QgsPointDisplacementRenderer::usedAttributes().

bool QgsFeatureRendererV2::usingSymbolLevels ( ) const [inline]

Definition at line 115 of file qgsrendererv2.h.

Referenced by QgsSingleSymbolRendererV2::clone(), QgsGraduatedSymbolRendererV2::clone(), QgsCategorizedSymbolRendererV2::clone(), QgsRuleBasedRendererV2::clone(), QgsVectorLayer::draw(), QgsRendererV2Widget::showSymbolLevelsDialog(), and QgsVectorFileWriter::writeAsVectorFormat().

virtual bool QgsFeatureRendererV2::willRenderFeature ( QgsFeature & feat ) [inline, virtual]

return whether the renderer will render a feature or not.

Must be called between startRender() and stopRender() calls. Default implementation uses symbolForFeature().

Note:: added in 1.9

Reimplemented in QgsRuleBasedRendererV2.

Definition at line 168 of file qgsrendererv2.h.

Referenced by QgsVectorLayer::drawLabels(), QgsAttributeTableFilterModel::generateListOfVisibleFeatures(), and QgsMapToolIdentify::identifyVectorLayer().

QDomElement QgsFeatureRendererV2::writeSld	(	QDomDocument &	doc,
		const QgsVectorLayer &	layer
	)		const `[virtual]`

create the SLD UserStyle element following the SLD v1.1 specs

Note:: added in 1.9

Definition at line 488 of file qgsrendererv2.cpp.

References QgsMapLayer::name(), and toSld().

Referenced by QgsVectorLayer::writeSld().

Member Data Documentation

int QgsFeatureRendererV2::mCurrentVertexMarkerSize [protected]

The current size of editing marker.

Definition at line 206 of file qgsrendererv2.h.

Referenced by renderVertexMarker(), and setVertexMarkerAppearance().

int QgsFeatureRendererV2::mCurrentVertexMarkerType [protected]

The current type of editing marker.

Definition at line 204 of file qgsrendererv2.h.

Referenced by renderVertexMarker(), and setVertexMarkerAppearance().

QString QgsFeatureRendererV2::mType [protected]

Definition at line 199 of file qgsrendererv2.h.

bool QgsFeatureRendererV2::mUsingSymbolLevels [protected]

Definition at line 201 of file qgsrendererv2.h.

Referenced by QgsSingleSymbolRendererV2::save(), QgsCategorizedSymbolRendererV2::save(), QgsGraduatedSymbolRendererV2::save(), and QgsRuleBasedRendererV2::save().

The documentation for this class was generated from the following files:

src/core/symbology-ng/qgsrendererv2.h
src/core/symbology-ng/qgsrendererv2.cpp

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation