Raster data container. More...

#include <qgsrasterblock.h>

Collaboration diagram for QgsRasterBlock:

Public Member Functions
	QgsRasterBlock ()
	QgsRasterBlock (QGis::DataType theDataType, int theWidth, int theHeight)
	Constructor which allocates data block in memory.
	QgsRasterBlock (QGis::DataType theDataType, int theWidth, int theHeight, double theNoDataValue)
	Constructor which allocates data block in memory.
virtual	~QgsRasterBlock ()
bool	reset (QGis::DataType theDataType, int theWidth, int theHeight)
	Reset block.
bool	reset (QGis::DataType theDataType, int theWidth, int theHeight, double theNoDataValue)
	Reset block.
bool	isValid () const
	Returns true if the block is valid (correctly filled with data).
void	setValid (bool valid)
	Mark block as valid or invalid.
bool	isEmpty () const
	Returns true if block is empty, i.e.
int	dataTypeSize () const
QGis::DataType	dataType () const
	Returns data type.
bool	hasNoDataValue () const
	True if the block has no data value.
bool	hasNoData () const
	Returns true if the block may contain no data.
double	noDataValue () const
	Return no data value.
double	value (int row, int column) const
	Read a single value if type of block is numeric.
double	value (size_t index) const
	Read a single value if type of block is numeric.
QRgb	color (int row, int column) const
	Read a single color.
QRgb	color (size_t index) const
	Read a single value.
bool	isNoData (int row, int column)
	Check if value at position is no data.
bool	isNoData (size_t index)
	Check if value at position is no data.
bool	setValue (int row, int column, double value)
	Set value on position.
bool	setValue (size_t index, double value)
	Set value on index (indexed line by line)
bool	setColor (int row, int column, QRgb color)
	Set color on position.
bool	setColor (size_t index, QRgb color)
	Set color on index (indexed line by line)
bool	setIsNoData (int row, int column)
	Set no data on pixel.
bool	setIsNoData (size_t index)
	Set no data on pixel.
bool	setIsNoData ()
	Set the whole block to no data.
bool	setIsNoDataExcept (const QRect &theExceptRect)
	Set the whole block to no data except specified rectangle.
char *	bits (int row, int column)
	Get pointer to data.
char *	bits (size_t index)
	Get pointer to data.
char *	bits ()
	Get pointer to data.
bool	convert (QGis::DataType destDataType)
	Convert data to different type.
QImage	image () const
	Get image if type is color.
bool	setImage (const QImage *image)
	set image.
void	applyNoDataValues (const QgsRasterRangeList &rangeList)
QgsError	error () const
	Get error.
void	setError (const QgsError &theError)
	Set error.

Static Public Member Functions
static int	typeSize (int dataType)
static bool	typeIsNumeric (QGis::DataType type)
	Returns true if data type is numeric.
static bool	typeIsColor (QGis::DataType type)
	Returns true if data type is color.
static QGis::DataType	typeWithNoDataValue (QGis::DataType dataType, double *noDataValue)
	For given data type returns wider type and sets no data value.
static QByteArray	valueBytes (QGis::DataType theDataType, double theValue)
	Get byte array representing a value.
static QString	printValue (double value)
	Print double value with all necessary significant digits.
static double	readValue (void *data, QGis::DataType type, size_t index)
static void	writeValue (void *data, QGis::DataType type, size_t index, double value)
static QRect	subRect (const QgsRectangle &theExtent, int theWidth, int theHeight, const QgsRectangle &theSubExtent)
	For theExtent and theWidht, theHeight find rectangle covered by subextent.

Private Member Functions
bool	isNoDataValue (double value) const
	Test if value is nodata for specific band.
bool	createNoDataBitmap ()
	Allocate no data bitmap.

Static Private Member Functions
static QImage::Format	imageFormat (QGis::DataType theDataType)
static QGis::DataType	dataType (QImage::Format theFormat)
static bool	isNoDataValue (double value, double noDataValue)
	Test if value is nodata comparing to noDataValue.
static void *	convert (void *srcData, QGis::DataType srcDataType, QGis::DataType destDataType, size_t size)
	Convert block of data from one type to another.

Private Attributes
bool	mValid
QGis::DataType	mDataType
int	mTypeSize
int	mWidth
int	mHeight
bool	mHasNoDataValue
double	mNoDataValue
void *	mData
QImage *	mImage
char *	mNoDataBitmap
int	mNoDataBitmapWidth
size_t	mNoDataBitmapSize
QgsError	mError

