Extensions Test Point

boolean object.testPoint ( number x, number y, [number layer [, number xoff [, number yoff] ] ] )

Tests if the object is currently overlapping a specific point in the frame.

If a layer is specified, the test is limited to instances on that layer.  By default, layer is equal to mmf.ANY_LAYER.  If the xoff or yoff parameters are specified, the test is made as if the object had first been moved by those amounts (but without actually moving the object).

Parameters

x X coordinate in the frame
y Y coordinate in the frame
layer Optional.  1-based layer index, or constants mmf.ANY_LAYER, mmf.SAME_LAYER, or mmf.DIFF_LAYER 
xoff Optional.  X coordinate offset to shift object before making the test
yoff Optional.  Y coordinate offset to shift object before making the test

Return Values

boolean true if object is overlapping the specified point, false otherwise

Example

-- Assume we have a goomba object
-- If goomba tries to walk off the edge of the frame, turn around
if (goomba.testPoint(mmf.frame.xRight, goomba.yBottom - 8)) then
  goomba.x = goomba.x - 1
  goomba.direction = mmf.DIR_W
end

Copyright 2010 Justin Aquadro