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), if FALSE ignore water like it isn't there
• 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.
• This is not a prim property; stopping or resetting the script stops llSetHoverHeight; same with the similar llGroundRepel
• If the object tries to go above the height (like, walking up a prim ramp), llSetHoverHeight will pull it back down, unlike the similar llGroundRepel

Examples

// 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
    }
}

Notes

• It is possible to assign height a negative value. If water is TRUE, this will make the object hover below the water level.
• Unless volume detect is enabled, 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. Enabling volume detect will cause negative height settings to move the object below the ground level.
• 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 );