movedOverDrawing: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:
|trusted=true
|trusted=true
|description=
|description=
Use to check if a given path has crossed through a specified drawing.
Use to check if a given path has crossed through a specified drawing including templates. The easiest way to discover a drawing's Id is via the Draw Explorer interface.


Returns a JSON array with coordinates of all cells in the path that overlap with the area defined by the given drawing.
Returns a JSON array with coordinates of all cells in the path that overlap with the area defined by the given drawing.
Line 13: Line 13:
'''Parameters'''
'''Parameters'''
{{param|mapName|A string containing the name of the map.}}
{{param|mapName|A string containing the name of the map.}}
{{param|drawingId|A string containing the id of the drawing. The easiest way to discover a drawing's Id is via the Draw Explorer interface.}}
{{param|drawingId|A string containing the id of the drawing.}}
{{param|path|JSON array of X/Y coordinate such as that returned by {{func|getLastPath}}}}
{{param|path|JSON array of X/Y coordinate such as that returned by {{func|getLastPath}}}}
|examples=
|examples=

Revision as of 14:25, 8 September 2020

movedOverDrawing() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.5.2
Use to check if a given path has crossed through a specified drawing including templates. The easiest way to discover a drawing's Id is via the Draw Explorer interface. Returns a JSON array with coordinates of all cells in the path that overlap with the area defined by the given drawing.

Usage

getDrawingInfo(mapName, drawingId, path)

Parameters

  • mapName - A string containing the name of the map.
  • drawingId - A string containing the id of the drawing.
  • path - JSON array of X/Y coordinate such as that returned by getLastPath()

Examples

[h: lp = getLastPath()]
[h: id = findDrawings(getCurrentMapName(),"fig1")] 
[r: movedOverDrawing(getCurrentMapName(),id,lp)]

See Also