setDrawingLayer: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created page with "{{MacroFunction |name=setDrawingLayer |version=1.4.1.7 |trusted=true |description= For a specified drawing, set the layer of the map to which the drawing belongs. The Map L...")
 
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 6: Line 6:
For a specified drawing, set the layer of the map to which the drawing belongs.
For a specified drawing, set the layer of the map to which the drawing belongs.


The [[Map Layer]] is one of:
The [[Introduction to Mapping#introduction to Mapping|Map Layer]] is one of:
* {{code|TOKEN}}
* {{code|TOKEN}}
* {{code|GM}} also known as Hidden
* {{code|GM}} also known as Hidden
* {{code|OBJECT}}
* {{code|OBJECT}}
* {{code|BACKGROUND}}
* {{code|BACKGROUND}}
 
|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setDrawingLayer(mapName, drawingId, layer)
setDrawingLayer(mapName, drawingId, layer)
</source>
</syntaxhighlight>
'''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. The easiest way to discover a drawing's Id is via the Draw Explorer interface.}}
{{param|layer|The layer to move the drawing to.}}
{{param|layer|The layer to move the drawing to.}}
|examples=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[r:setDrawingLayer("Grasslands", "0000000074836E675D00000000000000","GM")]
[h:setDrawingLayer("Grasslands", "0000000074836E675D00000000000000","GM")]
</source>
[h:refreshDrawing("Grasslands", "0000000074836E675D00000000000000")]
</syntaxhighlight>
|also=
|also=
{}}}
{{func|getDrawingLayer}} {{func|refreshDrawing}}
}}
[[Category:Draw Function]]
[[Category:Draw Function]]

Latest revision as of 21:04, 14 March 2023

setDrawingLayer() Function

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

Introduced in version 1.4.1.7
For a specified drawing, set the layer of the map to which the drawing belongs.

The Map Layer is one of:

  • TOKEN
  • GM also known as Hidden
  • OBJECT
  • BACKGROUND
 

Usage

setDrawingLayer(mapName, drawingId, layer)

Parameters

  • mapName - A string containing the name 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.
  • layer - The layer to move the drawing to.

Example

[h:setDrawingLayer("Grasslands", "0000000074836E675D00000000000000","GM")]
[h:refreshDrawing("Grasslands", "0000000074836E675D00000000000000")]

See Also