org.jemmy.image.awt

Class ResizeImageComparator

java.lang.Object

org.jemmy.image.pixel.ResizeComparator

org.jemmy.image.awt.ResizeImageComparator

All Implemented Interfaces:

ImageComparator

public class ResizeImageComparator
extends ResizeComparator

Comparator that makes image sizes equal to compare them with other comparator most of them work only for the images with equal dimensions. It is controlled by three parameters:

Resize Mode - defines way of resizing images that are being compared. One of the following constants:

• NO_RESIZE,
• PROPORTIONAL_RESIZE,
• ARBITRARY_RESIZE.

Default value is ResizeImageComparator.ResizeMode.PROPORTIONAL_RESIZE.

• Resize Hint - defines the way of images scaling that is specified when Image.getScaledInstance() method is invoked. One of the Image.SCALE_XXX is expected. Default value is SCALE_DEFAULT.
• Proportion Distortion Threshold - defines maximum proportion distortion that is used in PROPORTIONAL_RESIZE mode to deal with cases when rounding and other problems could cause sizes to be not ideally proportional.

  Threshold value is applied in the following way: Math.abs(image.getSize() * scale - size) / image.getSize() > PROPORTION_DISTORTION_THRESHOLD, where image.getSize() is both image dimensions and size is target width and height (which is defined as mininum of sizes of two images) and scale is the scale factor that scales the particular image to fit the width and height.

  Default value is 0.02 so as much as 2% of width/height could differ (around 5 in 0-255 color component values).

Author:

mrkam

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResizeImageComparator.ResizeMode Resize Modes

Nested classes/interfaces inherited from class org.jemmy.image.pixel.ResizeComparator

ResizeComparator.Mode

Field Summary

Fields

Modifier and Type	Field and Description
static String	OUTPUT Identifies output where resize details are printed.

Constructor Summary

Constructors

Constructor and Description
ResizeImageComparator(double propDistThreshold, ImageComparator subComparator) Creates ResizeImageComparator with the following settings: resize mode: ResizeMode.PROPORTIONAL_RESIZE.
ResizeImageComparator(ImageComparator subComparator) Creates ResizeImageComparator with default resize settings: resize mode: ResizeMode.PROPORTIONAL_RESIZE.
ResizeImageComparator(ResizeImageComparator.ResizeMode resizeMode, double propDistThreshold, int hint, ImageComparator subComparator) Creates ResizeImageComparator with specified settings.
ResizeImageComparator(ResizeImageComparator.ResizeMode resizeMode, ImageComparator subComparator) Creates ResizeImageComparator with the specified resize mode and default settings for other parameters: proportion distortion threshold: 0.02.

Method Summary

Modifier and Type	Method and Description
String	getID()
Dimension	getSize(Image image)
Image	resize(Image image, Dimension size)

Methods inherited from class org.jemmy.image.pixel.ResizeComparator

compare, getSubComparator, setSubComparator

Methods inherited from class java.lang.Object

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

Field Detail

OUTPUT

public static final String OUTPUT

Identifies output where resize details are printed. Output is disabled by default.

See Also:

Environment.getOutput(java.lang.String)

Constructor Detail

ResizeImageComparator

public ResizeImageComparator(ImageComparator subComparator)

Creates ResizeImageComparator with default resize settings:

• resize mode: ResizeMode.PROPORTIONAL_RESIZE.
• proportion distortion threshold: 0.02.
• resize hint: Image.SCALE_DEFAULT.

Parameters:

subComparator - comparator to compare images after resize.

See Also:

Image.getScaledInstance(int, int, int), ResizeImageComparator.ResizeMode, ResizeImageComparator

ResizeImageComparator

public ResizeImageComparator(ResizeImageComparator.ResizeMode resizeMode,
                             ImageComparator subComparator)

Creates ResizeImageComparator with the specified resize mode and default settings for other parameters:

• proportion distortion threshold: 0.02.
• resize hint: Image.SCALE_DEFAULT.

Parameters:

resizeMode - resize mode for this comparator.

subComparator - comparator to compare images after resize.

See Also:

ResizeImageComparator.ResizeMode, ResizeImageComparator

ResizeImageComparator

public ResizeImageComparator(double propDistThreshold,
                             ImageComparator subComparator)

Creates ResizeImageComparator with the following settings:

• resize mode: ResizeMode.PROPORTIONAL_RESIZE.
• specified proportion distortion threshold.
• resize hint: Image.SCALE_DEFAULT.

Parameters:

propDistThreshold - proportion distortion threshold.

subComparator - comparator to compare images after resize.

See Also:

ResizeImageComparator

ResizeImageComparator

public ResizeImageComparator(ResizeImageComparator.ResizeMode resizeMode,
                             double propDistThreshold,
                             int hint,
                             ImageComparator subComparator)

Creates ResizeImageComparator with specified settings.

Parameters:

resizeMode - Resize mode.

propDistThreshold - Proportion distortion threshold.

hint - Resize hint.

subComparator - comparator to compare images after resize.

See Also:

ResizeImageComparator, ResizeImageComparator.ResizeMode

Method Detail

resize

public Image resize(Image image,
                    Dimension size)

Specified by:

resize in class ResizeComparator

getID

public String getID()

Specified by:

getID in interface ImageComparator

Overrides:

getID in class ResizeComparator

getSize

public Dimension getSize(Image image)

Specified by:

getSize in class ResizeComparator