getLights: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 6: Line 6:
* If the delimiter ''"json"'' then a [[JSON Array]] is returned.
* If the delimiter ''"json"'' then a [[JSON Array]] is returned.
* Otherwise a [[Macros:string list{{!}}string list]] is returned with the delimiter passed in.
* Otherwise a [[Macros:string list{{!}}string list]] is returned with the delimiter passed in.
 


|usage=
|usage=

Revision as of 23:25, 2 March 2019

getLights() Function

Introduced in version 1.3b48
Returns a string list containing the names of the light sources that are turned on for the Current Token. The type of the value returned depends on the delimiter parameter.
  • If the delimiter is not specified then a string list is returned with the default value of ',' is used.
  • If the delimiter "json" then a JSON Array is returned.
  • Otherwise a string list is returned with the delimiter passed in.
 

Usage

getLights()
getLights(type)
getLights(type, delim)

Where

  • type is the type of light source (e.g. "Generic" or "D20"). If it is not specified then all light sources that are on for the token are returned.
  • delim is the delimiter used to separate values in the string list. If it is not specified then it defaults to ","

If you want to specify the delimiter but still want to fetch all of the light source types then you can use the special value "*" for type.

Examples

To get a string list of all of the LightSource:light sources that the current token has on.
[getLights()]

To get a string list of the LightSource:light sources that the current token has on with the lighet source type of "Generic".

[getLights("Generic")]

Version Changes

  • 1.3b49 - Added "json" delimiter option.