Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Improve documentation
  • Loading branch information
nyalldawson committed Nov 2, 2021
1 parent d2520ae commit 4b43f07
Show file tree
Hide file tree
Showing 10 changed files with 60 additions and 2 deletions.
Expand Up @@ -26,6 +26,9 @@ class QgsMultiBandColorRendererWidget: QgsRasterRendererWidget


void setFromRenderer( const QgsRasterRenderer *r );
%Docstring
Sets the widget state from the specified renderer.
%End

virtual QString min( int index = 0 );

Expand Down
Expand Up @@ -27,6 +27,9 @@ class QgsPalettedRendererWidget: QgsRasterRendererWidget


void setFromRenderer( const QgsRasterRenderer *r );
%Docstring
Sets the widget state from the specified renderer.
%End

};

Expand Down
20 changes: 20 additions & 0 deletions python/gui/auto_generated/raster/qgsrasterrendererwidget.sip.in
Expand Up @@ -13,6 +13,10 @@

class QgsRasterRendererWidget: QWidget
{
%Docstring(signature="appended")

Abstract base class for widgets which configure a :py:class:`QgsRasterRenderer`.
%End

%TypeHeaderCode
#include "qgsrasterrendererwidget.h"
Expand All @@ -22,9 +26,25 @@ class QgsRasterRendererWidget: QWidget
QgsRasterRendererWidget( QgsRasterLayer *layer, const QgsRectangle &extent );

virtual QgsRasterRenderer *renderer() = 0 /Factory/;
%Docstring
Creates a new renderer, using the properties defined in the widget.

The caller takes ownership of the returned renderer.
%End

void setRasterLayer( QgsRasterLayer *layer );
%Docstring
Sets the raster ``layer`` associated with the widget.

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

const QgsRasterLayer *rasterLayer() const;
%Docstring
Returns the raster layer associated with the widget.

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

virtual void setMapCanvas( QgsMapCanvas *canvas );
%Docstring
Expand Down
Expand Up @@ -27,6 +27,9 @@ class QgsSingleBandGrayRendererWidget: QgsRasterRendererWidget


void setFromRenderer( const QgsRasterRenderer *r );
%Docstring
Sets the widget state from the specified renderer.
%End

virtual QString min( int index = 0 );
virtual QString max( int index = 0 );
Expand Down
Expand Up @@ -49,7 +49,7 @@ Returns the current raster band number

void setFromRenderer( const QgsRasterRenderer *r );
%Docstring
Set state of the widget from renderer settings
Sets the widget state from the specified renderer.
%End

public slots:
Expand Down
3 changes: 3 additions & 0 deletions src/gui/raster/qgsmultibandcolorrendererwidget.h
Expand Up @@ -44,6 +44,9 @@ class GUI_EXPORT QgsMultiBandColorRendererWidget: public QgsRasterRendererWidget
QgsRasterRenderer *renderer() override;
void setMapCanvas( QgsMapCanvas *canvas ) override;

/**
* Sets the widget state from the specified renderer.
*/
void setFromRenderer( const QgsRasterRenderer *r );

QString min( int index = 0 ) override;
Expand Down
3 changes: 3 additions & 0 deletions src/gui/raster/qgspalettedrendererwidget.h
Expand Up @@ -192,6 +192,9 @@ class GUI_EXPORT QgsPalettedRendererWidget: public QgsRasterRendererWidget, priv

QgsRasterRenderer *renderer() override;

/**
* Sets the widget state from the specified renderer.
*/
void setFromRenderer( const QgsRasterRenderer *r );

private:
Expand Down
18 changes: 18 additions & 0 deletions src/gui/raster/qgsrasterrendererwidget.h
Expand Up @@ -32,6 +32,8 @@ class QgsRasterMinMaxWidget;
/**
* \ingroup gui
* \class QgsRasterRendererWidget
*
* \brief Abstract base class for widgets which configure a QgsRasterRenderer.
*/
class GUI_EXPORT QgsRasterRendererWidget: public QWidget
{
Expand All @@ -45,9 +47,25 @@ class GUI_EXPORT QgsRasterRendererWidget: public QWidget
, mExtent( extent )
{}

/**
* Creates a new renderer, using the properties defined in the widget.
*
* The caller takes ownership of the returned renderer.
*/
virtual QgsRasterRenderer *renderer() = 0 SIP_FACTORY;

/**
* Sets the raster \a layer associated with the widget.
*
* \see rasterLayer()
*/
void setRasterLayer( QgsRasterLayer *layer ) { mRasterLayer = layer; }

/**
* Returns the raster layer associated with the widget.
*
* \see setRasterLayer()
*/
const QgsRasterLayer *rasterLayer() const { return mRasterLayer; }

/**
Expand Down
3 changes: 3 additions & 0 deletions src/gui/raster/qgssinglebandgrayrendererwidget.h
Expand Up @@ -40,6 +40,9 @@ class GUI_EXPORT QgsSingleBandGrayRendererWidget: public QgsRasterRendererWidget
QgsRasterRenderer *renderer() override;
void setMapCanvas( QgsMapCanvas *canvas ) override;

/**
* Sets the widget state from the specified renderer.
*/
void setFromRenderer( const QgsRasterRenderer *r );

QString min( int index = 0 ) override { Q_UNUSED( index ) return mMinLineEdit->text(); }
Expand Down
4 changes: 3 additions & 1 deletion src/gui/raster/qgssinglebandpseudocolorrendererwidget.h
Expand Up @@ -56,7 +56,9 @@ class GUI_EXPORT QgsSingleBandPseudoColorRendererWidget: public QgsRasterRendere
//! Returns the current raster band number
int currentBand() const;

//! Set state of the widget from renderer settings
/**
* Sets the widget state from the specified renderer.
*/
void setFromRenderer( const QgsRasterRenderer *r );

public slots:
Expand Down

0 comments on commit 4b43f07

Please sign in to comment.