com.github.loyada.jdollarx

Class Images

java.lang.Object

com.github.loyada.jdollarx.Images

public class Images
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Images.ImageComparator

Constructor Summary

Constructors

Constructor and Description
Images()

Method Summary

Modifier and Type	Method and Description
static void	assertImageIsEqualToExpected(InBrowser browser, Path el, InputStream expectedImageInput) Verify that the element's image is pixel-perfect
static void	assertImageIsEqualToExpectedWithShiftAndCrop(InBrowser browser, Path el, InputStream expectedImageInput, int maxShift) Verify that the element's image is pixel-perfect, but allowing some crop/shift
static void	assertImageIsSimilarToExpected(InBrowser browser, Path el, InputStream expectedImageInput, int maxBadPixelsRatio) Verify the picture is "similar" to the reference image.
static BufferedImage	captureCanvas(InBrowser browser, Path canvas)
static void	captureCanvasToFile(InBrowser browser, Path el, File outputFile) Save an HTML5 canvas to file.
static void	captureToFile(InBrowser browser, Path el, File outputFile) Save image to file
static void	show(InBrowser browser, Path el) Display image of an element in a separate window.
static void	showCanvas(InBrowser browser, Path el) Display image of an HTML5 canvas element in a separate window.

Methods inherited from class java.lang.Object

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

Constructor Detail

Images

public Images()

Method Detail

captureToFile

public static void captureToFile(InBrowser browser,
                                 Path el,
                                 File outputFile)

Save image to file

Parameters:

browser - - browser

el - - Path element to capture

outputFile - - output file

captureCanvasToFile

public static void captureCanvasToFile(InBrowser browser,
                                       Path el,
                                       File outputFile)

Save an HTML5 canvas to file. Optimized for canvas. Will fail if the element is not a canvas.

Parameters:

browser - - browser

el - - Path element to capture

outputFile - - output file

show

public static void show(InBrowser browser,
                        Path el)

Display image of an element in a separate window. Does not work as an evaluation within the debugger.

Parameters:

browser - - browser

el - - the element to capture and display

showCanvas

public static void showCanvas(InBrowser browser,
                              Path el)

Display image of an HTML5 canvas element in a separate window. Does not work as an evaluation within the debugger.

Parameters:

browser - - browser

el - - the element to capture and display

assertImageIsEqualToExpected

public static void assertImageIsEqualToExpected(InBrowser browser,
                                                Path el,
                                                InputStream expectedImageInput)
                                         throws IOException

Verify that the element's image is pixel-perfect

Parameters:

browser - - browser

el - - element to capture and verify

expectedImageInput - reference image file

Throws:

IOException - - file could not be read

assertImageIsEqualToExpectedWithShiftAndCrop

public static void assertImageIsEqualToExpectedWithShiftAndCrop(InBrowser browser,
                                                                Path el,
                                                                InputStream expectedImageInput,
                                                                int maxShift)
                                                         throws IOException

Verify that the element's image is pixel-perfect, but allowing some crop/shift

Parameters:

browser - - browser

el - - element to capture and verify

expectedImageInput - reference image file

maxShift - maximum pixels the images are shifted/cropped compared to each other (both on x and y axis)

Throws:

IOException - - file could not be read

assertImageIsSimilarToExpected

public static void assertImageIsSimilarToExpected(InBrowser browser,
                                                  Path el,
                                                  InputStream expectedImageInput,
                                                  int maxBadPixelsRatio)
                                           throws IOException

Verify the picture is "similar" to the reference image. Ignores minor differences between the pixels.

Parameters:

browser - - browser

el - - element to capture and validate

expectedImageInput - - reference image

maxBadPixelsRatio - - a positive number. For example: If it's 100, then 1% of the pixels can have major differences compared to the reference.

Throws:

IOException - - image file could not be read

captureCanvas

public static BufferedImage captureCanvas(InBrowser browser,
                                          Path canvas)