Difference between revisions of "B2.Body:setLinearDamping"
m (Text replacement - "</source" to "</syntaxhighlight") |
|||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
'''Available since:''' Gideros 2012.2.2<br/> | '''Available since:''' Gideros 2012.2.2<br/> | ||
| + | '''Class:''' [[b2.Body]]<br/> | ||
| + | |||
=== Description === | === Description === | ||
| − | + | Sets the linear damping of the body. | |
| − | Sets the linear damping of the body. | + | <syntaxhighlight lang="lua"> |
| − | + | b2.Body:setLinearDamping(linearDamping) | |
| − | < | + | </syntaxhighlight> |
| − | + | Damping is used to reduce the world velocity of bodies. Damping differs from friction in that friction only occurs when two surfaces are in contact. Damping is also much cheaper to simulate than friction. Note, however, that damping is not a replacement for friction; the two effects should be used together. | |
| − | </ | + | |
| + | Damping parameters should be between -1 and 1, with 0 meaning no damping, and 1 meaning full damping. We generally do not use linear damping because it makes bodies look floaty. | ||
| + | |||
| + | Damping is approximated for stability and performance. At small damping values the damping effect is mostly independent of the time step. At larger damping values, the damping effect will vary with the time step. This is not an issue if you use a fixed time step (recommended). | ||
| + | |||
=== Parameters === | === Parameters === | ||
| − | '''linearDamping''': (number) | + | '''linearDamping''': (number) new linear damping of the body<br/> |
| + | |||
| + | {{B2.Body}} | ||
Latest revision as of 16:58, 12 July 2023
Available since: Gideros 2012.2.2
Class: b2.Body
Description
Sets the linear damping of the body.
b2.Body:setLinearDamping(linearDamping)
Damping is used to reduce the world velocity of bodies. Damping differs from friction in that friction only occurs when two surfaces are in contact. Damping is also much cheaper to simulate than friction. Note, however, that damping is not a replacement for friction; the two effects should be used together.
Damping parameters should be between -1 and 1, with 0 meaning no damping, and 1 meaning full damping. We generally do not use linear damping because it makes bodies look floaty.
Damping is approximated for stability and performance. At small damping values the damping effect is mostly independent of the time step. At larger damping values, the damping effect will vary with the time step. This is not an issue if you use a fixed time step (recommended).
Parameters
linearDamping: (number) new linear damping of the body
- B2.Body
- B2.Body:applyAngularImpulse
- B2.Body:applyForce
- B2.Body:applyLinearImpulse
- B2.Body:applyTorque
- B2.Body:createFixture
- B2.Body:destroyFixture
- B2.Body:getAngle
- B2.Body:getAngularDamping
- B2.Body:getAngularVelocity
- B2.Body:getGravityScale
- B2.Body:getInertia
- B2.Body:getLinearDamping
- B2.Body:getLinearVelocity
- B2.Body:getLocalCenter
- B2.Body:getLocalPoint
- B2.Body:getLocalVector
- B2.Body:getMass
- B2.Body:getPosition
- B2.Body:getWorldCenter
- B2.Body:getWorldPoint
- B2.Body:getWorldVector
- B2.Body:isActive
- B2.Body:isAwake
- B2.Body:isBullet
- B2.Body:isFixedRotation
- B2.Body:isSleepingAllowed
- B2.Body:setActive
- B2.Body:setAngle
- B2.Body:setAngularDamping
- B2.Body:setAngularVelocity
- B2.Body:setAwake
- B2.Body:setBullet
- B2.Body:setFixedRotation
- B2.Body:setGravityScale
- B2.Body:setLinearDamping
- B2.Body:setLinearVelocity
- B2.Body:setPosition
- B2.Body:setSleepingAllowed
