com.tplan.robot.imagecomparison.search

Class EdgeMap

java.lang.Object

com.tplan.robot.imagecomparison.search.EdgeMap

public class EdgeMap
extends Object

Image edge detector.

T-Plan Robot Enterprise, (C) 2009-2022 T-Plan Limited. All rights reserved.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DIRECTION_BOTH Mask indicating a map based on a combination of both horizontal and vertical gradients.
static int	DIRECTION_HORIZONTAL Mask indicating a map based on horizontal gradients.
static int	DIRECTION_VERTICAL Mask indicating a map based on vertical gradients.
static int	EDGE_TYPE_FULL
static int	EDGE_TYPE_THIN
static int	TYPE_BLUE Type mask of indicating a map created of the blue channel gradients.
static int	TYPE_GREEN Type mask of indicating a map created of the green channel gradients.
static int	TYPE_RED Type mask of indicating a map created of the red channel gradients.
static int	TYPE_RGB Type mask indicating that the map is created of a combination of red, green and blue channel gradients.

Constructor Summary

Constructors

Constructor and Description
EdgeMap(BufferedImage image, int type, int edgeType, int threshold, int direction) Construct a new edge map.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o) Match this object against another intensity map or a 2-dimensional byte array.
byte[][]	getEdgeMap() Get the edge map.
int	getHeight() Get the map height.
int	getThreshold() Get the intensity gradient threshold the map was created with.
int	getType() Get the map type.
int	getWidth() Get the map width.
String	toString()
static String	toString(byte[][] array, boolean condensed, Rectangle r) Convert the byte array to a string suitable for printing.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

TYPE_RED

public static final int TYPE_RED

Type mask of indicating a map created of the red channel gradients.

See Also:

Constant Field Values

TYPE_GREEN

public static final int TYPE_GREEN

Type mask of indicating a map created of the green channel gradients.

See Also:

Constant Field Values

TYPE_BLUE

public static final int TYPE_BLUE

Type mask of indicating a map created of the blue channel gradients.

See Also:

Constant Field Values

TYPE_RGB

public static final int TYPE_RGB

Type mask indicating that the map is created of a combination of red, green and blue channel gradients. It is equal to logical OR of all the three TYPE_RED, TYPE_GREEN and TYPE_BLUE components.

See Also:

Constant Field Values

DIRECTION_HORIZONTAL

public static final int DIRECTION_HORIZONTAL

Mask indicating a map based on horizontal gradients.

See Also:

Constant Field Values

DIRECTION_VERTICAL

public static final int DIRECTION_VERTICAL

Mask indicating a map based on vertical gradients.

See Also:

Constant Field Values

DIRECTION_BOTH

public static final int DIRECTION_BOTH

Mask indicating a map based on a combination of both horizontal and vertical gradients.

See Also:

Constant Field Values

EDGE_TYPE_FULL

public static final int EDGE_TYPE_FULL

See Also:

Constant Field Values

EDGE_TYPE_THIN

public static final int EDGE_TYPE_THIN

See Also:

Constant Field Values

Constructor Detail

EdgeMap

public EdgeMap(BufferedImage image,
               int type,
               int edgeType,
               int threshold,
               int direction)

Construct a new edge map.

Parameters:

image - an image to retrieve the edges from.

type - the map type. It can be a single RGB channel represented by one of the TYPE_RED, TYPE_GREEN and TYPE_BLUE masks or a combination (logical OR) of them. For example, to create a map which detects edges based on the changes in the blue and green channel use the type of "TYPE_GREEN } | TYPE_BLUE".

edgeType - the edge type, either EDGE_TYPE_FULL or EDGE_TYPE_THIN.

threshold - the threshold.

direction - the edge detection direction, one of DIRECTION_VERTICAL, DIRECTION_HORIZONTAL or DIRECTION_BOTH.

Method Detail

equals

public boolean equals(Object o)

Match this object against another intensity map or a 2-dimensional byte array.

Overrides:

equals in class Object

Parameters:

o - an object.

Returns:

true if the objects match.

toString

public String toString()

Overrides:

toString in class Object

getType

public int getType()

Get the map type. It may one of the TYPE_RED, TYPE_GREEN and TYPE_BLUE masks or any logical OR of these constants.

Returns:

the map type.

getWidth

public int getWidth()

Get the map width.

Returns:

the map width.

getHeight

public int getHeight()

Get the map height.

Returns:

the map height.

getThreshold

public int getThreshold()

Get the intensity gradient threshold the map was created with.

Returns:

the intensity gradient threshold.

getEdgeMap

public byte[][] getEdgeMap()

Get the edge map. The map contains zeros where the pixels are constant or R, G, B components specified by the map type keep increasing or decreasing. The map contains the value of 1 where the component stops growing and starts decreasing or the value of 2 for the opposite scenario.

Returns:

the edge map in form of a 2-dimensional byte array.

toString

public static String toString(byte[][] array,
                              boolean condensed,
                              Rectangle r)

Convert the byte array to a string suitable for printing.

Parameters:

array - a byte array.

condensed - true will omit spaces among numbers (suitable for bit maps).

r - optional rectangle to limit the output to.

Returns:

the map in form of a 2-dimensional matrix.