movedOverDrawing: Difference between revisions
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 | {{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)]