This is a helper class for unit tests that need to write an image and compare it to an expected result or render time. More...

#include <qgsrenderchecker.h>

Public Member Functions
	QgsRenderChecker ()

	~QgsRenderChecker ()
	Destructor. More...

bool	compareImages (const QString &theTestName, unsigned int theMismatchCount=0, const QString &theRenderedImageFile="")
	Test using two arbitary images (map renderer will not be used) More...

QString	controlImagePath () const

QVector< QgsDartMeasurement >	dartMeasurements () const
	Get access to buffered dash messages. More...

int	elapsedTime ()

void	enableDashBuffering (bool enable)
	Call this to enable internal buffering of dash messages. More...

QString	expectedImageFile () const
	Returns the path to the expected image file. More...

QString	imageToHash (const QString &theImageFile)
	Get an md5 hash that uniquely identifies an image. More...

bool	isKnownAnomaly (const QString &theDiffImageFile)
	Get a list of all the anomalies. More...

float	matchPercent ()

unsigned int	matchTarget ()

unsigned int	mismatchCount ()

QString	renderedImage ()
	The path of the rendered image can be retrieved through that method. More...

QString	report ()

bool	runTest (const QString &theTestName, unsigned int theMismatchCount=0)
	Test using renderer to generate the image to be compared. More...

void	setColorTolerance (unsigned int theColorTolerance)
	Set tolerance for color components used by runTest() and compareImages(). More...

void	setControlName (const QString &theName)
	Base directory name for the control image (with control image path suffixed) the path to the image will be constructed like this: controlImagePath + '/' + mControlName + '/' + mControlName + '.png'. More...

void	setControlPathPrefix (const QString &theName)
	Prefix where the control images are kept. More...

void	setControlPathSuffix (const QString &theName)

void	setElapsedTimeTarget (int theTarget)

Q_DECL_DEPRECATED void	setMapRenderer (QgsMapRenderer *thepMapRenderer)

void	setMapSettings (const QgsMapSettings &mapSettings)

void	setRenderedImage (const QString &theImageFileName)

void	setSizeTolerance (int xTolerance, int yTolerance)
	Sets the largest allowable difference in size between the rendered and the expected image. More...

Static Public Member Functions
static void	drawBackground (QImage *image)
	Draws a checkboard pattern for image backgrounds, so that transparency is visible without requiring a transparent background for the image. More...

Protected Attributes
int	mElapsedTime

QString	mExpectedImageFile

unsigned int	mMatchTarget

QString	mRenderedImageFile

QString	mReport

Detailed Description

This is a helper class for unit tests that need to write an image and compare it to an expected result or render time.

Definition at line 37 of file qgsrenderchecker.h.

Constructor & Destructor Documentation

◆ QgsRenderChecker()

QgsRenderChecker::QgsRenderChecker ( )

Definition at line 32 of file qgsrenderchecker.cpp.

◆ ~QgsRenderChecker()

QgsRenderChecker::~QgsRenderChecker ( )

inline

Destructor.

Definition at line 44 of file qgsrenderchecker.h.

Member Function Documentation

◆ compareImages()

bool QgsRenderChecker::compareImages	(	const QString &	theTestName,
		unsigned int	theMismatchCount = `0`,
		const QString &	theRenderedImageFile = `""`
	)

Test using two arbitary images (map renderer will not be used)

Parameters

theTestName	- to be used as the basis for writing a file to e.g. /tmp/theTestName.png
theMismatchCount	- defaults to 0 - the number of pixels that are allowed to be different from the control image. In some cases rendering may be non-deterministic. This parameter allows you to account for that by providing a tolerance.
theRenderedImageFile	to optionally override the output filename

Note: : make sure to call setExpectedImage and setRenderedImage first.

Definition at line 253 of file qgsrenderchecker.cpp.

◆ controlImagePath()

QString QgsRenderChecker::controlImagePath ( ) const

