Type any phrase to search documentation

Software Documentation

Exporting a firing system scriptDocumentation

IntegrationIntermediateLast updated: October 4, 2019

29 Megafire

To create and export a script for the Megafire firing system, please follow these steps:

  1. Address the show (“Addressing > Address show”).
  2. Export the script (“File > Export > Export firing scripts“).

Step 2 creates the script file, which has the “CSV” extension. The file format details are described in this section.

 

Figure 1 – Megafire firing system

 

Table 1 – File format and encoding

File formatExtensionText encodingField delimiterEnd-of-line
Text.CSVUTF-8semicolonCRLF

The script contains rows for the firing events, i.e., unique combinations of module, pin, and ignition-time. Multiple effects can be combined on a single cue. The special characteristics of the script are shown in the following table:

 

Table 2 – Special characteristics

Special characteristicsDescription
Sort order of rowsRows sorted ascending by event time.
What rows representEach row represents a unique firing event, a module/pin/event-time combination. For example, a chain of five shells will be one row, not five. A pair of shells shot together from the same position will be one row, not two, even if the shells are different effects. A flight of shells shot together from multiple positions with the same module-pin using scab wire is still one row.
HeaderThe header file, in Brazilian Portuguese, indicates the meaning of the columns.
Time resolutionThe Megafire system supports millisecond resolution.
Special charactersThe CSV file allows all UTF-8 characters except semicolon and control characters like linefeed and tab, which are filtered out. There is no escaping or quoting facility.

Each row in the script has a number of fields separated by the tab character. The names of the fields and their descriptions are the following:

Table 3 – Specifications of script fields

Field nameDescription
SequênciaCue number, starting with 1. Every row is a unique event time / module / pin combination, so every row is a unique cue. The cue numbers thus increment sequentially. If multiple effects are on the same cue, their effect names are combined in the effect name and size column (see below).
Tempo de igniçãoTime of ignition in seconds with three digits of fraction.
Duração do efeitoDuration of the effect in seconds with three digits of fraction.
Tempo para disparoPrefire of the effect in seconds with three digits of fraction.
Artefato e calibreEffect name and size. If the cue represents multiple effects, the description begins with the number of effects in parentheses, continues with the first effect name, and ends with elipsis (…) as an indication the row represents more than is being displayed in this single field.
Nome da posiçãoPosition name.
DireçãoAngle or angles of the shells in the cue, drawn in ASCII art, like \|/.
DistribuidorModule number, starting with 1.
CanalPin number, starting with 1.
ID do artefatoPart number.
Preço do artefatoPrice per device.

An example script containing twelve (12) shells across nine (9) firing rows is shown in Figure 1 and included for download in Table 4.

Sequência;Tempo de ignição;Duração do efeito;Tempo para disparo;Artefato e calibre;Nome da posição;Direção;Distribuidor;Canal;ID do artefato;Preço do artefato
1;2.760;1.020;2.240;White Chrysanthemum 2";Pos-01;|;1;1;G2SH1001;1.45
2;2.860;1.020;2.240;White Chrysanthemum 2";Pos-02;|;2;1;G2SH1001;1.45
3;2.960;1.020;2.240;White Chrysanthemum 2";Pos-03;|;3;1;G2SH1001;1.45
4;3.060;1.020;2.240;White Chrysanthemum 2";Pos-04;|;4;1;G2SH1001;1.45
5;3.160;1.020;2.240;White Chrysanthemum 2";Pos-05;|;5;1;G2SH1001;1.45
6;3.260;1.020;2.240;White Chrysanthemum 2";Pos-06;|;6;1;G2SH1001;1.45
7;3.360;1.020;2.240;White Chrysanthemum 2";Pos-07;|;7;1;G2SH1001;1.45
8;3.460;1.020;2.240;White Chrysanthemum 2";Pos-08;|;8;1;G2SH1001;1.45
9;3.560;1.020;2.240;White Chrysanthemum 2";Pos-09;|;9;1;G2SH1001;1.45
10;11.446;1.110;0.000;Green Mine 2";Pos-04;\;4;2;G2XX1018;1.45
11;11.446;1.110;0.000;Green Mine 2";Pos-05;|;5;2;G2XX1018;1.45
12;11.446;1.110;0.000;Green Mine 2";Pos-06;/;6;2;G2XX1018;1.45

Figure 1 – Example Megafire script

 

Table 4 – Example files

Download linkExplanation
test_megafire.fixExample show file
test_megafire.csvExample exported file (TXT)