Difference between revisions of "B2.Body:setActive"
From GiderosMobile
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
<languages /> | <languages /> | ||
| − | ''' | + | '''Available since:''' Gideros 2011.6<br/> |
| − | ''' | + | '''Class:''' [[Special:MyLanguage/b2.Body|b2.Body]]<br/> |
| − | === | + | |
| − | + | === Description === | |
| − | Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up. | + | Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up. |
| − | If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false, | + | |
| − | all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are | + | If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false, all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies. |
| − | otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies. | + | |
| − | Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries. | + | Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries. |
| − | Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a [[b2.World]] object and | + | |
| − | remains in the body list. | + | Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a [[b2.World]] object and remains in the body list. |
| − | |||
<source lang="lua"> | <source lang="lua"> | ||
| − | + | b2.Body:setActive(flag) | |
</source> | </source> | ||
| − | === | + | |
| − | '''flag''': (boolean) | + | === Parameters === |
| + | '''flag''': (boolean) active flag <br/> | ||
| + | |||
| + | {{B2.Body}} | ||
Revision as of 07:23, 17 February 2020
Available since: Gideros 2011.6
Class: b2.Body
Description
Sets the active state of the body. An inactive body is not simulated and cannot be collided with or woken up.
If you pass a flag of true, all fixtures will be added to the broad-phase. If you pass a flag of false, all fixtures will be removed from the broad-phase and all contacts will be destroyed. Fixtures and joints are otherwise unaffected. You may continue to create/destroy fixtures and joints on inactive bodies.
Fixtures on an inactive body are implicitly inactive and will not participate in collisions, ray-casts, or queries.
Joints connected to an inactive body are implicitly inactive. An inactive body is still owned by a b2.World object and remains in the body list.
b2.Body:setActive(flag)
Parameters
flag: (boolean) active flag
- 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
