stingray.Vector2 object reference

Description

Describes a three-dimensional vector.

NOTE: Vector2 objects are temporary. You can only use them in the frame in which they were generated. If you need to save a Vector2 across multiple frames, use a Vector2Box instead. For more information, see Object Lifetimes and Userdata Binding.

Operators

You can use several operators like + and - to modify and transform Vector2 objects, described below.

Addition: +

You can add two vectors together using the + operator. For example:

newVector = vector1 + vector2

This is equivalent to the add() function.

Subtraction: -

You can subtract one vector from another using the - operator. For example:

newVector = vector1 - vector2

This is equivalent to the subtract() function.

Negation: -

You can negate a vector using the - operator as a prefix to any vector variable. For example:

negativeVector = -vector1

Multiplication: *

You can multiply a vector by a scalar value using the * operator. For example:

newVector = vector * scalarFactor

This is equivalent to the multiply() function. See also multiply_elements(), which lets you multiply two vectors together per-element.

Division: /

You can divide a vector by a scalar value using the / operator. For example:

newVector = vector / scalarFactor

This is equivalent to the divide() function. See also divide_elements(), which lets you divide one vector by another per-element.

Accessing components: []

You can set and retrieve component values by using the [] operator. Use the indices 1 or "x" for the X component, and 2 or "y" for the Y component. For example:

yComponentValue = vector[2]
xComponentValue = vector["x"]

Constructors and accessors

stingray.GoogleVR.compute_distorted_point() stingray.GoogleVR.controller_touch_position() stingray.Gui.text_extents() stingray.SimulatedTouchPanel.gesture_long_press() stingray.SimulatedTouchPanel.gesture_pinch() stingray.SimulatedTouchPanel.gesture_rotate() stingray.SimulatedTouchPanel.gesture_tap() stingray.SimulatedTouchPanel.gesture_tap_sequence() stingray.SimulatedTouchPanel1.gesture_long_press() stingray.SimulatedTouchPanel1.gesture_pinch() stingray.SimulatedTouchPanel1.gesture_rotate() stingray.SimulatedTouchPanel1.gesture_tap() stingray.SimulatedTouchPanel1.gesture_tap_sequence() stingray.TouchInputController.gesture_long_press() stingray.TouchInputController.gesture_pinch() stingray.TouchInputController.gesture_rotate() stingray.TouchInputController.gesture_tap() stingray.TouchInputController.gesture_tap_sequence() stingray.TouchPanel.gesture_long_press() stingray.TouchPanel.gesture_pinch() stingray.TouchPanel.gesture_rotate() stingray.TouchPanel.gesture_tap() stingray.TouchPanel.gesture_tap_sequence() stingray.TouchPanel1.gesture_long_press() stingray.TouchPanel1.gesture_pinch() stingray.TouchPanel1.gesture_rotate() stingray.TouchPanel1.gesture_tap() stingray.TouchPanel1.gesture_tap_sequence() stingray.TouchPanel2.gesture_long_press() stingray.TouchPanel2.gesture_pinch() stingray.TouchPanel2.gesture_rotate() stingray.TouchPanel2.gesture_tap() stingray.TouchPanel2.gesture_tap_sequence() stingray.Vector2() stingray.Vector2.add() stingray.Vector2.divide() stingray.Vector2.divide_elements() stingray.Vector2.lerp() stingray.Vector2.max() stingray.Vector2.min() stingray.Vector2.multiply() stingray.Vector2.multiply_elements() stingray.Vector2.normalize() stingray.Vector2.subtract() stingray.Vector2.zero() stingray.Vector2Box.unbox()

Related sample code

Appkit: /debug_menu.lua Appkit: /debug_scrollbox.lua Appkit: /loading_screen.lua

