setLight: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
m (Fixing broken wiki links, pointing to Lights and Sights tutorial)
Line 3: Line 3:
|version=1.3b48
|version=1.3b48
|description=
|description=
Sets the [[Map:light source|light source]]s of the [[Token:Current Token|Current Token]]. If the value is {{false}} then the [[Map:light source|light source]] is turned off; otherwise, it is turned on.
Sets the [[Introduction to Lights and Sights|light source]]s of the [[Current Token|Current Token]]. If the value is {{false}} then the [[Introduction to Lights and Sights|light source]] is turned off; otherwise, it is turned on.


|usage=
|usage=
Line 13: Line 13:


'''Parameters'''
'''Parameters'''
{{param|type|The [[LightSource:light source type|light source type]], (e.g. "Generic", "D20").}}
{{param|type|The light source type, (e.g. "Generic", "D20").}}
{{param|name|The name of the [[LightSource:light source|light source]].}}
{{param|name|The name of the [[Introduction to Lights and Sights|light source]].}}
{{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}} }}

Revision as of 02:11, 6 February 2021

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, mapname)

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

  • mapname - The name 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.