getHalo: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<source" to "<syntaxhighlight")
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{MacroFunction
{{MacroFunction
|name=getHalo
|name=getHalo
|description=Gets the value of the specified [[Token:halo{{!}}halo]] for the [[Token:Current Token{{!}}Current Token]]. The value returned is a string that represents the hexadecimal value of the color of the halo in the format #''RRGGBB'' or "None" if there is no [[Token:halo{{!}}halo]].
|version=1.3b49
|description=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 {{code|"#RRGGBB"}} or {{code|"None"}} if the token has no [[Halo]].


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: color = getHalo()]
getHalo()
</source>
</syntaxhighlight>
<syntaxhighlight lang="mtmacro" line>
getHalo(id)
</syntaxhighlight>
'''Parameter'''
{{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=
{{change|1.3b51|Added {{code|id}} parameter option.}}
}}
}}
[[Category:Token Function]]
[[Category:Token Function]]

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.