19.13.3 segmentQuery

physics.Space:segmentQuery(startvect, stopvect, layers, group,

Parameter

Type

Description

self

in physics.Shape

The input Shape

startvect

in physics.Vect

An end point of the segment

stopvect

in physics.Vect

Other end point of the segment

layers

in number

A bitmap of the layers.
Match if shape.layers inter- sects layers

group

in number

The group number to check.
Match if object is not in group

function

function(shape, t, normal)

A function to call providing each Shape in turn that matches the criteria

Queries the Space for all Shapes that intersect the line segment from startvect to stopvect and match layers and not in group. The function is called with each matching Shape. Sensor Shapes are included.

The callback function is called with each Shape, proportion of distance along the line segment (a fraction from 0 to 1), and the surface normal vector of the intersection point of the Shape.

Introduced in platform.apiLevel = '2.0'