Regular API function

simAddForce / sim.addForce

Description Adds a non-central force to a shape object that is dynamically enabled. Added forces are cumulative, and are reset to zero after sim.handleDynamics was called (or by using the following flag: sim.handleflag_resetforcetorque). See also sim.addForceAndTorque.
C/C++
synopsis
simInt simAddForce (simInt shapeHandle,const simFloat* position,const simFloat* force)
C/C++
parameters
shapeHandle: handle of a dynamically enabled shape. Can be combined with sim.handleflag_resetforcetorque in order to clear the accumulated force and torque.
position: pointer to 3 values that represent the relative position where the force should be applied.
force: pointer to 3 values that represent the force (in relative coordinates) to add.
C/C++
return value
-1 if operation was not successful
Lua
synopsis
sim.addForce(int shapeHandle,float[3] position,float[3] force)
Lua
parameters
Similar to the C-function counterpart
Lua
return values
Python
synopsis
sim.addForce(int shapeHandle,list position,list force)