Definition at line 47 of file qgsrenderchecker.cpp.

◆ dartMeasurements()

QVector<QgsDartMeasurement> QgsRenderChecker::dartMeasurements ( ) const

inline

Get access to buffered dash messages.

Only will return something if you call enableDashBuffering( true ); before.

Returns: buffered dash messages

Note: not available in python bindings

Definition at line 169 of file qgsrenderchecker.h.

◆ drawBackground()

void QgsRenderChecker::drawBackground ( QImage * image )

static

Draws a checkboard pattern for image backgrounds, so that transparency is visible without requiring a transparent background for the image.

Definition at line 91 of file qgsrenderchecker.cpp.

◆ elapsedTime()

int QgsRenderChecker::elapsedTime ( )

inline

Definition at line 58 of file qgsrenderchecker.h.

◆ enableDashBuffering()

void QgsRenderChecker::enableDashBuffering ( bool enable )

inline

Call this to enable internal buffering of dash messages.

You may later call dashMessages() to get access to the buffered messages. If disabled (default) dash messages will be sent immediately.

Parameters

enable Enable or disable buffering

Definition at line 160 of file qgsrenderchecker.h.

◆ expectedImageFile()

QString QgsRenderChecker::expectedImageFile ( ) const

inline

Returns the path to the expected image file.

Returns: Path to the expected image file

Definition at line 151 of file qgsrenderchecker.h.

◆ imageToHash()

QString QgsRenderChecker::imageToHash ( const QString & theImageFile )

Get an md5 hash that uniquely identifies an image.

Definition at line 68 of file qgsrenderchecker.cpp.

◆ isKnownAnomaly()

bool QgsRenderChecker::isKnownAnomaly ( const QString & theDiffImageFile )

Get a list of all the anomalies.

An anomaly is a rendered difference file where there is some red pixel content (indicating a render check mismatch), but where the output was still acceptible. If the render diff matches one of these anomalies we will still consider it to be acceptible.

Returns: a bool indicating if the diff matched one of the anomaly files

Definition at line 112 of file qgsrenderchecker.cpp.

◆ matchPercent()

float QgsRenderChecker::matchPercent ( )

inline

Definition at line 50 of file qgsrenderchecker.h.

◆ matchTarget()

unsigned int QgsRenderChecker::matchTarget ( )

inline

Definition at line 56 of file qgsrenderchecker.h.

◆ mismatchCount()

unsigned int QgsRenderChecker::mismatchCount ( )

inline

Definition at line 55 of file qgsrenderchecker.h.

◆ renderedImage()

QString QgsRenderChecker::renderedImage ( )

inline

The path of the rendered image can be retrieved through that method.

Will return the path set with setRenderedImage() or generated in runTest()

Returns: The path to the rendered image

Definition at line 85 of file qgsrenderchecker.h.

◆ report()

QString QgsRenderChecker::report ( )

inline

Definition at line 48 of file qgsrenderchecker.h.

◆ runTest()

bool QgsRenderChecker::runTest	(	const QString &	theTestName,
		unsigned int	theMismatchCount = `0`
	)

Test using renderer to generate the image to be compared.

Parameters

theTestName	- to be used as the basis for writing a file to e.g. /tmp/theTestName.png
theMismatchCount	- defaults to 0 - the number of pixels that are allowed to be different from the control image. In some cases rendering may be non-deterministic. This parameter allows you to account for that by providing a tolerance.

Note: make sure to call setExpectedImage and setMapRenderer first

Definition at line 172 of file qgsrenderchecker.cpp.

◆ setColorTolerance()

void QgsRenderChecker::setColorTolerance ( unsigned int theColorTolerance )

inline

Set tolerance for color components used by runTest() and compareImages().

Default value is 0.

Parameters

theColorTolerance is maximum difference for each color component including alpha to be considered correct.

Note: added in 2.1

