Initial Setup and Configuration

Configuration is defined using the titles of notecards in each light's object Contents. The notecard title starts with a keyword in upper case followed by an option. Some notecards are not needed by some light types, but if you include them they will be ignored so you can't make a mistake.

  1. Start by rezzing and positioning one of the lights. Decide if this is to be a single light or one of a group you want to turn on/off as a group

    If this is to be a single light, go to step 4

  2. Rezz additional lights to be in the same group and position them.
  3. Add a "SWITCH_GROUP" to each of the lights to turn on/off at the same time.

    Such as "SWITCH_GROUP Outside" or "SWITCH_GROUP Living Room"

    Now all lights in the same Switch Group will turn on and off together

  4. If you are using a number of the same type of light, such as a number of path lights, you can speed up your setup, by defining a Configuration Group. This will allow you to configure one of the lights as a master and have that light send the common configuration to all other lights in the Configuration Group. If you don't need this, go to step 6.
  5. Choose one of the group to be the Master light that will contain the configuration information.
    1. Add the CONFIG_MASTER notecard to this light.
    2. Add a CONFIG_GROUP group name notecard to all of the lights
    3. Edit the CONFIG_GROUP notecard title in each light and change CONFIG_GROUP group name " to the name of the light group.
      Such as "CONFIG_GROUP Path", or "CONFIG_GROUP Living Room"
    4. Now add configuration notecards to the Master Light as needed.
      • COLOR color
      • RADIUS distance
      • SIZE scale_factor
    5. Changes to the configuration will be sent to each of the other lights.
  6. Option Notecards
    Note:

    If many of your lights are going to have the same configuration, you can use Configuration Groups so you only need to put these notecards in the CONFIG_MASTER light.

    But you can over-ride the CONFIG_MASTER configuration values by putting these notecards in individual lights.

    COLOR color
    The color of the light can be
    • Daylight - slightly bluish white
    • Neutral White
    • Soft White - Warmer color typically used for homes
    • Red
    • Green
    • Blue
    • Yellow
    RADIUS distance
    This is how far in meters the light will travel (from 0.1 to 20). There is slight fall off in intensity to soften the edges. This setting will also affect the brightness of the light on objects.

    for example: RADIUS 4.5 or RADIUS 10

    SIZE scaling_factor
    This is a value greater than 0.1 that controls the size of the light fixture. 1.0 is the default size.
    SWITCH_GROUP name
    Include this notecard in each light in a group that is to be turned on/off at the same time.
    CONFIG_GROUP name
    Include this notecard in each light in a group that is to receive its configuration from the CONFIG_MASTER light.
    CONFIG_MASTER
    If you are using the CONFIG_GROUP notecard, include a CONFIG_MASTER notecard in ONE of the lights. You can then put all of the configuration notecards (for the whole group), in this master light's contents. This master will then send its configuration to all other lights in the configuration group.
    TYPE type
    This notecard is only used by Pendant Lights.
    • TYPE GP - General Purpose - throws light in all directions
    • TYPE GPNC - A General Purpose light but with no light above the light so the ceiling is dark. Like a lamp with a solid shade that only allows light down and to the sides
    • TYPE DOWN - Down lights are spot lights that project a circular spot on the floor If you choose this TYPE, you will also need a SPOT notecard.
    SPOT Spot angle
    This notecard is only used by Pendant Lights (when configured as "TYPE DOWN"), and Can Lights.

    This determines how wide the angle of the spot projection is. But you can think of it as the size of the spot on the floor. It can be between 0.1 and 3.0

    FIXTURE_COLOR color
    The color to be applied to the fixture. If the fixture has a build-in in color or texture, this will modify it.
    • White - Reveals the default color of the fixture
    • Black
    • Silver
    • Copper
    • Gold
    INSTANCE some name
    This notecard is only needed if you own more than one building or parcel in a region, AND you will be using Switch or Configuration Groups. The INSTANCE notecard will separate the messaging between lights in these different areas.


    Temporary Adjustments

    When you touch a light a menu will allow you to select an adjustment menu for Size, Radius or Spot size. These adjustments allow you to quickly experiment and decide what the best notecard values are for these settings. You can then put those values into the notecards.

    Any values placed in the notecards of the designated MASTER light are sent to all other lights in the group. But if you want specific lights to have their own settings, just add a notecard for that value to that specific light and it will override the values from the Master Light.