QGIS API Documentation  master-3f58142
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes
QgsSymbolV2 Class Reference

#include <qgssymbolv2.h>

+ Inheritance diagram for QgsSymbolV2:

List of all members.

Public Types

enum  OutputUnit { MM = 0, MapUnit, Mixed }
enum  RenderHint { DataDefinedSizeScale = 1, DataDefinedRotation = 2 }
enum  ScaleMethod { ScaleArea, ScaleDiameter }
enum  SymbolType { Marker, Line, Fill }

Public Member Functions

virtual ~QgsSymbolV2 ()
qreal alpha () const
 Get alpha transparency 1 for opaque, 0 for invisible.
bool appendSymbolLayer (QgsSymbolLayerV2 *layer)
 append symbol layer at the end of the list
QImage bigSymbolPreviewImage ()
bool changeSymbolLayer (int index, QgsSymbolLayerV2 *layer)
 delete layer at specified index and set a new one
virtual QgsSymbolV2 * clone () const =0
QColor color ()
bool deleteSymbolLayer (int index)
 delete symbol layer at specified index
void drawPreviewIcon (QPainter *painter, QSize size)
QString dump ()
bool insertSymbolLayer (int index, QgsSymbolLayerV2 *layer)
 insert symbol layer to specified index
QgsSymbolV2::OutputUnit outputUnit () const
int renderHints () const
void setAlpha (qreal alpha)
 Set alpha transparency 1 for opaque, 0 for invisible.
void setColor (const QColor &color)
void setOutputUnit (QgsSymbolV2::OutputUnit u)
void setRenderHints (int hints)
void startRender (QgsRenderContext &context, const QgsVectorLayer *layer=0)
void stopRender (QgsRenderContext &context)
QgsSymbolLayerV2 * symbolLayer (int layer)
int symbolLayerCount ()
QgsSymbolLayerV2 * takeSymbolLayer (int index)
 remove symbol layer from the list and return pointer to it
void toSld (QDomDocument &doc, QDomElement &element, QgsStringMap props) const
SymbolType type () const
QSet< QString > usedAttributes () const

Static Public Member Functions

static QgsSymbolV2 * defaultSymbol (QGis::GeometryType geomType)
 return new default symbol for specified geometry type

Protected Member Functions

 QgsSymbolV2 (SymbolType type, QgsSymbolLayerV2List layers)
QgsSymbolLayerV2List cloneLayers () const
bool isSymbolLayerCompatible (SymbolType t)
 check whether a symbol layer type can be used within the symbol (marker-marker, line-line, fill-fill/line)

Protected Attributes

qreal mAlpha
 Symbol opacity (in the range 0 - 1)
QgsSymbolLayerV2List mLayers
int mRenderHints
SymbolType mType

Detailed Description

Definition at line 41 of file qgssymbolv2.h.

Member Enumeration Documentation

enum QgsSymbolV2::OutputUnit
Enumerator:
MM 
MapUnit 
Mixed 

Definition at line 45 of file qgssymbolv2.h.

enum QgsSymbolV2::RenderHint
Note:
added in 1.5
Enumerator:
DataDefinedSizeScale 
DataDefinedRotation 

Definition at line 66 of file qgssymbolv2.h.

enum QgsSymbolV2::ScaleMethod
Enumerator:
ScaleArea 
ScaleDiameter 

Definition at line 59 of file qgssymbolv2.h.

enum QgsSymbolV2::SymbolType
Enumerator:
Marker 
Line 
Fill 

Definition at line 52 of file qgssymbolv2.h.

Constructor & Destructor Documentation

QgsSymbolV2::~QgsSymbolV2 ( ) [virtual]

Definition at line 56 of file qgssymbolv2.cpp.

References mLayers.

QgsSymbolV2::QgsSymbolV2 ( SymbolType  type,
QgsSymbolLayerV2List  layers 
) [protected]

Definition at line 36 of file qgssymbolv2.cpp.

References isSymbolLayerCompatible(), mLayers, and type().

Member Function Documentation

qreal QgsSymbolV2::alpha ( ) const [inline]

