Light commands

B (rightness)

name b brightness;


  • brightness is a decimal number between 0 and 1.
  • name is the name of the light to influence, multiple selectors ware allowed

for example:

myLight b 0.5;
myLight1:mylight2 b 0.75;

On / Off

On and off turns the named light on and off, the light returns to its previous brightness setting when turn on.

name on | off;


  • name is the name of the light to influence

for example:

myLight on;
* off;


Colour changes the colour of the light.  The colour is written as a standard llScript vector where the 3 components defined the red, green and blue contributions.

name colour <g,r,b>;


  • name is the name of the light
  • rgb are numbers in the range 0..255

for example:

* colour <255,0,0>; will change all lights to red


Use lets you select the combination of emitters to use.

Emitters are added to a light by linking a suitable prim to the light (suitably centred on the lights local z axis) The name of the emitter is  set in the description field of the linked emitter prim.  The emitter can then be selected and if there is an associated controller for the light the emitter name will be displayed.

use emitter list;

where emitter list is a colon delimited list of available emitters.  The light itself is always called MASTER. If there is ab associated beam then it has the name BEAM and can be selected and deselected using the same mechanism (although it actually emits no light)


Zoom changes the position of the light emitter relative to the target, if th nonyl emitter is the master emitter (i.e. the llamp itself then this command has no obvious output although the zoom position is updated and stored and will be used when necesary)

zoom <percent>

where percent is the pecetnage of the distance between the m lamp and the current target.  0% places the emitter on the lamp and 100% places it on the target, emitters are usually pre adjusted so that a zoom of 80, 90% gives good spotlight behaviour while 20, 30% is more suitable for flood light behaviour.  Zooms can be negative in which case th emitter is placed behind the lamp and greater than 100 in which case the emitter is placed bayond the target.  Zoom has no effect if only the master emitter is selected – the emitter built into the lamp unit.

for example:

/5FS zoom 80;
will set the lights in the FS group to have a zoom setting of 80%

P (osition)

Position allows manual positioning of the lamp target. The position is an x,y,z blue relative to the current stage centre, for example <0,0,1> is a target position 1 m above the stage centre.


Rig will for selected lights to find the location of their associated support and then to move to it and reattach.

name rig;


  • name is the name of the light

for example:

* rig;
will re attach all lights


Track forces a light or set of lights to determine a transponder position and then point at it, the move to the new position uses the current move time and is performed smoothly in conjunction with any other commands (if possible).  If the transponder can’t be found then no move is made and the entire command sequence is aborted.

for example:

* track MYTARGET;
will move all lights to point at the transponder MYTARGET


In general lights are placed in groups. Each group typically will included several lights and each light can be in many groups.  Groups are usually named to reflect the use the group of lights will be put to.  Most of the groups are set up automatically by the controller but you can manually add lights to groups to suit particular requirements.

name group groupName
where the named light or light group or combination is put into the group groupNam. For example

FS1:FS2 group follow;
which will lights FS1 and FS2 (or groups of that those names) into the group follow

Push / Pop

Push will save the site of the light on an internals stack, Pop will restore a saved state.  This now mens that transition can now be run which don’t upset the basic light setup.  For example, a fast transition can be run without upsetting the basic on / off timing.


Auto will automatically enable or disable a light.

Auto on, will disable a light if the lights target falls outside the stage volume (as defined by the Setter)

Auto off will revert the light to full manual control. auto super will also enable or disable a light dependent on it having an active follow target.  If a light hasn’t found its target tracker then the light will safely remain in the disabled (off) state.

In addition on and super allow a transition time between the enabled an disabled states to be set.

For example:

FS auto super 2.0;
will enable full auto mode for light group FS using an enabled/disabled transition time of 2 seconds

Chassis commands

there are a set of commands which can be sent to the lamp chases – the coordinating script for one or more lights.


Delete the light stack


Rebuild the light stack


Force the stack to correctly re attach its various parts


re scan the stack and collect together any wayward beams and emitters


Set allows the setting of several configuration commands:

set beam transparency glow
set the amount of transparency nd glow to use for the beam effect for a chassis

set emitter emitter width
set the width of the beam for specified emitter

set overrange distance
set the distance beyond the target position the light will extend its lighting range to

set falloff distance
set the rate of fall off for the lights

For example

set beam 0.005 0.01;
set emitter hard 3;
set overrange 2;
set falloff 0;


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s