Other related reference items

	stingray.Gui stingray.Vector2Box
	stingray.Camera.screen_to_world() stingray.Camera.world_to_screen() stingray.GoogleVR.compute_distorted_point() stingray.Gui.bitmap() stingray.Gui.bitmap_3d() stingray.Gui.bitmap_3d_uv() stingray.Gui.bitmap_uv() stingray.Gui.rect() stingray.Gui.rect() stingray.Gui.rect_3d() stingray.Gui.text() stingray.Gui.triangle() stingray.Gui.update_bitmap() stingray.Gui.update_bitmap_3d() stingray.Gui.update_bitmap_3d_uv() stingray.Gui.update_bitmap_uv() stingray.Gui.update_rect() stingray.Gui.update_rect_3d() stingray.Gui.update_text() stingray.Gui.update_video() stingray.Gui.update_video_3d() stingray.Gui.video() stingray.Gui.video_3d() stingray.GwNavQueries.diskcast() stingray.GwNavQueries.raycast() stingray.Replay.record_screen_debug_text() stingray.Rotation2D() stingray.Vector2Box() stingray.Vector2Box.store()
	Math

Related help topics

Release Notes > Stingray 1.1 Release Notes

Data Members

x : number The extent of the vector along the X axis.

y : number The extent of the vector along the Y axis.

Functions

add ( vector_a, vector_b ) : stingray.Vector2 Adds the two specified vectors together, and returns the resulting vector.

Parameters

vector_a :	stingray.Vector2	The first vector to add.
vector_b :	stingray.Vector2	The second vector to add.

Returns

stingray.Vector2

The sum of the two input vectors.

distance ( vector_a, vector_b ) : number Returns the distance between two specified points.

Parameters

vector_a :	stingray.Vector2	The first point.
vector_b :	stingray.Vector2	The second point.

Returns

number

The scalar distance between vector_a and vector_b.

distance_squared ( vector_a, vector_b ) : number Returns the square of the distance between two specified points.

Parameters

vector_a :	stingray.Vector2	The first vector.
vector_b :	stingray.Vector2	The second vector.

Returns

number

The square of the distance between vector_a and vector_b.

divide ( vector, factor ) : stingray.Vector2 Divides the specified vector by a scalar value, and returns the resulting vector.

Parameters

vector :	stingray.Vector2	The vector to divide.
factor :	number	A scalar value to divide into the vector.

Returns

stingray.Vector2

The quotient of the input vector and the scalar value.

divide_elements ( vector_a, vector_b ) : stingray.Vector2 Divides each element of vector_a by the corresponding element of vector_b, and returns the resulting vector.

Parameters

vector_a :	stingray.Vector2	The vector to be divided.
vector_b :	stingray.Vector2	The vector to divide into vector_a.

Returns

stingray.Vector2

The quotient of the two input vectors.

dot ( vector_a, vector_b ) : number Returns the dot product of the two specified vectors.

Parameters

vector_a :	stingray.Vector2	The first vector.
vector_b :	stingray.Vector2	The second vector.

Returns

number

The dot product.

element ( vector, index ) : number Returns the value stored at the specified index within the vector.

Parameters

vector :	stingray.Vector2	The vector whose component will be returned.
index :	integer	The index of the component to return. Use 1 for the X component, or 2 for the Y component.

Returns

number

The value of the element at the specified index.

equal ( vector_a, vector_b ) : boolean Indicates whether or not the two vectors are identical.

Parameters

vector_a :	stingray.Vector2	The first vector to compare.
vector_b :	stingray.Vector2	The second vector to compare.

Returns

boolean

Returns true if the two vectors are identical, or false otherwise.

is_valid ( vector ) : boolean Indicates whether or not the vector is composed entirely of valid values.

Parameters

vector :

stingray.Vector2

The vector to be validated.

Returns

boolean

Returns true if all components of the vector are valid numbers, or false if any component is #NaN or #INF.

length ( vector ) : number Returns the scalar length of the specified vector.

Parameters

vector :

stingray.Vector2

The vector whose length will be returned.

Returns

number

The length of the vector.

lerp ( vector_a, vector_b, ratio ) : stingray.Vector2 Produces a new vector by interpolating linearly between the two specified vectors with the specified ratio.

Parameters

vector_a :	stingray.Vector2	The first vector.
vector_b :	stingray.Vector2	The second vector.
ratio :	number	The interpolation ratio, or weight. May be any value between 0 and 1 inclusive. Values closer to 0 produce vectors closer to vector_a; values closer to 1 produce vectors closer to vector_b.

