com.io7m.jregions.core.unparameterized.volumes

Class VolumesBI

java.lang.Object

com.io7m.jregions.core.unparameterized.volumes.VolumesBI

public final class VolumesBI
extends Object

Functions over volumes.

These functions operate using the concepts of minimum-x, maximum-x, minimum-y, maximum-y, minimum-z, maximum-z, edges. It is up to individual applications to assign meaning to these edges such as "left" for minimum-x, "top" for minimum-y, or "far" for minimum-z.

Method Summary

Modifier and Type	Method and Description
static VolumeBI	containing(VolumeBI a, VolumeBI b) Construct a volume that will contain both a and b.
static boolean	contains(VolumeBI a, VolumeBI b) Determine whether or not one volume contains another.
static boolean	containsPoint(VolumeBI a, BigInteger x, BigInteger y, BigInteger z) Determine whether or not a volume contains a given point.
static boolean	couldFitInside(VolumeBI a, VolumeBI b) Determine whether or not one volume could fit inside another.
static VolumeBI	create(BigInteger x, BigInteger y, BigInteger z, BigInteger size_x, BigInteger size_y, BigInteger size_z) Create a volume of size (size_x, size_y, size_z) placing the minimum corner at (x, y, z).
static VolumeBI	moveAbsolute(VolumeBI volume, BigInteger x, BigInteger y, BigInteger z) Move the given volume to (x, y, z).
static VolumeBI	moveRelative(VolumeBI volume, BigInteger x, BigInteger y, BigInteger z) Move the given volume by (x, y, z).
static VolumeBI	moveToOrigin(VolumeBI volume) Move the given volume to (0, 0, 0).
static boolean	overlaps(VolumeBI a, VolumeBI b) Determine whether or not two volumes overlap.
static String	show(VolumeBI volume)
static String	showToBuilder(VolumeBI volume, StringBuilder sb)
static VolumeSizeBI	size(VolumeBI volume)
static VolumeXYZSplitBI<VolumeBI>	splitAtXYZ(VolumeBI v, BigInteger x, BigInteger y, BigInteger z) Split the given volume at point (x, y, z).

Methods inherited from class java.lang.Object

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

Method Detail

create

public static VolumeBI create(BigInteger x,
                              BigInteger y,
                              BigInteger z,
                              BigInteger size_x,
                              BigInteger size_y,
                              BigInteger size_z)

Create a volume of size (size_x, size_y, size_z) placing the minimum corner at (x, y, z).

Parameters:

x - The X value of the minimum corner

y - The Y value of the minimum corner

z - The Z value of the minimum corner

size_x - The size of the volume on the X axis

size_y - The size of the volume on the Y axis

size_z - The size of the volume on the Z axis

Returns:

A volume

contains

public static boolean contains(VolumeBI a,
                               VolumeBI b)

Determine whether or not one volume contains another.

Containing is reflexive: contains(a, a) == true.

Containing is transitive: contains(a, b) → contains(b, c) → contains(a, c).

Containing is not necessarily symmetric.

Parameters:

a - Volume A

b - Volume B

Returns:

true iff a contains b

moveRelative

public static VolumeBI moveRelative(VolumeBI volume,
                                    BigInteger x,
                                    BigInteger y,
                                    BigInteger z)

Move the given volume by (x, y, z).

Parameters:

volume - The volume

x - The amount to move on the X axis

y - The amount to move on the Y axis

z - The amount to move on the Z axis

Returns:

A moved volume

moveAbsolute

public static VolumeBI moveAbsolute(VolumeBI volume,
                                    BigInteger x,
                                    BigInteger y,
                                    BigInteger z)

Move the given volume to (x, y, z).

Parameters:

volume - The volume

x - The position to which to move on the X axis

y - The position to which to move on the Y axis

z - The position to which to move on the Z axis

Returns:

A moved volume

moveToOrigin

public static VolumeBI moveToOrigin(VolumeBI volume)

Move the given volume to (0, 0, 0).

Parameters:

volume - The volume

Returns:

A moved volume

overlaps

public static boolean overlaps(VolumeBI a,
                               VolumeBI b)

Determine whether or not two volumes overlap.

Overlapping is reflexive: overlaps(a, a) == true.

Overlapping is symmetric: overlaps(a, b) == overlaps(b, a).

Overlapping is not necessarily transitive.

Parameters:

a - A volume

b - A volume

Returns:

true iff a overlaps b

couldFitInside

public static boolean couldFitInside(VolumeBI a,
                                     VolumeBI b)

Determine whether or not one volume could fit inside another.

Fitting is reflexive: couldFitInside(a, a) == true.

Fitting is transitive: couldFitInside(a, b) → couldFitInside(b, c) → couldFitInside(a, c).

Fitting is not necessarily symmetric.

Parameters:

a - A volume

b - A volume

Returns:

true iff a could fit inside b

containing

public static VolumeBI containing(VolumeBI a,
                                  VolumeBI b)

Construct a volume that will contain both a and b.

Parameters:

a - A volume

b - A volume

Returns:

A volume containing a and b

containsPoint

public static boolean containsPoint(VolumeBI a,
                                    BigInteger x,
                                    BigInteger y,
                                    BigInteger z)

Determine whether or not a volume contains a given point.

Parameters:

a - A volume

x - The X coordinate of the point

y - The Y coordinate of the point

z - The Z coordinate of the point

Returns:

true iff a contains (x, y, z)

splitAtXYZ

public static VolumeXYZSplitBI<VolumeBI> splitAtXYZ(VolumeBI v,
                                                    BigInteger x,
                                                    BigInteger y,
                                                    BigInteger z)

Split the given volume at point (x, y, z).

Parameters:

v - A volume

x - The X coordinate of the point

y - The Y coordinate of the point

z - The Z coordinate of the point

Returns:

true iff a contains (x, y, z)

show

public static String show(VolumeBI volume)

Parameters:

volume - The volume

Returns:

A terse string describing the position and size of the volume

size

public static VolumeSizeBI size(VolumeBI volume)

Parameters:

volume - The volume

Returns:

The size of the volume

showToBuilder

public static String showToBuilder(VolumeBI volume,
                                   StringBuilder sb)

Parameters:

volume - The volume

sb - A string builder

Returns:

A terse string describing the position and size of the volume