javafx.geometry

Class Bounds

java.lang.Object

javafx.geometry.Bounds

Direct Known Subclasses:

BoundingBox

public abstract class Bounds
extends java.lang.Object

The base class for objects that are used to describe the bounds of a node or other scene graph object. One interesting characteristic of a Bounds object is that it may have a negative width, height, or depth. A negative value for any of these indicates that the Bounds are "empty".

Since:

JavaFX 2.0

Field Summary

Fields

Modifier and Type	Field and Description
private double	depth
private double	height
private double	maxX
private double	maxY
private double	maxZ
private double	minX
private double	minY
private double	minZ
private double	width

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Bounds(double minX, double minY, double minZ, double width, double height, double depth) Creates a new instance of Bounds class.

Method Summary

Modifier and Type	Method and Description
abstract boolean	contains(Bounds b) Tests if the interior of this Bounds entirely contains the specified Bounds, b.
abstract boolean	contains(double x, double y) Tests if the specified (x, y) coordinates are inside the boundary of Bounds.
abstract boolean	contains(double x, double y, double z) Tests if the specified (x, y, z) coordinates are inside the boundary of Bounds.
abstract boolean	contains(double x, double y, double w, double h) Tests if the interior of this Bounds entirely contains the specified rectangular area.
abstract boolean	contains(double x, double y, double z, double w, double h, double d) Tests if the interior of this Bounds entirely contains the specified rectangular area.
abstract boolean	contains(Point2D p) Tests if the specified point is inside the boundary of Bounds.
abstract boolean	contains(Point3D p) Tests if the specified point is inside the boundary of Bounds.
double	getCenterX() The central x coordinate of this Bounds.
double	getCenterY() The central y coordinate of this Bounds.
double	getCenterZ() The central z coordinate of this Bounds.
double	getDepth() The depth of this Bounds.
double	getHeight() The height of this Bounds.
double	getMaxX() The x coordinate of the lower-right corner of this Bounds.
double	getMaxY() The y coordinate of the lower-right corner of this Bounds.
double	getMaxZ() The maximum z coordinate of this Bounds.
double	getMinX() The x coordinate of the upper-left corner of this Bounds.
double	getMinY() The y coordinate of the upper-left corner of this Bounds.
double	getMinZ() The minimum z coordinate of this Bounds.
double	getWidth() The width of this Bounds.
abstract boolean	intersects(Bounds b) Tests if the interior of this Bounds intersects the interior of a specified Bounds, b.
abstract boolean	intersects(double x, double y, double w, double h) Tests if the interior of this Bounds intersects the interior of a specified rectangular area.
abstract boolean	intersects(double x, double y, double z, double w, double h, double d) Tests if the interior of this Bounds intersects the interior of a specified rectangular area.
abstract boolean	isEmpty() Indicates whether any of the dimensions(width, height or depth) of this bounds is less than zero.

Methods inherited from class java.lang.Object

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

Field Detail

minX

private double minX

minY

private double minY

minZ

private double minZ

width

private double width

height

private double height

depth

private double depth

maxX

private double maxX

maxY

private double maxY

maxZ

private double maxZ

Constructor Detail

Bounds

protected Bounds(double minX,
                 double minY,
                 double minZ,
                 double width,
                 double height,
                 double depth)

Creates a new instance of Bounds class.

Parameters:

minX - the X coordinate of the upper-left corner

minY - the Y coordinate of the upper-left corner

minZ - the minimum z coordinate of the Bounds

width - the width of the Bounds

height - the height of the Bounds

depth - the depth of the Bounds

Method Detail

getMinX

public final double getMinX()

The x coordinate of the upper-left corner of this Bounds.

Returns:

the x coordinate of the upper-left corner

getMinY

public final double getMinY()

The y coordinate of the upper-left corner of this Bounds.

Returns:

the y coordinate of the upper-left corner

getMinZ

public final double getMinZ()

The minimum z coordinate of this Bounds.

Returns:

the minimum z coordinate

getWidth

public final double getWidth()

The width of this Bounds.

Returns:

the width

getHeight

public final double getHeight()

The height of this Bounds.

Returns:

the height

getDepth

public final double getDepth()

The depth of this Bounds.

Returns:

the depth

getMaxX

public final double getMaxX()

The x coordinate of the lower-right corner of this Bounds.

Returns:

the x coordinate of the lower-right corner

getMaxY

public final double getMaxY()

The y coordinate of the lower-right corner of this Bounds.

Returns:

the y coordinate of the lower-right corner

getMaxZ

public final double getMaxZ()

