token.halo: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(New page: The variable ''token.halo'' allows programmatic querying and setting of the token's '''Halo''', a colored border that, if set, appears around the token. In the image below, the yellow bord...)
 
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 6: Line 6:


===Getting the Token Halo Color===
===Getting the Token Halo Color===
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
Halo color: [token.halo]
Halo color: [token.halo]
</source>
</syntaxhighlight>


Outputs the hexadecimal value for the token halo color. In the case of the example image above, it would output ''#ffff00''.  
Outputs the hexadecimal value for the token halo color. In the case of the example image above, it would output ''#ffff00''.  


===Setting the Token Halo Color===
===Setting the Token Halo Color===
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:token.halo = "red"]
[h:token.halo = "red"]
</source>
</syntaxhighlight>


or
or


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h:token.halo = #ff0000]
[h:token.halo = #ff0000]
</source>
</syntaxhighlight>


Sets the color of the token.halo to red (or the hexadecimal value ''#ff0000'').  
Sets the color of the token.halo to red (or the hexadecimal value ''#ff0000'').
 
===Removing the Token Halo===
 
<syntaxhighlight lang="mtmacro" line>
[h:token.halo="None"]
</syntaxhighlight>


===Color Names and Standard Colors===
===Color Names and Standard Colors===
Line 42: Line 48:


The variable will also accept any hexadecimal color value. Hexadecimal color values do not need to be enclosed in quotes.
The variable will also accept any hexadecimal color value. Hexadecimal color values do not need to be enclosed in quotes.
[[Category:Special Variable]]
[[Category:Macro Function]]

Latest revision as of 23:59, 4 July 2023

The variable token.halo allows programmatic querying and setting of the token's Halo, a colored border that, if set, appears around the token. In the image below, the yellow border around the token is the token's halo.

Examples

Getting the Token Halo Color

Halo color: [token.halo]

Outputs the hexadecimal value for the token halo color. In the case of the example image above, it would output #ffff00.

Setting the Token Halo Color

[h:token.halo = "red"]

or

[h:token.halo = #ff0000]

Sets the color of the token.halo to red (or the hexadecimal value #ff0000).

Removing the Token Halo

[h:token.halo="None"]

Color Names and Standard Colors

The token.halo variable accepts the following named colors (if using a named color, enclose the value in quotes):

  • Black
  • Green
  • Yellow
  • Orange
  • Red
  • Blue
  • Cyan
  • DarkGray
  • Magenta
  • Pink
  • White

The variable will also accept any hexadecimal color value. Hexadecimal color values do not need to be enclosed in quotes.