Difference between revisions of "Fixture:setMask"

m
 
Line 1: Line 1:
 
{{newin|[[0.8.0]]|080|type=method}}
 
{{newin|[[0.8.0]]|080|type=method}}
 
{{notice|Fixture:setMask works in '''NOT''' Categories selected will '''NOT''' collide with this fixture. If you want to work as Box2d works with Mask use instead [[Fixture:setFilterData]]}}
 
  
 
Sets the category masks of the fixture. There can be up to 16 categories represented as a number from 1 to 16.
 
Sets the category masks of the fixture. There can be up to 16 categories represented as a number from 1 to 16.

Latest revision as of 22:52, 1 December 2023

Available since LÖVE 0.8.0
This method is not supported in earlier versions.


Sets the category masks of the fixture. There can be up to 16 categories represented as a number from 1 to 16.

This fixture will NOT collide with the fixtures that are in the selected categories if the other fixture also has a category of this fixture selected.

Calling this function with no arguments will make the fixture have no masks.

Function

Synopsis

Fixture:setMask( mask1, mask2, ... )

Arguments

number mask1
The first category.
number mask2
The second category.
number ...
Additional categories.

Returns

Nothing.

Examples

Body.fixture:setCategory(1)
Body.fixture:setMask(1)               -- this fixture is in category 1 and will not physically collide with other fixtures in category 1

See Also


Other Languages