Difference between revisions of "LlSetForceAndTorque"

Latest revision as of 14:42, 22 January 2015

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

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.)

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

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

@@ Line 1: / Line 1: @@
 {{LSL Function
+|inject-2={{LSL_Function/force|force|torque|local=local}}{{LSL_Function/physical}}
 |func_id=76
 |func_sleep=0.0
@@ Line 6: / Line 7: @@
 |p1_type=vector|p1_name=force|p1_desc=directional 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)
 |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
-|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
 |also_functions={{LSL DefineRow||[[llSetForce]]|}}