Definition at line 99 of file qgsrenderchecker.h.

◆ setControlName()

void QgsRenderChecker::setControlName ( const QString & theName )

Base directory name for the control image (with control image path suffixed) the path to the image will be constructed like this: controlImagePath + '/' + mControlName + '/' + mControlName + '.png'.

Definition at line 54 of file qgsrenderchecker.cpp.

◆ setControlPathPrefix()

void QgsRenderChecker::setControlPathPrefix ( const QString & theName )

inline

Prefix where the control images are kept.

This will be appended to controlImagePath

Definition at line 70 of file qgsrenderchecker.h.

◆ setControlPathSuffix()

void QgsRenderChecker::setControlPathSuffix ( const QString & theName )

Definition at line 60 of file qgsrenderchecker.cpp.

◆ setElapsedTimeTarget()

void QgsRenderChecker::setElapsedTimeTarget ( int theTarget )

inline

Definition at line 59 of file qgsrenderchecker.h.

◆ setMapRenderer()

void QgsRenderChecker::setMapRenderer ( QgsMapRenderer * thepMapRenderer )

Deprecated:: since 2.4 - use setMapSettings()

Definition at line 81 of file qgsrenderchecker.cpp.

◆ setMapSettings()

void QgsRenderChecker::setMapSettings ( const QgsMapSettings & mapSettings )

Note: added in 2.4

Definition at line 86 of file qgsrenderchecker.cpp.

◆ setRenderedImage()

void QgsRenderChecker::setRenderedImage ( const QString & theImageFileName )

inline

Definition at line 77 of file qgsrenderchecker.h.

◆ setSizeTolerance()

void QgsRenderChecker::setSizeTolerance	(	int	xTolerance,
		int	yTolerance
	)

inline

Sets the largest allowable difference in size between the rendered and the expected image.

Parameters

xTolerance	x tolerance in pixels
yTolerance	y tolerance in pixels

Note: added in QGIS 2.12

Definition at line 106 of file qgsrenderchecker.h.

Member Data Documentation

◆ mElapsedTime

int QgsRenderChecker::mElapsedTime

protected

Definition at line 174 of file qgsrenderchecker.h.

◆ mExpectedImageFile

QString QgsRenderChecker::mExpectedImageFile

protected

Definition at line 176 of file qgsrenderchecker.h.

◆ mMatchTarget

unsigned int QgsRenderChecker::mMatchTarget

protected

Definition at line 173 of file qgsrenderchecker.h.

◆ mRenderedImageFile

QString QgsRenderChecker::mRenderedImageFile

protected

Definition at line 175 of file qgsrenderchecker.h.

◆ mReport

QString QgsRenderChecker::mReport

protected

Definition at line 172 of file qgsrenderchecker.h.

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

/tmp/buildd/qgis-2.18.21+99unstable/src/core/qgsrenderchecker.h
/tmp/buildd/qgis-2.18.21+99unstable/src/core/qgsrenderchecker.cpp

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ QgsRenderChecker()

◆ ~QgsRenderChecker()

Member Function Documentation

◆ compareImages()

◆ controlImagePath()

◆ dartMeasurements()

◆ drawBackground()

◆ elapsedTime()

◆ enableDashBuffering()

◆ expectedImageFile()

◆ imageToHash()

◆ isKnownAnomaly()

◆ matchPercent()

◆ matchTarget()

◆ mismatchCount()

◆ renderedImage()

◆ report()

◆ runTest()

◆ setColorTolerance()

◆ setControlName()

◆ setControlPathPrefix()

◆ setControlPathSuffix()

◆ setElapsedTimeTarget()

◆ setMapRenderer()

◆ setMapSettings()

◆ setRenderedImage()

◆ setSizeTolerance()

Member Data Documentation

◆ mElapsedTime

◆ mExpectedImageFile

◆ mMatchTarget

◆ mRenderedImageFile

◆ mReport