Detailed Description

Raster data container.

Definition at line 32 of file qgsrasterblock.h.

Constructor & Destructor Documentation

QgsRasterBlock::QgsRasterBlock ( )

Definition at line 26 of file qgsrasterblock.cpp.

QgsRasterBlock::QgsRasterBlock	(	QGis::DataType	theDataType,
		int	theWidth,
		int	theHeight
	)

Constructor which allocates data block in memory.

Parameters

theDataType	raster data type
theWidth	width of data matrix
theHeight	height of data matrix

Note: not available in python bindings (use variant with theNoDataValue)

Definition at line 42 of file qgsrasterblock.cpp.

References mDataType, mHeight, mWidth, and reset().

QgsRasterBlock::QgsRasterBlock	(	QGis::DataType	theDataType,
		int	theWidth,
		int	theHeight,
		double	theNoDataValue
	)

Constructor which allocates data block in memory.

Parameters

theDataType	raster data type
theWidth	width of data matrix
theHeight	height of data matrix
theNoDataValue	the value representing no data (NULL)

Definition at line 59 of file qgsrasterblock.cpp.

References mDataType, mHeight, mNoDataValue, mWidth, and reset().

QgsRasterBlock::~QgsRasterBlock ( )

virtual

Definition at line 76 of file qgsrasterblock.cpp.

References mData, mImage, mNoDataBitmap, QgsDebugMsg, and qgsFree().

Member Function Documentation

void QgsRasterBlock::applyNoDataValues ( const QgsRasterRangeList & rangeList )

Definition at line 687 of file qgsrasterblock.cpp.

References QgsRasterRange::contains(), mHeight, mWidth, setIsNoData(), size, and value().

Referenced by QgsRasterDataProvider::block().

char * QgsRasterBlock::bits	(	int	row,
		int	column
	)

Get pointer to data.

Parameters

row	row index
column	column index

Returns: pointer to data

Note: not available in python bindings

Definition at line 633 of file qgsrasterblock.cpp.

References bits(), and mWidth.

Referenced by QgsPalettedRasterRenderer::block(), QgsRasterProjector::block(), and QgsRasterDataProvider::block().

char * QgsRasterBlock::bits ( size_t index )

Get pointer to data.

Parameters

index data matrix index

Returns: pointer to data

Note: not available in python bindings

Definition at line 613 of file qgsrasterblock.cpp.

References mData, mHeight, mImage, mTypeSize, mWidth, and QgsDebugMsg.

char * QgsRasterBlock::bits ( )

Get pointer to data.

Returns: pointer to data

Note: not available in python bindings

Definition at line 638 of file qgsrasterblock.cpp.

References mData, and mImage.

Referenced by bits(), and setColor().

QRgb QgsRasterBlock::color	(	int	row,
		int	column
	)		const

Read a single color.

Parameters

row	row index
column	column index

Returns: color

Definition at line 300 of file qgsrasterblock.cpp.

References mImage.

Referenced by QgsSingleBandColorDataRenderer::block(), QgsBrightnessContrastFilter::block(), QgsHueSaturationFilter::block(), color(), setColor(), and QgsRasterFileWriter::writeImageRaster().

QRgb QgsRasterBlock::color ( size_t index ) const

Read a single value.

Parameters

index data matrix index

Returns: color

Definition at line 293 of file qgsrasterblock.cpp.

References color(), and mWidth.

bool QgsRasterBlock::convert ( QGis::DataType destDataType )

Convert data to different type.

Parameters

destDataType dest data type

Returns: true on success

Definition at line 652 of file qgsrasterblock.cpp.

References image(), imageFormat(), isEmpty(), mData, mDataType, mHeight, mImage, mTypeSize, mWidth, QgsDebugMsg, qgsFree(), typeIsColor(), typeIsNumeric(), and typeSize().

Referenced by QgsSingleBandColorDataRenderer::block().

void * QgsRasterBlock::convert	(	void *	srcData,
		QGis::DataType	srcDataType,
		QGis::DataType	destDataType,
		size_t	size
	)

staticprivate

Convert block of data from one type to another.

Original block memory is not release.

Parameters

