R3d.Fixture:setMaterial: Difference between revisions
From GiderosMobile
Created page with "'''Available since:''' Gideros 2019.10<br/> '''Class:''' R3d.Body<br/> === Description === Sets the body material (bounciness, frictionCoefficient, rollingResistance). <s..." |
No edit summary |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
'''Available since:''' Gideros 2019.10<br/> | '''Available since:''' Gideros 2019.10<br/> | ||
'''Class:''' [[R3d. | '''Class:''' [[R3d.Fixture]]<br/> | ||
=== Description === | === Description === | ||
Sets the | Sets the fixture material (''bounciness'', ''frictionCoefficient'', ''massDensity''). | ||
< | <syntaxhighlight lang="lua"> | ||
r3d. | r3d.Fixture:setMaterial(material) | ||
</ | </syntaxhighlight> | ||
'''warnings''': not setting material.bounciness between (0, 1) will crash your app! | |||
'''warnings''': setting material.frictionCoefficient a negative value will crash your app! | |||
'''warnings''': material.rollingResistance is deprecated use '''[[R3d.Body:setAngularDamping]]''' instead | |||
=== Parameters === | === Parameters === | ||
'''material''': (table) the | '''material''': (table) the fixture material table:<br/> | ||
*material.'''bounciness''' | |||
*material.'''frictionCoefficient''' | |||
*material.'''massDensity''' | |||
=== Example === | === Example === | ||
< | <syntaxhighlight lang="lua"> | ||
local | -- the body | ||
mat.bounciness = 0.1 -- | view.body = world:createBody(view:getMatrix()) | ||
mat.frictionCoefficient = 0.5 -- | local shape = r3d.SphereShape.new(params.sizex) -- radius | ||
mat.rollingResistance = 1 -- | local fixture = view.body:createFixture(shape, nil, params.mass) | ||
-- materials default: bounciness=0.5, frictionCoefficient=0.3, massDensity=1 Kg | |||
</ | local mat = fixture:getMaterial() | ||
mat.bounciness = 0.1 -- 0 = no bounciness, 1 = max bounciness | |||
mat.frictionCoefficient = 0.5 -- 0 = no friction | |||
--mat.rollingResistance = 0.1 -- DEPRECATED! | |||
mat.massDensity = 5 -- in Kg | |||
fixture:setMaterial(mat) | |||
</syntaxhighlight> | |||
{{R3d. | {{R3d.Fixture}} | ||
Latest revision as of 01:08, 19 December 2025
Available since: Gideros 2019.10
Class: R3d.Fixture
Description
Sets the fixture material (bounciness, frictionCoefficient, massDensity).
r3d.Fixture:setMaterial(material)
warnings: not setting material.bounciness between (0, 1) will crash your app! warnings: setting material.frictionCoefficient a negative value will crash your app! warnings: material.rollingResistance is deprecated use R3d.Body:setAngularDamping instead
Parameters
material: (table) the fixture material table:
- material.bounciness
- material.frictionCoefficient
- material.massDensity
Example
-- the body
view.body = world:createBody(view:getMatrix())
local shape = r3d.SphereShape.new(params.sizex) -- radius
local fixture = view.body:createFixture(shape, nil, params.mass)
-- materials default: bounciness=0.5, frictionCoefficient=0.3, massDensity=1 Kg
local mat = fixture:getMaterial()
mat.bounciness = 0.1 -- 0 = no bounciness, 1 = max bounciness
mat.frictionCoefficient = 0.5 -- 0 = no friction
--mat.rollingResistance = 0.1 -- DEPRECATED!
mat.massDensity = 5 -- in Kg
fixture:setMaterial(mat)