🇬🇧

Documentation

Glossary

Command Line: Enter Commands in the Desktop App and Web App Editor#

The Command Line is the input field above the information bar at the bottom of the desktop app and Web App Editor. You can use it to select objects, change properties on multiple objects, or import and export templates as local JSON files. The input field is not shown in the iOS app or in the Web App's mobile layout.

  1. Open a drawing and select the objects you want to change with SET. In the edit mode for an object definition, SET can also use the object being edited when nothing is selected.
  2. Click the Command Line, enter a command, and press Enter.
  3. Check the selection or changed values in Object Properties. After a command, the input field briefly flashes green or red. This feedback is unreliable for some SET variants: it may flash red even when a change was made. Check the result on the object. Use Up Arrow and Down Arrow to recall previously entered commands.

Enlarged current component view of the empty Command Line input field

When empty, the input field is difficult to distinguish from the white workspace. Click the narrow line directly above the information bar to enter a command.

The examples use internal property names, such as DmxAddress1. You can see which properties an object has in Object Properties. Command names are not case-sensitive. Use quotation marks for property names, group names, or values that contain spaces.

Set and Distribute Properties#

CommandDescriptionExample
SET Parametername ValueSets the property of all selected objects to the same value.Set FixtureId 101
SET Parametername + IncreasevalueIncreases the existing numeric property value of each selected object by the entered amount.Set DmxAddress1 + 52
SET Parametername Startvalue +Sets the starting value on the first selected object and increases it by 1 for each subsequent object. For DMX addresses, it uses each fixture's footprint instead.Set DmxAddress1 100 +
SET Parametername Startvalue + IncreasevalueSets the starting value on the first selected object and increases it by the specified increment for each subsequent object.Set DmxAddress1 100 + 52
SET Parametername < ValueDistributes numeric values from the existing value on the last selected object to the entered value on the first selected object. Requires at least two objects.Set X < 10
SET Parametername > ValueDistributes numeric values from the existing value on the first selected object to the entered value on the last selected object. Requires at least two objects.Set X > 2
SET Parametername Startvalue thru EndvalueDistributes numeric values evenly from the starting value to the end value across at least two selected objects. to is not recognized as a range operator.Set Z 1 thru 10
SET Parametername First Value / Second ValueAlternates between the first and second value for the selected objects.Set X 5 / 10

For numeric distributions, the order of the selected objects matters. For DmxAddress1 through DmxAddress4, SET *Startvalue* + uses each fixture's footprint instead of an increment of 1. With SET *Startvalue* + *Increasevalue*, specify a fixed increment.

Properties within a list, such as connections or beam properties, also require a list name and an index:

CommandDescriptionExample
SET (array-name index value-name) valueSets a property in the object-list entry at the specified index. The entry must already exist on the selected object; indexing starts at 0.Set (CountDefinition 0 Inv_CountSpare) 3

Examples of array properties. The entries and values actually available depend on the selected object and its existing connections, supports, or beams:

Array NameValue Name
LinkedDepartmentsObjectsName
ElectricalConnectionsConnectorName, ConnectionName, Consumption, LinkedGenerator, LinkedGeneratorAssemblyGroup, LinkedFuse, LinkedFuseAssemblyGroup, AttachedCableLength
CountDefinitionInv_CountSpare (reserve quantity for an existing inventory entry)
SupportPropertiesName, BridleSet, RopeCrossSection, Capacity, ResistanceX, ResistanceY, ResistanceZ, ResistanceXX, ResistanceYY, ResistanceZZ, ReactionForceX, ReactionForceY, ReactionForceZ, ReactionForceXX, ReactionForceYY, ReactionForceZZ, ReactionForce, HookForce, RopeOffset
BeamPropertiesBeamAngle, FieldAngle, LampRotation, FrameSizeX, FrameSizeY, Dimmer, GelManufacturer, GelName, CurrentGoboObject, LightColor

For two-, three-, and four-leg bridles, a SET command for SupportProperties BridleSet or RopeCrossSection applies to all legs, including the drop, regardless of the selected index. Changing the set removes the existing part assignments for all legs and the fixed rope specification; changing the cross section retains the parts. Basket dimensions and other support properties remain separate for each leg.

For BeamProperties LightColor, enter the target value as a CIE color in the format (x; y; L_Y).

The Inventory worksheet uses the internal SetInventory command for editable quantity fields. Change Reserve Quantity and Total Booked directly in the inventory list; the table creates the appropriate command based on the selected resource. Inventory in the Worksheets overview explains the process and grouping used to ensure a unique resource.


Select Objects#

CommandDescriptionExample
SELECT StartID - EndID; SELECT StartID ... EndID; SELECT StartID thru EndIDSelects objects with consecutive numeric IDs from the start value through the end value. Add spaces around ... and thru; to is not evaluated by SELECT.Select 101-115; Select 101 ... 105; Select 101 thru 105
SELECT ID + IDSelects the individual objects with the specified IDs.Select 101+105
SELECTGROUP Selection group nameSelects the objects in the selection group with this name.Selectgroup Fronttruss

SELECT adds matching objects to the selection. Outside edit mode, it uses the displayed object ID. In edit mode, a numeric ID corresponds to the object's index in the edited container, starting at 0.

Exchange Templates as Local JSON Files#

IMPORT and EXPORT use the file <full drawing path>.json. Save the drawing first so its file path is set. EXPORT rewrites the file each time it is run; back up an existing JSON file before exporting again. Specify one template type when exporting. Without a type, the rewritten export file contains no templates. Specify a type when importing as well; IMPORT without a type reads the file but does not import any entries.

  1. Enter Export SYMBOLMAP in the Command Line and press Enter. Production Assist writes the Symbol Map to the JSON file at the drawing path.
  2. To import, place the appropriate JSON file at the same path, enter Import SYMBOLMAP, and press Enter. Production Assist imports new entries of that type from the file.

Use other template types in the same way. Importing templates adds only new entries; Import SETTINGS, however, can change application settings. Check imported templates in the relevant section of the Resource Manager, and review the application settings after running Import SETTINGS.

CommandDescriptionExample
IMPORT typeReads the specified template type from the local JSON file.Import SYMBOLMAP
EXPORT typeWrites the specified template type to the local JSON file.Export SYMBOLMAP

Supported type names are SYMBOLMAP, FIELDMAP, TEMPLATETRUCK, TEMPLATECASE, TEMPLATERACK, TEMPLATEPAPERFORMAT, PRINTFORMAT, CROSSSECTION, MATERIAL, CONNECTOR, STRUCTURALREPORT, PAPERWORKREPORT, PROPERTYTABELES, INVENTORYTABELES, and SETTINGS. Enter PROPERTYTABELES and INVENTORYTABELES exactly as shown; these two historical type names differ from the usual English spelling. Commands and type names are not case-sensitive.