Difference between revisions of "R3d.Body:applyLocalForceAtCenterOfMass"

From GiderosMobile
(Created page with "'''Available since:''' Gideros 2019.10<br/> '''Class:''' R3d.Body<br/> === Description === Applies a force to the body. <syntaxhighlight lang="lua"> r3d.Body:applyLocalFo...")
 
 
Line 7: Line 7:
 
r3d.Body:applyLocalForceAtCenterOfMass(forceX,forceY,forceZ[,pointX,pointY,pointZ])
 
r3d.Body:applyLocalForceAtCenterOfMass(forceX,forceY,forceZ[,pointX,pointY,pointZ])
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
If the force is applied to the center of mass, no torque will be created and only the linear motion of the body will be affected.
  
 
=== Parameters ===
 
=== Parameters ===
'''forceX''': (number) applies a force on the X axis<br/>
+
'''forceX''': (number) applies a force in Newton on the X axis<br/>
'''forceY''': (number) applies a force on the Y axis<br/>
+
'''forceY''': (number) applies a force in Newton on the Y axis<br/>
'''forceZ''': (number) applies a force on the Z axis<br/>
+
'''forceZ''': (number) applies a force in Newton on the Z axis<br/>
 
'''pointX''': (number) offsets the point of the force on the X axis ('''optional''' default is 0)<br/>
 
'''pointX''': (number) offsets the point of the force on the X axis ('''optional''' default is 0)<br/>
 
'''pointY''': (number) offsets the point of the force on the Y axis ('''optional''' default is 0)<br/>
 
'''pointY''': (number) offsets the point of the force on the Y axis ('''optional''' default is 0)<br/>

Latest revision as of 14:20, 16 December 2025

Available since: Gideros 2019.10
Class: R3d.Body

Description

Applies a force to the body.

r3d.Body:applyLocalForceAtCenterOfMass(forceX,forceY,forceZ[,pointX,pointY,pointZ])

If the force is applied to the center of mass, no torque will be created and only the linear motion of the body will be affected.

Parameters

forceX: (number) applies a force in Newton on the X axis
forceY: (number) applies a force in Newton on the Y axis
forceZ: (number) applies a force in Newton on the Z axis
pointX: (number) offsets the point of the force on the X axis (optional default is 0)
pointY: (number) offsets the point of the force on the Y axis (optional default is 0)
pointZ: (number) offsets the point of the force on the Z axis (optional default is 0)

Example

if isup then ship.body:applyLocalForceAtCenterOfMass(0, 0, 64) end