# Objects

## Select Objects

Select one or more objects by clicking the checkbox next to them or their name in the navigation bar (tree view) at the top of the screen.

<img src="./media/SelectObjects.png" width="600" height="">

### Common Attribute Display during Multi-Selection

To view common attributes for multiple objects, either hold down the **Ctrl** key while selecting them or click predefined groups or plant sections. This feature allows the simultaneous display of shared standard and custom attributes for up to 1,000 objects.

## Select Clipping Mode

<table>
<tr><td>

<img src="./media/image62.jpg" width="44" height="44">

</td><td>

**Select clipping mode**

To improve object visibility, clip the view to exclude the area around the selected objects.

</td></tr>
</table>

> After deactivating clipping mode, it may take a few moments for the entire model to load again.

Please wait until the progress bar in the status bar stops changing.

Select from three clipping modes and customise them using the available options:

### Volume Clipping

<table>
<tr><td>

<img src="./media/ButtonVolumeClipping.png" width="44" height="44">

</td><td>

**Volume clipping**

Select an object and surround it with a rectangular clipping box that matches its size. This ensures that only fully enclosed objects remain visible.

</td></tr>
</table>

<table>
<tr><td>

<img src="./media/image63.jpg" width="44" height="44">

</td><td>

**Customise clipping** 

To change the dimensions of the clipping box, move the slider between 0 and 25 metres or drag one side of the box directly. To reposition the box, drag the coloured arrows.

</td></tr>
</table>

<table>
<tr><td>

<img src="./media/ButtonFit.png" width="44" height="44">

</td><td>

 **Centre and fit selected objects**

This option automatically adjusts the view if the size of the clipped volume changes.

</td></tr>
</table>

<table>
<tr><td>

<img src="./media/image67.jpg" width="44" height="44">

</td><td>

**Save volume to clipboard**

Saves the volume of the current clipping to the clipboard so that you can paste it into an Excel file.

</td></tr>
</table>

> You can enlarge the box beyond 25 m and reduce it to a size smaller than the original object to create a cross-section.

If you drag one side to a value below 0 m, the opposite side of the box also moves.

### IntelliClipping

<table>
<tr><td>

<img src="./media/ButtonIntelliClipping.png" width="44" height="44">

</td><td>

In **IntelliClipping**, the original clipping box follows the shape of the selected object itself, which is surrounded by the default selection box.

</td></tr>
</table>

-   Use the slider to include all objects within the specified distance of the selected object in the clipping area, from 0 to 25 metres.
-   Selecting **None** will display only the selected object.

### Inverse Clipping

<table>
<tr><td>

<img src="./media/ButtonInverseClipping.png" width="44" height="44">

</td><td>

**Inverse clipping** provides a clear view towards the centre of the selected objects by clearing one quadrant along the x, y, and z axes. All other quadrants remain visible as usual.

</td></tr>
<tr><td>

<img src="./media/ButtonGrid.png" width="44" height="44">

</td><td>

**Show/hide grid planes**

You can add a grid that responds to the camera's distance from the object.

The grid is displayed as 1 m x 1 m, 10 m x 10 m, or 100 m x 100 m depending on the camera's distance from the object.

To change the size of the grid, drag the sides of the quadrant.

</td></tr>
</table>

> Similar to inverse clipping, Walk mode with an additional object or person always keeps a clear corridor between the object and the camera.

<table>
<tr><td>

<img src="./media/image67.jpg" width="44" height="44">

</td><td>

**Save volume to clipboard**

Saves the volume of the current clipping to the clipboard so that you can paste it into an Excel file.

</td></tr>
</table>

**Example:**

<table>
<tr><th></th><th>min Y</th><th>min X</th><th>min Z</th><th>max Y</th><th>max X</th><th>max Z</th></tr>
<tr><td>

NewVolume

</td><td>

3023.2Z

</td><td>

2375.12

</td><td>

67.19

</td><td>

3037.21

</td><td>

2393.12

</td><td>

72.15

</td></tr>
</table>

## Centre and Fit

<table>
<tr><td>

<img src="./media/ButtonFit.png" width="44" height="44">

</td><td>

**Centre and fit selected objects**

Select the objects you want to centre in the window and then click this button.

If nothing is selected, all elements are fitted into the window.

</td></tr>
</table>

## Toggle Visibility

<table>
<tr><td>

<img src="./media/image88.png" width="44" height="44">

</td><td>

**Toggle selected objects visibility**

To hide or show objects, select them and click this button.

</td></tr>
</table>

## Show Only

<table>
<tr><td>

<img src="./media/ButtonLimitSearch.png" width="44" height="44">

</td><td>

**Show only selected objects** 

This function hides all objects except the selected ones. Toggle it to activate or deactivate the filter.

</td></tr>
</table>

## Highlighting Objects

<table>
<tr><td>

<img src="./media/ButtonHighlight.png" width="44" height="44">

</td><td>

**Highlight selected objects**

All objects except the selected ones appear greyed out and semi-transparent.

Toggle the button again to deactivate this function.

</td></tr>
</table>

## Object Colours
### Colourise Selected Objects

<table>
<tr><th><img src="./media/ButtonColourOptions.png" width="44" height="44"></th><td>

**Colourise selected objects**

Change the display colour of selected objects by opening the colour menu.
</table>

This menu is divided into four main sections:

<img src="./media/IntelliPID_image135.png" width="400" height="253">

#### Colour Options

<table>
<tr><th Rowspan="2"><img src="./media/ButtonColouring.png" width="44" height="44"></th><td>

**Advanced colour selection** opens a pop-up menu for detailed colour selection, allowing you to choose from the full RGB colour spectrum:

