Box3D

Description

struct Tinman.Terrain.Util.Box3D

A three-dimensional bounding box with 64-bit floating-point precision.

The coordinates refer to infinitesimal points (pixel-is-point semantic).

Public / Constants

Empty


public static readonly attribute Empty → (Box3D)

An empty bounding box at the coordinate origin.

Inverse


public static readonly attribute Inverse → (Box3D)

An inverse bounding box that can be used as the initial value for computing bounds via subsequent calls to Grow.

Max


public static readonly attribute Max → (Box3D)

The largest possible box.

Public / Methods

CheckIntersection

2 overloads


[Pure]
public method CheckIntersection1 → (1)

box in : Box3D

The other bounding box.

returns → int32

-1 if the bounding boxes do not overlap, 1 if box in fully contains this bounding box and 0 if both bounding boxes overlap.

Checks the intersection between this bounding box and the given one.


[Pure]
public method CheckIntersection2 → (2)

ray in : Ray

The ray.

maximum opt : float64 = Maths.MaxDouble

The maximum ray distance to check.

returns → bool

true if the ray hits this bounding box, false if not.

Checks the intersection between this bounding box and the given ray.

Clamp

2 overloads


[Pure]
public method Clamp1 → (3)

in : float64

X-coordinate of point.

in : float64

Y-coordinate of point.

in : float64

Z-coordinate of point.

returns → Vec3D

The clamped point.

Clamps the given point to this box.


[Pure]
public method Clamp2 → (1)

in : Vec3D

The point coordinates.

returns → Vec3D

The clamped point.

Clamps the given point to this box.

ComputeOverlap


[Pure]
public method ComputeOverlap → (1)

box in : Box3D

Second bounding box.

returns → float64

The amount of overlap (i.e. the volume of the intersection).

Computes the overlap of this bounding box and the given one.

Contains

3 overloads


[Pure]
public method Contains1 → (1)

xyz in : Vec3D

The point coordinates.

returns → bool

true if this box contains the point, false if not.

Checks if this box contains the given point.


[Pure]
public method Contains2 → (3)

in : float64

The point X-coordinate.

in : float64

The point Y-coordinate.

in : float64

The point Z-coordinate.

returns → bool

true if this box contains the point, false if not.

Checks if this box contains the given point.


[Pure]
public method Contains3 → (1)

box in : Box3D

The other box.

returns → bool

true if this box fully contains the given box, false if not.

Checks if this box contains the given box.

Disjoint


[Pure]
public method Disjoint → (1)

box in : Box3D

The other box.

returns → bool

true if this box and the given box are disjoint, false if not.

Checks if this box and the given box are disjoint (i.e. do not intersect).

FromPoints

2 overloads


[Pure]
public static method FromPoints1 → (6)

x1 in : float64

X-coordinate of first corner point.

y1 in : float64

Y-coordinate of first corner point.

z1 in : float64

Z-coordinate of first corner point.

x2 in : float64

X-coordinate of second corner point.

y2 in : float64

Y-coordinate of second corner point.

z2 in : float64

Z-coordinate of second corner point.

returns → Box3D

The bounding box.

Creates a new instance of Box3D from the given corner points.


[Pure]
public static method FromPoints2 → (2)

in : Vec3D

First corner point.

in : Vec3D

Second corner point.

returns → Box3D

The bounding box.

Creates a new instance of Box3D from the given corner points.

FromRect


[Pure]
public static method FromRect → (6)

in : float64

X-coordinate of top-left-front corner of cuboid.

in : float64

Y-coordinate of top-left-front corner of cuboid.

in : float64

Z-coordinate of top-left-front corner of cuboid.

width in : float64

Width of cuboid.

height in : float64

Height of cuboid.

depth in : float64

Depth of cuboid.

returns → Box3D

The bounding box.

Creates a new instance of Box3D from the given rectangular cuboid.

Grow

3 overloads


public method Grow1 → (1)

box in : Box3D

To other box.

returns → Box3D

The resulting box.

Enlarges the extends of this box so that it covers the given box.


public method Grow2 → (1)

in : Vec3D

Coordinates of point to cover (can be NaN).

returns → Box3D

The resulting box.

Enlarges the extends of this box so that it covers the given point.


public method Grow3 → (3)

in : float64

X-coordinate of point to cover (can be NaN).

in : float64

Y-coordinate of point to cover (can be NaN).

in : float64

Z-coordinate of point to cover (can be NaN).

returns → Box3D

The resulting box.

Enlarges the extends of this box so that it covers the given point.

Intersect


[Pure]
public method Intersect → (1)

box in : Box3D

The bounding box.

returns → Box3D

The resulting bounding box.

Computes the intersection of the given bounding box and this one.

Scale


[Pure]
public method Scale → (1)

factor in : float64

The scale factor.

returns → Box3D

The resulting bounding box.

Scales the coordinates of this bounding box.

Translate

2 overloads


[Pure]
public method Translate1 → (1)

in : Vec3D

The translation vector.

returns → Box3D

The translated bounding box.

Translates this bounding box.


[Pure]
public method Translate2 → (3)

in : float64

Translation amount along X-axis.

in : float64

Translation amount along Y-axis.

in : float64

Translation amount along Z-axis.

returns → Box3D

The resulting bounding box.

Translates this bounding box.

Public / Attributes

Center


public attribute Center → (get)

value : Vec3D

The coordinates of the box center.

Return the center of this box.

Depth


public attribute Depth → (get)

value : float64

The box depth.

Returns the extends of this box along the Z-axis.

Height


public attribute Height → (get)

value : float64

The box height.

Returns the extends of this box along the Y-axis.

IsEmpty


public attribute IsEmpty → (get)

value : bool

true if this bounding box is empty, false if not.

Is this bounding box empty?

The bounding box is empty if its volume is zero.

IsPoint


public attribute IsPoint → (get)

value : bool

true if this bounding box is a point, false if not.

Is this bounding box a point?

Size


public attribute Size → (get)

value : Vec3D

The box size: The Width is stored in Vec3D.X, the Height in Vec3D.Y, the Depth in Vec3D.Z.

Returns the size of this box.

Volume


public attribute Volume → (get)

value : float64

The bounding box volume.

Returns the volume of this bounding box.

The volume will always be 0 when IsEmpty returns true.

Width


public attribute Width → (get)

value : float64

The box width.

Returns the extends of this box along the X-axis.

X1


public readonly attribute X1 → (float64)

X-coordinate of minimum corner of bounding box.

X2


public readonly attribute X2 → (float64)

X-coordinate of maximum corner of bounding box.

Y1


public readonly attribute Y1 → (float64)

Y-coordinate of minimum corner of bounding box.

Y2


public readonly attribute Y2 → (float64)

Y-coordinate of maximum corner of bounding box.

Z1


public readonly attribute Z1 → (float64)

Z-coordinate of minimum corner of bounding box.

Z2


public readonly attribute Z2 → (float64)

Z-coordinate of maximum corner of bounding box.

Serialization

Serializer


public static readonly attribute Serializer → (ITypeSerializer<Box3D>)

The serialization helper object for values of Box3D.