QGIS API Documentation
3.14.0-Pi (9f7028fd23)
|
Go to the documentation of this file.
30 , mSettings( *layer->diagramLayerSettings() )
31 , mDiagRenderer( layer->diagramRenderer()->clone() )
32 , mFields( layer->fields() )
33 , mLayerCrs( layer->
crs() )
35 , mOwnsSource( ownFeatureLoop )
69 QSet<QString> attributeNames;
70 if ( !
prepare( context, attributeNames ) )
71 return QList<QgsLabelFeature *>();
81 if ( featureFilterProvider )
126 for (
int i = 0; i < 4; ++i )
128 centerX += label->
getX( i );
129 centerY += label->
getY( i );
131 QgsPointXY outPt( centerX / 4.0, centerY / 4.0 );
185 if ( !settingList.isEmpty() && settingList.at( 0 ).scaleBasedVisibility )
187 double maxScale = settingList.at( 0 ).maximumScale;
193 double minScale = settingList.at( 0 ).minimumScale;
218 std::unique_ptr<QgsGeometry> scopedPreparedGeom;
223 if ( preparedGeom->
isNull() )
242 preparedObstacleGeom = obstacleGeometry;
245 double diagramWidth = 0;
246 double diagramHeight = 0;
250 if ( diagSize.isValid() )
252 diagramWidth = diagSize.width();
253 diagramHeight = diagSize.height();
274 ddPos = !std::isnan( ddPosX ) && !std::isnan( ddPosY );
285 ddPosX -= diagramWidth / 2.0;
286 ddPosY -= diagramHeight / 2.0;
313 priorityD = qBound( 0.0, priorityD, 10.0 );
314 priorityD = 1 - priorityD / 10.0;
bool isActive() const
Returns whether the property is currently active.
bool showAllDiagrams() const
Returns whether the layer should show all diagrams, including overlapping diagrams.
void setObstacleGeometry(const QgsGeometry &obstacleGeom)
Sets the label's obstacle geometry, if different to the feature geometry.
bool isObstacle() const
Returns whether the feature associated with a diagram acts as an obstacle for other labels or diagram...
double getY(int i=0) const
Returns the down-left y coordinate.
double valueAsDouble(int key, const QgsExpressionContext &context, double defaultValue=0.0, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as a double.
void setDistLabel(double dist)
Applies to "around point" placement strategy or linestring features.
void setPriority(double priority)
Sets the priority for labeling the feature.
const QgsMapToPixel & mapToPixel() const
Returns the context's map to pixel transform, which transforms between map coordinates and device coo...
QgsDiagramLayerSettings mSettings
Diagram layer settings.
QgsCoordinateTransform coordinateTransform() const
Returns the coordinate transform associated with the layer, or an invalid transform if no transformat...
QgsExpressionContext & expressionContext()
Gets the expression context.
int priority() const
Returns the diagram priority.
void init()
initialization method - called from constructors
QgsDiagramRenderer * renderer()
Returns the diagram renderer associated with the layer.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the diagram's property collection, used for data defined overrides.
void setId(QgsFeatureId id)
Sets the feature ID for this feature.
QgsDiagramRenderer * mDiagRenderer
Diagram renderer instance (owned by mSettings)
const QgsCoordinateReferenceSystem & crs
QString mName
Name of the layer.
LabelPosition is a candidate feature label position.
QgsVectorLayerDiagramProvider(QgsVectorLayer *layer, bool ownFeatureLoop=true)
Convenience constructor to initialize the provider from given vector layer.
void setOriginalValueVariable(const QVariant &value)
Sets the original value variable value for the context.
static QgsGeometry prepareGeometry(const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry(), bool mergeLines=false)
Prepares a geometry for registration with PAL.
void setValid(bool validity)
Sets the validity of the feature.
QPointF toQPointF() const
Converts a point to a QPointF.
OperationResult rotate(double rotation, const QgsPointXY ¢er)
Rotate this geometry around the Z axis.
void setIsObstacle(bool isObstacle)
Sets whether features are obstacles to labels of other layers.
QgsFeatureRequest & setSubsetOfAttributes(const QgsAttributeList &attrs)
Set a subset of attributes that will be fetched.
virtual QSizeF sizeMapUnits(const QgsFeature &feature, const QgsRenderContext &c) const
Returns size of the diagram for a feature in map units. Returns an invalid QSizeF in case of error.
QgsPointXY toMapCoordinates(int x, int y) const
Transform device coordinates to map (world) coordinates.
const QgsRectangle & extent() const
When rendering a map layer, calling this method returns the "clipping" extent for the layer (in the l...
@ Show
Whether to show the diagram.
QSet< QString > referencedFields(const QgsExpressionContext &context=QgsExpressionContext()) const
Returns the set of any fields referenced by the layer's diagrams.
FeaturePart * getFeaturePart() const
Returns the feature corresponding to this labelposition.
static QgsGeometry fromRect(const QgsRectangle &rect)
Creates a new geometry from a QgsRectangle.
QgsProperty property(int key) const override
Returns a matching property from the collection, if one exists.
@ PositionY
Y-coordinate data defined diagram position.
QgsLabelFeature * registerDiagram(QgsFeature &feat, QgsRenderContext &context, const QgsGeometry &obstacleGeometry=QgsGeometry())
helper method to register one diagram feature
std::unique_ptr< GEOSGeometry, GeosDeleter > unique_ptr
Scoped GEOS pointer.
QgsFeatureRequest & setFilterRect(const QgsRectangle &rectangle)
Sets the rectangle from which features will be taken.
@ ZIndex
Z-index for diagram ordering.
virtual bool prepare(const QgsRenderContext &context, QSet< QString > &attributeNames)
Prepare for registration of features.
QgsCoordinateTransform coordinateTransform() const
Returns the current coordinate transform for the context.
Placement
Placement modes which determine how label candidates are generated for a feature.
static geos::unique_ptr asGeos(const QgsGeometry &geometry, double precision=0)
Returns a geos geometry - caller takes ownership of the object (should be deleted with GEOSGeom_destr...
virtual void filterFeatures(const QgsVectorLayer *layer, QgsFeatureRequest &featureRequest) const =0
Add additional filters to the feature request to further restrict the features returned by the reques...
QString mLayerId
Associated layer's ID, if applicable.
static bool geometryRequiresPreparation(const QgsGeometry &geometry, QgsRenderContext &context, const QgsCoordinateTransform &ct, const QgsGeometry &clipGeometry=QgsGeometry(), bool mergeLines=false)
Checks whether a geometry requires preparation before registration with PAL.
double rotation() const
Returns the rotation of the resulting map image, in degrees clockwise.
The QgsAbstractLabelProvider class is an interface class. Implementations return list of labels and t...
void renderDiagram(const QgsFeature &feature, QgsRenderContext &c, QPointF pos, const QgsPropertyCollection &properties=QgsPropertyCollection()) const
Renders the diagram for a specified feature at a specific position in the passed render context.
bool prepare(const QgsExpressionContext &context=QgsExpressionContext()) const
Prepares the diagrams for a specified expression context.
bool mOwnsSource
Whether layer's feature source is owned.
void drawLabel(QgsRenderContext &context, pal::LabelPosition *label) const override
Draw this label at the position determined by the labeling engine.
void setFields(const QgsFields &fields, bool initAttributes=false)
Assign a field map with the feature to allow attribute access by attribute name.
@ Distance
Distance to diagram from feature.
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference)
const QgsFeatureFilterProvider * featureFilterProvider() const
Gets the filter feature provider used for additional filtering of rendered features.
void setZIndex(double zIndex)
Sets the label's z-index.
void setHasFixedAngle(bool enabled)
Sets whether the label should use a fixed angle instead of using angle from automatic placement.
QList< QgsLabelFeature * > mFeatures
List of generated label features (owned by the provider)
double distance(double x, double y) const
Returns the distance between this point and a specified x, y coordinate.
void setObstacleSettings(const QgsLabelObstacleSettings &settings)
Sets the label's obstacle settings.
QgsFields mFields
Layer's fields.
Stores the settings for rendering of all diagrams for a layer.
void setFixedPosition(const QgsPointXY &point)
Sets coordinates of the fixed position (relevant only if hasFixedPosition() returns true)
QgsCoordinateReferenceSystem mLayerCrs
Layer's CRS.
Evaluates and returns the diagram settings relating to a diagram for a specific feature.
void setHasFixedPosition(bool enabled)
Sets whether the label should use a fixed position instead of being automatically placed.
virtual QList< QgsDiagramSettings > diagramSettings() const =0
Returns list with all diagram settings in the renderer.
const QgsLabelingEngine * mEngine
Associated labeling engine.
QgsPointXY transform(const QgsPointXY &p) const
Transform the point from map (world) coordinates to device coordinates.
Placement placement() const
Returns the diagram placement.
double zIndex() const
Returns the diagram z-index.
QgsWeakMapLayerPointer mLayer
Weak pointer to source layer.
QgsCoordinateReferenceSystem destinationCrs() const
returns CRS of destination coordinate reference system
void setRenderer(QgsDiagramRenderer *diagramRenderer)
Sets the diagram renderer associated with the layer.
QgsAbstractGeometry * get()
Returns a modifiable (non-const) reference to the underlying abstract geometry primitive.
QgsPointXY center() const
Returns the center point of the rectangle.
const QgsMapSettings & mapSettings() const
Gets associated map settings.
bool nextFeature(QgsFeature &f)
bool valueAsBool(int key, const QgsExpressionContext &context, bool defaultValue=false, bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as an boolean.
double distance() const
Returns the distance between the diagram and the feature (in mm).
QgsLabelingResults * results() const
For internal use by the providers.
QgsCoordinateTransformContext transformContext() const
Returns the context's coordinate transform context, which stores various information regarding which ...
const QgsAttributes & attributes()
Gets feature's attributes - used for rendering of diagrams.
double getX(int i=0) const
Returns the down-left x coordinate.
~QgsVectorLayerDiagramProvider() override
Clean up.
bool hasProperty(int key) const override
Returns true if the collection contains a property with the specified key.
void setAttributes(const QgsAttributes &attrs)
Store feature's attributes - used for rendering of diagrams.
void setFixedAngle(double angle)
Sets angle in degrees of the fixed angle (relevant only if hasFixedAngle() returns true)
virtual QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest())=0
Gets an iterator for features matching the specified request.
QgsAbstractFeatureSource * mSource
Layer's feature source.
The QgsLabelFeature class describes a feature that should be used within the labeling engine....
@ AlwaysShow
Whether the diagram should always be shown, even if it overlaps other diagrams/labels.
@ PositionX
X-coordinate data defined diagram position.
void setAttributes(const QgsAttributes &attrs)
Sets the feature's attributes.
QgsFeatureId featureId() const
Returns the unique ID of the feature.
double rendererScale() const
Returns the renderer map scale.
virtual void registerFeature(QgsFeature &feature, QgsRenderContext &context, const QgsGeometry &obstacleGeometry=QgsGeometry())
Register a feature for labeling as one or more QgsLabelFeature objects stored into mFeatures.
QgsRectangle visibleExtent() const
Returns the actual extent derived from requested extent that takes takes output image size into accou...
QgsLabelFeature * feature()
Returns the parent feature.
QList< QgsLabelFeature * > labelFeatures(QgsRenderContext &context) override
Returns list of label features (they are owned by the provider and thus deleted on its destruction)
void setMapRotation(double degrees, double cx, double cy)
Set map rotation in degrees (clockwise)
QgsPalLayerSettings::Placement mPlacement
Placement strategy.
@ IsObstacle
Whether diagram features act as obstacles for other diagrams/labels.
const QgsMapToPixel & mapToPixel() const
@ Priority
Diagram priority (between 0 and 10)
double mPriority
Default priority of labels.
void setCoordinateTransform(const QgsCoordinateTransform &transform)
Sets the coordinate transform associated with the layer.
void setAlwaysShow(bool enabled)
Sets whether label should be always shown (sets very high label priority)
void setFeature(const QgsFeature &feature)
Convenience function for setting a feature for the context.