</td></tr>
</table>

<table>
<tr><td>

<img src="./media/IntelliPID_image136.png" width="200" height="">

</td><td>

Once you have chosen the required colour, confirm [<img src="./media/IntelliPID_image137.jpg" width="16" height="16">] or cancel [<img src="./media/IntelliPID_image61.png" width="16" height="16">] your selection.

The selected object or objects are displayed immediately in the chosen colour.

</td></tr>
</table>

<table>
<tr><th><img src="./media/IntelliPID_image17.jpg" width="44" height="44"></th><td>

**Pick colours** lets you take a colour from a 3D object and save it under **Custom colours** so that you can use it again later.

Activate the function, click an object to pick its colour, and then select a white custom colour square to save it.

</td></tr>
<tr><th><img src="./media/IntelliPID_image139.png" width="44" height="44"></th><td>

**Clear style** resets the colour of the selected objects to their default colour, which was initially assigned during the building process.

</td></tr>
<tr><th><img src="./media/IntelliPID_image140.png" width="44" height="44"></th><td>

**Reset all colours** restores **all** assigned colours for **all** objects to the default colours set during the building process.

</td></tr>
</table>

#### Default Colours

The **Default colours** section provides a basic set of predefined colours that can be applied to the currently selected objects.

#### Custom Colours

**Custom colours** are created by the user using the colour picker function described above. Once defined, they can be used in the same way as the default colours.

#### Opacity Setting

The slider at the bottom adjusts opacity. The leftmost position is fully transparent, while the rightmost position makes the selected objects fully opaque.

### Creating a Colour File

<table>
<tr><td>

<img src="./media/image75.jpg" width="44" height="44">

<img src="./media/ButtonLoadColourFile.png" width="44" height="44">

</td>
<td>

Your model is loaded with a default colour file.

You can also create a **Custom colour file** and load it via the file management menu.

</td></tr>
</table>

Custom colour files can be created in Excel by entering a colour and a corresponding condition. You can use colour names or HTML colour codes beginning with `#`, followed by six digits representing the intensity of red, green, and blue, with two optional digits for opacity.

For **Condition**, you can enter attributes such as task, piping, name, system path, or any other relevant attribute.

**Aspect** is an optional value used to colour insulation and/or simple physical piping.

**Example:**

<table>
<tr><th>Colour</th><th>Condition</th></tr>
<tr><td>

red

</td><td>

Task=Equipment

</td></tr>
<tr><td>

blue

</td><td>

Task=Structure

</td></tr>
<tr><td>

\#FF00FF22

</td><td>

Task=Supports

</td></tr>
<tr><td>

red

</td><td>

Task=Cableway

</td></tr>
<tr><td>

red

</td><td>

Task=Conduit

</td></tr>
<tr><td>

red

</td><td>

Task=HVAC

</td></tr>
<tr><td>

\#FF00FF

</td><td>

piping

</td></tr>
</table>

## Measure Distances

<table>
<tr><td>

<img src="./media/ButtonMeasurements.png" width="44" height="44">

</td><td>

**Measure distances** creates markers that can be placed on the outlines and corners of 3D objects. The markers can be repositioned by dragging them.

</td></tr>
<tr><td>

<img src="./media/ButtonMeasureDistance.png" width="44" height="44">

</td><td>

**Create new distance measurement** creates two connected markers and displays the distance between them, including the distances in the XYZ planes.

</td></tr>
<tr><td>

<img src="./media/ButtonMeasureMinimumDistance.png" width="44" height="44">

</td><td>

**Create new minimum distance measurement** creates two connected markers and displays the minimum distance between two selected objects.

</td></tr>
<tr><td>

<img src="./media/ButtonNewMeasurement.png" width="44" height="44">

</td><td>

**Create new coordinate measurement** creates a single measurement marker together with its coordinate information.

</td></tr>
<tr><td>

<img src="./media/EastAxis.png" width="44" height="44"><img src="./media/NorthAxis.png" width="44" height="44"><img src="./media/UpAxis.png" width="44" height="44">

</td><td>

**Prevent East-Axis/North-Axis/Up-Axis movement**

</td></tr>
<tr><td>

<img src="./media/IgnoreIntelligentTargetting.png" width="44" height="44">

</td><td>

**Ignore intelligent targetting** is explained in more detail in the examples below.

</td></tr>
<tr><td>

<img src="./media/ButtonCircle.png" width="44" height="44">

</td><td>

This button **Estimates the diameter** of cylindrical objects, such as pipes.

This feature is especially useful for laser scans and also displays a red diameter as a visual aid.

</td></tr>
</table>

><img src="./media/image289.png" width="330" height="165">

### Intelligent Targeting

<table>
<tr><th>**Activated** intelligent targeting</th><th>**Deactivated** intelligent targeting</th></tr>
<tr><td>

<img src="./media/image290.png" width="375" height="259">

</td><td>

<img src="./media/image291.png" width="375" height="259">

</td></tr>
</table>

* With **intelligent targeting** activated, the marker selects positions only on the previously selected object. In the example above, the right-hand marker, highlighted in blue, can be positioned at a point behind the red vertical beam.
* When **intelligent targeting** is deactivated, the right-hand marker, highlighted in blue, selects a position on any object over which it hovers. In this case, the operator's viewing angle becomes an important factor.

> For optimal measuring in models built with **AdapterForSmartReview**, use the following settings:

`Stroking Tolerance`: `100`

Enable `Advanced Graphics Handling for measuring and line tracking`.

> When you activate `Object Recognition` in models built with **AdapterForDocuments**, additional measuring points, such as pipe centres, become available.