Difference between revisions of "LlVecNorm"

From Second Life Wiki
Jump to navigation Jump to search
(Issues/SVC-4711)
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Issues/SVC-4711}}{{LSL_Function
{{LSL_Function
|inject-2={{Issues/SVC-4711}}
|func=llVecNorm
|func=llVecNorm
|func_id=13|func_sleep=0.0|func_energy=10.0
|func_id=13|func_sleep=0.0|func_energy=10.0
|p1_type=vector|p1_name=vec|p1_desc=Any valid vector
|p1_type=vector|p1_name=vec|p1_desc=Any valid vector
|return_type=vector
|return_type=vector
|Return_text=that is '''vec''' normalized (a unit vector sharing the same direction as '''vec''').
|Return_text=that is {{LSLP|vec}} normalized (a unit vector sharing the same direction as {{LSLP|vec}}).
|func_footnote=Functionally equivalent to: <code>'''vec''' / [[llVecMag]]('''vec'''))</code>
|func_footnote=If {{LSLP|vec}} is a [[ZERO_VECTOR]], than the value returned is a [[ZERO_VECTOR]].
|spec
|spec
|caveats=*Will return <0.0, 0.0, 0.0> when <0.0, 0.0, 0.0> is given as input.
|caveats
|examples=
|examples=
<lsl>
<source lang="lsl2">
default {
default {
     state_entry()
     state_entry()
Line 17: Line 18:
     }
     }
}
}
</lsl>
</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llVecMag]]|}}
|also_functions={{LSL DefineRow||[[llVecMag]]|}}
Line 24: Line 25:
|also_tests
|also_tests
|also_articles
|also_articles
|notes
|notes=
* Mathematically equivalent to:
** vec / [[llVecMag]]( vec )
** vec / llSqrt( vec.x * vec.x + vec.y * vec.y + vec.z * vec.z )
|cat1=Math/3D
|cat1=Math/3D
|cat2=Vector
|cat2=Vector

Latest revision as of 11:59, 22 January 2015

Summary

Function: vector llVecNorm( vector vec );

Returns the vector that is vec normalized (a unit vector sharing the same direction as vec).

• vector vec Any valid vector

If vec is a ZERO_VECTOR, than the value returned is a ZERO_VECTOR.

Caveats

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   llVecNorm returns zero vector as result when input is below a certain magnitude

Examples

default {
    state_entry()
    {
        vector input = <1.0,2.0,3.0>;
        llSay(0,"The unit vector on "+(string)input+" is: "+(string)llVecNorm(input) );
    }
}

Notes

  • Mathematically equivalent to:
    • vec / llVecMag( vec )
    • vec / llSqrt( vec.x * vec.x + vec.y * vec.y + vec.z * vec.z )

See Also

Functions

•  llVecMag
•  llVecDist

Deep Notes

All Issues

~ Search JIRA for related Issues
   llVecNorm returns zero vector as result when input is below a certain magnitude

Signature

function vector llVecNorm( vector vec );