Prop Definition

Top  Previous  Next

A prop in the Sequencer allows you to define a single item that is in your display. This item could be simple, like a string of lights, or a wreath; or it could be complex, like a pixel tree or matrix. For every prop, you assign it a name and then define the type of lights that it uses, its shape, and its assigned channel(s).







Each prop must have a name. The name must be unique within the preview.





This is an optional field for you to make notes about this prop.



Lights Section


Use this section to define the types of lights your prop consists of.


Dimming Curve


Some controllers have the ability to apply dimming curves in the hardware. This setting allows you to apply a dimming curve in software, for controllers that do not have the capability or where that capability is disabled. You do not want to have dimming curves enabled in both software and in the controller.


Use the Linear Curves for traditional lights. The percentage at the end of the curve name indicates the maximum brightness.

Use the Pixel Curves for RGB pixels. The percentage at the end of the curve name indicates the maximum brightness.

Use the Strobe Curve for strobes. It will prevent intermediate values (e.g. 50%) from reaching the string.




Choose the “Traditional” tab of the Lights section of the Prop Definition window to model:

strings of LEDs or incandescent lights (single color or multicolor)

strobe lights

wire frames

rope lights

net lights

single-color flood lights


Colors for your string are defined on the left. Click the “Custom” button to choose a custom color. By default, the custom color is close to an incandescent warm white bulb; however, you can change the default custom color by selecting "New prop defaults" from the Design Tab's Options Menu.




Set the “Type” drop-down as follows:


Select “Multicolor string 1 ch” for single color strings or single color flood lights or a single string with various light colors. Choose the colors that make up the string.


Choose “Channel per color” for bundles of single color strings (sometimes referred to as "superstrings"). Select color(s) for the strings on the left. For each color you choose, that color will show up in the “Order” list on the right. The Sequencer will assign one channel for each color that you choose. If the channels for these strings are numbered consecutively, it is recommended that you use the up and down arrows on the right-hand side to put the colors in the order that their channels are assigned (click on a color to select it, then use the arrow buttons to move it into the correct position). This way, the channels will be assigned correctly without any additional action.





Choose "RGB Pixels" for Light-O-Rama Cosmic Color Devices and any other pixel-based strips, nodes, bulbs, or panels.


Use the "Motion Effects Rows" button to define default motion effect rows that will be incorporated into new sequences (this setting has no effect on existing sequences). The number in parentheses on the button reflects the number of default motion effect rows that have already been defined for the prop. The dialog for adding default motion rows to a prop works just the same way as the dialog for adding motion effect rows to an existing sequence. See the Motion Effect Rows Dialog topic for more information.


Choose "Dumb RGB (3 channel)" for display elements that have a single red, green, and blue channel. This includes RGB floods and dumb RGB strips and nodes.


The channel order should be set to reflect the way the red, green, and blue channels are physically wired. If you are unsure, this may take some experimentation. This setting applies to both RGB Pixels and Dumb RGB.



Shapes Section


Use this section to define how your prop looks on your computer screen during sequence playback. Defining the shape accurately is also very important for pixel-based props so that motion effects get displayed correctly.




In the Prop Definition window, choose a shape that most closely matches your prop. Use "Lines-Connected", "Lines-Unconnected", "Lines-Closed Shape", or "Custom" to define a shape that isn't listed. Any shape can be resized and rotated, so you are not limited to the traditional orientation of the shape.


The description of the numerical entries in the middle of the shape section will change depending on the shape that is selected and type of lights (traditional, RGB pixels, or dumb RGB). Many shapes will require you to specify the number of lights in the prop (or in a section of the prop). For props with traditional or dumb RGB lights, this number can be an approximation -- set it to a value that looks good on your computer screen. For RGB pixels, the value must be the exact number of physical pixels.


At the bottom will be diagram of your shape primarily intended to show channel number orientation for props with multiple channels.



Channels Section


In the right-most section of the window you define the channels assigned to the prop. This section should be filled in last because the entries will change automatically based on the values you enter in the “Lights” and “Shape” sections. Take care to enter this information accurately, or your lights will not come on.


The Channels section (LOR device type)

The Channels section (LOR device type)


The Channels section (DMX device type)

The Channels section (DMX device type)


Uses The Same Channels As


Normally, you can leave this field set to "<none>". However, if you connect more than one set of lights to the same channel, then you can create a "Master prop" and one or more "sub props" to model this configuration. For example, if you have several candy canes that are all connected to the same channel and turn on and off together, then you can create one candy cane as the Master Prop. The master candy cane will have the "Uses The Same Channels As" field set to "<none>" and it will appear in the sequence grid (as an example, assume this prop is named "Candy cane master"). The other candy canes will be "sub props" --  the "Uses The Same Channels As" field will be set to "Candy cane master" and the props will not appear in the sequence grid. In the Prop Definition for each of the sub-props, the channel section most specify one or more channels from the master prop.


Should you change the channel(s) assigned to the master prop, it is up to you to also update the related sub-props. If you fail to keep them synchronized, you will get a warning on the Other Warnings tab in Preview Design.


Device Type


Select the device type from the drop-down that matches your hardware.


Use "LOR" for Light-O-Rama controllers using the Light-O-Rama protocol (or enhanced protocol). Note that the PixCon16 controller can use the Light-O-Rama protocol or E1.31 (DMX) protocol -- so your Device Type selection on the Prop Definition screen needs to match the way you have configured the controller..

Select “DMX” for controllers that connect via the E1.31 protocol over Ethernet or connect via a DMX USB adapter..

A device type of “Undetermined” is available for situations where the device type is not known. With this device type, lighting effects will be displayed during playback on the computer screen, but the prop cannot control real lights.


Max Circuit (or DMX Channel)


The number box at the top right defines how many channels are in each DMX universe or the maximum circuit number if LOR is selected. For DMX, you can leave this at the default value of 512, unless you have a controllers that does not allow an RGB pixel to cross universe boundaries. In this case, set the DMX universe size to 510 (170 pixels per universe).


Channel Numbering


There are 2 options for channel numbering:


Enter channel on first row, auto-number the rest: with this option, you must enter channel information for the first string only. Subsequent strings will be calculated automatically. This works well for many situations, but there are exceptions. For those exceptions you should use the second option.


This prop uses 4 consecutive channels

This prop uses 4 consecutive channels


Enter a channel on every row: with this option, you enter channel information for every string.


This prop uses 2 channels on controller 05 and 2 channels on controller 06

This prop uses 2 channels on controller 05 and 2 channels on controller 06


Separate Unit ID (or DMX Universe) for each RGB String


This check box will cause each string to start at circuit 1 of the subsequent Unit ID (or DMX Universe) from the previous row. If this box is unchecked, then each row starts from the last Unit ID and circuit from the previous row.


Channel Grid


It is very important that the values you enter in the channel grid match your controller settings. The values you enter depend on the device type that was selected:


For LOR: enter the network (Regular, Aux A, etc), Unit ID as a hexadecimal value (01 to F0), and the circuit (between 1 and the Max Circuit)

For DMX: enter the universe number (1 to 999) and channel (between 1 and the Max Circuit)

For Undetermined: there is nothing to enter