token.halo: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| (6 intermediate revisions by 3 users not shown) | |||
| Line 6: | Line 6: | ||
===Getting the Token Halo Color=== | ===Getting the Token Halo Color=== | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
Halo color: [token.halo] | Halo color: [token.halo] | ||
</ | </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=== | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:token.halo = "red"] | [h:token.halo = "red"] | ||
</ | </syntaxhighlight> | ||
or | or | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:token.halo = #ff0000] | [h:token.halo = #ff0000] | ||
</ | </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''). | ||
| Line 27: | Line 27: | ||
===Removing the Token Halo=== | ===Removing the Token Halo=== | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h:token.halo="None"] | [h:token.halo="None"] | ||
</ | </syntaxhighlight> | ||
===Color Names and Standard Colors=== | ===Color Names and Standard Colors=== | ||
| Line 48: | 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.