eu.printingin3d.javascad.coords

Class Boundaries3d

java.lang.Object

eu.printingin3d.javascad.coords.Boundaries3d

public class Boundaries3d
extends Object

Represents three intervals interpreting as an including cuboid which could contains the actual 3D object or objects.

Author:

ivivan

Field Summary

Fields

Modifier and Type	Field and Description
static Boundaries3d	EMPTY Represents an empty 3D boundary object.

Constructor Summary

Constructors

Constructor and Description
Boundaries3d(Boundary x, Boundary y, Boundary z) Constructs a new object with the given X, Y and Z boundary.
Boundaries3d(Coords3d minCorner, Coords3d maxCorner) Constructs a new object with the given two corner.

Method Summary

Modifier and Type	Method and Description
Boundaries3d	add(Boundaries3d delta) Adds the interval with the given delta - this operation always increase the size of the boundaries.
static Boundaries3d	combine(Collection<Boundaries3d> boundaries) Calculate the including cuboid so the result of this method is an interval representing a cuboid that all of the parameter cuboids are inside in this cuboid.
Coords3d	getAlignedValue(Side side) Returns with the coordinate of this boundary queried by the parameter.
Coords3d	getMaxCorner() Returns with the back-right-top corner's coordinates.
Coords3d	getMinCorner() Returns with the front-left-bottom corner's coordinates.
Dims3d	getSize() Returns with the size of this boundaries.
Boundary	getX() Returns with the boundary on the X plane.
Boundary	getY() Returns with the boundary on the Y plane.
Boundary	getZ() Returns with the boundary on the Z plane.
static Boundaries3d	intersect(Collection<Boundaries3d> boundaries) Calculate the inner cuboid so the result of this method is an interval representing a cuboid that is inside all of the parameter cuboids.
Boundaries3d	move(Coords3d delta) Moves the interval with the given delta.
Boundaries3d	rotate(Angles3d angle) Rotates the interval with the given angle.
Boundaries3d	scale(Coords3d delta) Scales the interval with the given delta.

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY

public static final Boundaries3d EMPTY

Represents an empty 3D boundary object.

Constructor Detail

Boundaries3d

public Boundaries3d(Boundary x,
                    Boundary y,
                    Boundary z)

Constructs a new object with the given X, Y and Z boundary.

Parameters:

x - the boundary on the X plane

y - the boundary on the Y plane

z - the boundary on the Z plane

Boundaries3d

public Boundaries3d(Coords3d minCorner,
                    Coords3d maxCorner)

Constructs a new object with the given two corner. Despite of the parameters names any two opposite corners work.

Parameters:

minCorner - the first corner

maxCorner - the second corner

Method Detail

combine

public static Boundaries3d combine(Collection<Boundaries3d> boundaries)

Calculate the including cuboid so the result of this method is an interval representing a cuboid that all of the parameter cuboids are inside in this cuboid.

Parameters:

boundaries - the intervals considered during the calculation

Returns:

a new object representing the including cuboid

intersect

public static Boundaries3d intersect(Collection<Boundaries3d> boundaries)
                              throws IllegalValueException

Calculate the inner cuboid so the result of this method is an interval representing a cuboid that is inside all of the parameter cuboids.

Parameters:

boundaries - the intervals considered during the calculation

Returns:

a new object representing the including cuboid

Throws:

IllegalValueException - if the given boundaries have no common part

getX

public Boundary getX()

Returns with the boundary on the X plane.

Returns:

the boundary on the X plane

getY

public Boundary getY()

Returns with the boundary on the Y plane.

Returns:

the boundary on the Y plane

getZ

public Boundary getZ()

Returns with the boundary on the Z plane.

Returns:

the boundary on the Z plane

getSize

public Dims3d getSize()

Returns with the size of this boundaries. The result will be a Dims3d object which means it can be used to create a cube with the same size as this model.

Returns:

the size of this boundaries

getMinCorner

public Coords3d getMinCorner()

Returns with the front-left-bottom corner's coordinates.

Returns:

the front-left-bottom corner's coordinates

getMaxCorner

public Coords3d getMaxCorner()

Returns with the back-right-top corner's coordinates.

Returns:

the back-right-top corner's coordinates

move

public Boundaries3d move(Coords3d delta)

Moves the interval with the given delta.

Parameters:

delta - the value used by the move

Returns:

a new object with the calculated new boundaries

add

public Boundaries3d add(Boundaries3d delta)

Adds the interval with the given delta - this operation always increase the size of the boundaries.

Parameters:

delta - the value used by the add operation

Returns:

a new object with the calculated new boundaries

scale

public Boundaries3d scale(Coords3d delta)

Scales the interval with the given delta.

Parameters:

delta - the value used by the scale

Returns:

a new object with the calculated new boundaries

rotate

public Boundaries3d rotate(Angles3d angle)

Rotates the interval with the given angle. The rotation takes the cuboid represented by this object, rotates that and then returns with the cuboids parameter which can contain this result.

Parameters:

angle - the value used by the rotation

Returns:

a new object with the calculated new boundaries

getAlignedValue

public Coords3d getAlignedValue(Side side)

Returns with the coordinate of this boundary queried by the parameter.

Parameters:

side - the side we want to get

Returns:

the point we asked for