llSetHoverHeight

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetHoverHeight

llSetHoverHeight

Summary

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

0.0	Forced Delay
10.0	Energy

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

• float	height	–	Distance to hover above the ground (if negative, hovers below ground)
• integer	water	–	boolean, if TRUE then hover above water too (or below if height is negative).
• 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.

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.
  • Is this true if volume detect?
• 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

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