A ramp shader will color a raster pixel based on a list of values ranges in a ramp. More...

#include <qgscolorrampshader.h>

Inheritance diagram for QgsColorRampShader:

Classes
struct	ColorRampItem

Public Types
enum	ClassificationMode { Continuous = 1, EqualInterval = 2, Quantile = 3 }
	Classification modes used to create the color ramp shader. More...

enum	Type { Interpolated, Discrete, Exact }
	Supported methods for color interpolation. More...

Public Member Functions
	QgsColorRampShader (double minimumValue=0.0, double maximumValue=255.0, QgsColorRamp *colorRamp=nullptr, Type type=Interpolated, ClassificationMode classificationMode=Continuous)
	Creates a new color ramp shader. More...

	QgsColorRampShader (const QgsColorRampShader &other)
	Copy constructor. More...

ClassificationMode	classificationMode () const
	Returns the classification mode. More...

void	classifyColorRamp (int classes=0, int band=-1, const QgsRectangle &extent=QgsRectangle(), QgsRasterInterface *input=nullptr)
	Classify color ramp shader. More...

void	classifyColorRamp (int band=-1, const QgsRectangle &extent=QgsRectangle(), QgsRasterInterface *input=nullptr)
	Classify color ramp shader. More...

bool	clip () const
	Returns whether the shader will clip values which are out of range. More...

QList< QgsColorRampShader::ColorRampItem >	colorRampItemList () const
	Returns the custom colormap. More...

Type	colorRampType () const
	Returns the color ramp type. More...

QString	colorRampTypeAsQString () const
	Returns the color ramp type as a string. More...

bool	isEmpty () const
	Whether the color ramp contains any items. More...

void	legendSymbologyItems (QList< QPair< QString, QColor > > &symbolItems) const override
	Returns legend symbology items if provided by renderer. More...

QgsColorRampShader &	operator= (const QgsColorRampShader &other)
	Assignment operator. More...

void	readXml (const QDomElement &elem)
	Reads configuration from the given DOM element. More...

void	setClassificationMode (ClassificationMode classificationMode)
	Sets classification mode. More...

void	setClip (bool clip)
	Sets whether the shader should not render values out of range. More...

void	setColorRampItemList (const QList< QgsColorRampShader::ColorRampItem > &list)
	Sets a custom colormap. More...

void	setColorRampType (QgsColorRampShader::Type colorRampType)
	Sets the color ramp type. More...

void	setColorRampType (const QString &type)
	Sets the color ramp type. More...

void	setSourceColorRamp (QgsColorRamp *colorramp)
	Set the source color ramp. More...

bool	shade (double value, int returnRedValue, int returnGreenValue, int returnBlueValue, int returnAlphaValue) const override
	Generates and new RGB value based on one input value. More...

bool	shade (double redValue, double greenValue, double blueValue, double alphaValue, int returnRedValue, int returnGreenValue, int returnBlueValue, int returnAlphaValue) const override
	Generates and new RGB value based on original RGB value. More...

QgsColorRamp *	sourceColorRamp () const
	Gets the source color ramp. More...

QDomElement	writeXml (QDomDocument &doc) const
	Writes configuration to a new DOM element. More...

Public Member Functions inherited from QgsRasterShaderFunction
	QgsRasterShaderFunction (double minimumValue=0.0, double maximumValue=255.0)

virtual	~QgsRasterShaderFunction ()=default

double	maximumValue () const
	Returns the minimum value for the raster shader. More...

double	minimumMaximumRange () const

double	minimumValue () const
	Returns the maximum value for the raster shader. More...

virtual void	setMaximumValue (double value)
	Sets the maximum value for the raster shader. More...

virtual void	setMinimumValue (double value)
	Sets the minimum value for the raster shader. More...

Protected Attributes
std::unique_ptr< QgsColorRamp >	mSourceColorRamp
	Source color ramp. More...

Protected Attributes inherited from QgsRasterShaderFunction
double	mMaximumValue
	User defineable maximum value for the shading function. More...

double	mMinimumMaximumRange
	Minimum maximum range for the shading function. More...

double	mMinimumValue
	User defineable minimum value for the shading function. More...

Detailed Description

A ramp shader will color a raster pixel based on a list of values ranges in a ramp.

Definition at line 39 of file qgscolorrampshader.h.

Member Enumeration Documentation

◆ ClassificationMode

enum QgsColorRampShader::ClassificationMode

Classification modes used to create the color ramp shader.

