🇬🇧

Documentation

Scene Tree#

The Scene Tree shows all objects currently visible in the open drawing in a hierarchical (kinematic) tree structure. This lets you represent object hierarchies, which is helpful when you want to copy or move related elements together or combine their properties and tables. In general, the display order has no effect on static or electrical calculations; however, a specific arrangement can still be useful for certain workflows.

By default, Production Assist tries to group objects along trusses and structural elements when copying. You can enable or disable this automatic grouping in the properties.


  1. Switching between open drawings
  2. Selection
  3. Assembly Groups
  4. Sorting
  5. Filtering
  6. Meaning of the symbols and colors before the object names

Image 1.4


1. Switching between open drawings#

Next to the Scene Tree heading, you will find the name of the currently open drawing. You can use the drop-down menu next to it to switch between all drawings that are currently open.

Note: Switching the active drawing is only possible in the desktop app. In plugins such as Vectorworks, SketchUp, or Outdoor Cut, the drawing name is typically only displayed; you generally cannot switch directly to another active drawing there.

Image 1.4.1

Elements in the upper area#

  • Scene Tree + drawing name: Shows the name of the currently active drawing.
  • Drop-down arrow next to the drawing name: Opens the list of all open drawings.
  • Entry in the drop-down list: Click it to switch directly to the desired drawing.

In the example shown, Electric.lrwx is active, while Drawing1 is also open and can be selected.


2. Selection#

All inserted objects can be selected individually or as a multi-selection in the Scene Tree. On macOS, multi-selection works by holding down the Cmd key; on Windows, use the Ctrl key.

You can select several consecutive objects with the Shift key. All objects between the two selected entries are also highlighted.

Depending on the object type, additional information is shown directly in the object rows of the Scene Tree, for example:

  • Object name: The name of the respective object.
  • Object ID or Fixture ID: Appears before the object name, if available.
  • Symbols: Indicate the object type or certain properties.
  • Additional values: For example, weights or other object-related details for assembly groups.

3. Assembly Groups#

All objects in a drawing are displayed in a structured way in the Scene Tree. Related objects, for example fixtures on a truss, can be combined into an assembly group (Assembly Group). This improves clarity and makes tasks such as preparing paperwork easier. In addition, all included objects can be selected and edited together.

In the following example, several objects are grouped together within one group:

Image 1.4.2

Elements within an assembly group#

  • Arrow to the left of the group: Expands or collapses the group.
  • Group row: Shows that this is an assembly group (Assembly Group).
  • Additional field to the right of the group: Can contain group-related information, such as the weight.
  • Sub-objects (Children): All indented objects belong to this assembly group.

Creating an assembly group#

You can create an assembly group (Assembly Group) from several selected objects. To do this, first select the desired objects. Use the shortcut Cmd + G (on macOS) or Ctrl + G (on Windows) to create the assembly group. Alternatively, you can right-click the selected objects to open the context menu and use the Group Selected Objects command there. Then assign a name to the assembly group.

It is also possible to nest assembly groups. If you want to assign objects to an existing assembly group, you can drag and drop them into the desired group or right-click the object or objects and use the Move to Assembly Group command in the context menu.

NOTE: In some commands, the sub-objects of an assembly group are also referred to as Child or Children. The parent assembly group is called Parent.


4. Sorting#

Objects in the Scene Tree can be sorted according to various criteria. By default, No Sorting is active. Depending on the object type and use case, however, you can also sort by certain properties.

Image 1.4.3

Structure of the sorting menu#

  • Sort: Opens the sorting menu.
  • Sort by Property: Area for selecting the sorting type.
  • No Sorting: Clears the current sorting.
  • Name: Sorts alphabetically by object name.
  • FID: Sorts by Fixture ID.
  • Position On Structure: Sorts by an object's position on a structure.
  • Object ID: Sorts by Object ID.
  • Search field in the sorting menu: Helps you quickly find additional properties.
  • Property groups such as General Information, DMX, Position, Rotation/Scale, User/Time, Electricity, Data, Color, Support, and Truck: Contain additional fields that can be used for sorting.
  • Reverse Order: Reverses the current sort order.

If a sorting is active, it is also shown in the Scene Tree:

Image 1.4.4

Display when sorting is active#

  • Blue "Sorted by FID" field: Shows the currently active sort criterion.
  • X in the blue field: Removes the sorting directly.
  • Blue values to the right of the objects: Show the sort value of the respective object, in this case the FID.

Sorting is especially helpful if you want to quickly arrange fixtures, consumers, or other objects with unique IDs in a logical order.


5. Filtering#

To improve clarity and speed up your work, you can filter the objects displayed in the Scene Tree.

Image 1.4.5

Elements in the filter area#

  • Filter: Opens the filter menu.
  • Search: Filters the displayed objects by name or matching entries.
  • X in the search field: Clears the current search term.

Options in the filter menu#

Under Show the following, you can define which object types are displayed in the Scene Tree:

  • Consumer: Shows consumers.
  • Distributor: Shows distributors.
  • Plugboxes: Shows plugboxes.
  • Power source: Shows power sources or feeds.
  • Fixtures: Shows fixtures.
  • Structures: Shows structures such as trusses or other support elements.
  • Cable Path: Shows cable paths.
  • Support: Shows support objects.
  • Audio: Shows audio objects.
  • Meshes: Shows geometry or mesh objects.
  • Other: Shows other objects.
  • Show children: Shows sub-objects within groups.
  • Hide Unselected Objects: Hides all objects that are currently not selected.
  • Show Invisible Objects: Also shows objects that have been hidden via layers or classes.

Enabled options are marked with a check mark. If you remove the check mark, the corresponding objects are hidden in the Scene Tree.


6. Meaning of the symbols and colors before the object names#

Different symbols are shown in the Scene Tree depending on the object type:

SymbolObject
Light bulbFixtures / GDTF
ToolAssembly Group (Assembly Group)
CalculatorCalculation elements
CubeGeometry
BoxesSymbol
TagDimension

In addition, the assigned Object ID or Fixture ID is displayed in front of many objects. If this ID is red, it has been assigned more than once in the plan.

For objects with electrical or network-based connections, such as fixtures, power connections, power distributors, or consoles, the color of the symbol also changes:

  • Red = all inputs and outputs are still unpatched or free
  • Yellow = some inputs and outputs are already patched or connected
  • Green = all inputs and outputs are fully patched or connected

NOTE: Right-clicking an object in the Scene Tree opens the context menu with many helpful commands. You can find an overview of these commands in the Context Menu chapter.

WARNING: Many selected objects in the Scene Tree, especially symbol and geometry objects, can be edited via Edit Mode in the Edit Geometry Window. You can find more details in the Symbol Workflow chapter.