Get alpha transparency 1 for opaque, 0 for invisible.

Definition at line 120 of file qgssymbolv2.h.

Referenced by QgsSymbolsListWidget::QgsSymbolsListWidget(), QgsSymbolLayerV2Utils::saveSymbol(), and toSld().

bool QgsSymbolV2::appendSymbolLayer ( QgsSymbolLayerV2 *  layer)

append symbol layer at the end of the list

Definition at line 173 of file qgssymbolv2.cpp.

References isSymbolLayerCompatible(), mLayers, and QgsSymbolLayerV2::type().

Referenced by QgsSymbolV2SelectorDialog::addLayer(), and QgsSymbolsListWidget::setSymbolFromStyle().

QImage QgsSymbolV2::bigSymbolPreviewImage ( )

Definition at line 275 of file qgssymbolv2.cpp.

References QgsSymbolLayerV2Utils::createRenderContext(), Fill, Line, Marker, mType, startRender(), and stopRender().

Referenced by QgsSymbolV2SelectorDialog::updatePreview().

bool QgsSymbolV2::changeSymbolLayer ( int  index,
QgsSymbolLayerV2 *  layer 
)

delete layer at specified index and set a new one

Definition at line 203 of file qgssymbolv2.cpp.

References isSymbolLayerCompatible(), mLayers, and QgsSymbolLayerV2::type().

Referenced by QgsSymbolV2SelectorDialog::changeLayer().

virtual QgsSymbolV2* QgsSymbolV2::clone ( ) const [pure virtual]

Implemented in QgsFillSymbolV2, QgsLineSymbolV2, and QgsMarkerSymbolV2.

Referenced by _createCategories(), QgsRendererRulePropsDialog::accept(), QgsCategorizedSymbolRendererV2Widget::addCategories(), QgsGraduatedSymbolRendererV2::addClass(), QgsSymbolsListWidget::addSymbolToStyle(), QgsCategorizedSymbolRendererV2Widget::changeCategorizedSymbol(), QgsCategorizedSymbolRendererV2Widget::changeCategorySymbol(), QgsGraduatedSymbolRendererV2Widget::changeGraduatedSymbol(), QgsCategorizedSymbolRendererV2Widget::changeSelectedSymbols(), QgsGraduatedSymbolRendererV2Widget::changeSelectedSymbols(), QgsSingleSymbolRendererV2Widget::changeSingleSymbol(), QgsSingleSymbolRendererV2::clone(), QgsGraduatedSymbolRendererV2::clone(), QgsCategorizedSymbolRendererV2::clone(), QgsComposerSymbolV2Item::clone(), QgsRuleBasedRendererV2::Rule::clone(), QgsGraduatedSymbolRendererV2::createRenderer(), QgsRendererRangeV2::operator=(), QgsRendererCategoryV2::operator=(), QgsRendererCategoryV2::QgsRendererCategoryV2(), QgsRendererRangeV2::QgsRendererRangeV2(), QgsRendererRulePropsDialog::QgsRendererRulePropsDialog(), QgsSingleSymbolRendererV2Widget::QgsSingleSymbolRendererV2Widget(), QgsRuleBasedRendererV2::refineRuleCategories(), QgsRuleBasedRendererV2::refineRuleRanges(), QgsRuleBasedRendererV2::refineRuleScales(), QgsSingleSymbolRendererV2::startRender(), QgsGraduatedSymbolRendererV2::startRender(), QgsCategorizedSymbolRendererV2::startRender(), QgsStyleV2::symbol(), QgsGraduatedSymbolRendererV2::updateColorRamp(), QgsCategorizedSymbolRendererV2::updateSymbols(), QgsGraduatedSymbolRendererV2::updateSymbols(), QgsCategorizedSymbolRendererV2Widget::updateUiFromRenderer(), and QgsGraduatedSymbolRendererV2Widget::updateUiFromRenderer().

QgsSymbolLayerV2List QgsSymbolV2::cloneLayers ( ) const [protected]

Definition at line 348 of file qgssymbolv2.cpp.

