setDrawingEraser: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 7: Line 7:
|usage=
|usage=
<syntaxhighlight lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setDrawingEraser(mapName, drawingId, boolean)
setDrawingEraser(mapRef, drawingId, boolean)
</syntaxhighlight>
</syntaxhighlight>
'''Parameters'''
'''Parameters'''
{{param|mapName|A string containing the name of the map.}}
{{param|mapRef|The Name or ID 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. The easiest way to discover a drawing's Id is via the Draw Explorer interface.}}
{{param|boolean|The value of the setting to set, {{code|true}}({{code|1}}) or {{code|false}}({{code|0}}).}}
{{param|boolean|The value of the setting to set, {{code|true}}({{code|1}}) or {{code|false}}({{code|0}}).}}

Latest revision as of 23:59, 14 March 2023

setDrawingEraser() Function

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

Introduced in version 1.5.0
Sets the eraser setting of the drawing that corresponds to the map and drawing id. If Set to false(0) the drawing will be displayed normally, but if set to true(1) the drawing will erase all below.

Usage

setDrawingEraser(mapRef, drawingId, boolean)

Parameters

  • mapRef - The Name or ID of the map.
  • drawingId - A string containing the id of the drawing. The easiest way to discover a drawing's Id is via the Draw Explorer interface.
  • boolean - The value of the setting to set, true(1) or false(0).

Example

[h:setDrawingEraser("Grasslands", "0000000094218C675800000000000000",0)]
[h:refreshDrawing("Grasslands", "0000000094218C675800000000000000")]
[h:setDrawingEraser("Grasslands", "00000000CCF6B567CC00000000000000",1)]
[h:refreshDrawing("Grasslands", "00000000CCF6B567CC00000000000000")]

See Also