Difference between revisions of "LlSetBuoyancy"

From Second Life Wiki
Jump to navigation Jump to search
m (Changed spelling to 'affect' from 'effect', since to affect an object is to have an effect on it, whereas to effect an object would be more like to rez it.)
m
Line 10: Line 10:
|caveats=*[[llWind|Wind]] can cause the prim to drift.
|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.
*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.
*This function eats [[energy]] to keep the object floating. Large objects may not be able to supply enough energy to keep the object floating.
|constants
|constants
|examples=Makes an object float up slowly (e.g. a red balloon)<lsl>default
|examples=Makes an object float up slowly (e.g. a red balloon)<lsl>default

Revision as of 22:23, 8 May 2010

Summary

Function: llSetBuoyancy( float buoyancy );

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

Caveats

  • 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 may not be able to supply enough energy to keep the object floating.
All Issues ~ Search JIRA for related Bugs

Examples

Makes an object float up slowly (e.g. a red balloon)<lsl>default {

   state_entry()
   {
       llSetStatus(STATUS_PHYSICS, TRUE);
       llSetBuoyancy(1.05);
   }
}</lsl>

Notes

Often used to make an object look like gravity does not affect it.

Deep Notes

Search JIRA for related Issues

Signature

function void llSetBuoyancy( float buoyancy );