QGIS API Documentation
2.18.21-Las Palmas (9fba24a)
|
A class for filling symbols with a repeated raster image. More...
#include <qgsfillsymbollayerv2.h>
Public Types | |
enum | FillCoordinateMode { Feature, Viewport } |
Public Member Functions | |
QgsRasterFillSymbolLayer (const QString &imageFilePath=QString()) | |
~QgsRasterFillSymbolLayer () | |
double | alpha () const |
The opacity for the raster image used in the fill. More... | |
QgsRasterFillSymbolLayer * | clone () const override |
Shall be reimplemented by subclasses to create a deep copy of the instance. More... | |
FillCoordinateMode | coordinateMode () const |
Coordinate mode for fill. More... | |
virtual double | estimateMaxBleed () const override |
Returns the estimated maximum distance which the layer style will bleed outside the drawn shape. More... | |
QString | imageFilePath () const |
The path to the raster image used for the fill. More... | |
QString | layerType () const override |
Returns a string that represents this layer type. More... | |
QPointF | offset () const |
Returns the offset for the fill. More... | |
const QgsMapUnitScale & | offsetMapUnitScale () const |
Returns the map unit scale for the fill's offset. More... | |
QgsSymbolV2::OutputUnit | offsetUnit () const |
Returns the units for the fill's offset. More... | |
QgsStringMap | properties () const override |
Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer. More... | |
void | renderPolygon (const QPolygonF &points, QList< QPolygonF > *rings, QgsSymbolV2RenderContext &context) override |
void | setAlpha (const double alpha) |
Sets the opacity for the raster image used in the fill. More... | |
void | setCoordinateMode (const FillCoordinateMode mode) |
Set the coordinate mode for fill. More... | |
void | setImageFilePath (const QString &imagePath) |
Sets the path to the raster image used for the fill. More... | |
void | setOffset (QPointF offset) |
Sets the offset for the fill. More... | |
void | setOffsetMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale for the fill's offset. More... | |
void | setOffsetUnit (const QgsSymbolV2::OutputUnit unit) |
Sets the units for the fill's offset. More... | |
virtual bool | setSubSymbol (QgsSymbolV2 *symbol) override |
set layer's subsymbol. takes ownership of the passed symbol More... | |
void | setWidth (const double width) |
Sets the width for scaling the image used in the fill. More... | |
void | setWidthMapUnitScale (const QgsMapUnitScale &scale) |
Sets the map unit scale for the image's width. More... | |
void | setWidthUnit (const QgsSymbolV2::OutputUnit unit) |
Sets the units for the image's width. More... | |
void | startRender (QgsSymbolV2RenderContext &context) override |
void | stopRender (QgsSymbolV2RenderContext &context) override |
virtual QgsSymbolV2 * | subSymbol () override |
double | width () const |
Returns the width used for scaling the image used in the fill. More... | |
const QgsMapUnitScale & | widthMapUnitScale () const |
Returns the map unit scale for the image's width. More... | |
QgsSymbolV2::OutputUnit | widthUnit () const |
Returns the units for the image's width. More... | |
Public Member Functions inherited from QgsImageFillSymbolLayer | |
QgsImageFillSymbolLayer () | |
virtual | ~QgsImageFillSymbolLayer () |
QColor | dxfColor (QgsSymbolV2RenderContext &context) const override |
get color More... | |
Qt::PenStyle | dxfPenStyle () const override |
get pen style More... | |
double | dxfWidth (const QgsDxfExport &e, QgsSymbolV2RenderContext &context) const override |
get line width More... | |
QgsMapUnitScale | mapUnitScale () const override |
const QgsMapUnitScale & | outlineWidthMapUnitScale () const |
QgsSymbolV2::OutputUnit | outlineWidthUnit () const |
QgsSymbolV2::OutputUnit | outputUnit () const override |
void | setMapUnitScale (const QgsMapUnitScale &scale) override |
void | setOutlineWidthMapUnitScale (const QgsMapUnitScale &scale) |
void | setOutlineWidthUnit (QgsSymbolV2::OutputUnit unit) |
void | setOutputUnit (QgsSymbolV2::OutputUnit unit) override |
QSet< QString > | usedAttributes () const override |
Returns the set of attributes referenced by the layer. More... | |
Public Member Functions inherited from QgsFillSymbolLayerV2 | |
double | angle () const |
void | drawPreviewIcon (QgsSymbolV2RenderContext &context, QSize size) override |
void | setAngle (double angle) |
Public Member Functions inherited from QgsSymbolLayerV2 | |
virtual | ~QgsSymbolLayerV2 () |
virtual QColor | color () const |
The fill color. More... | |
virtual Q_DECL_DEPRECATED const QgsExpression * | dataDefinedProperty (const QString &property) const |
Returns a data defined expression for a property, if set. More... | |
virtual Q_DECL_DEPRECATED QString | dataDefinedPropertyString (const QString &property) const |
Returns a data defined expression for a property, if set. More... | |
virtual double | dxfAngle (QgsSymbolV2RenderContext &context) const |
get angle More... | |
virtual QColor | dxfBrushColor (QgsSymbolV2RenderContext &context) const |
get brush/fill color More... | |
virtual Qt::BrushStyle | dxfBrushStyle () const |
get brush/fill style More... | |
virtual QVector< qreal > | dxfCustomDashPattern (QgsSymbolV2::OutputUnit &unit) const |
get dash pattern More... | |
virtual double | dxfOffset (const QgsDxfExport &e, QgsSymbolV2RenderContext &context) const |
get offset More... | |
virtual Q_DECL_DEPRECATED QVariant | evaluateDataDefinedProperty (const QString &property, const QgsFeature *feature, const QVariant &defaultVal=QVariant(), bool *ok=nullptr) const |
Evaluates the matching data defined property and returns the calculated value. More... | |
virtual QVariant | evaluateDataDefinedProperty (const QString &property, const QgsSymbolV2RenderContext &context, const QVariant &defaultVal=QVariant(), bool *ok=nullptr) const |
Evaluates the matching data defined property and returns the calculated value. More... | |
virtual QColor | fillColor () const |
Get fill color. More... | |
virtual QgsDataDefined * | getDataDefinedProperty (const QString &property) const |
Returns the data defined property corresponding to the specified property key. More... | |
virtual bool | hasDataDefinedProperties () const |
Checks whether the layer has any associated data defined properties. More... | |
virtual bool | hasDataDefinedProperty (const QString &property) const |
Checks whether the layer has a matching data defined property and if that property is currently actived. More... | |
virtual bool | isCompatibleWithSymbol (QgsSymbolV2 *symbol) const |
Returns if the layer can be used below the specified symbol. More... | |
bool | isLocked () const |
virtual QString | ogrFeatureStyle (double mmScaleFactor, double mapUnitScaleFactor) const |
virtual QColor | outlineColor () const |
Get outline color. More... | |
QgsPaintEffect * | paintEffect () const |
Returns the current paint effect for the layer. More... | |
virtual void | removeDataDefinedProperties () |
Removes all data defined properties from the layer and deletes associated objects. More... | |
virtual void | removeDataDefinedProperty (const QString &property) |
Removes a data defined property from the layer. More... | |
int | renderingPass () const |
virtual void | setColor (const QColor &color) |
The fill color. More... | |
virtual Q_DECL_DEPRECATED void | setDataDefinedProperty (const QString &property, const QString &expressionString) |
Sets a data defined expression for a property. More... | |
virtual void | setDataDefinedProperty (const QString &property, QgsDataDefined *dataDefined) |
Sets a data defined property for the layer. More... | |
virtual void | setFillColor (const QColor &color) |
Set fill color. More... | |
void | setLocked (bool locked) |
virtual void | setOutlineColor (const QColor &color) |
Set outline color. More... | |
void | setPaintEffect (QgsPaintEffect *effect) |
Sets the current paint effect for the layer. More... | |
void | setRenderingPass (int renderingPass) |
virtual void | toSld (QDomDocument &doc, QDomElement &element, const QgsStringMap &props) const |
Writes the SLD element following the SLD v1.1 specs. More... | |
QgsSymbolV2::SymbolType | type () const |
virtual bool | writeDxf (QgsDxfExport &e, double mmMapUnitScaleFactor, const QString &layerName, QgsSymbolV2RenderContext &context, QPointF shift=QPointF(0.0, 0.0)) const |
write as DXF More... | |
Static Public Member Functions | |
static QgsSymbolLayerV2 * | create (const QgsStringMap &properties=QgsStringMap()) |
Protected Member Functions | |
void | applyDataDefinedSettings (QgsSymbolV2RenderContext &context) override |
Protected Member Functions inherited from QgsFillSymbolLayerV2 | |
QgsFillSymbolLayerV2 (bool locked=false) | |
void | _renderPolygon (QPainter *p, const QPolygonF &points, const QList< QPolygonF > *rings, QgsSymbolV2RenderContext &context) |
Default method to render polygon. More... | |
Protected Member Functions inherited from QgsSymbolLayerV2 | |
QgsSymbolLayerV2 (QgsSymbolV2::SymbolType type, bool locked=false) | |
void | copyDataDefinedProperties (QgsSymbolLayerV2 *destLayer) const |
Copies all data defined properties of this layer to another symbol layer. More... | |
void | copyPaintEffect (QgsSymbolLayerV2 *destLayer) const |
Copies paint effect of this layer to another symbol layer. More... | |
virtual Q_DECL_DEPRECATED QgsExpression * | expression (const QString &property) const |
Returns the data defined expression associated with a property. More... | |
virtual Q_DECL_DEPRECATED void | prepareExpressions (const QgsFields *fields, double scale=-1.0) |
Prepares all data defined property expressions for evaluation. More... | |
virtual void | prepareExpressions (const QgsSymbolV2RenderContext &context) |
Prepares all data defined property expressions for evaluation. More... | |
void | restoreDataDefinedProperties (const QgsStringMap &stringMap) |
Restores all data defined properties from string map. More... | |
void | saveDataDefinedProperties (QgsStringMap &stringMap) const |
Saves all data defined properties to a string map. More... | |
Protected Attributes | |
double | mAlpha |
FillCoordinateMode | mCoordinateMode |
QString | mImageFilePath |
Path to the image file. More... | |
QPointF | mOffset |
QgsMapUnitScale | mOffsetMapUnitScale |
QgsSymbolV2::OutputUnit | mOffsetUnit |
double | mWidth |
QgsMapUnitScale | mWidthMapUnitScale |
QgsSymbolV2::OutputUnit | mWidthUnit |
Protected Attributes inherited from QgsImageFillSymbolLayer | |
QBrush | mBrush |
double | mNextAngle |
QgsLineSymbolV2 * | mOutline |
Custom outline. More... | |
double | mOutlineWidth |
Outline width. More... | |
QgsMapUnitScale | mOutlineWidthMapUnitScale |
QgsSymbolV2::OutputUnit | mOutlineWidthUnit |
Protected Attributes inherited from QgsFillSymbolLayerV2 | |
double | mAngle |
Protected Attributes inherited from QgsSymbolLayerV2 | |
QColor | mColor |
QMap< QString, QgsDataDefined *> | mDataDefinedProperties |
QgsFields | mFields |
bool | mLocked |
QgsPaintEffect * | mPaintEffect |
int | mRenderingPass |
QgsSymbolV2::SymbolType | mType |
A class for filling symbols with a repeated raster image.
Definition at line 610 of file qgsfillsymbollayerv2.h.
Enumerator | |
---|---|
Feature | |
Viewport |
Definition at line 614 of file qgsfillsymbollayerv2.h.
Definition at line 3663 of file qgsfillsymbollayerv2.cpp.
QgsRasterFillSymbolLayer::~QgsRasterFillSymbolLayer | ( | ) |
Definition at line 3675 of file qgsfillsymbollayerv2.cpp.
|
inline |
The opacity for the raster image used in the fill.
Definition at line 671 of file qgsfillsymbollayerv2.h.
|
overrideprotectedvirtual |
Reimplemented from QgsImageFillSymbolLayer.
Definition at line 3847 of file qgsfillsymbollayerv2.cpp.
|
overridevirtual |
Shall be reimplemented by subclasses to create a deep copy of the instance.
Implements QgsSymbolLayerV2.
Definition at line 3810 of file qgsfillsymbollayerv2.cpp.
|
inline |
Coordinate mode for fill.
Controls how the top left corner of the image fill is positioned relative to the feature.
Definition at line 660 of file qgsfillsymbollayerv2.h.
|
static |
Definition at line 3680 of file qgsfillsymbollayerv2.cpp.
|
overridevirtual |
Returns the estimated maximum distance which the layer style will bleed outside the drawn shape.
Eg, polygons drawn with an outline will draw half the width of the outline outside of the polygon. This amount is estimated, since it may be affected by data defined symbology rules.
Reimplemented from QgsImageFillSymbolLayer.
Definition at line 3827 of file qgsfillsymbollayerv2.cpp.
|
inline |
The path to the raster image used for the fill.
Definition at line 647 of file qgsfillsymbollayerv2.h.
|
overridevirtual |
Returns a string that represents this layer type.
Used for serialization. Should match with the string used to register this symbol layer in the registry.
Implements QgsSymbolLayerV2.
Definition at line 3747 of file qgsfillsymbollayerv2.cpp.
|
inline |
Returns the offset for the fill.
Definition at line 686 of file qgsfillsymbollayerv2.h.
|
inline |
Returns the map unit scale for the fill's offset.
Definition at line 716 of file qgsfillsymbollayerv2.h.
|
inline |
Returns the units for the fill's offset.
Definition at line 701 of file qgsfillsymbollayerv2.h.
|
overridevirtual |
Should be reimplemented by subclasses to return a string map that contains the configuration information for the symbol layer.
This is used to serialize a symbol layer perstistently.
Implements QgsSymbolLayerV2.
Definition at line 3792 of file qgsfillsymbollayerv2.cpp.
|
overridevirtual |
Reimplemented from QgsImageFillSymbolLayer.
Definition at line 3752 of file qgsfillsymbollayerv2.cpp.
void QgsRasterFillSymbolLayer::setAlpha | ( | const double | alpha | ) |
Sets the opacity for the raster image used in the fill.
alpha | opacity value between 0 (fully transparent) and 1 (fully opaque) |
Definition at line 3842 of file qgsfillsymbollayerv2.cpp.
void QgsRasterFillSymbolLayer::setCoordinateMode | ( | const FillCoordinateMode | mode | ) |
Set the coordinate mode for fill.
Controls how the top left corner of the image fill is positioned relative to the feature.
mode | coordinate mode |
Definition at line 3837 of file qgsfillsymbollayerv2.cpp.
void QgsRasterFillSymbolLayer::setImageFilePath | ( | const QString & | imagePath | ) |
Sets the path to the raster image used for the fill.
imagePath | path to image file |
Definition at line 3832 of file qgsfillsymbollayerv2.cpp.
|
inline |
Sets the offset for the fill.
offset | offset for fill |
Definition at line 679 of file qgsfillsymbollayerv2.h.
|
inline |
Sets the map unit scale for the fill's offset.
scale | map unit scale for offset |
Definition at line 709 of file qgsfillsymbollayerv2.h.
|
inline |
Sets the units for the fill's offset.
unit | units for offset |
Definition at line 694 of file qgsfillsymbollayerv2.h.
|
overridevirtual |
set layer's subsymbol. takes ownership of the passed symbol
Reimplemented from QgsImageFillSymbolLayer.
Definition at line 3741 of file qgsfillsymbollayerv2.cpp.
|
inline |
Sets the width for scaling the image used in the fill.
The image's height will also be scaled to maintain the image's aspect ratio.
width | width for scaling the image |
Definition at line 725 of file qgsfillsymbollayerv2.h.
|
inline |
Sets the map unit scale for the image's width.
scale | map unit scale for width |
Definition at line 756 of file qgsfillsymbollayerv2.h.
|
inline |
Sets the units for the image's width.
unit | units for width |
Definition at line 741 of file qgsfillsymbollayerv2.h.
|
overridevirtual |
Implements QgsSymbolLayerV2.
Definition at line 3781 of file qgsfillsymbollayerv2.cpp.
|
overridevirtual |
Implements QgsSymbolLayerV2.
Definition at line 3787 of file qgsfillsymbollayerv2.cpp.
|
inlineoverridevirtual |
Reimplemented from QgsImageFillSymbolLayer.
Definition at line 635 of file qgsfillsymbollayerv2.h.
|
inline |
Returns the width used for scaling the image used in the fill.
The image's height is scaled to maintain the image's aspect ratio.
Definition at line 733 of file qgsfillsymbollayerv2.h.
|
inline |
Returns the map unit scale for the image's width.
Definition at line 763 of file qgsfillsymbollayerv2.h.
|
inline |
Returns the units for the image's width.
Definition at line 748 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 770 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 769 of file qgsfillsymbollayerv2.h.
|
protected |
Path to the image file.
Definition at line 768 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 772 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 774 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 773 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 776 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 778 of file qgsfillsymbollayerv2.h.
|
protected |
Definition at line 777 of file qgsfillsymbollayerv2.h.