References QgsSymbolLayerV2::clone(), mLayers, QgsSymbolLayerV2::setLocked(), and QgsSymbolLayerV2::setRenderingPass().

Referenced by QgsMarkerSymbolV2::clone(), QgsLineSymbolV2::clone(), and QgsFillSymbolV2::clone().

QColor QgsSymbolV2::color ( void  )

Definition at line 240 of file qgssymbolv2.cpp.

References mLayers.

Referenced by dump(), QgsComposerMap::gridPen(), QgsMarkerLineSymbolLayerV2::setSubSymbol(), QgsCentroidFillSymbolLayerV2::setSubSymbol(), QgsSymbolsListWidget::updateSymbolColor(), QgsCategorizedSymbolRendererV2::updateSymbols(), and QgsGraduatedSymbolRendererV2::updateSymbols().

QgsSymbolV2 * QgsSymbolV2::defaultSymbol ( QGis::GeometryType  geomType) [static]

return new default symbol for specified geometry type

Definition at line 95 of file qgssymbolv2.cpp.

References QgsStyleV2::defaultStyle(), QgsProject::instance(), QGis::Line, QGis::Point, QGis::Polygon, QgsDebugMsg, QgsProject::readEntry(), setAlpha(), setColor(), and QgsStyleV2::symbol().

Referenced by QgsCategorizedSymbolRendererV2Widget::addCategory(), QgsRuleBasedRendererV2Widget::addRule(), QgsCategorizedSymbolRendererV2Widget::changeCategorySymbol(), QgsFeatureRendererV2::defaultRenderer(), QgsVectorLayer::drawRendererV2Levels(), QgsCategorizedSymbolRendererV2Widget::QgsCategorizedSymbolRendererV2Widget(), QgsGraduatedSymbolRendererV2Widget::QgsGraduatedSymbolRendererV2Widget(), QgsRendererRulePropsDialog::QgsRendererRulePropsDialog(), QgsRuleBasedRendererV2Widget::QgsRuleBasedRendererV2Widget(), and QgsSingleSymbolRendererV2Widget::QgsSingleSymbolRendererV2Widget().

bool QgsSymbolV2::deleteSymbolLayer ( int  index)

delete symbol layer at specified index

Definition at line 183 of file qgssymbolv2.cpp.

References mLayers.

Referenced by QgsSymbolsListWidget::setSymbolFromStyle().

void QgsSymbolV2::drawPreviewIcon ( QPainter *  painter,
QSize  size 
)

Definition at line 251 of file qgssymbolv2.cpp.

References QgsSymbolLayerV2Utils::createRenderContext(), Fill, Line, mAlpha, mLayers, mRenderHints, mType, outputUnit(), QgsLineSymbolLayerV2::renderPolygonOutline(), QgsSymbolLayerV2::startRender(), and QgsSymbolLayerV2::stopRender().

Referenced by QgsVectorFieldSymbolLayer::drawPreviewIcon(), QgsComposerLegend::drawSymbolV2(), and QgsSymbolLayerV2Utils::symbolPreviewPixmap().

QString QgsSymbolV2::dump ( )

Definition at line 316 of file qgssymbolv2.cpp.

References color(), QgsSymbolLayerV2Utils::encodeColor(), Fill, Line, Marker, mLayers, and type().

Referenced by QgsRendererRangeV2::dump(), QgsRendererCategoryV2::dump(), and QgsSingleSymbolRendererV2::dump().

bool QgsSymbolV2::insertSymbolLayer ( int  index,
QgsSymbolLayerV2 *  layer 
)

insert symbol layer to specified index

Definition at line 161 of file qgssymbolv2.cpp.

References isSymbolLayerCompatible(), mLayers, and QgsSymbolLayerV2::type().

Referenced by QgsSymbolV2SelectorDialog::moveLayerByOffset().

bool QgsSymbolV2::isSymbolLayerCompatible ( SymbolType  t) [protected]

check whether a symbol layer type can be used within the symbol (marker-marker, line-line, fill-fill/line)

Note:
added in 1.7

Definition at line 151 of file qgssymbolv2.cpp.

References Fill, Line, and mType.

