Difference between revisions of "R3d.Fixture:getMaterial"

From GiderosMobile
m (Text replacement - "<source" to "<syntaxhighlight")
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:
 
<syntaxhighlight lang="lua">
 
<syntaxhighlight lang="lua">
 
(bounciness) (frictionCoefficient) (rollingResistance) = r3d.Body:getMaterial()
 
(bounciness) (frictionCoefficient) (rollingResistance) = r3d.Body:getMaterial()
</source>
+
</syntaxhighlight>
  
 
=== Return values ===
 
=== Return values ===
Line 13: Line 13:
 
'''Returns''' (bounciness) the bounciness of the fixture (default = 0.5)<br/>
 
'''Returns''' (bounciness) the bounciness of the fixture (default = 0.5)<br/>
 
'''Returns''' (frictionCoefficient) the friction coefficient of the fixture (default = 0.3)<br/>
 
'''Returns''' (frictionCoefficient) the friction coefficient of the fixture (default = 0.3)<br/>
'''Returns''' (rollingResistance) the rolling resistance of the fixture (default = 0)<br/>
+
'''Returns''' (rollingResistance) the rolling resistance of the fixture'''*''' (default = 0)<br/>
 +
 
 +
'''* this has been removed in latest ReactPhysics3D. Use [[R3d.Body:setAngularDamping]] to set and get the rolling resistance'''
  
 
=== Example ===
 
=== Example ===
Line 24: Line 26:
 
local mat = fixture:getMaterial()
 
local mat = fixture:getMaterial()
 
print(mat.bounciness, mat.frictionCoefficient, mat.rollingResistance) -- returns 0.5, 0.3, 0
 
print(mat.bounciness, mat.frictionCoefficient, mat.rollingResistance) -- returns 0.5, 0.3, 0
</source>
+
</syntaxhighlight>
  
 
{{R3d.Fixture}}
 
{{R3d.Fixture}}

Latest revision as of 01:31, 15 December 2025

Available since: Gideros 2019.10
Class: R3d.Fixture

Description

Gets the fixture material (bounciness, frictionCoefficient, rollingResistance).

(bounciness) (frictionCoefficient) (rollingResistance) = r3d.Body:getMaterial()

Return values

values between 0 and 1 (0 means no bounciness, friction or rolling resistance).

Returns (bounciness) the bounciness of the fixture (default = 0.5)
Returns (frictionCoefficient) the friction coefficient of the fixture (default = 0.3)
Returns (rollingResistance) the rolling resistance of the fixture* (default = 0)

* this has been removed in latest ReactPhysics3D. Use R3d.Body:setAngularDamping to set and get the rolling resistance

Example

-- the body
view.body = xworld:createBody(view:getMatrix())
local shape = r3d.SphereShape.new(params.sizex) -- radius
local fixture = view.body:createFixture(shape, nil, params.mass)
-- materials
local mat = fixture:getMaterial()
print(mat.bounciness, mat.frictionCoefficient, mat.rollingResistance) -- returns 0.5, 0.3, 0