Returns

stingray.Vector2

The resulting vector.

max ( vector_a, vector_b ) : stingray.Vector2 Returns a vector that contains the greatest value for each component in the two specified vectors.

Parameters

vector_a :	stingray.Vector2	The first vector.
vector_b :	stingray.Vector2	The second vector.

Returns

stingray.Vector2

The resulting vector.

min ( vector_a, vector_b ) : stingray.Vector2 Returns a vector that contains the smallest value for each component in the two specified vectors.

Parameters

vector_a :	stingray.Vector2	The first vector.
vector_b :	stingray.Vector2	The second vector.

Returns

stingray.Vector2

The resulting vector.

multiply ( vector, factor ) : stingray.Vector2 Multiplies the specified vector by a scalar value, and returns the resulting vector.

Parameters

vector :	stingray.Vector2	The vector to multiply.
factor :	number	A scalar value to multiply with the vector.

Returns

stingray.Vector2

The product of the input vector and the scalar value.

multiply_elements ( vector_a, vector_b ) : stingray.Vector2 Multiplies each element of vector_a by the corresponding element of vector_b, and returns the resulting vector.

Parameters

vector_a :	stingray.Vector2	The first vector to multiply.
vector_b :	stingray.Vector2	The second vector to multiply.

Returns

stingray.Vector2

The product of the two input vectors.

normalize ( vector ) : stingray.Vector2 Normalizes the specified vector -- i.e. converts its scalar length to 1 -- and returns the result.

Parameters

vector :

stingray.Vector2

The vector to be normalized.

Returns

stingray.Vector2

The normalized vector.

set_element ( vector, index, value ) Sets the specified index within the vector to the specified value.

Parameters

vector :	stingray.Vector2	The vector whose component will be set.
index :	integer	The index of the component to set. Use 1 for the X component, or 2 for the Y component.
value :	number	The value to set at the specified index.

Returns

This function does not return any values.

set_x ( vector, value ) Sets the value of the vector's X component.

Parameters

vector :	stingray.Vector2	The vector whose component will be set.
value :	number	The new value for the X component.

Returns

This function does not return any values.

set_xy ( vector, x, y ) Sets the values of the vector's X and Y components.

Parameters

vector :	stingray.Vector2	The vector whose components will be set.
x :	number	The new value for the X component.
y :	number	The new value for the Y component.

Returns

This function does not return any values.

set_y ( vector, value ) Sets the value of the vector's Y component.

Parameters

vector :	stingray.Vector2	The vector whose component will be set.
value :	number	The new value for the Y component.

Returns

This function does not return any values.

subtract ( vector_a, vector_b ) : stingray.Vector2 Subtracts vector_b from vector_a, and returns the resulting vector.

Parameters

vector_a :	stingray.Vector2	The starting vector.
vector_b :	stingray.Vector2	The vector that will be subtracted.

Returns

stingray.Vector2

The result of the subtraction.

to_elements ( vector ) : number, number Decomposes the specified vector into its component values.

Parameters

vector :

stingray.Vector2

The vector to be broken down into its components.

Returns

number	The X component of the vector.
number	The Y component of the vector.

to_string ( vector ) : string Returns a string representation of the specified vector.

Parameters

vector :

stingray.Vector2

The vector to return as a string.

Returns

string

The string representation.

Use this function only for debugging purposes; do not attempt to save the string and read it back into a new vector. Use a Vector2Box to save vectors across multiple frames.

x ( vector ) : number Returns the value of the vector's X component.

Parameters

vector :

stingray.Vector2

The vector whose component will be returned.

Returns

number

The value of the X component.

y ( vector ) : number Returns the value of the vector's Y component.

Parameters

vector :

stingray.Vector2

The vector whose component will be returned.

Returns

number

The value of the Y component.

zero ( ) : stingray.Vector2 Returns a new vector with all values initialized to zero.

Parameters

This function does not accept any parameters.

Returns

stingray.Vector2

The zero vector.