/************************************************************************ * This file has been generated automatically from * * * * src/core/qgsmapsettings.h * * * * Do not edit manually ! Edit header and run scripts/sipify.pl again * ************************************************************************/ class QgsMapSettings { %Docstring The QgsMapSettings class contains configuration for rendering of the map. The rendering itself is done by QgsMapRendererJob subclasses. In order to set up QgsMapSettings instance, it is necessary to set at least few members: extent, output size and layers. QgsMapSettings and QgsMapRendererJob (+subclasses) are intended to replace QgsMapRenderer class that existed before QGIS 2.4. The advantage of the new classes is that they separate the settings from the rendering and provide asynchronous API for map rendering. .. versionadded:: 2.4 %End %TypeHeaderCode #include "qgsmapsettings.h" %End public: QgsMapSettings(); QgsRectangle extent() const; %Docstring of output size. Use visibleExtent() to get the resulting extent. :rtype: QgsRectangle %End void setExtent( const QgsRectangle &rect, bool magnified = true ); %Docstring of output size. Use visibleExtent() to get the resulting extent. %End QSize outputSize() const; %Docstring Return the size of the resulting map image :rtype: QSize %End void setOutputSize( QSize size ); %Docstring Set the size of the resulting map image %End double rotation() const; %Docstring Returns the rotation of the resulting map image, in degrees clockwise. .. versionadded:: 2.8 .. seealso:: setRotation() :rtype: float %End void setRotation( double rotation ); %Docstring Sets the ``rotation`` of the resulting map image, in degrees clockwise. .. versionadded:: 2.8 .. seealso:: rotation() %End double outputDpi() const; %Docstring Default value is 96 :rtype: float %End void setOutputDpi( double dpi ); %Docstring Set DPI used for conversion between real world units (e.g. mm) and pixels %End void setMagnificationFactor( double factor ); %Docstring Set the magnification factor. \param factor the factor of magnification .. versionadded:: 2.16 .. seealso:: magnificationFactor() %End double magnificationFactor() const; %Docstring .. seealso:: setMagnificationFactor() :rtype: float %End QStringList layerIds() const; %Docstring The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top) :rtype: list of str %End QList layers() const; %Docstring The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top) :rtype: list of QgsMapLayer %End void setLayers( const QList &layers ); %Docstring The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top) %End QMap layerStyleOverrides() const; %Docstring .. versionadded:: 2.8 :rtype: QMap %End void setLayerStyleOverrides( const QMap &overrides ); %Docstring .. versionadded:: 2.8 %End QString customRenderFlags() const; %Docstring Get custom rendering flags. Layers might honour these to alter their rendering. :return: custom flags strings, separated by ';' .. versionadded:: 2.16 .. seealso:: setCustomRenderFlags() :rtype: str %End void setCustomRenderFlags( const QString &customRenderFlags ); %Docstring Sets the custom rendering flags. Layers might honour these to alter their rendering. \param customRenderFlags custom flags strings, separated by ';' .. versionadded:: 2.16 .. seealso:: customRenderFlags() %End void setDestinationCrs( const QgsCoordinateReferenceSystem &crs ); %Docstring sets destination coordinate reference system %End QgsCoordinateReferenceSystem destinationCrs() const; %Docstring returns CRS of destination coordinate reference system :rtype: QgsCoordinateReferenceSystem %End QgsUnitTypes::DistanceUnit mapUnits() const; %Docstring Get units of map's geographical coordinates - used for scale calculation :rtype: QgsUnitTypes.DistanceUnit %End bool setEllipsoid( const QString &ellipsoid ); %Docstring Sets the ``ellipsoid`` by its acronym. Known ellipsoid acronyms can be retrieved using QgsEllipsoidUtils.acronyms(). Calculations will only use the ellipsoid if a valid ellipsoid has been set. :return: true if ellipsoid was successfully set .. versionadded:: 3.0 .. seealso:: ellipsoid() :rtype: bool %End QString ellipsoid() const; %Docstring Returns ellipsoid's acronym. Calculations will only use the ellipsoid if a valid ellipsoid has been set. .. versionadded:: 3.0 .. seealso:: setEllipsoid() :rtype: str %End void setBackgroundColor( const QColor &color ); %Docstring Set the background color of the map %End QColor backgroundColor() const; %Docstring Get the background color of the map :rtype: QColor %End void setSelectionColor( const QColor &color ); %Docstring Set color that is used for drawing of selected vector features %End QColor selectionColor() const; %Docstring Get color that is used for drawing of selected vector features :rtype: QColor %End enum Flag { Antialiasing, DrawEditingInfo, ForceVectorOutput, UseAdvancedEffects, DrawLabeling, UseRenderingOptimization, DrawSelection, DrawSymbolBounds, RenderMapTile, RenderPartialOutput, // TODO }; typedef QFlags Flags; void setFlags( QgsMapSettings::Flags flags ); %Docstring Set combination of flags that will be used for rendering %End void setFlag( Flag flag, bool on = true ); %Docstring Enable or disable a particular flag (other flags are not affected) %End Flags flags() const; %Docstring Return combination of flags used for rendering :rtype: Flags %End bool testFlag( Flag flag ) const; %Docstring Check whether a particular flag is enabled :rtype: bool %End void setOutputImageFormat( QImage::Format format ); %Docstring sets format of internal QImage %End QImage::Format outputImageFormat() const; %Docstring format of internal QImage, default QImage.Format_ARGB32_Premultiplied :rtype: QImage.Format %End bool hasValidSettings() const; %Docstring Check whether the map settings are valid and can be used for rendering :rtype: bool %End QgsRectangle visibleExtent() const; %Docstring Return the actual extent derived from requested extent that takes takes output image size into account :rtype: QgsRectangle %End QPolygonF visiblePolygon() const; %Docstring .. versionadded:: 2.8 :rtype: QPolygonF %End double mapUnitsPerPixel() const; %Docstring Return the distance in geographical coordinates that equals to one pixel in the map :rtype: float %End double scale() const; %Docstring Returns the calculated map scale. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map. :rtype: float %End void setExpressionContext( const QgsExpressionContext &context ); %Docstring Sets the expression context. This context is used for all expression evaluation associated with this map settings. .. seealso:: expressionContext() .. versionadded:: 2.12 %End const QgsExpressionContext &expressionContext() const; %Docstring Gets the expression context. This context should be used for all expression evaluation associated with this map settings. .. seealso:: setExpressionContext() .. versionadded:: 2.12 :rtype: QgsExpressionContext %End QgsDatumTransformStore &datumTransformStore(); %Docstring :rtype: QgsDatumTransformStore %End const QgsMapToPixel &mapToPixel() const; %Docstring :rtype: QgsMapToPixel %End double layerToMapUnits( const QgsMapLayer *layer, const QgsRectangle &referenceExtent = QgsRectangle() ) const; %Docstring Computes an *estimated* conversion factor between layer and map units: layerUnits * layerToMapUnits = mapUnits \param layer The layer \param referenceExtent A reference extent based on which to perform the computation. If not specified, the layer extent is used .. versionadded:: 2.12 :rtype: float %End QgsRectangle layerExtentToOutputExtent( const QgsMapLayer *layer, QgsRectangle extent ) const; %Docstring transform bounding box from layer's CRS to output CRS .. seealso:: layerToMapCoordinates( QgsMapLayer* layer, QgsRectangle rect ) if you want to transform a rectangle :return: a bounding box (aligned rectangle) containing the transformed extent :rtype: QgsRectangle %End QgsRectangle outputExtentToLayerExtent( const QgsMapLayer *layer, QgsRectangle extent ) const; %Docstring transform bounding box from output CRS to layer's CRS .. seealso:: mapToLayerCoordinates( QgsMapLayer* layer,QgsRectangle rect ) if you want to transform a rectangle :return: a bounding box (aligned rectangle) containing the transformed extent :rtype: QgsRectangle %End QgsPointXY layerToMapCoordinates( const QgsMapLayer *layer, QgsPointXY point ) const; %Docstring transform point coordinates from layer's CRS to output CRS :return: the transformed point :rtype: QgsPointXY %End QgsRectangle layerToMapCoordinates( const QgsMapLayer *layer, QgsRectangle rect ) const; %Docstring transform rectangle from layer's CRS to output CRS .. seealso:: layerExtentToOutputExtent() if you want to transform a bounding box :return: the transformed rectangle :rtype: QgsRectangle %End QgsPointXY mapToLayerCoordinates( const QgsMapLayer *layer, QgsPointXY point ) const; %Docstring transform point coordinates from output CRS to layer's CRS :return: the transformed point :rtype: QgsPointXY %End QgsRectangle mapToLayerCoordinates( const QgsMapLayer *layer, QgsRectangle rect ) const; %Docstring transform rectangle from output CRS to layer's CRS .. seealso:: outputExtentToLayerExtent() if you want to transform a bounding box :return: the transformed rectangle :rtype: QgsRectangle %End QgsCoordinateTransform layerTransform( const QgsMapLayer *layer ) const; %Docstring Return coordinate transform from layer's CRS to destination CRS \param layer :return: transform - may be invalid if the transform is not needed :rtype: QgsCoordinateTransform %End QgsRectangle fullExtent() const; %Docstring returns current extent of layer set :rtype: QgsRectangle %End void readXml( QDomNode &node ); %Docstring serialization */ %End void writeXml( QDomNode &node, QDomDocument &doc ); void setSegmentationTolerance( double tolerance ); %Docstring Sets the segmentation tolerance applied when rendering curved geometries \param tolerance the segmentation tolerance* %End double segmentationTolerance() const; %Docstring Gets the segmentation tolerance applied when rendering curved geometries :rtype: float %End void setSegmentationToleranceType( QgsAbstractGeometry::SegmentationToleranceType type ); %Docstring Sets segmentation tolerance type (maximum angle or maximum difference between curve and approximation) \param type the segmentation tolerance typename* %End QgsAbstractGeometry::SegmentationToleranceType segmentationToleranceType() const; %Docstring Gets segmentation tolerance type (maximum angle or maximum difference between curve and approximation) :rtype: QgsAbstractGeometry.SegmentationToleranceType %End void setLabelingEngineSettings( const QgsLabelingEngineSettings &settings ); %Docstring Sets global configuration of the labeling engine .. versionadded:: 3.0 %End const QgsLabelingEngineSettings &labelingEngineSettings() const; %Docstring Returns global configuration of the labeling engine .. versionadded:: 3.0 :rtype: QgsLabelingEngineSettings %End protected: void updateDerived(); }; QFlags operator|(QgsMapSettings::Flag f1, QFlags f2); /************************************************************************ * This file has been generated automatically from * * * * src/core/qgsmapsettings.h * * * * Do not edit manually ! Edit header and run scripts/sipify.pl again * ************************************************************************/