Vector3

Category: Built-In Types

Brief Description

Vector class, which performs basic 3D vector math operations.

Member Functions

Vector3	Vector3 ( float x, float y, float z )
Vector3	abs ( )
float	angle_to ( Vector3 to )
Vector3	ceil ( )
Vector3	cross ( Vector3 b )
Vector3	cubic_interpolate ( Vector3 b, Vector3 pre_a, Vector3 post_b, float t )
float	distance_squared_to ( Vector3 b )
float	distance_to ( Vector3 b )
float	dot ( Vector3 b )
Vector3	floor ( )
Vector3	inverse ( )
float	length ( )
float	length_squared ( )
Vector3	linear_interpolate ( Vector3 b, float t )
int	max_axis ( )
int	min_axis ( )
Vector3	normalized ( )
Vector3	reflect ( Vector3 by )
Vector3	rotated ( Vector3 axis, float phi )
Vector3	slide ( Vector3 by )
Vector3	snapped ( float by )

Member Variables

• float x - X component of the vector.
• float y - Y component of the vector.
• float z - Z component of the vector.

Numeric Constants

• AXIS_X = 0 — Enumerated value for the X axis. Returned by functions like max_axis or min_axis.
• AXIS_Y = 1 — Enumerated value for the Y axis.
• AXIS_Z = 2 — Enumerated value for the Z axis.

Description

Vector3 is one of the core classes of the engine, and includes several built-in helper functions to perform basic vector math operations.

Member Function Description

Vector3 Vector3 ( float x, float y, float z )

Returns a Vector3 with the given components.

Vector3 abs ( )

Returns a new vector with all components in absolute values (i.e. positive).

float angle_to ( Vector3 to )

Vector3 ceil ( )

Returns a new vector with all components rounded up.

Vector3 cross ( Vector3 b )

Return the cross product with b.

Vector3 cubic_interpolate ( Vector3 b, Vector3 pre_a, Vector3 post_b, float t )

Perform a cubic interpolation between vectors pre_a, a, b, post_b (a is current), by the given amount (t).

float distance_squared_to ( Vector3 b )

Return the squared distance (distance minus the last square root) to b. Prefer this function over distance_to if you need to sort vectors or need the squared distance for some formula.

float distance_to ( Vector3 b )

Return the distance to b.

float dot ( Vector3 b )

Return the dot product with b.

Vector3 floor ( )

Returns a new vector with all components rounded down.

Vector3 inverse ( )

Returns the inverse of the vector. This is the same as Vector3( 1.0 / v.x, 1.0 / v.y, 1.0 / v.z )

float length ( )

Return the length of the vector.

float length_squared ( )

Return the length of the vector, squared. Prefer this function over “length” if you need to sort vectors or need the squared length for some formula.

Vector3 linear_interpolate ( Vector3 b, float t )

Linearly interpolates the vector to a given one (b), by the given amount (t).

int max_axis ( )

Returns AXIS_X, AXIS_Y or AXIS_Z depending on which axis is the largest.

int min_axis ( )

Returns AXIS_X, AXIS_Y or AXIS_Z depending on which axis is the smallest.

Vector3 normalized ( )

Return a copy of the normalized vector to unit length. This is the same as v / v.length().

Vector3 reflect ( Vector3 by )

Like “slide”, but reflects the Vector instead of continuing along the wall.

Vector3 rotated ( Vector3 axis, float phi )

Rotates the vector around some axis by phi radians.

Vector3 slide ( Vector3 by )

Slides the vector along a wall.

Vector3 snapped ( float by )

Return a copy of the vector, snapped to the lowest neared multiple.