Referenced by appendSymbolLayer(), changeSymbolLayer(), insertSymbolLayer(), and QgsSymbolV2().

QgsSymbolV2::OutputUnit QgsSymbolV2::outputUnit ( ) const

Definition at line 63 of file qgssymbolv2.cpp.

References Mixed, and mLayers.

Referenced by drawPreviewIcon(), QgsComposerLegend::drawSymbolV2(), QgsCentroidFillSymbolLayerV2::outputUnit(), QgsSymbolsListWidget::QgsSymbolsListWidget(), QgsMarkerSymbolV2::renderPoint(), QgsFillSymbolV2::renderPolygon(), QgsLineSymbolV2::renderPolyline(), startRender(), stopRender(), and toSld().

int QgsSymbolV2::renderHints ( ) const [inline]
Note:
added in 1.5

Definition at line 127 of file qgssymbolv2.h.

void QgsSymbolV2::setAlpha ( qreal  alpha) [inline]

Set alpha transparency 1 for opaque, 0 for invisible.

Definition at line 122 of file qgssymbolv2.h.

Referenced by QgsMarkerSymbolV2::clone(), QgsLineSymbolV2::clone(), QgsFillSymbolV2::clone(), QgsComposerMap::createDefaultOverviewFrameSymbol(), defaultSymbol(), QgsSymbolLayerV2Utils::loadSymbol(), QgsSymbolsListWidget::on_mTransparencySlider_valueChanged(), QgsMarkerLineSymbolLayerV2::startRender(), and QgsCentroidFillSymbolLayerV2::startRender().

void QgsSymbolV2::setColor ( const QColor &  color)

Definition at line 231 of file qgssymbolv2.cpp.

References mLayers.

Referenced by _createCategories(), QgsCategorizedSymbolRendererV2Widget::changeSelectedSymbols(), QgsGraduatedSymbolRendererV2Widget::changeSelectedSymbols(), QgsGraduatedSymbolRendererV2::createRenderer(), defaultSymbol(), QgsVectorLayer::drawRendererV2Levels(), QgsComposerMap::readXML(), QgsMarkerLineSymbolLayerV2::setColor(), QgsCentroidFillSymbolLayerV2::setColor(), QgsComposerMap::setGridPenColor(), QgsSymbolsListWidget::setSymbolColor(), QgsGraduatedSymbolRendererV2::updateColorRamp(), QgsCategorizedSymbolRendererV2::updateSymbols(), and QgsGraduatedSymbolRendererV2::updateSymbols().

void QgsSymbolV2::setOutputUnit ( QgsSymbolV2::OutputUnit  u)

Definition at line 86 of file qgssymbolv2.cpp.

References mLayers.

Referenced by QgsComposerLegend::drawSymbolV2(), QgsSymbolLayerV2Utils::loadSymbol(), and QgsSymbolsListWidget::on_mSymbolUnitComboBox_currentIndexChanged().

void QgsSymbolV2::setRenderHints ( int  hints) [inline]
Note:
added in 1.5

Definition at line 125 of file qgssymbolv2.h.

Referenced by QgsSingleSymbolRendererV2::startRender(), QgsGraduatedSymbolRendererV2::startRender(), QgsCategorizedSymbolRendererV2::startRender(), and QgsMarkerLineSymbolLayerV2::startRender().

void QgsSymbolV2::startRender ( QgsRenderContext &  context,
const QgsVectorLayer *  layer = 0 
)

Definition at line 216 of file qgssymbolv2.cpp.

References mAlpha, mLayers, mRenderHints, outputUnit(), and QgsSymbolV2RenderContext::setLayer().

Referenced by QgsPointPatternFillSymbolLayer::applyPattern(), bigSymbolPreviewImage(), QgsComposerMap::drawGridLine(), QgsAnnotationItem::drawMarkerSymbol(), QgsComposerMap::drawOverviewMapExtent(), QgsSingleSymbolRendererV2::startRender(), QgsPointDisplacementRenderer::startRender(), QgsVectorFieldSymbolLayer::startRender(), QgsGraduatedSymbolRendererV2::startRender(), QgsCategorizedSymbolRendererV2::startRender(), QgsMarkerLineSymbolLayerV2::startRender(), QgsSVGFillSymbolLayer::startRender(), QgsLinePatternFillSymbolLayer::startRender(), QgsPointPatternFillSymbolLayer::startRender(), and QgsCentroidFillSymbolLayerV2::startRender().