The maximum z coordinate of this Bounds.

Returns:

the maximum z coordinate

getCenterX

public final double getCenterX()

The central x coordinate of this Bounds.

Returns:

the central x coordinate

Since:

11

getCenterY

public final double getCenterY()

The central y coordinate of this Bounds.

Returns:

the central y coordinate

Since:

11

getCenterZ

public final double getCenterZ()

The central z coordinate of this Bounds.

Returns:

the central z coordinate

Since:

11

isEmpty

public abstract boolean isEmpty()

Indicates whether any of the dimensions(width, height or depth) of this bounds is less than zero.

Returns:

true if any of the dimensions(width, height or depth) of this bounds is less than zero

contains

public abstract boolean contains(Point2D p)

Tests if the specified point is inside the boundary of Bounds.

Parameters:

p - the specified point to be tested

Returns:

true if the specified point is inside the boundary of this Bounds; false otherwise

contains

public abstract boolean contains(Point3D p)

Tests if the specified point is inside the boundary of Bounds.

Parameters:

p - the specified 3D point to be tested

Returns:

true if the specified point is inside the boundary of this Bounds; false otherwise

contains

public abstract boolean contains(double x,
                                 double y)

Tests if the specified (x, y) coordinates are inside the boundary of Bounds.

Parameters:

x - the specified x coordinate to be tested

y - the specified y coordinate to be tested

Returns:

true if the specified (x, y) coordinates are inside the boundary of this Bounds; false otherwise

contains

public abstract boolean contains(double x,
                                 double y,
                                 double z)

Tests if the specified (x, y, z) coordinates are inside the boundary of Bounds.

Parameters:

x - the specified x coordinate to be tested

y - the specified y coordinate to be tested

z - the specified z coordinate to be tested

Returns:

true if the specified (x, y) coordinates are inside the boundary of this Bounds; false otherwise

contains

public abstract boolean contains(Bounds b)

Tests if the interior of this Bounds entirely contains the specified Bounds, b.

Parameters:

b - The specified Bounds

Returns:

true if the specified Bounds, b, is inside the boundary of this Bounds; false otherwise

contains

public abstract boolean contains(double x,
                                 double y,
                                 double w,
                                 double h)

Tests if the interior of this Bounds entirely contains the specified rectangular area.

Parameters:

x - the x coordinate of the upper-left corner of the specified rectangular area

y - the y coordinate of the upper-left corner of the specified rectangular area

w - the width of the specified rectangular area

h - the height of the specified rectangular area

Returns:

true if the interior of this Bounds entirely contains the specified rectangular area; false otherwise

contains

public abstract boolean contains(double x,
                                 double y,
                                 double z,
                                 double w,
                                 double h,
                                 double d)

Tests if the interior of this Bounds entirely contains the specified rectangular area.

Parameters:

x - the x coordinate of the upper-left corner of the specified rectangular volume

y - the y coordinate of the upper-left corner of the specified rectangular volume

z - the z coordinate of the upper-left corner of the specified rectangular volume

w - the width of the specified rectangular volume

h - the height of the specified rectangular volume

d - the depth of the specified rectangular volume

Returns:

true if the interior of this Bounds entirely contains the specified rectangular area; false otherwise

intersects

public abstract boolean intersects(Bounds b)

Tests if the interior of this Bounds intersects the interior of a specified Bounds, b.

Parameters:

b - The specified Bounds

Returns:

true if the interior of this Bounds and the interior of the specified Bounds, b, intersect

intersects

public abstract boolean intersects(double x,
                                   double y,
                                   double w,
                                   double h)

Tests if the interior of this Bounds intersects the interior of a specified rectangular area.

Parameters:

x - the x coordinate of the upper-left corner of the specified rectangular area

y - the y coordinate of the upper-left corner of the specified rectangular area

w - the width of the specified rectangular area

h - the height of the specified rectangular area

Returns:

true if the interior of this Bounds and the interior of the rectangular area intersect

intersects

public abstract boolean intersects(double x,
                                   double y,
                                   double z,
                                   double w,
                                   double h,
                                   double d)

Tests if the interior of this Bounds intersects the interior of a specified rectangular area.

Parameters:

x - the x coordinate of the upper-left corner of the specified rectangular volume

y - the y coordinate of the upper-left corner of the specified rectangular volume

z - the z coordinate of the upper-left corner of the specified rectangular volume

w - the width of the specified rectangular volume

h - the height of the specified rectangular volume

d - the depth of the specified rectangular volume

Returns:

true if the interior of this Bounds and the interior of the rectangular area intersect