Skip to content

Commit

Permalink
Dox++
Browse files Browse the repository at this point in the history
  • Loading branch information
nyalldawson committed Dec 13, 2018
1 parent 591bb75 commit 44bbf1f
Show file tree
Hide file tree
Showing 2 changed files with 91 additions and 7 deletions.
48 changes: 45 additions & 3 deletions python/core/auto_generated/qgsrendercontext.sip.in
Original file line number Diff line number Diff line change
Expand Up @@ -109,8 +109,14 @@ Returns the destination QPainter for the render operation.

QgsCoordinateTransform coordinateTransform() const;
%Docstring
Returns the current coordinate transform for the context, or an invalid
transform is no coordinate transformation is required.
Returns the current coordinate transform for the context.

This represents the coordinate transform required to transform a layer
which is being rendered back to the CRS of the rendered map. If no coordinate
transformation is required, or the render context is not associated with
a map layer render, then an invalid coordinate transformation is returned.

.. seealso:: :py:func:`setCoordinateTransform`
%End

const QgsDistanceArea &distanceArea() const;
Expand Down Expand Up @@ -163,6 +169,22 @@ during rendering operations, e.g. for resolving relative symbol paths.
%End

const QgsRectangle &extent() const;
%Docstring
When rendering a map layer, calling this method returns the "clipping"
extent for the layer (in the layer's CRS).

This extent is a "worst-case" scenario, which is guaranteed to cover the complete
visible portion of the layer when it is rendered to a map. It is often larger
than the actual visible portion of that layer.

.. warning::

For some layers, depending on the visible extent and the coordinate
transforms involved, this extent will represent the entire globe. This method
should never be used to determine the actual visible extent of a map render.

.. seealso:: :py:func:`setExtent`
%End

const QgsMapToPixel &mapToPixel() const;

Expand Down Expand Up @@ -218,10 +240,30 @@ Returns true if vector selections should be shown in the rendered map

void setCoordinateTransform( const QgsCoordinateTransform &t );
%Docstring
Sets coordinate transformation.
Sets the current coordinate transform for the context.

This represents the coordinate transform required to transform the layer
which is being rendered back to the CRS of the rendered map.

Set to an invalid QgsCoordinateTransform to indicate that no transformation is required.

.. seealso:: :py:func:`coordinateTransform`
%End

void setMapToPixel( const QgsMapToPixel &mtp );

void setExtent( const QgsRectangle &extent );
%Docstring
When rendering a map layer, calling this method sets the "clipping"
extent for the layer (in the layer's CRS).

This extent should be a "worst-case" scenario, which is guaranteed to
completely cover the entire visible portion of the layer when it is rendered
to the map. It may be larger than the actual visible area, but MUST contain at least the
entire visible area.

.. seealso:: :py:func:`setExtent`
%End

void setDrawEditingInformation( bool b );

Expand Down
50 changes: 46 additions & 4 deletions src/core/qgsrendercontext.h
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,14 @@ class CORE_EXPORT QgsRenderContext
QPainter *painter() {return mPainter;}

/**
* Returns the current coordinate transform for the context, or an invalid
* transform is no coordinate transformation is required.
* Returns the current coordinate transform for the context.
*
* This represents the coordinate transform required to transform a layer
* which is being rendered back to the CRS of the rendered map. If no coordinate
* transformation is required, or the render context is not associated with
* a map layer render, then an invalid coordinate transformation is returned.
*
* \see setCoordinateTransform()
*/
QgsCoordinateTransform coordinateTransform() const {return mCoordTransform;}

Expand Down Expand Up @@ -215,7 +221,21 @@ class CORE_EXPORT QgsRenderContext
*/
void setPathResolver( const QgsPathResolver &resolver ) { mPathResolver = resolver; }

const QgsRectangle &extent() const {return mExtent;}
/**
* When rendering a map layer, calling this method returns the "clipping"
* extent for the layer (in the layer's CRS).
*
* This extent is a "worst-case" scenario, which is guaranteed to cover the complete
* visible portion of the layer when it is rendered to a map. It is often larger
* than the actual visible portion of that layer.
*
* \warning For some layers, depending on the visible extent and the coordinate
* transforms involved, this extent will represent the entire globe. This method
* should never be used to determine the actual visible extent of a map render.
*
* \see setExtent()
*/
const QgsRectangle &extent() const { return mExtent; }

const QgsMapToPixel &mapToPixel() const {return mMapToPixel;}

Expand Down Expand Up @@ -269,9 +289,31 @@ class CORE_EXPORT QgsRenderContext

//setters

//! Sets coordinate transformation.
/**
* Sets the current coordinate transform for the context.
*
* This represents the coordinate transform required to transform the layer
* which is being rendered back to the CRS of the rendered map.
*
* Set to an invalid QgsCoordinateTransform to indicate that no transformation is required.
*
* \see coordinateTransform()
*/
void setCoordinateTransform( const QgsCoordinateTransform &t );

void setMapToPixel( const QgsMapToPixel &mtp ) {mMapToPixel = mtp;}

/**
* When rendering a map layer, calling this method sets the "clipping"
* extent for the layer (in the layer's CRS).
*
* This extent should be a "worst-case" scenario, which is guaranteed to
* completely cover the entire visible portion of the layer when it is rendered
* to the map. It may be larger than the actual visible area, but MUST contain at least the
* entire visible area.
*
* \see setExtent()
*/
void setExtent( const QgsRectangle &extent ) {mExtent = extent;}

void setDrawEditingInformation( bool b );
Expand Down

0 comments on commit 44bbf1f

Please sign in to comment.