Software Documentation

Software Documentation


Intermediate Last updated: September 30, 2019

8 Variable tube size racks with row length constraint

Some types of racks that hold variable size tubes are limited by the length of the rack: bigger tubes take up more space than smaller tubes, and there’s only so much space. Single-shot racks with tracks for single-shot tubes to slide into, like the PyroLamas rack below, are an example.

Figure 1 – PyroLamas rack with fixed length rows capable of holding variable size tubes


The rack layout function “Racks > Add racks for show” and the addressing functions can take into account a rack length constraint when determining how many racks are required for the effects in the show.  To set up a rack length constraint, do “Racks > Create rack” and configure the rack with,

  1. “Max. usable length per row” set to the length of the row
  2. “Number of tubes” per row set to the maximum number of tubes per row
  3. “Fits any size” set to true

The usable length is consumed by the tubes assigned to the row according to their size.  Obviously the outer diameter is the right measure of space taken by the tube, but the size the effect in the tube, which is typically closer to the inner diameter of the tube, is the measure used for the calculation, so you may wish to make the length limit slightly smaller than the actual row length in order to compensate for the difference and any other buffer space you want to allow between the tubes.


Figure 2 – Configuring a rack with a length limit of 250mm per row


The figure below shows an example with two racks, each having two rows of maximum five tubes, with a length limit of 250mm.  The effects assigned to the racks are 60mm effects, so four tubes can fit within the length limitation, but not five.

In this example, the first rack illustrates that it doesn’t matter which four tubes are assigned effects, so long as there aren’t more than four.  The second rack illustrates what happens if you manually assign too many effects to a row — one of the pin numbers will turn red to indicate an error.


Figure 3 – Only four 60mm tubes fit in 250mm; the fifth is red