getHalo: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(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(tokenRef)
</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|tokenRef|getHalo which has its halo color returned, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{Note|Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.}}


|example=
|example=
The following example will display the text "Halo Color Text" in the color of the [[Current 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 02:59, 13 May 2024

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(tokenRef)

Parameter

  • tokenRef - getHalo which has its halo color returned, defaults to the Current Token.

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

Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.

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.