Difference between revisions of "LlSetForceAndTorque"

From Second Life Wiki
Jump to: navigation, search
m (Replaced old <LSL> block with <source lang="lsl2">)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{LSL Function
 
{{LSL Function
 +
|inject-2={{LSL_Function/force|force|torque|local=local}}{{LSL_Function/physical}}
 
|func_id=76
 
|func_id=76
 
|func_sleep=0.0
 
|func_sleep=0.0
Line 5: Line 6:
 
|func=llSetForceAndTorque
 
|func=llSetForceAndTorque
 
|p1_type=vector|p1_name=force|p1_desc=directional force
 
|p1_type=vector|p1_name=force|p1_desc=directional force
|p2_type=vector|p2_name=torque|p3_desc=torque force
+
|p2_type=vector|p2_name=torque|p2_desc=torque force
|p3_type=integer|p3_name=local|p3_desc=boolean, if {{LSLG|TRUE}} uses [[Viewer coordinate frames#Local|local]] axis, if {{LSLG|FALSE}} uses [[Viewer coordinate frames#Region|region]] axis.
+
|p3_type=integer|p3_subtype=boolean|p3_name=local
 
|func_desc=Sets the force and torque of object (if the script is physical)
 
|func_desc=Sets the force and torque of object (if the script is physical)
 
|spec
 
|spec
|caveats
+
|caveats=
 +
* If either value is [[ZERO_VECTOR]], the function eliminates both forces. Both values must be non-zero for this function to work. (The workaround to this is setting both separately.)
 
|constants
 
|constants
|examples
+
|examples=
 +
<source lang="lsl2">
 +
default
 +
{
 +
    touch_start(integer total_number)
 +
    {
 +
        llSetForceAndTorque( <0.0,0.0,5.0>, <1.0,0.0,0.0>, FALSE );
 +
    }
 +
}
 +
</source>
 
|helpers
 
|helpers
 
|also_functions={{LSL DefineRow||[[llSetForce]]|}}
 
|also_functions={{LSL DefineRow||[[llSetForce]]|}}

Latest revision as of 14:42, 22 January 2015

Summary

Function: llSetForceAndTorque( vector force, vector torque, integer local );

Sets the force and torque of object (if the script is physical)

• vector force directional force
• vector torque torque force
• integer local boolean, if TRUE force is treated as a local directional vector, if FALSE force is treated as a region directional vector

Caveats

  • Only works in physics-enabled objects.
  • If either value is ZERO_VECTOR, the function eliminates both forces. Both values must be non-zero for this function to work. (The workaround to this is setting both separately.)
All Issues ~ Search JIRA for related Bugs

Examples

default
{
    touch_start(integer total_number)
    {
        llSetForceAndTorque( <0.0,0.0,5.0>, <1.0,0.0,0.0>, FALSE );
    }
}

See Also

Functions

•  llSetForce
•  llSetTorque

Deep Notes

Search JIRA for related Issues

Signature

function void llSetForceAndTorque( vector force, vector torque, integer local );