Object Tree
Object tree in VICUS Buildings: building hierarchy, name filter, renaming and locking objects, editing drawings/DXF, drawing layers and images.
VICUS Buildings Page 4 of 5 in this chapter
Overview
The object tree – labelled navigation tree in the menu – on the left-hand side lists all objects of the project in a hierarchy: buildings with levels, rooms and surfaces, shading objects as well as imported drawings, images, OpenStreetMap data and IFC models. Small icons in front of each entry control the visibility, selection and lock state of every individual object; a double-click renames objects or opens editing dialogs. Every change in the object tree can be reverted with Edit › Undo (Ctrl+Z).
The mechanics of selection and showing/hiding – mouse selection in the scene, selection window, Smart select and selection information – are described in detail under Selection & Visibility. This page focuses on the structure of the tree and on renaming, locking and editing the individual objects.
Structure
The tree is organized by object groups. Each group only appears when the project contains the corresponding objects:
| Group (top-level node) | Child entries |
|---|---|
| Buildings | Building → Levels → Rooms → Surfaces → Sub-surfaces (windows/doors) and holes |
| Shading objects | individual shading surfaces |
| Drawings/DXFs | the layers of each drawing |
| Images | individual bitmap images |
| OpenStreetMap | Map with OSM Ground, OSM Streets & Railways and OSM Buildings |
| IFC | IFC Model with the IFC Objects of an imported IFC model |
Notes on the structure:
- Rooms, surfaces and the other objects are sorted by name in natural order, ignoring case (Room 2 before Room 12). Buildings and levels keep the order in which they are stored in the project.
- Group and category nodes (e.g. Buildings) cannot be selected and have no visibility icon – they only bundle the objects below them.
- Clicking the triangle in front of a node expands or collapses the branch; collapsing a branch also collapses all of its sub-branches. The expanded/collapsed state is preserved while editing.
- Surfaces with invalid geometry are shown in dark red; a tooltip states the cause.
- Rooms without a name appear as unnamed.
- View › Show IDs in navigation tree displays the numeric ID after each object name – helpful for matching against result quantities and messages (see Building Structure & Terms).
Filtering by name
The input field Filter by name… below the tree reduces the tree to the objects whose name contains the entered text (case is ignored). The parent nodes of a match remain visible so that its position in the hierarchy stays recognizable; while the filter is active, the tree is fully expanded. The clear button at the right edge of the field removes the filter, and the tree returns to its previous expanded/collapsed state.
Icons in front of each entry
Depending on the object type, up to three clickable icons appear in front of an object’s name:
| Icon | Effect |
|---|---|
| Light bulb | Toggle the object’s visibility in the 3D scene |
| Selection box | Select or deselect the object |
| Lock | Lock/unlock the object (only for drawings, images and the OSM map) |
| Color box | Change the layer color (only for drawing layers) |
A single click on an icon toggles the property for the object and all of its child objects – for example for a building including all its levels and rooms. Hold Shift while clicking to apply the change only to the clicked object itself, without its child objects.
The selection and visibility actions of the tree toolbar (Select all Ctrl+A, Deselect all Esc, Invert selection Ctrl+I, Smart select Ctrl+F, Hide F6 / Show F7) are described under Selection & Visibility. Hiding objects also deselects them. Locked objects cannot be selected – their selection box has no effect.
Renaming objects
Many objects can be renamed directly in the tree:
- Double-click the object’s name – the name turns into an input field.
- Enter the new name and confirm with Enter.
Renaming is available for buildings, levels, rooms, surfaces, sub-surfaces (windows/doors), holes and shading objects. Drawings, layers, images, OSM and IFC objects cannot be renamed; a double-click there opens the respective editing dialog instead (see below). An empty name is discarded, and duplicate names are made unique automatically. Renaming can be undone.
Locking objects
The lock icon protects objects from being moved or deleted by accident. It is only available for drawings, images and the OSM map – typically for an imported site plan or floor plan that serves as a drawing background.
A locked object:
- can no longer be selected and therefore not moved or deleted,
- but remains visible and continues to serve as a background and snapping reference for modeling.
Clicking the lock locks or unlocks the object together with its child objects (Shift = only the clicked object; the OSM map always includes its child objects).
Editing drawings and DXF
A double-click on the name of a drawing opens the Drawing properties dialog:
| Field | Meaning |
|---|---|
| Offset: (x, y, z) | Moves the entire drawing in space [m] |
| Scaling factor: | Unit of the source file (Meter, Decimeter, Centimeter, Millimeter) or Custom – converts the drawing to meters |
| Custom scaling factor: | Free conversion factor when Custom is selected |
| Line weight: | Scaling of the drawing’s line weights |
| Text size: | Scaling of the drawing’s text elements |
This lets you position an imported DXF floor plan in the project and scale it to match the building – for example to trace walls and rooms on top of it. The individual layers of the drawing appear as child entries (see next section).
Drawing layers
Every imported drawing holds its layers as child entries in the object tree – just like the layers in a CAD program. Each layer offers these icons:
- Light bulb: show/hide individual layers to display only the relevant information of the floor plan.
- Selection box: select the layer together with its drawing elements.
- Color box: a click opens a color dialog; the chosen color is used for all elements of the layer. The change can be undone (Layer color changed).
This way you can, for example, hide dimension or annotation layers and keep only the wall and room edges as a drawing background. Layers cannot be locked individually – lock the drawing instead.
Editing images (bitmaps)
A double-click on an image opens a dialog to adjust its appearance:
| Field | Meaning |
|---|---|
| Brightness: | Brightness of the image |
| Saturation: | Color saturation of the image |
| Transparency: | Transparency, to display the image as a subtle background |
Images are used, for example, to place a scanned floor plan or an aerial photo as a background beneath the model.
Editing IFC models
A double-click on IFC Model opens the dialog Edit IFC Model Properties, where the Transparency: of the displayed IFC model is set.
Reassigning missing files
If a project references a drawing, image or OSM file that cannot be found, the entry appears as Missing or invalid file ’…’. A double-click opens a file dialog to reassign the file; the objects are then re-read automatically.
Removing objects
The button Remove (Del) deletes the selected (visible) objects. If drawings or drawing layers are affected, a dialog asks for confirmation, because these objects often serve as a background. Removing can be undone. Further notes on deleting are given under Selection & Visibility.
Practical tip
Lock an imported floor plan (DXF) with the lock icon right after importing it. It stays visible as a drawing background but can no longer be moved or deleted by accident while you model walls and rooms on top of it. Hide layers you do not need – such as dimensions or furniture – individually via the light bulb, and give the remaining layers distinct colors via the color box.