Difference between revisions of "B2.World:queryAABB"
From GiderosMobile
m (Text replacement - "</source>" to "</syntaxhighlight>") |
|||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| + | <languages /> | ||
'''<translate>Available since</translate>:''' Gideros 2011.6<br/> | '''<translate>Available since</translate>:''' Gideros 2011.6<br/> | ||
'''<translate>Class</translate>:''' [[Special:MyLanguage/b2.World|b2.World]]<br/> | '''<translate>Class</translate>:''' [[Special:MyLanguage/b2.World|b2.World]]<br/> | ||
| + | |||
=== <translate>Description</translate> === | === <translate>Description</translate> === | ||
| − | + | Queries the world for all fixtures that potentially overlap the provided AABB. | |
| − | + | <syntaxhighlight lang="lua"> | |
| − | |||
| − | < | ||
(table) = b2.World:queryAABB(minx,miny,maxx,maxy) | (table) = b2.World:queryAABB(minx,miny,maxx,maxy) | ||
| − | </ | + | </syntaxhighlight> |
| + | |||
=== <translate>Parameters</translate> === | === <translate>Parameters</translate> === | ||
'''minx''': (number) <translate>the minimal x coordinate of the query box</translate> <br/> | '''minx''': (number) <translate>the minimal x coordinate of the query box</translate> <br/> | ||
| Line 14: | Line 15: | ||
'''maxx''': (number) <translate>the maximal x coordinate of the query box</translate> <br/> | '''maxx''': (number) <translate>the maximal x coordinate of the query box</translate> <br/> | ||
'''maxy''': (number) <translate>the maximal y coordinate of the query box</translate> <br/> | '''maxy''': (number) <translate>the maximal y coordinate of the query box</translate> <br/> | ||
| + | |||
=== <translate>Return values</translate> === | === <translate>Return values</translate> === | ||
'''<translate>Returns</translate>''' (table) <translate>Indexed array of fixtures that potentially overlaps the provided AABB</translate><br/> | '''<translate>Returns</translate>''' (table) <translate>Indexed array of fixtures that potentially overlaps the provided AABB</translate><br/> | ||
| + | |||
=== <translate>Examples</translate> === | === <translate>Examples</translate> === | ||
| − | '''Query specific area for bodies''' | + | '''Query specific area for bodies''' |
| − | < | + | <syntaxhighlight lang="lua"> |
| + | --get all fixtures in this area | ||
local fixtures = world:queryAABB(0, 0, 100, 10) | local fixtures = world:queryAABB(0, 0, 100, 10) | ||
--check if there are any fixture | --check if there are any fixture | ||
| Line 26: | Line 30: | ||
local body = fixtures[i]:getBody() | local body = fixtures[i]:getBody() | ||
end | end | ||
| − | end</ | + | end |
| + | </syntaxhighlight> | ||
| + | |||
| + | {{B2.World}} | ||
Latest revision as of 14:27, 13 July 2023
Available since: Gideros 2011.6
Class: b2.World
Description
Queries the world for all fixtures that potentially overlap the provided AABB.
(table) = b2.World:queryAABB(minx,miny,maxx,maxy)
Parameters
minx: (number) the minimal x coordinate of the query box
miny: (number) the minimal y coordinate of the query box
maxx: (number) the maximal x coordinate of the query box
maxy: (number) the maximal y coordinate of the query box
Return values
Returns (table) Indexed array of fixtures that potentially overlaps the provided AABB
Examples
Query specific area for bodies
--get all fixtures in this area
local fixtures = world:queryAABB(0, 0, 100, 10)
--check if there are any fixture
if #fixtures > 0 then
for i = 1, #fixtures do
--getting body of fixture
local body = fixtures[i]:getBody()
end
end
