org.mapfish.print.test.util

Class ImageSimilarity

java.lang.Object

org.mapfish.print.test.util.ImageSimilarity

public final class ImageSimilarity
extends java.lang.Object

Class for comparing an expected image to an actual image.

CHECKSTYLE:OFF

Constructor Summary

Constructors

Constructor and Description
ImageSimilarity(java.io.File expectedFile) The constructor, which creates the GUI and start the image processing task.

Method Summary

Modifier and Type	Method and Description
void	assertSimilarity(java.awt.image.BufferedImage actualImage, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(byte[] graphicData, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(java.io.File actual) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(java.io.File actualFile, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(net.sf.jasperreports.engine.JasperPrint jasperPrint, java.lang.Integer page, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(java.util.List<java.net.URI> graphicFiles, int width, int height, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
void	assertSimilarity(java.net.URI svgFile, int width, int height, double maxDistance) Check that the actual image and the image calculated by this object are within the given distance.
static java.awt.image.BufferedImage	convertFromSvg(java.net.URI svgFile, int width, int height) Renders an SVG image into a BufferedImage.
static java.awt.image.BufferedImage	exportReportToImage(net.sf.jasperreports.engine.JasperPrint jasperPrint, java.lang.Integer page) Exports a rendered JasperPrint to a BufferedImage.
static void	main(java.lang.String[] args)
static java.awt.image.BufferedImage	mergeImages(java.util.List<java.net.URI> graphicFiles, int width, int height) Merges a list of graphic files into a single graphic.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImageSimilarity

public ImageSimilarity(java.io.File expectedFile)
                throws java.io.IOException

The constructor, which creates the GUI and start the image processing task.

Throws:

java.io.IOException

Method Detail

mergeImages

public static java.awt.image.BufferedImage mergeImages(java.util.List<java.net.URI> graphicFiles,
                                                       int width,
                                                       int height)
                                                throws java.io.IOException,
                                                       org.apache.batik.transcoder.TranscoderException

Merges a list of graphic files into a single graphic.

Parameters:

graphicFiles - a list of graphic files

width - the graphic width (required for svg files)

height - the graphic height (required for svg files)

Returns:

a single graphic

Throws:

java.io.IOException

org.apache.batik.transcoder.TranscoderException

convertFromSvg

public static java.awt.image.BufferedImage convertFromSvg(java.net.URI svgFile,
                                                          int width,
                                                          int height)
                                                   throws org.apache.batik.transcoder.TranscoderException

Renders an SVG image into a BufferedImage.

Throws:

org.apache.batik.transcoder.TranscoderException

exportReportToImage

public static java.awt.image.BufferedImage exportReportToImage(net.sf.jasperreports.engine.JasperPrint jasperPrint,
                                                               java.lang.Integer page)
                                                        throws net.sf.jasperreports.engine.JRException

Exports a rendered JasperPrint to a BufferedImage.

Throws:

net.sf.jasperreports.engine.JRException

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Throws:

java.io.IOException

assertSimilarity

public void assertSimilarity(java.io.File actual)
                      throws java.io.IOException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

actual - the image to compare to "this" image.

Throws:

java.io.IOException

assertSimilarity

public void assertSimilarity(byte[] graphicData,
                             double maxDistance)
                      throws java.io.IOException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException

assertSimilarity

public void assertSimilarity(java.util.List<java.net.URI> graphicFiles,
                             int width,
                             int height,
                             double maxDistance)
                      throws java.io.IOException,
                             org.apache.batik.transcoder.TranscoderException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

graphicFiles - a list of graphic files

width - the graphic width (required for svg files)

height - the graphic height (required for svg files)

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException

org.apache.batik.transcoder.TranscoderException

assertSimilarity

public void assertSimilarity(java.net.URI svgFile,
                             int width,
                             int height,
                             double maxDistance)
                      throws java.io.IOException,
                             org.apache.batik.transcoder.TranscoderException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException

org.apache.batik.transcoder.TranscoderException

assertSimilarity

public void assertSimilarity(net.sf.jasperreports.engine.JasperPrint jasperPrint,
                             java.lang.Integer page,
                             double maxDistance)
                      throws java.io.IOException,
                             net.sf.jasperreports.engine.JRException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException

net.sf.jasperreports.engine.JRException

assertSimilarity

public void assertSimilarity(java.io.File actualFile,
                             double maxDistance)
                      throws java.io.IOException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

actualFile - the file to compare to "this" image.

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException

assertSimilarity

public void assertSimilarity(java.awt.image.BufferedImage actualImage,
                             double maxDistance)
                      throws java.io.IOException

Check that the actual image and the image calculated by this object are within the given distance.

Parameters:

actualImage - the image to compare to "this" image.

maxDistance - the maximum distance between the two images.

Throws:

java.io.IOException