srcData	source data
srcDataType	source data type
destDataType	dest data type
size	block size (width * height)

Returns: block of data in destDataType

Definition at line 769 of file qgsrasterblock.cpp.

References qgsMalloc(), readValue(), size, typeSize(), value(), and writeValue().

bool QgsRasterBlock::createNoDataBitmap ( )

private

Allocate no data bitmap.

Returns: true on success

Definition at line 832 of file qgsrasterblock.cpp.

References mHeight, mNoDataBitmap, mNoDataBitmapSize, mNoDataBitmapWidth, mWidth, QgsDebugMsg, and qgsMalloc().

Referenced by setIsNoData(), and setIsNoDataExcept().

QGis::DataType QgsRasterBlock::dataType ( ) const

inline

Returns data type.

Definition at line 139 of file qgsrasterblock.h.

Referenced by QgsRasterNuller::block(), QgsRasterProjector::block(), and setImage().

QGis::DataType QgsRasterBlock::dataType ( QImage::Format theFormat )

staticprivate

Definition at line 162 of file qgsrasterblock.cpp.

References QGis::ARGB32, QGis::ARGB32_Premultiplied, and QGis::UnknownDataType.

int QgsRasterBlock::dataTypeSize ( ) const

inline

Definition at line 127 of file qgsrasterblock.h.

Referenced by setIsNoData(), and setIsNoDataExcept().

QgsError QgsRasterBlock::error ( ) const

inline

Get error.

Definition at line 295 of file qgsrasterblock.h.

bool QgsRasterBlock::hasNoData ( ) const

Returns true if the block may contain no data.

It does not guarantee that it really contains any no data. It can be used to speed up processing. Not the difference between this method and hasNoDataValue().

Returns: true if the block may contain no data

Definition at line 270 of file qgsrasterblock.cpp.

References mHasNoDataValue, and mNoDataBitmap.

Referenced by QgsRasterProjector::block().

bool QgsRasterBlock::hasNoDataValue ( ) const

inline

True if the block has no data value.

Returns: true if the block has no data value

Definition at line 146 of file qgsrasterblock.h.

Referenced by QgsRasterNuller::block(), and QgsRasterProjector::block().

QImage QgsRasterBlock::image ( ) const

Get image if type is color.

Returns: image

Definition at line 706 of file qgsrasterblock.cpp.

References mImage.

Referenced by QgsRasterResampleFilter::block(), convert(), and QgsRasterDrawer::draw().

QImage::Format QgsRasterBlock::imageFormat ( QGis::DataType theDataType )

staticprivate

Definition at line 149 of file qgsrasterblock.cpp.

References QGis::ARGB32, and QGis::ARGB32_Premultiplied.

Referenced by convert(), and reset().

bool QgsRasterBlock::isEmpty ( ) const

Returns true if block is empty, i.e.

its size is 0 (zero rows or cols). This method does not return true if size is not zero and all values are 'no data' (null).

Definition at line 175 of file qgsrasterblock.cpp.

References mData, mDataType, mHeight, mImage, mWidth, QgsDebugMsg, typeIsColor(), and typeIsNumeric().

Referenced by QgsPalettedRasterRenderer::block(), QgsSingleBandColorDataRenderer::block(), QgsSingleBandPseudoColorRenderer::block(), QgsBrightnessContrastFilter::block(), QgsSingleBandGrayRenderer::block(), QgsRasterResampleFilter::block(), QgsHueSaturationFilter::block(), QgsRasterProjector::block(), QgsRasterDataProvider::block(), and convert().

bool QgsRasterBlock::isNoData	(	int	row,
		int	column
	)

Check if value at position is no data.

Parameters

row	row index
column	column index

Returns: true if value is no data

Definition at line 337 of file qgsrasterblock.cpp.

References mWidth.

Referenced by QgsRasterInterface::bandStatistics(), QgsSingleBandPseudoColorRenderer::block(), QgsPalettedRasterRenderer::block(), QgsMultiBandColorRenderer::block(), QgsSingleBandGrayRenderer::block(), QgsRasterNuller::block(), QgsRasterProjector::block(), and QgsRasterInterface::histogram().

bool QgsRasterBlock::isNoData ( size_t index )

Check if value at position is no data.

Parameters

index data matrix index

Returns: true if value is no data

Definition at line 307 of file qgsrasterblock.cpp.

