Difference between revisions of "LlGroundNormal"

Revision as of 10:51, 18 June 2012

Function: vector llGroundNormal( vector offset );

Returns a vector that is the ground normal from the current position + offset.

• vector

–

offset relative to the prim's position and expressed in local coordinates

The requested position needs to be in the same region. Only the x and y coordinates in offset are important, the z component is ignored.

This function is defined as: <lsl> vector llGroundNormal(vector offset) {

   vector slope = llGroundSlope(offset);
   return <slope.x, slope.y, 1.0>;

} </lsl>

There seems to some confusion be between a Surface Normal (the direction from the surface) and Normalized Vector (a vector with a magnitude of 1.0, AKA Unit Vector). This function does not return a unit vector. Surface normals may encode additional information in the magnitude of the vector.if you need a Unit Vector, simply use llVecNorm.

Signature
function vector llGroundNormal( vector offset );

@@ Line 1: / Line 1: @@
 {{LSL_Function
-|inject-2={{LSL Function/offset|offset|noZ=*}}
+|inject-2={{LSL Function/offset|offset|noZ=*|sim=*}}
 |func_id=222|func_sleep=0.0|func_energy=10.0
 |func=llGroundNormal
 |return_type=vector|p1_type=vector|p1_name=offset
-|func_footnote=The requested position needs to be in the same sim.
+|func_footnote
 |func_desc
 |return_text=that is the ground {{Wikipedia|Normal (geometry)|normal}} from the current [[llGetPos|position]] + {{LSLPT|offset}}.