AABB

Axis-Aligned Bounding Box.

Description

AABB consists of a position, a size, and several utility functions. It is typically used for fast overlap tests.

It uses floating-point coordinates. The 2D counterpart to AABB is Rect2.

Note: Unlike Rect2, AABB does not have a variant that uses integer coordinates.

Properties

Vector3

end

Vector3(0, 0, 0)

Vector3

position

Vector3(0, 0, 0)

Vector3

size

Vector3(0, 0, 0)

Methods

AABB

AABB ( ) constructor

AABB

AABB ( AABB from ) constructor

AABB

AABB ( Vector3 position, Vector3 size ) constructor

AABB

abs ( ) const

bool

encloses ( AABB with ) const

AABB

expand ( Vector3 to_point ) const

float

get_area ( ) const

Vector3

get_center ( ) const

Vector3

get_endpoint ( int idx ) const

Vector3

get_longest_axis ( ) const

int

get_longest_axis_index ( ) const

float

get_longest_axis_size ( ) const

Vector3

get_shortest_axis ( ) const

int

get_shortest_axis_index ( ) const

float

get_shortest_axis_size ( ) const

Vector3

get_support ( Vector3 dir ) const

AABB

grow ( float by ) const

bool

has_no_area ( ) const

bool

has_no_surface ( ) const

bool

has_point ( Vector3 point ) const

AABB

intersection ( AABB with ) const

bool

intersects ( AABB with ) const

bool

intersects_plane ( Plane plane ) const

Variant

intersects_ray ( Vector3 from, Vector3 dir ) const

Variant

intersects_segment ( Vector3 from, Vector3 to ) const

bool

is_equal_approx ( AABB aabb ) const

AABB

merge ( AABB with ) const

bool

operator != ( ) operator

bool

operator != ( AABB right ) operator

AABB

operator * ( Transform3D right ) operator

bool

operator == ( ) operator

bool

operator == ( AABB right ) operator

Property Descriptions

Default

Vector3(0, 0, 0)

Ending corner. This is calculated as position + size. Setting this value will change the size.


Default

Vector3(0, 0, 0)

Beginning corner. Typically has values lower than end.


Default

Vector3(0, 0, 0)

Size from position to end. Typically, all components are positive.

If the size is negative, you can use abs to fix it.

Method Descriptions

  • AABB AABB ( ) constructor

Constructs a default-initialized AABB with default (zero) values of position and size.


Constructs an AABB as a copy of the given AABB.


Constructs an AABB from a position and size.


  • AABB abs ( ) const

Returns an AABB with equivalent position and size, modified so that the most-negative corner is the origin and the size is positive.


Returns true if this AABB completely encloses another one.


Returns this AABB expanded to include a given point.


  • float get_area ( ) const

Returns the volume of the AABB.


Returns the center of the AABB, which is equal to position + (size / 2).


Gets the position of the 8 endpoints of the AABB in space.


  • Vector3 get_longest_axis ( ) const

Returns the normalized longest axis of the AABB.


  • int get_longest_axis_index ( ) const

Returns the index of the longest axis of the AABB (according to Vector3's AXIS_* constants).


  • float get_longest_axis_size ( ) const

Returns the scalar length of the longest axis of the AABB.


  • Vector3 get_shortest_axis ( ) const

Returns the normalized shortest axis of the AABB.


  • int get_shortest_axis_index ( ) const

Returns the index of the shortest axis of the AABB (according to Vector3::AXIS* enum).


  • float get_shortest_axis_size ( ) const

Returns the scalar length of the shortest axis of the AABB.


Returns the support point in a given direction. This is useful for collision detection algorithms.


Returns a copy of the AABB grown a given amount of units towards all the sides.


  • bool has_no_area ( ) const

Returns true if the AABB is flat or empty.


  • bool has_no_surface ( ) const

Returns true if the AABB is empty.


Returns true if the AABB contains a point.


Returns the intersection between two AABB. An empty AABB (size 0,0,0) is returned on failure.


Returns true if the AABB overlaps with another.


  • bool intersects_plane ( Plane plane ) const

Returns true if the AABB is on both sides of a plane.



Returns true if the AABB intersects the line segment between from and to.


  • bool is_equal_approx ( AABB aabb ) const

Returns true if this AABB and aabb are approximately equal, by calling @GlobalScope.is_equal_approx on each component.


Returns a larger AABB that contains both this AABB and with.


  • bool operator != ( ) operator


  • bool operator != ( AABB right ) operator



  • bool operator == ( ) operator


  • bool operator == ( AABB right ) operator