net.sf.jaxodraw.util
Class JaxoUtils

java.lang.Object
  net.sf.jaxodraw.util.JaxoUtils

public final class JaxoUtils
extends Object

Some static utility methods.

Since:

2.0

Field Summary

static String

LINE_SEPARATOR The system-dependent line separator.

Method Summary

static void	drawImageArea(Image m, int x, int y, int width, int height, Graphics g) Draw the part (x,y,width,height) of the image 'm' on 'g', at the same position (x,y).
static void	drawImageArea(Image m, int x, int y, int width, int height, Graphics g, int gx, int gy) Draw the part (x,y,width,height) of the image 'm' on 'g' at (gx,gy).
static boolean	equal(float a, float b) Compares the two floats.
static boolean	equal(float a, float b, float epsilon) Compares the two floats within a certain accuracy.
static boolean	equals(Object[] expected, Object[] actual) Check if two arrays are equal.
static boolean	equivalent(Object[] expected, Object[] actual) Check if two arrays are equivalent.
static Image	getChooserImage(Color iconColor) Returns an image with a box of 40x15 pixels size, of the given color.
static Image	getChooserImage(Color iconColor, Dimension size) Returns an image with a box of the given pixels size, of the given color.
static ImageIcon	getChooserImageIcon(Color iconColor) Returns an image icon with a box of 40x15 pixels size, of the given color.
static ImageIcon	getChooserImageIcon(Color iconColor, Dimension size) Returns an image icon with a box of the given pixels size, of the given color.
static boolean	isButton1(MouseEvent e) Check for button 1 mouse events.
static boolean	isButton2(MouseEvent e) Check for button 2 mouse events.
static boolean	isButton3(MouseEvent e) Check for button 3 mouse events.
static boolean	isDoubleClick(MouseEvent e) Check for double click mouse events.
static Image	newImage(String resourceName) Image from /resources/icons/ icon resource.
static ImageIcon	newImageIcon(String resourceName) ImageIcon from /resources/icons/ icon resource.
static String	toString(Object[] array) This is intended to be equivalent to Arrays.toString(a) but also compatible with JDK 1.4.
static boolean	zero(double a) Checks if the given double is zero.

Methods inherited from class java.lang.Object

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

Field Detail

LINE_SEPARATOR

public static final String LINE_SEPARATOR

The system-dependent line separator.

Method Detail

equal

public static boolean equal(float a,
                            float b,
                            float epsilon)

Compares the two floats within a certain accuracy.

Parameters:

a - First float to compare.

b - Second float to compare.

epsilon - the desired accuracy. Has to be non-negative.

Returns:

True if the floats are equal to within the given accuracy.

equal

public static boolean equal(float a,
                            float b)

Compares the two floats.

Parameters:

a - First float to compare.

b - Second float to compare.

Returns:

True if the floats are equal to within 0.1%.

zero

public static boolean zero(double a)

Checks if the given double is zero.

Parameters:

a - The double to check.

Returns:

True if the double is smaller in magnitude than 0.001d.

drawImageArea

public static void drawImageArea(Image m,
                                 int x,
                                 int y,
                                 int width,
                                 int height,
                                 Graphics g)

Draw the part (x,y,width,height) of the image 'm' on 'g', at the same position (x,y).

Parameters:

m - The image.

x - The x coordinate.

y - The y coordinate.

width - The width.

height - The height.

g - The graphics context.

drawImageArea

public static void drawImageArea(Image m,
                                 int x,
                                 int y,
                                 int width,
                                 int height,
                                 Graphics g,
                                 int gx,
                                 int gy)

Draw the part (x,y,width,height) of the image 'm' on 'g' at (gx,gy).

Parameters:

m - The image.

x - The x coordinate.

y - The y coordinate.

width - The width.

height - The height.

g - The graphics context.

gx - The x coordinate of the new origin.

gy - The y coordinate of the new origin.

newImageIcon

public static ImageIcon newImageIcon(String resourceName)

ImageIcon from /resources/icons/ icon resource.

Parameters:

resourceName - The name of the resource.

Returns:

An ImageIcon.

newImage

public static Image newImage(String resourceName)

Image from /resources/icons/ icon resource.

Parameters:

resourceName - The name of the resource file.

Returns:

An Image.

getChooserImage

public static Image getChooserImage(Color iconColor)

Returns an image with a box of 40x15 pixels size, of the given color.

Parameters:

iconColor - The color of theimage.

Returns:

An Image.

getChooserImage

public static Image getChooserImage(Color iconColor,
                                    Dimension size)

Returns an image with a box of the given pixels size, of the given color.

Parameters:

iconColor - The color of theimage.

size - The size ofthe image.

Returns:

An Image.

getChooserImageIcon

public static ImageIcon getChooserImageIcon(Color iconColor)

Returns an image icon with a box of 40x15 pixels size, of the given color. Used for the color button in the edit panels.

Parameters:

iconColor - The color of theimage.

Returns:

An ImageIcon.

getChooserImageIcon

public static ImageIcon getChooserImageIcon(Color iconColor,
                                            Dimension size)

Returns an image icon with a box of the given pixels size, of the given color.

Parameters:

iconColor - The color of theimage.

size - The size ofthe image.

Returns:

An ImageIcon.

isButton1

public static boolean isButton1(MouseEvent e)

Check for button 1 mouse events.

Parameters:

e - The MouseEvent.

Returns:

True if e corresponds to a button 1 mouse event.

isButton2

public static boolean isButton2(MouseEvent e)

Check for button 2 mouse events.

Parameters:

e - The MouseEvent.

Returns:

True if e corresponds to a button 2 mouse event.

isButton3

public static boolean isButton3(MouseEvent e)

Check for button 3 mouse events.

Parameters:

e - The MouseEvent.

Returns:

True if e corresponds to a button 3 mouse event.

isDoubleClick

public static boolean isDoubleClick(MouseEvent e)

Check for double click mouse events.

Parameters:

e - The MouseEvent.

Returns:

True if e corresponds to a double click mouse event.

toString

public static String toString(Object[] array)

This is intended to be equivalent to Arrays.toString(a) but also compatible with JDK 1.4. This concatenates the results of calling String.valueOf() on each element of the array, so this won't work well for multi-dimensional arrays.

Parameters:

array - An array.

Returns:

A string.

equals

public static boolean equals(Object[] expected,
                             Object[] actual)

Check if two arrays are equal. Two arrays are equal if they contain the same elements in the same order, or if they are both null.

Parameters:

expected - one array to be tested for equality.

actual - the other array to be tested for equality.

Returns:

True if the two arrays are equal.

See Also:

Arrays.equals(java.lang.Object[],java.lang.Object[])

equivalent

public static boolean equivalent(Object[] expected,
                                 Object[] actual)

Check if two arrays are equivalent. Two arrays are equivalent if they contain the same number of elements, and every element of one array is also contained in the other array. In other words, two arrays are equivalent if they contain the same elements irrespective of order.

This implementation uses Arrays.sort(java.lang.Object[]) to bring the elements of each array into natural order, before they are checked for equality. Therefore, the elements of each array must implement the Comparable interface and they must be mutually comparable.

Parameters:

expected - one array to be tested for equivalence.

actual - the other array to be tested for equivalence.

Returns:

True if the two arrays contain the same elements.

See Also:

Arrays.equals(java.lang.Object[],java.lang.Object[]), Arrays.sort(java.lang.Object[])