void QgsSymbolV2::stopRender ( QgsRenderContext &  context)

Definition at line 224 of file qgssymbolv2.cpp.

References mAlpha, mLayers, mRenderHints, and outputUnit().

Referenced by QgsPointPatternFillSymbolLayer::applyPattern(), bigSymbolPreviewImage(), QgsComposerMap::drawGridLine(), QgsAnnotationItem::drawMarkerSymbol(), QgsComposerMap::drawOverviewMapExtent(), QgsSingleSymbolRendererV2::stopRender(), QgsPointDisplacementRenderer::stopRender(), QgsVectorFieldSymbolLayer::stopRender(), QgsMarkerLineSymbolLayerV2::stopRender(), QgsSVGFillSymbolLayer::stopRender(), QgsPointPatternFillSymbolLayer::stopRender(), and QgsCentroidFillSymbolLayerV2::stopRender().

QgsSymbolLayerV2 * QgsSymbolV2::symbolLayer ( int  layer)

Definition at line 142 of file qgssymbolv2.cpp.

References mLayers.

Referenced by QgsVectorLayer::drawRendererV2Levels(), QgsVectorFileWriter::exportFeaturesSymbolLevels(), QgsSymbolV2SelectorDialog::loadSymbol(), QgsSymbolLayerV2Utils::loadSymbols(), QgsSymbolLevelsV2Dialog::populateTable(), QgsSymbolLevelsV2Dialog::renderingPassChanged(), QgsSymbolLayerV2Utils::saveSymbol(), QgsSymbolLevelsV2Dialog::setDefaultLevels(), QgsRuleBasedRendererV2::stopRender(), QgsMarkerLineSymbolLayerV2::toSld(), and QgsPointPatternFillSymbolLayer::toSld().

int QgsSymbolV2::symbolLayerCount ( ) [inline]

Definition at line 83 of file qgssymbolv2.h.

Referenced by QgsVectorLayer::drawRendererV2Levels(), QgsVectorFileWriter::exportFeaturesSymbolLevels(), QgsSymbolV2SelectorDialog::loadSymbol(), QgsSymbolLayerV2Utils::loadSymbols(), QgsSymbolLevelsV2Dialog::populateTable(), QgsSymbolLevelsV2Dialog::QgsSymbolLevelsV2Dialog(), QgsSymbolLevelsV2Dialog::renderingPassChanged(), QgsSymbolLayerV2Utils::saveSymbol(), QgsSymbolLevelsV2Dialog::setDefaultLevels(), QgsSymbolsListWidget::setSymbolFromStyle(), QgsRuleBasedRendererV2::stopRender(), QgsMarkerLineSymbolLayerV2::toSld(), and QgsPointPatternFillSymbolLayer::toSld().

QgsSymbolLayerV2 * QgsSymbolV2::takeSymbolLayer ( int  index)

remove symbol layer from the list and return pointer to it

Definition at line 194 of file qgssymbolv2.cpp.

References mLayers.

Referenced by QgsSymbolV2SelectorDialog::moveLayerByOffset(), QgsSymbolV2SelectorDialog::removeLayer(), and QgsSymbolsListWidget::setSymbolFromStyle().

void QgsSymbolV2::toSld ( QDomDocument &  doc,
QDomElement &  element,
QgsStringMap  props 
) const

Definition at line 335 of file qgssymbolv2.cpp.

References alpha(), QgsSymbolLayerV2Utils::encodeSldUom(), mLayers, and outputUnit().

Referenced by QgsRendererRangeV2::toSld(), QgsRendererCategoryV2::toSld(), QgsSingleSymbolRendererV2::toSld(), QgsVectorFieldSymbolLayer::toSld(), QgsSVGFillSymbolLayer::toSld(), QgsLinePatternFillSymbolLayer::toSld(), and QgsCentroidFillSymbolLayerV2::toSld().

