View source for LlApplyImpulse/zh-Hant

{{LSL_Function/zh-Hant
|func=llApplyImpulse
|sort=ApplyImpulse
|func_id=72|func_sleep=0.0|func_energy=10.0
|p1_type=vector
|p1_name=force
|p2_type=integer
|p2_name=local
|p2_hover=boolean, if TRUE, force is treated as a local directional vector instead of region directional vector.
|p2_desc=boolean, if [[TRUE]], '''force''' is treated as a [[Viewer coordinate frames#Local|local]] directional vector instead of [[Viewer coordinate frames#Region|region]] directional vector.
|func_footnote=Instantaneous impulse. [[llSetForce]] has continuous push. "Instantaneous" seems to mean a one second impulse, as an application of a force (in newtons) equal to the object's mass (in kg) for one second will accelerate it to a velocity of 1 (in meters per second), which appears to be what happens with this function.
|func_desc=Applies impulse to object
|return_text|spec
|caveats=*Object must be physical.
*The force [[llVecMag|magnitude]] is capped at 20.000.
*The force magnitude is scaled by the object's energy.
|examples=
<lsl>
//Rez an object, and drop this script in it.
//This will launch it at the owner.
default {
     state_entry() {
          list p = llGetObjectDetails(llGetOwner(), [OBJECT_POS]);
          if(p != []) {
              llSetStatus(STATUS_PHYSICS, TRUE);
              vector pos = llList2Vector(p, 0);
              vector direction = llVecNorm(pos - llGetPos());
              llApplyImpulse(direction * 100, 0);
          }
     }
}
</lsl>
|helpers
|also_functions=
{{LSL DefineRow||[[llApplyRotationalImpulse]]|}}
{{LSL DefineRow||[[llSetForce]]|Set continuous force}}
|notes
|cat1=Physics
|cat2=Movement
|cat3
|cat4
}}