Difference between revisions of "LlSetBuoyancy"

Revision as of 23:31, 7 August 2007

Function: llSetBuoyancy( float buoyancy );


0.0	Forced Delay
10.0	Energy

Sets the buoyancy of the task or object. Requires physics to be enabled.

• float

buoyancy

if (buoyancy == 0.0) disables
if (buoyancy < 1.0) sinks
if (buoyancy == 1.0) floats
if (buoyancy > 1.0) rises

Wind can cause the prim to drift.
Unlike some other characteristics, this is cancelled if the script that set buoyancy is removed from the prim.
This function eats energy to keep the object floating. Large objects many not be able to supply enough energy to keep the object floating.

Makes an object float up slowly (e.g. a red balloon)

default
{
    state_entry()
    {
        llSetStatus(STATUS_PHYSICS, TRUE);
        llSetBuoyancy(1.05);
    }
}

Signature
function void llSetBuoyancy( float buoyancy );

@@ Line 5: / Line 5: @@
 |func=llSetBuoyancy
 |p1_type=float|p1_name=buoyancy|p1_desc
-|func_desc=Sets the buoyancy of the task or object.
+|func_desc=Sets the buoyancy of the task or object. Requires [[STATUS_PHYSICS|physics]] to be enabled.
-|func_footnote=if ('''buoyancy''' == 0.0) disables<br/>if ('''buoyancy''' < 1.0) sinks <br/>if ('''buoyancy''' == 1.0) floats <br/>If ('''buoyancy''' > 1.0) rises
+|func_footnote=if ('''buoyancy''' == 0.0) disables<br/>if ('''buoyancy''' < 1.0) sinks <br/>if ('''buoyancy''' == 1.0) floats <br/>if ('''buoyancy''' > 1.0) rises
 |spec
 |caveats=*[[llWind|Wind]] can cause the prim to drift.
 *Unlike some other characteristics, this is cancelled if the script that set buoyancy is removed from the prim.
+*This function eats [[energy]] to keep the object floating. Large objects many not be able to supply enough energy to keep the object floating.
 |constants
 |examples=Makes an object float up slowly (e.g. a red balloon)<pre>