SymbolType QgsSymbolV2::type ( ) const [inline]

Definition at line 77 of file qgssymbolv2.h.

Referenced by QgsSymbolV2SelectorDialog::addLayer(), SymbolLayerItem::data(), dump(), QgsLayerPropertiesWidget::populateLayerTypes(), QgsSymbolsListWidget::populateSymbols(), QgsStyleV2ManagerDialog::populateSymbols(), QgsStyleV2ManagerDialog::populateTypes(), QgsSymbolsListWidget::QgsSymbolsListWidget(), QgsSymbolV2(), QgsFeatureRendererV2::renderFeatureWithSymbol(), QgsSymbolLayerV2Utils::saveSymbol(), QgsFeatureRendererV2::setScaleMethodToSymbol(), QgsVectorFieldSymbolLayer::setSubSymbol(), QgsImageFillSymbolLayer::setSubSymbol(), QgsMarkerLineSymbolLayerV2::setSubSymbol(), QgsPointPatternFillSymbolLayer::setSubSymbol(), QgsCentroidFillSymbolLayerV2::setSubSymbol(), QgsSingleSymbolRendererV2::startRender(), QgsSingleSymbolRendererV2::symbolForFeature(), QgsGraduatedSymbolRendererV2::symbolForFeature(), QgsCategorizedSymbolRendererV2::symbolForFeature(), and QgsSymbolsListWidget::updateSymbolInfo().

QSet< QString > QgsSymbolV2::usedAttributes ( ) const

Definition at line 361 of file qgssymbolv2.cpp.

References mLayers.

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

Member Data Documentation

qreal QgsSymbolV2::mAlpha [protected]

Symbol opacity (in the range 0 - 1)

Definition at line 145 of file qgssymbolv2.h.

Referenced by QgsMarkerSymbolV2::clone(), QgsLineSymbolV2::clone(), QgsFillSymbolV2::clone(), drawPreviewIcon(), QgsMarkerSymbolV2::renderPoint(), QgsFillSymbolV2::renderPolygon(), QgsLineSymbolV2::renderPolyline(), startRender(), and stopRender().

QgsSymbolLayerV2List QgsSymbolV2::mLayers [protected]

Definition at line 142 of file qgssymbolv2.h.

Referenced by QgsMarkerSymbolV2::angle(), appendSymbolLayer(), changeSymbolLayer(), cloneLayers(), color(), deleteSymbolLayer(), drawPreviewIcon(), dump(), insertSymbolLayer(), outputUnit(), QgsFillSymbolV2::QgsFillSymbolV2(), QgsLineSymbolV2::QgsLineSymbolV2(), QgsMarkerSymbolV2::QgsMarkerSymbolV2(), QgsSymbolV2(), QgsMarkerSymbolV2::renderPoint(), QgsFillSymbolV2::renderPolygon(), QgsLineSymbolV2::renderPolyline(), QgsMarkerSymbolV2::scaleMethod(), QgsMarkerSymbolV2::setAngle(), QgsFillSymbolV2::setAngle(), setColor(), setOutputUnit(), QgsMarkerSymbolV2::setScaleMethod(), QgsMarkerSymbolV2::setSize(), QgsLineSymbolV2::setWidth(), QgsMarkerSymbolV2::size(), startRender(), stopRender(), symbolLayer(), takeSymbolLayer(), toSld(), usedAttributes(), QgsLineSymbolV2::width(), and ~QgsSymbolV2().

int QgsSymbolV2::mRenderHints [protected]

Definition at line 147 of file qgssymbolv2.h.

Referenced by drawPreviewIcon(), QgsMarkerSymbolV2::renderPoint(), QgsFillSymbolV2::renderPolygon(), QgsLineSymbolV2::renderPolyline(), startRender(), and stopRender().

SymbolType QgsSymbolV2::mType [protected]

Definition at line 141 of file qgssymbolv2.h.

Referenced by bigSymbolPreviewImage(), drawPreviewIcon(), and isSymbolLayerCompatible().

The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Defines