Class: QgsSnappingConfig¶

Stores configuration of snapping settings for the project.

class qgis.core.QgsSnappingConfig[source]¶

Bases: object

__init__(project: QgsProject | None = None)

Constructor with default parameters defined in global settings

Parameters:: project (Optional[QgsProject] = None)

__init__(a0: QgsSnappingConfig)

Parameters:: a0 (QgsSnappingConfig)

Disabled = 0¶

Global = 1¶

class IndividualLayerSettings[source]¶

Bases: object

A container of advanced configuration (per layer) of the snapping of the project.

QgsSnappingConfig.IndividualLayerSettings(enabled: bool, type: QgsSnappingConfig.SnappingType, tolerance: float, units: Qgis.MapToolUnit) IndividualLayerSettings

Parameters:

enabled
type
tolerance
units

Deprecated since version 3.12: Use the method with Qgis.SnappingTypes instead.

QgsSnappingConfig.IndividualLayerSettings(enabled: bool, type: Union[Qgis.SnappingTypes, Qgis.SnappingType], tolerance: float, units: Qgis.MapToolUnit, minScale: float = 0, maxScale: float = 0) IndividualLayerSettings

Parameters:

enabled
type
tolerance
units
minScale – 0.0 disable scale limit
maxScale – 0.0 disable scale limit

Added in version 3.12.

QgsSnappingConfig.IndividualLayerSettings() Constructs an invalid setting

QgsSnappingConfig.IndividualLayerSettings(a0: QgsSnappingConfig.IndividualLayerSettings)

enabled(self) → bool[source]¶

Returns if snapping is enabled

Return type:: bool

maximumScale(self) → float[source]¶

Returns max scale on which snapping is limited

Added in version 3.14.

Return type:: float

minimumScale(self) → float[source]¶

Returns minimum scale on which snapping is limited

Added in version 3.14.

Return type:: float

setEnabled(self, enabled: bool)[source]¶

enables the snapping

Parameters:: enabled (bool)

setMaximumScale(self, maxScale: float)[source]¶

Sets the max scale value on which snapping is used, 0.0 disable scale limit

Added in version 3.14.

Parameters:: maxScale (float)

setMinimumScale(self, minScale: float)[source]¶

Sets the min scale value on which snapping is used, 0.0 disable scale limit

Added in version 3.14.

Parameters:: minScale (float)

setTolerance(self, tolerance: float)[source]¶

Sets the tolerance

Parameters:: tolerance (float)

setType(self, type: QgsSnappingConfig.SnappingType)[source]¶

define the type of snapping

Deprecated since version 3.12: Use setTypeFlag() instead.

Parameters:: type (QgsSnappingConfig.SnappingType)

setTypeFlag(self, type: Qgis.SnappingTypes | Qgis.SnappingType)[source]¶

define the type of snapping

Added in version 3.12.

Parameters:: type (Union[Qgis.SnappingTypes, Qgis.SnappingType])

setUnits(self, units: Qgis.MapToolUnit)[source]¶

Sets the type of units

Parameters:: units (Qgis.MapToolUnit)

tolerance(self) → float[source]¶

Returns the tolerance

Return type:: float

type(self) → QgsSnappingConfig.SnappingType[source]¶

Returns the flags type (vertices | segments | area | centroid | middle)

Deprecated since version 3.12: Use typeFlag() instead.

Return type:: QgsSnappingConfig.SnappingType

typeFlag(self) → Qgis.SnappingTypes[source]¶

Returns the flags type (vertices | segments | area | centroid | middle)

Added in version 3.12.

Return type:: Qgis.SnappingTypes

units(self) → Qgis.MapToolUnit[source]¶

Returns the type of units

Return type:: Qgis.MapToolUnit

valid(self) → bool[source]¶

Returns if settings are valid

Return type:: bool

PerLayer = 2¶

class ScaleDependencyMode¶: Bases: int

Segment = 3¶

class SnappingMode(*values)¶

Bases: IntEnum

SnappingMode defines on which layer the snapping is performed

Added in version 3.26.

ActiveLayer: On the active layer
AllLayers: On all vector layers
AdvancedConfiguration: On a per layer configuration basis

class SnappingType¶: Bases: int

SnappingTypeFlag¶: alias of SnappingTypes

SnappingTypes¶: alias of SnappingType

Vertex = 1¶

VertexAndSegment = 2¶

addLayers(self, layers: Iterable[QgsMapLayer]) → bool[source]¶

Adds the specified layers as individual layers to the configuration with standard configuration. When implementing a long-living QgsSnappingConfig (like the one in QgsProject) it is best to directly feed this with information from the layer registry.

Return type:: bool
Returns:: True if changes have been done.
Parameters:: layers (Iterable[QgsMapLayer])

clearIndividualLayerSettings(self)[source]¶: Removes all individual layer snapping settings

Added in version 3.16.

enabled(self) → bool[source]¶

Returns if snapping is enabled

Return type:: bool

individualLayerSettings(self) → Dict[source]¶

Returns individual snapping settings for all layers

individualLayerSettings(self, vl: Optional[QgsVectorLayer]) -> QgsSnappingConfig.IndividualLayerSettings Returns individual layer snappings settings (applied if mode is AdvancedConfiguration)

Return type:: Dict

intersectionSnapping(self) → bool[source]¶

Returns if the snapping on intersection is enabled

Return type:: bool

maximumScale(self) → float[source]¶

Returns the max scale (i.e. most "zoomed in" scale)

Added in version 3.14.

Return type:: float

minimumScale(self) → float[source]¶

Returns the min scale (i.e. most "zoomed out" scale)

Added in version 3.14.

Return type:: float

mode(self) → Qgis.SnappingMode[source]¶

Returns the mode (all layers, active layer, per layer settings)

Return type:: Qgis.SnappingMode

project(self) → QgsProject | None[source]¶

The project from which the snapped layers should be retrieved

Return type:: Optional[QgsProject]

readProject(self, doc: QDomDocument)[source]¶

Reads the configuration from the specified QGIS project document.

Parameters:: doc (QDomDocument)

removeLayers(self, layers: Iterable[QgsMapLayer]) → bool[source]¶

Removes the specified layers from the individual layer configuration. When implementing a long-living QgsSnappingConfig (like the one in QgsProject) it is best to directly feed this with information from the layer registry.