setPenWidth: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created page with "{{MacroFunction |name=setPenWidth |version=1.4.1.9 |trusted=true |description= Sets the line width for a specified drawing. Regardless of the set width, a line will only be vi...")
 
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=setPenWidth
|name=setPenWidth
|version=1.4.1.9
|version=1.5.0
|trusted=true
|trusted=true
|description=
|description=
Line 7: Line 7:
Regardless of the set width, a line will only be visible if it has a visible colour. See setPenColor.
Regardless of the set width, a line will only be visible if it has a visible colour. See setPenColor.
|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
setPenWidth(mapName, drawingId, paint)
setPenWidth(mapRef, drawingId, width)
</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 colour or texture of the pen.}}
{{param|width|A number for the desired line thickness.}}
|examples=
|examples=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:setPenWidth("Grasslands", "0000000094218C675800000000000000",10)]
[h:setPenWidth("Grasslands", "0000000094218C675800000000000000",10)]
[h:setPenWidth("Grasslands", "0000000087318B505800000000000000",120)]
[h:setPenWidth("Grasslands", "0000000087318B505800000000000000",3)]
</source>
</syntaxhighlight>
|also=
|also=
{{func|getPenWidth}} {{func|setPenColor}}
{{func|getPenWidth}} {{func|setPenColor}}
}}
}}
[[Category:Draw Function]]
[[Category:Draw Function]]

Latest revision as of 23:59, 14 March 2023

setPenWidth() Function

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

Introduced in version 1.5.0
Sets the line width for a specified drawing. Regardless of the set width, a line will only be visible if it has a visible colour. See setPenColor.

Usage

setPenWidth(mapRef, drawingId, width)

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.
  • width - A number for the desired line thickness.

Examples

[h:setPenWidth("Grasslands", "0000000094218C675800000000000000",10)]
[h:setPenWidth("Grasslands", "0000000087318B505800000000000000",3)]

See Also