References isNoDataValue(), mData, mDataType, mHasNoDataValue, mHeight, mNoDataBitmap, mNoDataBitmapWidth, mWidth, QgsDebugMsg, readValue(), and value().

bool QgsRasterBlock::isNoDataValue	(	double	value,
		double	noDataValue
	)

staticprivate

Test if value is nodata comparing to noDataValue.

Parameters

value	tested value
noDataValue	no data value

Returns: true if value is nodata

Definition at line 275 of file qgsrasterblock.cpp.

References qgsDoubleNear().

Referenced by isNoData().

bool QgsRasterBlock::isNoDataValue ( double value ) const

inlineprivate

Test if value is nodata for specific band.

Parameters

value tested value

Returns: true if value is nodata

Definition at line 463 of file qgsrasterblock.h.

References mNoDataValue, and qgsDoubleNear().

bool QgsRasterBlock::isValid ( ) const

inline

Returns true if the block is valid (correctly filled with data).

An empty block may still be valid (if zero size block was requested). If the block is not valid, error may be retrieved by error() method.

Definition at line 79 of file qgsrasterblock.h.

Referenced by QgsRasterChecker::runTest().

double QgsRasterBlock::noDataValue ( ) const

inline

Return no data value.

If the block does not have a no data value the returned value is undefined.

Returns: No data value

Definition at line 157 of file qgsrasterblock.h.

Referenced by QgsRasterNuller::block(), and QgsRasterProjector::block().

QString QgsRasterBlock::printValue ( double value )

static

Print double value with all necessary significant digits.

   It is ensured that conversion back to double gives the same number.

Parameters

value the value to be printed

Returns: string representing the value

Definition at line 730 of file qgsrasterblock.cpp.

References QgsDebugMsg, and value().

Referenced by QgsRasterLayerSaveAsDialog::addNoDataRow(), QgsMapToolIdentify::identifyRasterLayer(), QgsRasterLayerSaveAsDialog::setOutputExtent(), and QgsRasterTransparency::writeXML().

double QgsRasterBlock::readValue	(	void *	data,
		QGis::DataType	type,
		size_t	index
	)

inlinestatic

Definition at line 382 of file qgsrasterblock.h.

References QGis::Byte, QGis::Float32, QGis::Float64, QGis::Int16, QGis::Int32, QgsDebugMsg, QGis::UInt16, and QGis::UInt32.

Referenced by convert(), isNoData(), and value().

bool QgsRasterBlock::reset	(	QGis::DataType	theDataType,
		int	theWidth,
		int	theHeight
	)

Reset block.

Parameters

theDataType	raster data type
theWidth	width of data matrix
theHeight	height of data matrix

Returns: true on success

Note: not available in python bindings (use variant with theNoDataValue)

Definition at line 84 of file qgsrasterblock.cpp.

References mHasNoDataValue, and QgsDebugMsg.

Referenced by QgsPalettedRasterRenderer::block(), QgsSingleBandPseudoColorRenderer::block(), QgsSingleBandColorDataRenderer::block(), QgsMultiBandColorRenderer::block(), QgsBrightnessContrastFilter::block(), QgsSingleBandGrayRenderer::block(), QgsRasterResampleFilter::block(), QgsHueSaturationFilter::block(), and QgsRasterBlock().

bool QgsRasterBlock::reset	(	QGis::DataType	theDataType,
		int	theWidth,
		int	theHeight,
		double	theNoDataValue
	)

Reset block.

Parameters

theDataType	raster data type
theWidth	width of data matrix
theHeight	height of data matrix
theNoDataValue	the value representing no data (NULL)

Returns: true on success

Definition at line 96 of file qgsrasterblock.cpp.

References imageFormat(), mData, mDataType, mHasNoDataValue, mHeight, mImage, mNoDataBitmap, mNoDataValue, mTypeSize, mValid, mWidth, QgsDebugMsg, qgsFree(), qgsMalloc(), typeIsColor(), typeIsNumeric(), typeSize(), and QGis::UnknownDataType.

bool QgsRasterBlock::setColor	(	int	row,
		int	column,
		QRgb	color
	)

Set color on position.

Parameters

row	row index
column	column index
color	the color to be set, QRgb value

Returns: true on success

Definition at line 363 of file qgsrasterblock.cpp.

References mWidth.

