This commit is contained in:
Nyall Dawson 2020-06-11 09:54:25 +10:00
parent e293a9da8f
commit c795ddb1e9
42 changed files with 198 additions and 158 deletions

View File

@ -15,6 +15,7 @@ class QgsCameraPose
{
%Docstring
Class that encapsulates camera pose in a 3D scene. The pose is defined with the following parameters:
- center point - towards which point the camera is looking
- distance from the center point - how far is the camera from the point towards which it is looking
- pitch angle - vertical rotation of the camera (0 degrees = camera looking down, 90 degrees = camera looking from the side)

View File

@ -16,6 +16,7 @@ class QgsAlignRaster
%Docstring
QgsAlignRaster takes one or more raster layers and warps (resamples) them
so they have the same:
- coordinate reference system
- cell size and raster size
- offset of the raster grid

View File

@ -0,0 +1,5 @@
# The following has been generated automatically from src/core/qgsmapsettingsutils.h
# monkey patching scoped based enum
QgsMapSettingsUtils.EffectsCheckFlag.IgnoreGeoPdfSupportedEffects.__doc__ = "Ignore advanced effects which are supported in GeoPDF exports"
QgsMapSettingsUtils.EffectsCheckFlag.__doc__ = 'Flags for controlling the behavior of containsAdvancedEffects()\n\n.. versionadded:: 3.14\n\n' + '* ``IgnoreGeoPdfSupportedEffects``: ' + QgsMapSettingsUtils.EffectsCheckFlag.IgnoreGeoPdfSupportedEffects.__doc__
# --

View File

@ -1568,6 +1568,7 @@ Exports the geometry to a GeoJSON string.
Attempts to coerce this geometry into the specified destination ``type``.
This method will do anything possible to force the current geometry into the specified type. E.g.
- lines or polygons will be converted to points by return either a single multipoint geometry or multiple
single point geometries.
- polygons will be converted to lines by extracting their exterior and interior rings, returning
@ -2122,14 +2123,14 @@ The 2 types should match.
:param epsilon: maximum difference for coordinates between the objects
:return: ``True`` if objects are
- polylines and have the same number of points and all
points are equal within the specified tolerance
- polygons and have the same number of points and all
points are equal within the specified tolerance
- multipolygons and have the same number of polygons, the polygons have the same number
of rings, and each ring has the same number of points and all points are equal
within the specified
tolerance
- polylines and have the same number of points and all
points are equal within the specified tolerance
- polygons and have the same number of points and all
points are equal within the specified tolerance
- multipolygons and have the same number of polygons, the polygons have the same number
of rings, and each ring has the same number of points and all points are equal
within the specified tolerance
.. versionadded:: 2.9
%End

View File

@ -149,6 +149,7 @@ Returns ``False`` if the QgsQuadrilateral is not valid.
%Docstring
Set all points
Returns ``False`` if the QgsQuadrilateral is not valid:
- The points do not have the same type
- The quadrilateral would have auto intersections
- The quadrilateral has double points

View File

@ -16,6 +16,7 @@ class QgsLayerTreeNode : QObject
%Docstring
This class is a base class for nodes in a layer tree.
Layer tree is a hierarchical structure consisting of group and layer nodes:
- group nodes are containers and may contain children (layer and group nodes)
- layer nodes point to map layers, they do not contain further children
@ -42,6 +43,7 @@ used by third party plugins. Custom properties are stored also in the project
file. The storage is not efficient for large amount of data.
Custom properties that have already been used within QGIS:
- "loading" - whether the project is being currently loaded (root node only)
- "overview" - whether to show a layer in overview
- "showFeatureCount" - whether to show feature counts in layer tree (vector only)

View File

@ -84,6 +84,7 @@ class QgsMeshDataSourceInterface /Abstract/
Interface for mesh data sources
Mesh is a collection of vertices, edges and faces in 2D or 3D space
- vertex - XY(Z) point (in the mesh's coordinate reference system)
- edge - two XY(Z) points (in the mesh's coordinate reference system) representing straight seqment
- faces - sets of vertices forming a closed shape - typically triangles or quadrilaterals

View File

@ -392,6 +392,7 @@ Returns the root items of the dataset group tree item
%Docstring
Sets the root items of the dataset group tree item.
Changes active dataset groups if those one are not enabled anymore :
- new active scalar dataset group is the first root item enabled child
- new active vector dataset group is none

View File

@ -17,6 +17,7 @@ class QgsMeshLayerTemporalProperties : QgsMapLayerTemporalProperties
Implementation of map layer temporal properties for mesh layers.
The time in a mesh layer is defined by :
- a reference time provided by the data, the project or the user
- each dataset is associated with a relative times
- time extent is defined by the first time and the last time of all dataset

View File

@ -498,6 +498,7 @@ We try to match the Proj string to internal QGIS CRS ID using the following logi
Set up this CRS from a string definition.
It supports the following formats:
- "EPSG:<code>" - handled with createFromOgcWms()
- "POSTGIS:<srid>" - handled with createFromSrid()
- "INTERNAL:<srsid>" - handled with createFromSrsId()

View File

@ -404,6 +404,7 @@ createChildren() immediately because result will be useless. *
virtual void deleteLater();
%Docstring
Safely delete the item:
- disconnects parent
- unsets parent (but does not remove itself)
- deletes all its descendants recursively

View File

@ -362,10 +362,11 @@ Datum of Australia Technical Manual", Chapter 4.
code (and documentation) taken from rttopo project
https://git.osgeo.org/gogs/rttopo/librttopo
- spheroid_project.spheroid_project(...)
- Valid bounds checking for degrees (latitude=+- 85.05115) is based values used for
-> 'WGS84 Web Mercator (Auxiliary Sphere)' calculations
--> latitudes outside these bounds cause the calculations to become unstable and can return invalid results
- spheroid_project.spheroid_project(...)
- Valid bounds checking for degrees (latitude=+- 85.05115) is based values used for
-> 'WGS84 Web Mercator (Auxiliary Sphere)' calculations
--> latitudes outside these bounds cause the calculations to become unstable and can return invalid results
.. versionadded:: 3.0
%End

View File

@ -16,6 +16,7 @@ class QgsFields
Container of fields for a vector layer.
In addition to storing a list of QgsField instances, it also:
- allows quick lookups of field names to index in the list
- keeps track of where the field definition comes from (vector data provider, joined layer or newly added from an editing operation)

View File

@ -16,6 +16,7 @@ class QgsMapLayerDependency
This class models dependencies with or between map layers.
A dependency is defined by a layer ID, a type and an origin.
The two combinations of type/origin that are currently supported are:
- PresenceDependency && FromProvider: virtual layers for instance which may depend on other layers already loaded to work
- DataDependency && FromUser: dependencies given by the user, mainly to represent database triggers

View File

@ -17,6 +17,7 @@ The QgsOgcUtils class provides various utility functions for conversion between
OGC (Open Geospatial Consortium) standards and QGIS internal representations.
Currently supported standards:
- GML2 - Geography Markup Language (import, export)
%End

View File

@ -20,6 +20,7 @@ class QgsPointLocator : QObject
{
%Docstring
The class defines interface for querying point location:
- query nearest vertices / edges to a point
- query vertices / edges in rectangle
- query areas covering a point

View File

@ -229,14 +229,15 @@ Breaks a provider data source URI into its component paths (e.g. file path, laye
:param uri: uri string
:return: map containing components. Standard components may include:
- "path": file path
- "layerName"
- "url": base URL, for online services
- "referer": referrer string, for HTTP requests
- "host": hostname, for database services
- "bounds": hardcoded layer bounds (as a QgsRectangle)
- "crs": CRS definition
- "authcfg": authentication configuration ID
- "path": file path
- "layerName"
- "url": base URL, for online services
- "referer": referrer string, for HTTP requests
- "host": hostname, for database services
- "bounds": hardcoded layer bounds (as a QgsRectangle)
- "crs": CRS definition
- "authcfg": authentication configuration ID
.. note::

View File

@ -17,8 +17,10 @@ This class has all the configuration of snapping and can return answers to snapp
Internally, it keeps a cache of QgsPointLocator instances for multiple layers.
Currently it supports the following queries:
- snapToMap() - has multiple modes of operation
- snapToCurrentLayer()
For more complex queries it is possible to use locatorForLayer() method that returns
point locator instance with layer's indexed data.

View File

@ -17,11 +17,13 @@ class QgsSpatialIndexKDBush
A very fast static spatial index for 2D points based on a flat KD-tree.
Compared to QgsSpatialIndex, this index:
- supports single point features only (no multipoints)
- is static (features cannot be added or removed from the index after construction)
- is much faster!
- allows direct retrieval of the original feature's points, without requiring additional feature requests
- supports true "distance based" searches, i.e. return all points within a radius
from a search point
QgsSpatialIndexKDBush objects are implicitly shared and can be inexpensively copied.

View File

@ -55,10 +55,8 @@ as follows:
- crs=definition
Defines the coordinate reference system to use for the layer.
definition is any string accepted by :py:func:`QgsCoordinateReferenceSystem.createFromString()`
- index=yes
Specifies that the layer will be constructed with a spatial index
- field=name:type(length,precision)
Defines an attribute of the layer. Multiple field parameters can be added
to the data provider definition. type is one of "integer", "double", "string".
@ -104,6 +102,7 @@ Used to access data provided by a web feature service.
The url can be a HTTP url to a WFS server (legacy, e.g. http://foobar/wfs?TYPENAME=xxx&SRSNAME=yyy[&FILTER=zzz]), or,
starting with QGIS 2.16, a URI constructed using the QgsDataSourceUri class with the following parameters :
- url=string (mandatory): HTTP url to a WFS server endpoint. e.g http://foobar/wfs
- typename=string (mandatory): WFS typename
- srsname=string (recommended): SRS like 'EPSG:XXXX'
@ -111,7 +110,7 @@ starting with QGIS 2.16, a URI constructed using the QgsDataSourceUri class with
- password=string
- authcfg=string
- version=auto/1.0.0/1.1.0/2.0.0
-sql=string: full SELECT SQL statement with optional WHERE, ORDER BY and possibly with JOIN if supported on server
- sql=string: full SELECT SQL statement with optional WHERE, ORDER BY and possibly with JOIN if supported on server
- filter=string: QGIS expression or OGC/FES filter
- restrictToRequestBBOX=1: to download only features in the view extent (or more generally
in the bounding box of the feature iterator)
@ -135,6 +134,7 @@ geometry constructor functions.
Used to access data provided by a OGC API - Features server.
The URI should be constructed using the QgsDataSourceUri class with the following parameters:
- url=string (mandatory): HTTP url to a OGC API - Features landing page.
- typename=string (mandatory): Collection id
- username=string
@ -151,7 +151,6 @@ Also note:
- You can use various functions available in the QGIS Expression list,
however the function must exist server side and have the same name and arguments to work.
- Use the special $geometry parameter to provide the layer geometry column as input
into the spatial binary operators e.g intersects($geometry, geomFromWKT('POINT (5 6)'))
@ -183,7 +182,7 @@ Defines the algorithm used to split records into columns. Records are
defined by new lines, except for csv format files for which quoted fields
may span multiple records. The default type is csv.
- "csv" splits the file based on three sets of characters:
- "csv" splits the file based on three sets of characters:
delimiter characters, quote characters,
and escape characters. Delimiter characters mark the end
of a field. Quote characters enclose a field which can contain
@ -195,14 +194,13 @@ also quote characters are treated specially - they can only
escape themselves within quotes. Elsewhere they are treated as
quote characters. The defaults for delimiter, quote, and escape
are ',', '"', '"'.
- "regexp" splits each record using a regular expression (see QRegExp
- "regexp" splits each record using a regular expression (see QRegExp
documentation for details).
- "whitespace" splits each record based on whitespace (on or more whitespace
- "whitespace" splits each record based on whitespace (on or more whitespace
characters. Leading whitespace in the record is ignored.
- "plain" is provided for backwards compatibility. It is equivalent to
- "plain" is provided for backwards compatibility. It is equivalent to
CSV except that the default quote characters are single and double quotes,
and there is no escape characters.
- delimiter=characters
Defines the delimiter characters used for csv and plain type files, or the
@ -283,16 +281,16 @@ Defines an expression that will identify a subset of records to display
Defines the coordinate reference system used for the layer. This can be
any string accepted by :py:func:`QgsCoordinateReferenceSystem.createFromString()`
-subsetIndex=(yes|no)
- subsetIndex=(yes|no)
Determines whether the provider generates an index to improve the efficiency
of subsets. The default is yes
-spatialIndex=(yes|no)
- spatialIndex=(yes|no)
Determines whether the provider generates a spatial index. The default is no.
-watchFile=(yes|no)
- watchFile=(yes|no)
Defines whether the file will be monitored for changes. The default is
to monitor for changes.
@ -1298,13 +1296,14 @@ Adds a ring to polygon/multipolygon features
:param featureId: if specified, feature ID for feature ring was added to will be stored in this parameter
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
.. note::
@ -1326,13 +1325,14 @@ Adds a ring to polygon/multipolygon features
:param featureId: if specified, feature ID for feature ring was added to will be stored in this parameter
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
.. note::
@ -1350,13 +1350,14 @@ Adds a ring to polygon/multipolygon features (takes ownership)
:param featureId: if specified, feature ID for feature ring was added to will be stored in this parameter
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
- Success
- LayerNotEditable
- AddRingNotInExistingFeature
- InvalidInputGeometryType
- AddRingNotClosed
- AddRingNotValid
- AddRingCrossesExistingRings
.. note::
@ -1375,14 +1376,15 @@ Adds a ring to polygon/multipolygon features (takes ownership)
Adds a new part polygon to a multipart feature
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
.. note::
@ -1400,14 +1402,15 @@ Adds a new part polygon to a multipart feature
Adds a new part polygon to a multipart feature
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
.. note::
@ -1429,14 +1432,15 @@ Adds a new part polygon to a multipart feature
Adds a new part polygon to a multipart feature
:return: QgsGeometry.OperationResult
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
- Success
- LayerNotEditable
- SelectionIsEmpty
- SelectionIsGreaterThanOne
- AddPartSelectedGeometryNotFound
- AddPartNotMultiGeometry
- InvalidBaseGeometry
- InvalidInputGeometryType
.. note::
@ -1491,13 +1495,14 @@ Splits parts cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: QgsGeometry.OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
.. note::
@ -1518,13 +1523,14 @@ Splits parts cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: QgsGeometry.OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
.. note::
@ -1542,13 +1548,14 @@ Splits features cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: QgsGeometry.OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
.. note::
@ -1569,13 +1576,14 @@ Splits features cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: QgsGeometry.OperationResult
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
- Success
- NothingHappened
- LayerNotEditable
- InvalidInputGeometryType
- InvalidBaseGeometry
- GeometryEngineError
- SplitCannotSplitPoint
.. note::

View File

@ -108,10 +108,11 @@ Adds a ring to polygon/multipolygon features
Adds a new part polygon to a multipart feature
:return: - QgsGeometry.Success
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
.. deprecated:: QGIS 3.12
- will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
@ -122,10 +123,11 @@ Adds a new part polygon to a multipart feature
Adds a new part polygon to a multipart feature
:return: - QgsGeometry.Success
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
.. note::
@ -137,10 +139,11 @@ Adds a new part polygon to a multipart feature
Adds a new part polygon to a multipart feature
:return: - QgsGeometry.Success
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
- QgsGeometry.AddPartSelectedGeometryNotFound
- QgsGeometry.AddPartNotMultiGeometry
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.InvalidInput
.. note::
@ -166,12 +169,13 @@ Splits parts cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: - QgsGeometry.InvalidBaseGeometry
- QgsGeometry.Success
- QgsGeometry.InvalidInput
- QgsGeometry.NothingHappened if a selection is present but no feature has been split
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.GeometryEngineError
- QgsGeometry.SplitCannotSplitPoint
- QgsGeometry.Success
- QgsGeometry.InvalidInput
- QgsGeometry.NothingHappened if a selection is present but no feature has been split
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.GeometryEngineError
- QgsGeometry.SplitCannotSplitPoint
.. deprecated:: QGIS 3.12
- will be removed in QGIS 4.0. Use the variant which accepts QgsPoint objects instead of QgsPointXY.
@ -185,12 +189,13 @@ Splits parts cut by the given line
:param topologicalEditing: ``True`` if topological editing is enabled
:return: - QgsGeometry.InvalidBaseGeometry
- QgsGeometry.Success
- QgsGeometry.InvalidInput
- QgsGeometry.NothingHappened if a selection is present but no feature has been split
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.GeometryEngineError
- QgsGeometry.SplitCannotSplitPoint
- QgsGeometry.Success
- QgsGeometry.InvalidInput
- QgsGeometry.NothingHappened if a selection is present but no feature has been split
- QgsGeometry.InvalidBaseGeometry
- QgsGeometry.GeometryEngineError
- QgsGeometry.SplitCannotSplitPoint
%End
QgsGeometry::OperationResult splitFeatures( const QVector<QgsPointXY> &splitLine, bool topologicalEditing = false ) /Deprecated/;

View File

@ -246,6 +246,7 @@ layer, note that the number of features returned might be greater than one when
converting a multi part geometry to single part
The following operations will be performed to convert the input features:
- convert single geometries to multi part
- drop additional attributes
- drop geometry if layer is geometry-less
@ -266,6 +267,7 @@ layer, note that the number of features returned might be greater than the numbe
of input features.
The following operations will be performed to convert the input features:
- convert single geometries to multi part
- drop additional attributes
- drop geometry if layer is geometry-less

View File

@ -78,13 +78,9 @@ This is the constructor for the RasterLayer class.
The main tasks carried out by the constructor are:
- Load the rasters default style (.qml) file if it exists
- Populate the RasterStatsVector with initial values for each band.
- Calculate the layer extents
- Determine whether the layer is gray, paletted or multiband.
- Assign sensible defaults for the red, green, blue and gray bands.
%End

View File

@ -1104,6 +1104,7 @@ Used internally when reading/writing symbols.
Sets the path to the SVG file to render in the fill.
This is usually an absolute file path. Other supported options include
- relative paths to folders from the user's SVG search paths
- base64 encoded content, prefixed with a 'base64:' string
- http(s) paths

View File

@ -81,6 +81,7 @@ Reads configuration from the given DOM element
void graduatedColors( double value1, double value2, QList<double> &breakValues, QList<QColor> &breakColors, QList<QLinearGradient> &gradients ) const;
%Docstring
Returns the break values, graduated colors and the associated gradients between two values
- If the color is fixed or only one color for the interval (value1, value2), returns only one color in ``breakColors``
and void lists for ``breakValues``, ``gradients``
- If the color ramp is classified with 'exact', returns void ``gradients``

View File

@ -16,10 +16,12 @@ We may need stable references to symbol layers, when pointers to symbol layers i
(when a symbol or a feature renderer is cloned for example).
A symbol layer identifier consists of:
- an identifier to its symbol (given by the QgsFeatureRenderer)
- a path of indexes inside its symbol and subsymbols.
For a symbol in a QgsSingleSymbolRenderer that has two symbol layers, it will give:
- "" for the symbol key
- [0] and [1] for the two symbol layer indexes
@ -27,6 +29,7 @@ For a QgsRuleBasedRenderer each rule key is the symbol key.
For a symbol with a symbol layer that has a sub symbol (say a QgsArrowSymbolLayer),
path to symbol layers of the sub symbol are given by a list of indexes:
- [0, 0] : first symbol layer of the sub symbol of the first symbol layer
- [0, 1] : second symbol layer of the sub symbol of the first symbol layer
- [2, 0] : first symbol layer of the sub symbol of the third symbol layer, etc.

View File

@ -50,15 +50,18 @@ and does the map rendering.
To construct a vector tile layer, it is best to use QgsDataSourceUri class and set
the following parameters to get a valid encoded URI:
- "type" - what kind of data source will be used
- "url" - URL or path of the data source (specific to each data source type, see below)
Currently supported data source types:
- "xyz" - the "url" should be a template like http://example.com/{z}/{x}/{y}.pbf where
{x},{y},{z} will be replaced by tile coordinates
- "mbtiles" - tiles read from a MBTiles file (a SQLite database)
Currently supported decoders:
- MVT - following Mapbox Vector Tiles specification
.. versionadded:: 3.14

View File

@ -36,6 +36,7 @@ is backend dependent. Currently only "mbtiles" source type supports writing
of metadata. The key-value pairs will be written to the "metadata" table
in the MBTiles file. Some useful metadata keys listed here, but see MBTiles spec
for more details:
- "name" - human-readable name of the tileset
- "bounds" - extent in WGS 84: "minlon,minlat,maxlon,maxlat"
- "center" - default view of the map: "longitude,latitude,zoomlevel"
@ -45,6 +46,7 @@ for more details:
- "description" - descriptions of the content
- "type" - whether this is an overlay or a basemap
- "version" - version of the tileset
Vector tile writer always writes "format" and "json" metadata. If not specified
in metadata by the client, tile writer also writes "name", "bounds", "minzoom"
and "maxzoom".

View File

@ -78,11 +78,12 @@ Sets the dock widget as visible to a user, ie both shown and raised to the front
When setting a dock as user visible, the dock will be opened (if it is not already
opened) and raised to the front.
When setting as hidden, the following logic is used:
- hiding a dock which is open but not raised (ie hidden by another tab) will have no
effect, and the dock will still be opened and hidden by the other tab
- hiding a dock which is open and raised (ie, user visible) will cause the dock to
be closed
- hiding a dock which is closed has no effect and raises no signals
- hiding a dock which is open but not raised (ie hidden by another tab) will have no
effect, and the dock will still be opened and hidden by the other tab
- hiding a dock which is open and raised (ie, user visible) will cause the dock to
be closed
- hiding a dock which is closed has no effect and raises no signals
.. seealso:: :py:func:`isUserVisible`

View File

@ -20,6 +20,7 @@ Multiple locations are supported, they will be used in order of
preference, from top to bottom.
URI construction takes in account following information:
- QGIS version
- language of the QGIS UI

View File

@ -1001,6 +1001,7 @@ Emitted when canvas background color changes
void renderComplete( QPainter * );
%Docstring
TODO: deprecate when decorations are reimplemented as map canvas items
- anything related to rendering progress is not visible outside of map canvas
- additional drawing shall be done directly within the renderer job or independently as a map canvas item
%End

View File

@ -12,6 +12,7 @@ class QgsMapCanvasTracer : QgsTracer
{
%Docstring
Extension of QgsTracer that provides extra functionality:
- automatic updates of own configuration based on canvas settings
- reporting of issues to the user via message bar
- determines whether tracing is currently enabled by the user

View File

@ -67,6 +67,7 @@ value and converting it to its proper Type.
If the value is not set and a default was not provided an invalid QVariant is returned.
Validation steps:
- required
- can convert to proper Type
- custom validator (if set - not available in Python bindings)

View File

@ -47,7 +47,7 @@ class APP_EXPORT QgsMapToolAddCircularString: public QgsMapToolCapture
/**
* The parent map tool, e.g. the add feature tool.
* Completed circular strings will be added to this tool by calling its addCurve() method.
* */
*/
QgsMapToolCapture *mParentTool = nullptr;
//! Circular string points (in map coordinates)
QgsPointSequence mPoints;

View File

@ -20,7 +20,7 @@
/**
* A tool to cut holes into polygon and multipolygon features and fill them
* with new feature. Attributes are copied from parent feature.
* */
*/
class APP_EXPORT QgsMapToolFillRing: public QgsMapToolCapture
{
Q_OBJECT

View File

@ -111,7 +111,6 @@ namespace pal
* It can be thrown by :
*
* - pal::Layer::setFeatureLabelSize if either the height or the width of the label is < 0
*
* - pal::Layer::setFeatureDistlabel is distlable < 0
*/
class ValueNotInRange : public std::exception

View File

@ -82,7 +82,6 @@ struct LayerRenderJob
* - One of its symbol layer masks a symbol layer of another layer.
* In this case we need to compute a mask image during the regular
* rendering pass that will be stored here;
*
* - Some of its symbol layers are masked by a symbol layer of another layer (or by a label mask)
* In this case we need to render the layer once again in a second pass, but with some symbol
* layers disabled.

View File

@ -121,10 +121,8 @@ typedef QSet<int> QgsAttributeIds;
* - crs=definition
* Defines the coordinate reference system to use for the layer.
* definition is any string accepted by QgsCoordinateReferenceSystem::createFromString()
*
* - index=yes
* Specifies that the layer will be constructed with a spatial index
*
* - field=name:type(length,precision)
* Defines an attribute of the layer. Multiple field parameters can be added
* to the data provider definition. type is one of "integer", "double", "string".
@ -220,7 +218,6 @@ typedef QSet<int> QgsAttributeIds;
*
* - You can use various functions available in the QGIS Expression list,
* however the function must exist server side and have the same name and arguments to work.
*
* - Use the special $geometry parameter to provide the layer geometry column as input
* into the spatial binary operators e.g intersects($geometry, geomFromWKT('POINT (5 6)'))
*
@ -271,7 +268,6 @@ typedef QSet<int> QgsAttributeIds;
* - "plain" is provided for backwards compatibility. It is equivalent to
* CSV except that the default quote characters are single and double quotes,
* and there is no escape characters.
*
* - delimiter=characters
*
* Defines the delimiter characters used for csv and plain type files, or the
@ -2317,7 +2313,6 @@ class CORE_EXPORT QgsVectorLayer : public QgsMapLayer, public QgsExpressionConte
*
* - the user is visibly informed that his changes were not saved and what he needs
* to do in order to be able to save the changes.
*
* - to set the property back to TRUE, once the user has fixed his data.
*
* When calling \see commitChanges(), this flag is checked just after the
@ -2337,7 +2332,6 @@ class CORE_EXPORT QgsVectorLayer : public QgsMapLayer, public QgsExpressionConte
*
* - the user is visibly informed that his changes were not saved and what he needs
* to do in order to be able to save the changes.
*
* - to set the property back to TRUE, once the user has fixed his data.
*
* When calling \see commitChanges(), this flag is checked just after the

View File

@ -146,16 +146,12 @@ class CORE_EXPORT QgsRasterLayer : public QgsMapLayer
* The main tasks carried out by the constructor are:
*
* - Load the rasters default style (.qml) file if it exists
*
* - Populate the RasterStatsVector with initial values for each band.
*
* - Calculate the layer extents
*
* - Determine whether the layer is gray, paletted or multiband.
*
* - Assign sensible defaults for the red, green, blue and gray bands.
*
* */
*/
explicit QgsRasterLayer( const QString &uri,
const QString &baseName = QString(),
const QString &providerType = "gdal",

View File

@ -743,7 +743,7 @@ class CORE_EXPORT QgsStyle : public QObject
* \param type is either SymbolEntity or ColorrampEntity
* \param qword is the query string to search the symbols or colorramps.
* \returns A QStringList of the matched symbols or colorramps
* */
*/
QStringList findSymbols( StyleEntity type, const QString &qword );
/**

View File

@ -50,13 +50,13 @@ class GUI_EXPORT QgsMapToolExtent : public QgsMapTool
* Sets a fixed aspect ratio to be used when dragging extent onto the canvas.
* To unset a fixed aspect ratio, set the width and height to zero.
* \param ratio aspect ratio's width and height
* */
*/
void setRatio( QSize ratio ) { mRatio = ratio; }
/**
* Returns the current fixed aspect ratio to be used when dragging extent onto the canvas.
* If the aspect ratio isn't fixed, the width and height will be set to zero.
* */
*/
QSize ratio() const { return mRatio; }
/**

View File

@ -271,13 +271,13 @@ namespace QgsWms
//! Gets layer search rectangle (depending on request parameter, layer type, map and layer crs)
QgsRectangle featureInfoSearchRect( QgsVectorLayer *ml, const QgsMapSettings &ms, const QgsRenderContext &rct, const QgsPointXY &infoPoint ) const;
/*
/**
* Configures the print layout for the GetPrint request
*\param c the print layout
*\param mapSettings the map settings
*\param atlasPrint true if atlas is used for printing
*\returns true in case of success
* */
*/
bool configurePrintLayout( QgsPrintLayout *c, const QgsMapSettings &mapSettings, bool atlasPrint = false );
void removeTemporaryLayers();