Difference between revisions of "R3d.Fixture:setCollisionCategoryBits"
From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>") |
|||
| Line 7: | Line 7: | ||
r3d.Fixture:setCollisionCategoryBits(bits) | r3d.Fixture:setCollisionCategoryBits(bits) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | '''Collision filtering''' | ||
| + | |||
| + | By default all the colliders of the bodies are able to collide with each other in the world. However, sometimes we want a body to collide only with a given group of bodies and not with other bodies. This is called collision filtering. The idea is to group the colliders of bodies into categories. Then we can specify for each collider against which categories of colliders it will be able to collide. | ||
| + | |||
| + | ReactPhysics3D uses bits masks to represent categories. The first thing to do is to assign a category to the colliders of your body. | ||
=== Parameters === | === Parameters === | ||
| Line 13: | Line 19: | ||
=== Example === | === Example === | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
| − | local | + | -- R3D: here we define some category BITS (that is those objects can collide) -- 2^15 = MAX |
| − | + | G_BITSOLID = 2^0 | |
| + | G_BITPLAYER = 2^1 | ||
| + | G_BITPLAYERBULLET = 2^2 | ||
| + | G_BITENEMY = 2^3 | ||
| + | G_BITENEMYBULLET = 2^4 | ||
| + | G_BITSENSOR = 2^5 | ||
| + | -- and their appropriate masks (that is what can collide with what) | ||
| + | solidcollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET + G_BITENEMY + G_BITENEMYBULLET | ||
| + | playercollisions = G_BITSOLID + G_BITENEMY + G_BITENEMYBULLET + G_BITSENSOR | ||
| + | playerbulletcollisions = G_BITSOLID + G_BITENEMY + G_BITENEMYBULLET | ||
| + | nmecollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET + G_BITENEMY | ||
| + | nmebulletcollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET | ||
| + | |||
| + | -- ... | ||
| + | local shape1 = r3d.SphereShape.new(h/4) | ||
| + | local shape2 = r3d.SphereShape.new(h/4) | ||
| + | local t1, t2 = Matrix.new(), Matrix.new() | ||
| + | t1:setPosition(0, h/4/2, -d/2) -- position shape1 behind the ship | ||
| + | t2:setPosition(0, h/4/2, d/2) -- in front of the ship | ||
| + | local f1 = viewport.body:createFixture(shape1, t1, 1) -- shape, transform, mass | ||
| + | local f2 = viewport.body:createFixture(shape2, t2, 1) -- shape, transform, mass | ||
| + | |||
| + | f1:setCollisionCategoryBits(G_BITPLAYER) | ||
| + | f2:setCollisionCategoryBits(G_BITPLAYER) | ||
| + | |||
| + | f1:setCollideWithMaskBits(playercollisions) | ||
| + | f2:setCollideWithMaskBits(playercollisions) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{R3d.Fixture}} | {{R3d.Fixture}} | ||
Latest revision as of 01:15, 19 December 2025
Available since: Gideros 2019.10
Class: R3d.Fixture
Description
Sets the fixture category bit.
r3d.Fixture:setCollisionCategoryBits(bits)
Collision filtering
By default all the colliders of the bodies are able to collide with each other in the world. However, sometimes we want a body to collide only with a given group of bodies and not with other bodies. This is called collision filtering. The idea is to group the colliders of bodies into categories. Then we can specify for each collider against which categories of colliders it will be able to collide.
ReactPhysics3D uses bits masks to represent categories. The first thing to do is to assign a category to the colliders of your body.
Parameters
bits: (number) the fixture category bit (power of 2)
Example
-- R3D: here we define some category BITS (that is those objects can collide) -- 2^15 = MAX
G_BITSOLID = 2^0
G_BITPLAYER = 2^1
G_BITPLAYERBULLET = 2^2
G_BITENEMY = 2^3
G_BITENEMYBULLET = 2^4
G_BITSENSOR = 2^5
-- and their appropriate masks (that is what can collide with what)
solidcollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET + G_BITENEMY + G_BITENEMYBULLET
playercollisions = G_BITSOLID + G_BITENEMY + G_BITENEMYBULLET + G_BITSENSOR
playerbulletcollisions = G_BITSOLID + G_BITENEMY + G_BITENEMYBULLET
nmecollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET + G_BITENEMY
nmebulletcollisions = G_BITSOLID + G_BITPLAYER + G_BITPLAYERBULLET
-- ...
local shape1 = r3d.SphereShape.new(h/4)
local shape2 = r3d.SphereShape.new(h/4)
local t1, t2 = Matrix.new(), Matrix.new()
t1:setPosition(0, h/4/2, -d/2) -- position shape1 behind the ship
t2:setPosition(0, h/4/2, d/2) -- in front of the ship
local f1 = viewport.body:createFixture(shape1, t1, 1) -- shape, transform, mass
local f2 = viewport.body:createFixture(shape2, t2, 1) -- shape, transform, mass
f1:setCollisionCategoryBits(G_BITPLAYER)
f2:setCollisionCategoryBits(G_BITPLAYER)
f1:setCollideWithMaskBits(playercollisions)
f2:setCollideWithMaskBits(playercollisions)
