Difference between revisions of "B2.Body:createFixture"
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 === | |
− | Creates a fixture and attach it to this body. If the density is non-zero, this function automatically | + | Creates a fixture and attach it to this body. If the density is non-zero, this function automatically |
− | updates the mass of the body. Contacts are not created until the next time step. The fixture definition is given | + | updates the mass of the body. Contacts are not created until the next time step. The fixture definition is given as an ordinary table. The fields of the fixture definition table are: |
− | as | + | <ul> |
− | + | <li>''shape'': (b2.Shape) The shape, this must be set.</li> | |
− | <ul | + | <li>''friction'': (number) The friction coefficient, usually in the range [0,1].</li> |
− | <li>''shape'': (b2.Shape) The shape, this must be set.</li | + | <li>''restitution'': (number) The restitution (elasticity) usually in the range [0,1].</li> |
− | <li>''friction'': (number) The friction coefficient, usually in the range [0,1].</li | + | <li>''density'': (number) The density, usually in kg/m^2.</li> |
− | <li>''restitution'': (number) The restitution (elasticity) usually in the range [0,1].</li | + | <li>''isSensor'': (boolean) A sensor shape collects contact information but never generates a collision response.</li> |
− | <li>''density'': (number) The density, usually in kg/m^2.</li | + | <li>''filter'': (table) Contact filtering data. The definition of contact filtering data is given at [[Special:MyLanguage/b2.Fixture:setFilterData|b2.Fixture:setFilterData]] function.</li> |
− | <li>''isSensor'': (boolean) A sensor shape collects contact information but never generates a collision response.</li | + | </ul> |
− | <li>''filter'': (table) Contact filtering data. The definition of contact filtering data is given at [[Special:MyLanguage/b2.Fixture:setFilterData|b2.Fixture:setFilterData]] function.</li | + | |
− | </ul | + | The unset fields get default values. |
− | + | ||
− | The unset fields | + | '''Warning''': this function is locked during callbacks. |
− | |||
− | |||
− | |||
− | |||
− | |||
<source lang="lua"> | <source lang="lua"> | ||
(b2.Fixture) = b2.Body:createFixture(fixtureDef) | (b2.Fixture) = b2.Body:createFixture(fixtureDef) | ||
</source> | </source> | ||
− | === | + | |
− | '''fixtureDef''': (table) | + | === Parameters === |
− | === | + | '''fixtureDef''': (table) <br/> |
− | ''' | + | |
+ | === Return values === | ||
+ | '''Returns''' (b2.Fixture) The created fixture instance.<br/> | ||
+ | |||
+ | {{B2.Body}} |
Revision as of 05:53, 17 February 2020
Available since: Gideros 2011.6
Class: b2.Body
Description
Creates a fixture and attach it to this body. If the density is non-zero, this function automatically updates the mass of the body. Contacts are not created until the next time step. The fixture definition is given as an ordinary table. The fields of the fixture definition table are:
- shape: (b2.Shape) The shape, this must be set.
- friction: (number) The friction coefficient, usually in the range [0,1].
- restitution: (number) The restitution (elasticity) usually in the range [0,1].
- density: (number) The density, usually in kg/m^2.
- isSensor: (boolean) A sensor shape collects contact information but never generates a collision response.
- filter: (table) Contact filtering data. The definition of contact filtering data is given at b2.Fixture:setFilterData function.
The unset fields get default values.
Warning: this function is locked during callbacks.
(b2.Fixture) = b2.Body:createFixture(fixtureDef)
Parameters
fixtureDef: (table)
Return values
Returns (b2.Fixture) The created fixture instance.
- 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