setFillColor: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=setFillColor
|name=setFillColor
|version=1.4.1.9
|version=1.5.0
|trusted=true
|trusted=true
|description=
|description=
Sets the colour or texture of the pen for a specified drawing.
Sets the colour or texture of the pen for a specified drawing.
|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setFillColor(mapName, drawingId, paint)
setFillColor(mapRef, drawingId, paint)
</source>
</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|paint|A string representing the fill colour or fill texture.}}
{{param|paint|A string representing the fill colour or fill texture.}}
|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:setFillColor("Grasslands", "0000000094218C675800000000000000","red")]
[h:setFillColor("Grasslands", "0000000094218C675800000000000000","red")]
[h:setFillColor("Grasslands", "0000000094218C675800000000000000","#ff0000")]
[h:setFillColor("Grasslands", "0000000094218C675800000000000000","#ff0000")]
Line 20: Line 20:
[h:setFillColor("Grasslands", "00000000CCF6B567CC00000000000000","asset://ffff0fe019c241c7456b0ec0b347ef37")]
[h:setFillColor("Grasslands", "00000000CCF6B567CC00000000000000","asset://ffff0fe019c241c7456b0ec0b347ef37")]
[h:refreshDrawing("Grasslands", "00000000CCF6B567CC00000000000000")]
[h:refreshDrawing("Grasslands", "00000000CCF6B567CC00000000000000")]
</source>
</syntaxhighlight>
|also=
|also=
{{func|getFillColor}}
{{func|getFillColor}} {{func|refreshDrawing}}
}}
}}
[[Category:Draw Function]]
[[Category:Draw Function]]

Latest revision as of 23:59, 14 March 2023

setFillColor() Function

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

Introduced in version 1.5.0
Sets the colour or texture of the pen for a specified drawing.

Usage

setFillColor(mapRef, drawingId, paint)

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.
  • paint - A string representing the fill colour or fill texture.

Example

[h:setFillColor("Grasslands", "0000000094218C675800000000000000","red")]
[h:setFillColor("Grasslands", "0000000094218C675800000000000000","#ff0000")]
[h:refreshDrawing("Grasslands", "0000000094218C675800000000000000")]
[h:setFillColor("Grasslands", "00000000CCF6B567CC00000000000000","asset://ffff0fe019c241c7456b0ec0b347ef37")]
[h:refreshDrawing("Grasslands", "00000000CCF6B567CC00000000000000")]

See Also