B2.Body:createFixture

Available since: Gideros 2011.6

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 a 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 gets 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.