Difference between revisions of "R3d.Body:applyWorldTorque"

From GiderosMobile
(Created page with "'''Available since:''' Gideros 2019.10<br/> '''Class:''' R3d.Body<br/> === Description === Applies a torque to the body. <syntaxhighlight lang="lua"> r3d.Body:applyWorldT...")
 
 
Line 3: Line 3:
  
 
=== Description ===
 
=== Description ===
Applies a torque to the body.
+
Applies a torque to the body in world-space.
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
 
r3d.Body:applyWorldTorque(torqueX,torqueY,torqueZ)
 
r3d.Body:applyWorldTorque(torqueX,torqueY,torqueZ)
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
The specified force/torque will be added to the total force/torque applied to the rigid body.
 +
 +
At the end of each call to the ''PhysicsWorld::update()'', the total force/torque of all the rigid bodies will be reset to zero. You need to call ''applyLocalTorque'' during several frames if you want the force/torque to be applied during a certain amount of time.
  
 
=== Parameters ===
 
=== Parameters ===
'''torqueX''': (number) applies a torque on the X axis<br/>
+
'''torqueX''': (number) applies a torque in Newton meters on the X axis<br/>
'''torqueY''': (number) applies a torque on the Y axis<br/>
+
'''torqueY''': (number) applies a torque in Newton meters on the Y axis<br/>
'''torqueZ''': (number) applies a torque on the Z axis<br/>
+
'''torqueZ''': (number) applies a torque in Newton meters on the Z axis<br/>
  
 
=== Example ===
 
=== Example ===

Latest revision as of 14:47, 16 December 2025

Available since: Gideros 2019.10
Class: R3d.Body

Description

Applies a torque to the body in world-space.

r3d.Body:applyWorldTorque(torqueX,torqueY,torqueZ)

The specified force/torque will be added to the total force/torque applied to the rigid body.

At the end of each call to the PhysicsWorld::update(), the total force/torque of all the rigid bodies will be reset to zero. You need to call applyLocalTorque during several frames if you want the force/torque to be applied during a certain amount of time.

Parameters

torqueX: (number) applies a torque in Newton meters on the X axis
torqueY: (number) applies a torque in Newton meters on the Y axis
torqueZ: (number) applies a torque in Newton meters on the Z axis

Example

if isleft then ship.body:applyWorldTorque(0, -24 * 64, 0) end