Difference between revisions of "LlSetHoverHeight"

From Second Life Wiki
Jump to navigation Jump to search
(moar testing yay)
m (Added notes on the effects of a negative value for "height".)
Line 42: Line 42:
}
}
</lsl>
</lsl>
|notes=* It is possible to assign '''height''' a negative value. This is only really useful when '''water''' is [[TRUE]], and will make the object hover below the water level.
* Negative '''height''' values when '''water''' is [[FALSE]] will not move the object below the ground level and may cause it to be dragged down the local incline to the nearest low point.
* Assigning '''height''' a value of zero will have the same effect as [[llStopHover]].
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llGroundRepel]]| Same as llSetHoverHeight but does not hover all the time}}
|also_functions={{LSL DefineRow||[[llGroundRepel]]| Same as llSetHoverHeight but does not hover all the time}}

Revision as of 02:13, 22 January 2012

Summary

Function: llSetHoverHeight( float height, integer water, float tau );

Critically damps to a height above the ground (or water) in tau seconds.

• float height Distance above the ground
• integer water boolean, if TRUE then hover above water too.
• float tau seconds to critically damp in

Do not use with vehicles.
Use llStopHover to stop hovering.

Caveats

  • Only works in physics-enabled objects.
  • Do not rely on built-in limits. In the past, the difference between the object's initial position and the hover height was limited to 64 meters. Under SL Server 1.26.2 the limit is 4096 meters above the ground level.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> // Put in an attached prim and touch to start floating in air without flying. // Touch again to drop to the ground.

integer gHovering = FALSE; // are we supposd to be hovering now?

default {

   touch_start(integer total_number) {
       if (!llGetAttached()) {
           llWhisper(0, "Wear me to play.");
           return;
       }
       if (gHovering) {
           llOwnerSay("Releasing you.");
           llStopHover();
       }
       else {
           llOwnerSay("Making you float...");
           // Start hovering 5 meters over our current location.
           vector myPosition = llGetPos();
           llSetHoverHeight(myPosition.z - llGround(ZERO_VECTOR) + 5.0, FALSE, 1.0);
       }
       gHovering = !gHovering; // flip the switch
   }

}

</lsl>

Notes

  • It is possible to assign height a negative value. This is only really useful when water is TRUE, and will make the object hover below the water level.
  • Negative height values when water is FALSE will not move the object below the ground level and may cause it to be dragged down the local incline to the nearest low point.
  • Assigning height a value of zero will have the same effect as llStopHover.

See Also

Functions

•  llGroundRepel Same as llSetHoverHeight but does not hover all the time
•  llStopHover To stop hovering

Deep Notes

Search JIRA for related Issues

Signature

function void llSetHoverHeight( float height, integer water, float tau );