Difference between revisions of "B2.Body:createFixture"

From GiderosMobile
Line 2: Line 2:
 
'''Available since:''' Gideros 2011.6<br/>
 
'''Available since:''' Gideros 2011.6<br/>
 
=== Description ===
 
=== Description ===
<br />
+
<translate><br />
 
Creates a fixture and attach it to this body. If the density is non-zero, this function automatically<br />
 
Creates a fixture and attach it to this body. If the density is non-zero, this function automatically<br />
 
updates the mass of the body. Contacts are not created until the next time step. The fixture definition is given<br />
 
updates the mass of the body. Contacts are not created until the next time step. The fixture definition is given<br />
Line 8: Line 8:
 
<br />
 
<br />
 
<ul><br />
 
<ul><br />
<li>`shape`: (b2.Shape) The shape, this must be set.</li><br />
+
<li>[[[shape]]]: (b2.Shape) The shape, this must be set.</li><br />
<li>`friction`: (number) The friction coefficient, usually in the range [0,1].</li><br />
+
<li>[[[friction]]]: (number) The friction coefficient, usually in the range [0,1].</li><br />
<li>`restitution`: (number) The restitution (elasticity) usually in the range [0,1].</li><br />
+
<li>[[[restitution]]]: (number) The restitution (elasticity) usually in the range [0,1].</li><br />
<li>`density`: (number) The density, usually in kg/m^2.</li><br />
+
<li>[[[density]]]: (number) The density, usually in kg/m^2.</li><br />
<li>`isSensor`: (boolean) A sensor shape collects contact information but never generates a collision response.</li><br />
+
<li>[[[isSensor]]]: (boolean) A sensor shape collects contact information but never generates a collision response.</li><br />
<li>`filter`: (table) Contact filtering data. The definition of contact filtering data is given at `b2.Fixture:setFilterData` function.</li><br />
+
<li>[[[filter`: (table) Contact filtering data. The definition of contact filtering data is given at `b2.Fixture:setFilterData]]] function.</li><br />
 
</ul><br />
 
</ul><br />
 
<br />
 
<br />
Line 19: Line 19:
 
<br />
 
<br />
 
<ul><br />
 
<ul><br />
<li>`Warning`: This function is locked during callbacks.</li><br />
+
<li>[[[Warning]]]: This function is locked during callbacks.</li><br />
 
</ul><br />
 
</ul><br />
<br />
+
<br /></translate>
 
<source lang="lua">
 
<source lang="lua">
 
(b2.Fixture) = b2.Body:createFixture(fixtureDef)
 
(b2.Fixture) = b2.Body:createFixture(fixtureDef)
 
</source>
 
</source>
 
=== Parameters ===
 
=== Parameters ===
'''fixtureDef''': (table) <br/>
+
'''fixtureDef''': (table) <translate></translate> <br/>
 
=== Return values ===
 
=== Return values ===
'''Returns''' (b2.Fixture) The created fixture instance.<br/>
+
'''Returns''' (b2.Fixture) <translate>The created fixture instance.</translate><br/>

Revision as of 14:32, 23 August 2018

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.