getHalo: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Updated with recent version changes.)
m (Text replacement - "<source" to "<syntaxhighlight")
 
(5 intermediate revisions by 3 users not shown)
Line 5: Line 5:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
getHalo()
getHalo()
</source>
</syntaxhighlight>
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
getHalo(id)
getHalo(id)
</source>
</syntaxhighlight>
'''Parameter'''
'''Parameter'''
{{param|id|The token {{code|id}} of the token which has its halo color returned, defaults to the [[Current Token]]}}
{{param|id|The token {{code|id}} of the token which has its halo color returned, defaults to the [[Current Token]]. {{TrustedParameter}} }}


|example=
|example=
The following example will display the text "Halo Color Text" in the color of the [[Token:halo{{!}}token's halo]].
The following example will display the text "Halo Color Text" in the color of the [[Current Token]]'s [[Halo]].
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
<span style="color:[r: getHalo()]">Halo Color Text</span>
<span style="color:[r: getHalo()]">Halo Color Text</span>
</source>
</syntaxhighlight>
 
|also=
[[Halo]],
[[setHalo|setHalo()]]


|changes=
|changes=

Latest revision as of 18:27, 14 March 2023

getHalo() Function

Introduced in version 1.3b49
Gets the color value of a token's Halo. The value returned is a string that represents the hexadecimal value of the color of the Halo in the format "#RRGGBB" or "None" if the token has no Halo.

Usage

getHalo()
getHalo(id)

Parameter

  • id - The token id of the token which has its halo color returned, defaults to the Current Token.

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

Example

The following example will display the text "Halo Color Text" in the color of the Current Token's Halo.
<span style="color:[r: getHalo()]">Halo Color Text</span>

See Also

Version Changes

  • 1.3b51 - Added id parameter option.