Enumerator
Continuous	Uses breaks from color palette.
EqualInterval	Uses equal interval.
Quantile	Uses quantile (i.e. equal pixel) count.

Definition at line 53 of file qgscolorrampshader.h.

◆ Type

enum QgsColorRampShader::Type

Supported methods for color interpolation.

Enumerator
Interpolated	Interpolates the color between two class breaks linearly.
Discrete	Assigns the color of the higher class for every pixel between two class breaks.
Exact	Assigns the color of the exact matching value in the color ramp item list.

Definition at line 45 of file qgscolorrampshader.h.

Constructor & Destructor Documentation

◆ QgsColorRampShader() [1/2]

QgsColorRampShader::QgsColorRampShader	(	double	minimumValue = `0.0`,
		double	maximumValue = `255.0`,
		QgsColorRamp *	colorRamp = `nullptr`,
		Type	type = `Interpolated`,
		ClassificationMode	classificationMode = `Continuous`
	)

Creates a new color ramp shader.

Parameters

minimumValue	minimum value for the raster shader
maximumValue	maximum value for the raster shader
type	interpolation type used
classificationMode	method used to classify the color ramp shader
colorRamp	vector color ramp used to classify the color ramp shader. Ownership is transferred to the shader.

Returns: new QgsColorRampShader

Definition at line 34 of file qgscolorrampshader.cpp.

◆ QgsColorRampShader() [2/2]

QgsColorRampShader::QgsColorRampShader ( const QgsColorRampShader & other )

Copy constructor.

Definition at line 44 of file qgscolorrampshader.cpp.

Member Function Documentation

◆ classificationMode()

ClassificationMode QgsColorRampShader::classificationMode ( ) const

inline

Returns the classification mode.

Definition at line 186 of file qgscolorrampshader.h.

◆ classifyColorRamp() [1/2]

void QgsColorRampShader::classifyColorRamp	(	int	classes = `0`,
		int	band = `-1`,
		const QgsRectangle &	extent = `QgsRectangle()`,
		QgsRasterInterface *	input = `nullptr`
	)

Classify color ramp shader.

Parameters

classes	number of classes
band	raster band used in classification (only used in quantile mode)
extent	extent used in classification (only used in quantile mode)
input	raster input used in classification (only used in quantile mode)

Definition at line 135 of file qgscolorrampshader.cpp.

◆ classifyColorRamp() [2/2]

void QgsColorRampShader::classifyColorRamp	(	int	band = `-1`,
		const QgsRectangle &	extent = `QgsRectangle()`,
		QgsRasterInterface *	input = `nullptr`
	)

Classify color ramp shader.

Parameters

band	raster band used in classification (quantile mode only)
extent	extent used in classification (quantile mode only)
input	raster input used in classification (quantile mode only)

Definition at line 314 of file qgscolorrampshader.cpp.

◆ clip()

bool QgsColorRampShader::clip ( ) const

inline

Returns whether the shader will clip values which are out of range.

See also: setClip()

Definition at line 199 of file qgscolorrampshader.h.

◆ colorRampItemList()

QList<QgsColorRampShader::ColorRampItem> QgsColorRampShader::colorRampItemList ( ) const

inline

Returns the custom colormap.

Definition at line 105 of file qgscolorrampshader.h.

◆ colorRampType()

Type QgsColorRampShader::colorRampType ( ) const

inline

Returns the color ramp type.

Definition at line 108 of file qgscolorrampshader.h.

◆ colorRampTypeAsQString()

QString QgsColorRampShader::colorRampTypeAsQString ( ) const

Returns the color ramp type as a string.

Definition at line 77 of file qgscolorrampshader.cpp.

◆ isEmpty()

bool QgsColorRampShader::isEmpty ( ) const

Whether the color ramp contains any items.

Since: QGIS 3.4

Definition at line 104 of file qgscolorrampshader.cpp.

◆ legendSymbologyItems()

void QgsColorRampShader::legendSymbologyItems ( QList< QPair< QString, QColor > > & symbolItems ) const

overridevirtual

Returns legend symbology items if provided by renderer.

Reimplemented from QgsRasterShaderFunction.

Definition at line 487 of file qgscolorrampshader.cpp.

◆ operator=()

QgsColorRampShader & QgsColorRampShader::operator= ( const QgsColorRampShader & other )

Assignment operator.

Definition at line 59 of file qgscolorrampshader.cpp.

◆ readXml()

