setLight: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 9: Line 9:
setLight(type, name, value)
setLight(type, name, value)
setLight(type, name, value, id)
setLight(type, name, value, id)
setLight(type, name, value, id, mapname)
setLight(type, name, value, id, mapRef)
</syntaxhighlight>
</syntaxhighlight>


Line 17: Line 17:
{{param|value|If {{true}} sets the light on, if {{false}} turns it off.}}
{{param|value|If {{true}} sets the light on, if {{false}} turns it off.}}
{{param|id|The token {{code|id}} of the token to change the light sources, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|id|The token {{code|id}} of the token to change the light sources, defaults to the [[Current Token]]. {{TrustedParameter}} }}
{{param|mapname|The name of the map to find the token.  Defaults to the current map.}}
{{param|mapRef|The Name or ID of the map to find the token.  Defaults to the current map.}}


|example=
|example=
Line 29: Line 29:
}}
}}
[[Category:Light Function]]
[[Category:Light Function]]
[[Category:Token Function]]

Latest revision as of 23:59, 22 August 2023

setLight() Function

Introduced in version 1.3b48
Sets the light sources of the Current Token. If the value is false(0) then the light source is turned off; otherwise, it is turned on.

Usage

setLight(type, name, value)
setLight(type, name, value, id)
setLight(type, name, value, id, mapRef)

Parameters

  • type - The light source type, (e.g. "Generic", "D20").
  • name - The name of the light source.
  • value - If true(1) sets the light on, if false(0) turns it off.
  • id - The token id of the token to change the light sources, defaults to the Current Token.

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

  • mapRef - The Name or ID of the map to find the token. Defaults to the current map.

Example

[h: setLight("D20", "Candle - 5", 1)]


Version Changes

  • 1.5.4 - Added id and mapname parameter options.