Skip to content

Commit

Permalink
Add 'mutator for ' to doxygen compliance blacklist
Browse files Browse the repository at this point in the history
  • Loading branch information
nyalldawson committed May 26, 2018
1 parent c10f6de commit 8f770c3
Show file tree
Hide file tree
Showing 5 changed files with 32 additions and 16 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -36,14 +36,18 @@ a specified bounding range.
A customicable method to indicate if the pixels is displayable
%End

void setMaximumValue( double );
void setMaximumValue( double value );
%Docstring
Mustator for the maximum value
Sets the maximum ``value``.

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

void setMinimumValue( double );
void setMinimumValue( double value );
%Docstring
Mutator for the minimum value
Sets the minimum ``value``.

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

protected:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,14 +60,14 @@ Resets the transparency list to a single ``value``.
Resets the transparency list to single red, green, and blue values.
%End

void setTransparentSingleValuePixelList( const QList<QgsRasterTransparency::TransparentSingleValuePixel> &newList /Transfer/ );
void setTransparentSingleValuePixelList( const QList<QgsRasterTransparency::TransparentSingleValuePixel> &newList );
%Docstring
Mutator for transparentSingleValuePixelList, replaces the whole list
Sets the transparent single value pixel list, replacing the whole existing list.
%End

void setTransparentThreeValuePixelList( const QList<QgsRasterTransparency::TransparentThreeValuePixel> &newList /Transfer/ );
void setTransparentThreeValuePixelList( const QList<QgsRasterTransparency::TransparentThreeValuePixel> &newList );
%Docstring
Mutator for transparentThreeValuePixelList, replaces the whole list
Sets the transparent three value pixel list, replacing the whole existing list.
%End

int alphaValue( double value, int globalTransparency = 255 ) const;
Expand Down
14 changes: 10 additions & 4 deletions src/core/raster/qgscontrastenhancementfunction.h
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,17 @@ class CORE_EXPORT QgsContrastEnhancementFunction
//! \brief A customicable method to indicate if the pixels is displayable
virtual bool isValueInDisplayableRange( double );

//! \brief Mustator for the maximum value
void setMaximumValue( double );
/**
* Sets the maximum \a value.
* \see setMinimumValue()
*/
void setMaximumValue( double value );

//! \brief Mutator for the minimum value
void setMinimumValue( double );
/**
* Sets the minimum \a value.
* \see setMaximumValue()
*/
void setMinimumValue( double value );

protected:
//! \brief User defineable maximum value for the band, used for enhanceContrasting
Expand Down
12 changes: 8 additions & 4 deletions src/core/raster/qgsrastertransparency.h
Original file line number Diff line number Diff line change
Expand Up @@ -76,11 +76,15 @@ class CORE_EXPORT QgsRasterTransparency
*/
void initializeTransparentPixelList( double redValue, double greenValue, double blueValue );

//! \brief Mutator for transparentSingleValuePixelList, replaces the whole list
void setTransparentSingleValuePixelList( const QList<QgsRasterTransparency::TransparentSingleValuePixel> &newList SIP_TRANSFER );
/**
* Sets the transparent single value pixel list, replacing the whole existing list.
*/
void setTransparentSingleValuePixelList( const QList<QgsRasterTransparency::TransparentSingleValuePixel> &newList );

//! \brief Mutator for transparentThreeValuePixelList, replaces the whole list
void setTransparentThreeValuePixelList( const QList<QgsRasterTransparency::TransparentThreeValuePixel> &newList SIP_TRANSFER );
/**
* Sets the transparent three value pixel list, replacing the whole existing list.
*/
void setTransparentThreeValuePixelList( const QList<QgsRasterTransparency::TransparentThreeValuePixel> &newList );

/**
* Returns the transparency value for a single \a value pixel.
Expand Down
2 changes: 2 additions & 0 deletions tests/code_layout/doxygen_parser.py
Original file line number Diff line number Diff line change
Expand Up @@ -577,6 +577,8 @@ def memberDocIsNonCompliant(self, member_elem):
return 'Use "Returns the..." instead of "getter"'
elif para.text.strip().lower().startswith('setter'):
return 'Use "Sets the..." instead of "setter"'
elif para.text.strip().lower().startswith('mutator'):
return 'Use "Sets the..." instead of "mutator for..."'
elif para.text.strip().lower().startswith('return '):
return 'Use "Returns the..." instead of "return ..."'
#elif para.text.strip().lower().startswith('set '):
Expand Down

0 comments on commit 8f770c3

Please sign in to comment.