2020-02-24 17:00:40 +01:00
<?xml version="1.0" encoding="UTF-8" ?>
<class name= "Vector3i" version= "4.0" >
<brief_description >
Vector used for 3D math using integer coordinates.
</brief_description>
<description >
3-element structure that can be used to represent positions in 3D space or any other pair of numeric values.
2020-06-21 17:16:10 +02:00
It uses integer coordinates and is therefore preferable to [Vector3] when exact precision is required.
[b]Note:[/b] In a boolean context, a Vector3i will evaluate to [code]false[/code] if it's equal to [code]Vector3i(0, 0, 0)[/code]. Otherwise, a Vector3i will always evaluate to [code]true[/code].
2020-02-24 17:00:40 +01:00
</description>
<tutorials >
2020-08-05 14:43:40 +02:00
<link title= "Math tutorial index" > https://docs.godotengine.org/en/latest/tutorials/math/index.html</link>
2020-10-01 10:34:47 +02:00
<link title= "Vector math" > https://docs.godotengine.org/en/latest/tutorials/math/vector_math.html</link>
<link title= "3Blue1Brown Essence of Linear Algebra" > https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab</link>
2020-02-24 17:00:40 +01:00
</tutorials>
<methods >
2020-11-10 14:16:20 +01:00
<method name= "Vector3i" qualifiers= "constructor" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
2020-11-09 17:46:03 +01:00
<description >
Constructs a default-initialized [Vector3i] with all components set to [code]0[/code].
</description>
</method>
2020-11-10 14:16:20 +01:00
<method name= "Vector3i" qualifiers= "constructor" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "from" type= "Vector3i" />
2020-02-24 17:00:40 +01:00
<description >
2020-11-09 17:46:03 +01:00
Constructs a [Vector3i] as a copy of the given [Vector3i].
2020-02-24 17:00:40 +01:00
</description>
</method>
2020-11-10 14:16:20 +01:00
<method name= "Vector3i" qualifiers= "constructor" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "from" type= "Vector3" />
2020-02-24 17:00:40 +01:00
<description >
Constructs a new [Vector3i] from [Vector3]. The floating point coordinates will be truncated.
</description>
</method>
2020-11-10 14:16:20 +01:00
<method name= "Vector3i" qualifiers= "constructor" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "x" type= "int" />
<argument index= "1" name= "y" type= "int" />
<argument index= "2" name= "z" type= "int" />
2020-11-09 17:46:03 +01:00
<description >
Returns a [Vector3i] with the given components.
</description>
</method>
2021-03-18 14:44:42 +01:00
<method name= "abs" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
2020-11-04 15:38:26 +01:00
<description >
</description>
</method>
2021-02-01 06:10:52 +01:00
<method name= "clamp" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "min" type= "Vector3i" />
<argument index= "1" name= "max" type= "Vector3i" />
2021-02-01 06:10:52 +01:00
<description >
Returns a new vector with all components clamped between the components of [code]min[/code] and [code]max[/code], by running [method @GlobalScope.clamp] on each component.
</description>
</method>
2021-03-18 14:44:42 +01:00
<method name= "max_axis" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "int" />
2020-06-03 14:22:26 +02:00
<description >
2020-07-21 20:07:00 +02:00
Returns the axis of the vector's largest value. See [code]AXIS_*[/code] constants. If all components are equal, this method returns [constant AXIS_X].
2020-06-03 14:22:26 +02:00
</description>
</method>
2021-03-18 14:44:42 +01:00
<method name= "min_axis" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "int" />
2020-06-03 14:22:26 +02:00
<description >
2020-07-21 20:07:00 +02:00
Returns the axis of the vector's smallest value. See [code]AXIS_*[/code] constants. If all components are equal, this method returns [constant AXIS_Z].
2020-06-03 14:22:26 +02:00
</description>
</method>
2020-11-10 14:16:20 +01:00
<method name= "operator !=" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator %" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator %" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator *" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator *" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "float" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator *" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator +" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator -" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator /" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator /" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "float" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator /" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator <" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator <=" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator ==" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator >" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator >=" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector3i" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
<method name= "operator []" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "int" />
<argument index= "0" name= "index" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
</description>
</method>
2021-06-19 17:58:49 +02:00
<method name= "operator unary+" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
2021-06-19 17:58:49 +02:00
<description >
</description>
</method>
<method name= "operator unary-" qualifiers= "operator" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
2021-06-19 17:58:49 +02:00
<description >
</description>
</method>
2021-03-18 14:44:42 +01:00
<method name= "sign" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "Vector3i" />
2020-06-03 14:22:26 +02:00
<description >
Returns the vector with each component set to one or negative one, depending on the signs of the components.
</description>
</method>
2020-02-24 17:00:40 +01:00
</methods>
2020-06-03 14:22:26 +02:00
<members >
<member name= "x" type= "int" setter= "" getter= "" default= "0" >
The vector's X component. Also accessible by using the index position [code][0][/code].
</member>
<member name= "y" type= "int" setter= "" getter= "" default= "0" >
The vector's Y component. Also accessible by using the index position [code][1][/code].
</member>
<member name= "z" type= "int" setter= "" getter= "" default= "0" >
The vector's Z component. Also accessible by using the index position [code][2][/code].
</member>
</members>
2020-02-24 17:00:40 +01:00
<constants >
<constant name= "AXIS_X" value= "0" >
Enumerated value for the X axis.
</constant>
<constant name= "AXIS_Y" value= "1" >
Enumerated value for the Y axis.
</constant>
<constant name= "AXIS_Z" value= "2" >
Enumerated value for the Z axis.
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "ZERO" value= "Vector3i(0, 0, 0)" >
2020-07-21 20:07:00 +02:00
Zero vector, a vector with all components set to [code]0[/code].
2020-02-24 17:00:40 +01:00
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "ONE" value= "Vector3i(1, 1, 1)" >
2020-07-21 20:07:00 +02:00
One vector, a vector with all components set to [code]1[/code].
2020-02-24 17:00:40 +01:00
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "LEFT" value= "Vector3i(-1, 0, 0)" >
2020-07-21 20:07:00 +02:00
Left unit vector. Represents the local direction of left, and the global direction of west.
2020-02-24 17:00:40 +01:00
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "RIGHT" value= "Vector3i(1, 0, 0)" >
2020-07-21 20:07:00 +02:00
Right unit vector. Represents the local direction of right, and the global direction of east.
2020-02-24 17:00:40 +01:00
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "UP" value= "Vector3i(0, 1, 0)" >
2020-02-24 17:00:40 +01:00
Up unit vector.
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "DOWN" value= "Vector3i(0, -1, 0)" >
2020-02-24 17:00:40 +01:00
Down unit vector.
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "FORWARD" value= "Vector3i(0, 0, -1)" >
2020-07-21 20:07:00 +02:00
Forward unit vector. Represents the local direction of forward, and the global direction of north.
2020-02-24 17:00:40 +01:00
</constant>
2019-09-24 19:45:03 +02:00
<constant name= "BACK" value= "Vector3i(0, 0, 1)" >
2020-07-21 20:07:00 +02:00
Back unit vector. Represents the local direction of back, and the global direction of south.
2020-02-24 17:00:40 +01:00
</constant>
</constants>
</class>