vectorNormalized: Difference between revisions

Latest revision as of 17:27, 18 March 2025

1.26

Hover & click on the images for description

Description

Description:: Returns normalized vector (unit vector, vectorMagnitude == 1) of given vector. If given vector is 0 result is a 0 vector as well.

2.14
Since 2.14 any count of numbers is valid.
Before 2.14, the first argument had to be vector 3D, or 2.00 2D (Which still returned 3D result, with z coordinate defaulted to 0)
Groups:: Math - Vectors

Syntax

Syntax:: vectorNormalized vector
Parameters:: vector: Array of Numbers
Return Value:: Array

Examples

Example 1:: vectorNormalized [12345,7890,38383]; // [0.300481,0.192045,0.934254] vectorMagnitude [0.300481,0.192045,0.934254]; // 1

Additional Information

See also:: vectorDiff vectorCrossProduct vectorDotProduct vectorCos vectorMagnitude vectorMagnitudeSqr vectorMultiply vectorDistance vectorDistanceSqr vectorDir vectorUp setVectorDir setVectorUp setVectorDirAndUp vectorFromTo matrixMultiply matrixTranspose

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

: Posted on 19 Jul, 2014
ffur2007slx2_5: 1.26 Algorithm:
Vector = [x,y,z]; Result = [x/(sqrt (x ^ 2 + y ^ 2 + z ^ 2)), y/(sqrt (x ^ 2 + y ^ 2 + z ^ 2)), z/(sqrt (x ^ 2 + y ^ 2 + z ^ 2))];
In mathematics, a unit vector in a normed vector space is a vector whose length is 1.

@@ Line 6: / Line 6: @@
 |gr2= Math - Vectors
-|descr= Returns normalized vector (unit vector, [[vectorMagnitude]] {{=}}{{=}} 1) of given vector. If given vector is 0 result is a 0 vector as well.
+|descr= Returns normalized vector (unit vector, [[vectorMagnitude]] {{=}}{{=}} 1) of given vector. If given vector is 0 result is a 0 vector as well.<br>
+{{Feature|GVI|arma3|2.14|Since {{GVI|arma3|2.14|size= 0.75}} any count of numbers is valid.<br>
+Before {{GVI|arma3|2.14|size= 0.75}}, the first argument had to be vector 3D, or {{GVI|arma3|2.00|size= 0.75}} 2D (Which still returned 3D result, with z coordinate defaulted to 0)}}
 |s1= [[vectorNormalized]] vector
-|p1= vector: [[Array]] - vector 3D or 2D (since Arma 3 v2.00, z coordinate is defaulted to 0)
+|p1= vector: [[Array]] of [[Number]]s
 |r1= [[Array]]
-|x1= <code>[[vectorNormalized]] [12345,7890,38383]; {{cc|[0.300481,0.192045,0.934254]}}
+|x1= <sqf>
-[[vectorMagnitude]] [0.300481,0.192045,0.934254]; {{cc|}}</code>
+vectorNormalized [12345,7890,38383]; // [0.300481,0.192045,0.934254]
+vectorMagnitude [0.300481,0.192045,0.934254]; // 1
+</sqf>
-|seealso= [[vectorDiff]], [[vectorCrossProduct]], [[vectorDotProduct]], [[vectorCos]], [[vectorMagnitude]], [[vectorMagnitudeSqr]], [[vectorMultiply]], [[vectorDistance]], [[vectorDistanceSqr]], [[vectorDir]], [[vectorUp]], [[setVectorDir]], [[setVectorUp]], [[setVectorDirAndUp]], [[vectorFromTo]], [[matrixMultiply]], [[matrixTranspose]]
+|seealso= [[vectorDiff]] [[vectorCrossProduct]] [[vectorDotProduct]] [[vectorCos]] [[vectorMagnitude]] [[vectorMagnitudeSqr]] [[vectorMultiply]] [[vectorDistance]] [[vectorDistanceSqr]] [[vectorDir]] [[vectorUp]] [[setVectorDir]] [[setVectorUp]] [[setVectorDirAndUp]] [[vectorFromTo]] [[matrixMultiply]] [[matrixTranspose]]
 }}
@@ Line 27: / Line 32: @@
 <dd class="note">
 {{GVI|arma3|1.26}} Algorithm:
-<code>Vector = [x,y,z];
+<sqf>
-Result = [x/([[sqrt]] (x ^ 2 + y ^ 2 + z ^ 2)), y/([[sqrt]] (x ^ 2 + y ^ 2 + z ^ 2)), z/([[sqrt]] (x ^ 2 + y ^ 2 + z ^ 2))];</code>
+Vector = [x,y,z];
+Result = [x/(sqrt (x ^ 2 + y ^ 2 + z ^ 2)), y/(sqrt (x ^ 2 + y ^ 2 + z ^ 2)), z/(sqrt (x ^ 2 + y ^ 2 + z ^ 2))];
+</sqf>
 In mathematics, a unit vector in a normed vector space is a vector whose length is 1.
 </dl>