setBar: Difference between revisions
Jump to navigation
Jump to search
Verisimilar (talk | contribs) m (Macros:Functions:setBar moved to setBar) |
No edit summary |
||
(9 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{MacroFunction | {{MacroFunction | ||
|name=setBar | |name=setBar | ||
|trusted=true | |||
|version=1.3b42 | |||
|description= | |description= | ||
Sets the value of the specified [[Token:bar|bar]] for the [[ | Sets the value of the specified [[Token:bar|bar]] for the [[Current Token]] and makes the bar visible. The value to set is between 0 and 1 for 0% to 100% respectively. | ||
|usage= | |usage= | ||
<source lang="mtmacro" line> | <source lang="mtmacro" line> | ||
setBar(name, pct/100) | |||
setBar(name, pct/100, id) | |||
setBar(name, pct/100, id, mapname) | |||
</source> | </source> | ||
'''Parameters''' | |||
{{param|name|The name of the bar.}} | |||
{{param|value|The value of the bar. Should be between 0 and 1.}} | |||
{{param|id|The token {{code|id}} of the token which has its bar set, defaults to the [[Current Token]]. {{TrustedParameter}} }} | |||
{{param|mapname|The name of the map to find the token. Defaults to the current map.}} | |||
|example= | |example= | ||
<source lang="mtmacro" line> | <source lang="mtmacro" line> | ||
[h: setBar(" | [h: setBar("Health", HP/MaxHP)] | ||
</source> | </source> | ||
|also= | |||
{{func|isBarVisible}}, | |||
{{func|setBarVisible}}, | |||
{{func|getBar}} | |||
|changes= | |||
{{change|1.5.7|Added {{code|id}} and {{code|mapname}} parameter options.}} | |||
}} | }} | ||
==Related Pages== | |||
* [[HP and Health Bars]] | |||
* [[bar.name|The <code>bar.name</code> special variable]] | |||
[[Category:Bar Function]] | [[Category:Bar Function]] |
Revision as of 14:25, 5 November 2019
setBar() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.3b42
Sets the value of the specified bar for the Current Token and makes the bar visible. The value to set is between 0 and 1 for 0% to 100% respectively.
Usage
setBar(name, pct/100)
setBar(name, pct/100, id)
setBar(name, pct/100, id, mapname)
Parameters
name
- The name of the bar.value
- The value of the bar. Should be between 0 and 1.id
- The tokenid
of the token which has its bar set, defaults to the Current Token.Note: This parameter can only be used in a Trusted Macro.
mapname
- The name of the map to find the token. Defaults to the current map.
Example
[h: setBar("Health", HP/MaxHP)]
See Also
Version Changes
- 1.5.7 - Added
id
andmapname
parameter options.