Referenced by QgsSingleBandColorDataRenderer::block(), QgsSingleBandPseudoColorRenderer::block(), QgsMultiBandColorRenderer::block(), QgsBrightnessContrastFilter::block(), QgsSingleBandGrayRenderer::block(), and QgsHueSaturationFilter::block().

bool QgsRasterBlock::setColor	(	size_t	index,
		QRgb	color
	)

Set color on index (indexed line by line)

Parameters

index	data matrix index
color	the color to be set, QRgb value

Returns: true on success

Definition at line 368 of file qgsrasterblock.cpp.

References bits(), color(), mImage, and QgsDebugMsg.

void QgsRasterBlock::setError ( const QgsError & theError )

inline

Set error.

Definition at line 298 of file qgsrasterblock.h.

bool QgsRasterBlock::setImage ( const QImage * image )

set image.

Parameters

image image

Returns: true on success

Definition at line 715 of file qgsrasterblock.cpp.

References dataType(), mData, mDataType, mHeight, mImage, mNoDataValue, mTypeSize, mWidth, qgsFree(), and typeSize().

Referenced by QgsRasterResampleFilter::block().

bool QgsRasterBlock::setIsNoData	(	int	row,
		int	column
	)

Set no data on pixel.

Parameters

row	row index
column	column index

Returns: true on success

Definition at line 388 of file qgsrasterblock.cpp.

References mWidth, and setIsNoData().

Referenced by QgsRasterNuller::block(), and QgsRasterDataProvider::block().

bool QgsRasterBlock::setIsNoData ( size_t index )

Set no data on pixel.

Parameters

index data matrix index

Returns: true on success

Definition at line 393 of file qgsrasterblock.cpp.

References createNoDataBitmap(), mHasNoDataValue, mNoDataBitmap, mNoDataBitmapWidth, mNoDataValue, mWidth, and setValue().

bool QgsRasterBlock::setIsNoData ( )

Set the whole block to no data.

Returns: true on success

Definition at line 420 of file qgsrasterblock.cpp.

References createNoDataBitmap(), dataTypeSize(), mData, mDataType, mHasNoDataValue, mHeight, mImage, mNoDataBitmap, mNoDataBitmapSize, mNoDataValue, mWidth, QgsDebugMsg, typeIsNumeric(), typeSize(), and valueBytes().

Referenced by applyNoDataValues(), and setIsNoData().

bool QgsRasterBlock::setIsNoDataExcept ( const QRect & theExceptRect )

Set the whole block to no data except specified rectangle.

Returns: true on success

Definition at line 472 of file qgsrasterblock.cpp.

References createNoDataBitmap(), dataTypeSize(), mData, mDataType, mHasNoDataValue, mHeight, mImage, mNoDataBitmap, mNoDataBitmapWidth, mNoDataValue, mWidth, QgsDebugMsg, typeIsNumeric(), typeSize(), and valueBytes().

Referenced by QgsRasterDataProvider::block().

void QgsRasterBlock::setValid ( bool valid )

inline

Mark block as valid or invalid.

Definition at line 82 of file qgsrasterblock.h.

bool QgsRasterBlock::setValue	(	int	row,
		int	column,
		double	value
	)

Set value on position.

Parameters

row	row index
column	column index
value	the value to be set

Returns: true on success

Definition at line 358 of file qgsrasterblock.cpp.

References mWidth.

Referenced by QgsRasterNuller::block(), setIsNoData(), and QgsRasterFileWriter::writeImageRaster().

bool QgsRasterBlock::setValue	(	size_t	index,
		double	value
	)

Set value on index (indexed line by line)

Parameters

index	data matrix index
value	the value to be set

Returns: true on success

Definition at line 342 of file qgsrasterblock.cpp.

References mData, mDataType, mHeight, mWidth, QgsDebugMsg, and writeValue().

QRect QgsRasterBlock::subRect	(	const QgsRectangle &	theExtent,
		int	theWidth,
		int	theHeight,
		const QgsRectangle &	theSubExtent
	)

static

For theExtent and theWidht, theHeight find rectangle covered by subextent.

The output rect has x oriented from left to right and y from top to bottom (upper-left to lower-right orientation).

Parameters

theExtent	extent, usually the larger
theWidth	numbers of columns in theExtent
theHeight	numbers of rows in theExtent
theSubExtent	extent, usually smaller than theExtent