Difference between revisions of "R3d.Body:setAngularDamping"
From GiderosMobile
m (Text replacement - "<source" to "<syntaxhighlight") |
|||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
Sets the body angular damping. Damping is the effect of reducing the velocity of the rigid body during the simulation (like air friction for instance). | Sets the body angular damping. Damping is the effect of reducing the velocity of the rigid body during the simulation (like air friction for instance). | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
| − | r3d.Body:setAngularDamping( | + | r3d.Body:setAngularDamping(damping) |
| − | </ | + | </syntaxhighlight> |
| + | |||
| + | By default, no damping is applied. However, you can choose to damp the linear or/and the angular velocity of a rigid body. For instance, without angular damping a pendulum will never come to rest. | ||
| + | |||
| + | The damping value has to be positive and a value of zero means no damping at all. | ||
| + | |||
| + | '''WARNINGS''': setting ''damping'' a negative value will crash your app! | ||
=== Parameters === | === Parameters === | ||
| − | ''' | + | '''damping''': (number) the new body angular damping, '''default = 0 no damping''' |
=== Example === | === Example === | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
| − | + | player1.body = world:createBody(view:getMatrix()) | |
| − | + | player1.body:setAngularDamping(2) | |
| − | </ | + | </syntaxhighlight> |
{{R3d.Body}} | {{R3d.Body}} | ||
Latest revision as of 10:29, 18 December 2025
Available since: Gideros 2020.2
Class: R3d.Body
Description
Sets the body angular damping. Damping is the effect of reducing the velocity of the rigid body during the simulation (like air friction for instance).
r3d.Body:setAngularDamping(damping)
By default, no damping is applied. However, you can choose to damp the linear or/and the angular velocity of a rigid body. For instance, without angular damping a pendulum will never come to rest.
The damping value has to be positive and a value of zero means no damping at all.
WARNINGS: setting damping a negative value will crash your app!
Parameters
damping: (number) the new body angular damping, default = 0 no damping
Example
player1.body = world:createBody(view:getMatrix())
player1.body:setAngularDamping(2)
- R3d.Body
- R3d.Body.DYNAMIC BODY
- R3d.Body.KINEMATIC BODY
- R3d.Body.STATIC BODY
- R3d.Body:applyLocalForceAtCenterOfMass
- R3d.Body:applyLocalForceAtLocalPosition
- R3d.Body:applyLocalForceAtWorldPosition
- R3d.Body:applyLocalTorque
- R3d.Body:applyWorldForceAtCenterOfMass
- R3d.Body:applyWorldForceAtLocalPosition
- R3d.Body:applyWorldForceAtWorldPosition
- R3d.Body:applyWorldTorque
- R3d.Body:createFixture
- R3d.Body:destroyFixture
- R3d.Body:enableGravity
- R3d.Body:getAngularDamping
- R3d.Body:getAngularLockAxisFactor
- R3d.Body:getAngularVelocity
- R3d.Body:getForce
- R3d.Body:getLinearDamping
- R3d.Body:getLinearLockAxisFactor
- R3d.Body:getLinearVelocity
- R3d.Body:getMass
- R3d.Body:getTorque
- R3d.Body:getTransform
- R3d.Body:raycast
- R3d.Body:resetForce
- R3d.Body:resetTorque
- R3d.Body:setAngularDamping
- R3d.Body:setAngularLockAxisFactor
- R3d.Body:setAngularVelocity
- R3d.Body:setIsActive
- R3d.Body:setIsAllowedToSleep
- R3d.Body:setIsSleeping
- R3d.Body:setLinearDamping
- R3d.Body:setLinearLockAxisFactor
- R3d.Body:setLinearVelocity
- R3d.Body:setMass
- R3d.Body:setSprite
- R3d.Body:setTransform
- R3d.Body:setType
- R3d.Body:testPointInside
- R3d.Body:updateMassPropertiesFromColliders