void QgsColorRampShader::readXml ( const QDomElement & elem )

Reads configuration from the given DOM element.

Since: QGIS 3.4

Definition at line 525 of file qgscolorrampshader.cpp.

◆ setClassificationMode()

void QgsColorRampShader::setClassificationMode ( ClassificationMode classificationMode )

inline

Sets classification mode.

Definition at line 183 of file qgscolorrampshader.h.

◆ setClip()

void QgsColorRampShader::setClip ( bool clip )

inline

Sets whether the shader should not render values out of range.

Parameters

clip	set to `true` to clip values which are out of range.

See also: clip()

Definition at line 193 of file qgscolorrampshader.h.

◆ setColorRampItemList()

void QgsColorRampShader::setColorRampItemList ( const QList< QgsColorRampShader::ColorRampItem > & list )

Sets a custom colormap.

Definition at line 91 of file qgscolorrampshader.cpp.

◆ setColorRampType() [1/2]

void QgsColorRampShader::setColorRampType ( QgsColorRampShader::Type colorRampType )

Sets the color ramp type.

Definition at line 99 of file qgscolorrampshader.cpp.

◆ setColorRampType() [2/2]

void QgsColorRampShader::setColorRampType ( const QString & type )

Sets the color ramp type.

Definition at line 109 of file qgscolorrampshader.cpp.

◆ setSourceColorRamp()

void QgsColorRampShader::setSourceColorRamp ( QgsColorRamp * colorramp )

Set the source color ramp.

Ownership is transferred to the shader.

See also: sourceColorRamp()

Since: QGIS 3.0

Definition at line 130 of file qgscolorrampshader.cpp.

◆ shade() [1/2]

bool QgsColorRampShader::shade	(	double	value,
		int *	returnRedValue,
		int *	returnGreenValue,
		int *	returnBlueValue,
		int *	returnAlphaValue
	)		const

overridevirtual

Generates and new RGB value based on one input value.

Reimplemented from QgsRasterShaderFunction.

Definition at line 319 of file qgscolorrampshader.cpp.

◆ shade() [2/2]

bool QgsColorRampShader::shade	(	double	redValue,
		double	greenValue,
		double	blueValue,
		double	alphaValue,
		int *	returnRedValue,
		int *	returnGreenValue,
		int *	returnBlueValue,
		int *	returnAlphaValue
	)		const

overridevirtual

Generates and new RGB value based on original RGB value.

Reimplemented from QgsRasterShaderFunction.

Definition at line 469 of file qgscolorrampshader.cpp.

◆ sourceColorRamp()

QgsColorRamp * QgsColorRampShader::sourceColorRamp ( ) const

Gets the source color ramp.

See also: setSourceColorRamp()

Since: QGIS 3.0

Definition at line 125 of file qgscolorrampshader.cpp.

◆ writeXml()

QDomElement QgsColorRampShader::writeXml ( QDomDocument & doc ) const

Writes configuration to a new DOM element.

Since: QGIS 3.4

Definition at line 496 of file qgscolorrampshader.cpp.

Member Data Documentation

◆ mSourceColorRamp

std::unique_ptr<QgsColorRamp> QgsColorRampShader::mSourceColorRamp

protected

Source color ramp.

Definition at line 204 of file qgscolorrampshader.h.

The documentation for this class was generated from the following files:

/tmp/buildd/qgis-3.8.0+99unstable/src/core/raster/qgscolorrampshader.h
/tmp/buildd/qgis-3.8.0+99unstable/src/core/raster/qgscolorrampshader.cpp

Classes

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ClassificationMode

◆ Type

Constructor & Destructor Documentation

◆ QgsColorRampShader() [1/2]

◆ QgsColorRampShader() [2/2]

Member Function Documentation

◆ classificationMode()

◆ classifyColorRamp() [1/2]

◆ classifyColorRamp() [2/2]

◆ clip()

◆ colorRampItemList()

◆ colorRampType()

◆ colorRampTypeAsQString()

◆ isEmpty()

◆ legendSymbologyItems()

◆ operator=()

◆ readXml()

◆ setClassificationMode()

◆ setClip()

◆ setColorRampItemList()

◆ setColorRampType() [1/2]

◆ setColorRampType() [2/2]

◆ setSourceColorRamp()

◆ shade() [1/2]

◆ shade() [2/2]

◆ sourceColorRamp()

◆ writeXml()

Member Data Documentation

◆ mSourceColorRamp