Exporting to Pirotex

Overview

In order to make a firing script, you need to configure your launch positions with specifications of your firing system. For instructions, please see the Export Overview section. The Pirotex firing system uses modules numbered 1 to 256, each having 32 channels numbered 1 to 32. Each channel links to one or more AKM-10 units having ten pins each. Every attached AKM-10 unit increases the number of pins associated with the channel by 10, e.g., if you have four AKM-10 units attached to channel 17, then channel 17 has 40 pins.

In Finale, the firing system unit address consists of both the module number and the channel number, written in a two-part format, "Module-Channel". For example, the address of module 1, channel 7 is "1-7".

When you add firing system units to launch positions in Finale, you should should set the "description" field to "pirotex" (this is optional), the "address" field to the two-part address (e.g.,"1-7"), the "first pin" field to 1, and the "no. of pins" field to the total number of pins on that channel (e.g., 40 if you have four AKM-10 units on the channel). Set the "matches per pin" field to the maximum number of effects you would like Finale to assign to a single pin, which could be anywhere from 1 (conservative) to dozens (aggressive) depending on your firing system hardware specifications and wiring choices. Once you are ready to export your firing script, click the "File > Export firing script > Pirotex" menu item.

The Pirotex Format

Pirotex scripts consist of a sequence of rows representing firing events. The file is a text file with fields separated by tabs.

In the Pirotex system, the pins on a channel are always fired in sequence, so the pin numbers themselves are actually not required in the script. Each firing instruction contains the time, followed by the module number, channel number, and effect names. It is possible to ignite multiple items with a single pin, so the effect names field contains all of the effect names on that pin, in case they are different. Special characters like double quotes are escaped so you can view the file in Excel (if you change the filename extension to "csv").

Example File

0:00:07.15	10	1	"Red Peony 3"""
0:00:08.15	10	1	"Red Peony 3"""
0:00:09.15	10	1	"Red Peony 3"""
0:00:17.15	10	2	"Red Peony 3"""
0:00:18.15	10	2	"Red Peony 3"""
0:00:19.15	10	2	"Red Peony 3"""
0:00:27.15	10	1	"Red Peony 3"", Red Peony 3"""
0:00:28.15	10	1	"Red Peony 3"", Red Peony 3"""
0:00:29.15	10	1	"Red Peony 3"", Red Peony 3"""
0:00:37.15	10	1	"Blu Peony 3"", Red Peony 3"""
0:00:38.15	10	1	"Blu Peony 3"", Red Peony 3"""
0:00:39.15	10	1	"Blu Peony 3"", Red Peony 3"""

The example above is based on four sequences of three shots separated by one second. The first six shots have a single effect per shot. The second six shots have two effects per shot. Because these particular effect names include a quotation mark character, the name fields have been "escaped" in the standard convention for viewing in Excel, by wrapping the field contents in quotation marks and doubling up any internal quotation marks. The show file for this example, which you can load in Finale, and its corresponding exported script file are available at the following links: