setTokenOpacity: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
(Corrected: Opacity must be a floating point number.) |
||
| Line 2: | Line 2: | ||
|name=setTokenOpacity | |name=setTokenOpacity | ||
|version=1.4.2.0 | |version=1.4.2.0 | ||
|description= | |description=Sets the opacity value of the corresponding token. | ||
|usage= | |usage= | ||
| Line 12: | Line 12: | ||
'''Parameters''' | '''Parameters''' | ||
{{param|value|The value of the opacity to set, ranging from 0 (completely transparent) to | {{param|value|The value of the opacity to set, ranging from 0.0 (completely transparent) to 1.0 (completely opaque). This must be a floating point value with leading zero if less than 1.0.}} | ||
{{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to retrieve the opacity, defaults to the [[Current Token]]. }} | {{param|id|OPTIONAL: The token {{code|id}} of the token for which you want to retrieve the opacity, defaults to the [[Current Token]]. }} | ||
{{param|mapname|OPTIONAL: The name of the map to find the token. Defaults to the current map.}} | {{param|mapname|OPTIONAL: The name of the map to find the token. Defaults to the current map.}} | ||
'''Returns'' | |||
The opacity value that was set. | |||
|example= | |example= | ||
<source lang="mtmacro" line> | <source lang="mtmacro" line> | ||
[h: setTokenOpacity( | [h: setTokenOpacity(0.5, "Dragon")] | ||
[h, token("Dragon"): setTokenOpacity(75)]</source> | [h, token("Dragon"): setTokenOpacity(0.75)] | ||
</source> | |||
|changes={{change|1.5.4|Added {{code|mapname}} parameter option.}} | |changes={{change|1.5.4|Added {{code|mapname}} parameter option.}} | ||
}} | }} | ||
[[Category:VBL Function]] | [[Category:VBL Function]] | ||
Revision as of 00:11, 8 February 2020
setTokenOpacity() Function
• Introduced in version 1.4.2.0
Sets the opacity value of the corresponding token.
Usage
setTokenOpacity(value)
setTokenOpacity(value, id)
setTokenOpacity(value, id, mapname)Parameters
value- The value of the opacity to set, ranging from 0.0 (completely transparent) to 1.0 (completely opaque). This must be a floating point value with leading zero if less than 1.0.id- OPTIONAL: The tokenidof the token for which you want to retrieve the opacity, defaults to the Current Token.mapname- OPTIONAL: The name of the map to find the token. Defaults to the current map.
'Returns The opacity value that was set.
Example
[h: setTokenOpacity(0.5, "Dragon")]
[h, token("Dragon"): setTokenOpacity(0.75)]
Version Changes
- 1.5.4 - Added
mapnameparameter option.