# Files Tab

<img src="./media/FilesTab.png" width="250" height="">

<table>
<tr><th>Button</th><th>Description</th></tr>
<tr><td>

<img src="./media/ButtonAdd.png" width="44" height="44">

</td><td>

Adds a new folder.

</td></tr>
<tr><td>

<img src="./media/ButtonDelete.png" width="44" height="44">

</td><td>

Deletes the currently selected tree-object.

</td></tr>
<tr><td>

<img src="./media/image75.jpg" width="44" height="44">

</td><td>

Copy a selected tree-object.

</td></tr>
<tr><td>

<img src="./media/ButtonUndo.png" width="44" height="44">

</td><td>

Undoes the last change to the tree.

</td></tr>
<tr><td>

<img src="./media/ButtonRedo.png" width="44" height="44">

</td><td>

Redoes the last undone change to the tree.

</td></tr>
<tr><td>

<img src="./media/ButtonSave.png" width="44" height="44">

</td><td>

Saves the currently selected tree object as a .upvtree file.

</td></tr>
<tr><td>

<img src="./media/ButtonLoad.png" width="44" height="44">

</td><td>

Opens a .upvtree file.

</td></tr>
</table>

The **Files** tab shows a tree structure of the model's work items. You can create additional UDiTH files by using the drop-down on the left side of the menu below the **Attributes** and **Files** tabs.

You can add the UDiTH files listed in the table below to the tree.

## Tree Items

<table>
<tr><th>Symbol</th><th>Description</th></tr>
<tr><td>

<img src="./media/ButtonAdd.png" width="44" height="44">

</td><td>

**Add** drop-down - Adds a folder object to the model root. Subfolders are not currently supported. Folders can be used to store and group all other file types. For example, if several files belong to one P&ID, you can create a folder containing all relevant files for that P&ID.

</td></tr>
<tr><td>

<img src="./media/image256.png" width="44" height="44">

</td><td>

**2D to 3D projection**

</td></tr>
<tr><td>

<img src="./media/image53.jpg" width="44" height="44">

</td><td>

**Animation**

</td></tr>
<tr><td>

<img src="./media/ButtonAppControl.png" width="44" height="44">

</td><td>

**AppControl**

</td></tr>
<tr><td>

<img src="./media/ButtonEdit.png" width="44" height="44">

</td><td>

**Comment** - The comment object contains one comment per node. Comments can be attached to any document element, whether original or sketch-based. Comment objects are always dependencies of the document object. For more details, see **Comment**.

</td></tr>
<tr><td>

<img src="./media/image56.jpg" width="44" height="44">

</td><td>

**Drawing**

</td></tr>
<tr><td>

<img src="./media/ButtonMarkup.png" width="44" height="44">

</td><td>

**Markup** - The markup file enables you to do markups on your documents, including graphical objects.

</td></tr>
<tr><td>

<img src="./media/ButtonMeasurements.png" width="44" height="44">

</td><td>

**Measurement**

</td></tr>
<tr><td>

<img src="./media/ButtonPackage.png" width="44" height="44">

</td><td>

**Package**

</td></tr>
<tr><td>

<img src="./media/ButtonPhoto.png" width="44" height="44">

</td><td>

**Photo**

</td></tr>
<tr><td>

<img src="./media/IntelliPID_image88.jpg" width="44" height="44">

</td><td>

**P&ID sketch** - The sketch file allows you to add sketches to your P&ID, including your custom P&ID symbols.

</td></tr>
<tr><td>

<img src="./media/ButtonNewMeasurement.png" width="44" height="44">

</td><td>

**Point of interest**

</td></tr>
<tr><td>

<img src="./media/ButtonReport.png" width="44" height="44">

</td><td>

["*Report*"](./Report)

</td></tr>
<tr><td>

<img src="./media/ButtonScreenshot.png" width="44" height="44">

</td><td>

[Screenshot](./Screenshot)

</td></tr>
<tr><td>

<img src="./media/image52.jpg" width="44" height="44">

</td><td>

[Sketch](./Sketch)

</td></tr>
<tr><td>

<img src="./media/ButtonSpraying.png" width="44" height="44">

</td><td>

[Spraying](./Spraying)

</td></tr>
<tr><td>

<img src="./media/ButtonShow.png" width="44" height="44">

</td><td>

[View](./View) of the current camera position

</td></tr>
</table>

## Quick Action Buttons

### Momentary Quick Action Buttons

<table>
<tr><td>

<img src="./media/ButtonEdit.png" width="44" height="44">

</td><td>

Edit - starts an editing process in a modal manner.

</td></tr>
<tr><td>

<img src="./media/ButtonInspect.png" width="44" height="44">

</td><td>

View - for example, moves the camera to a saved position.

</td></tr>
<tr><td>

<img src="./media/ButtonSelect.png" width="44" height="44">

</td><td>

Select

</td></tr>
</table>

### Quick Action Toggles

<table>
<tr><td>

<img src="./media/ButtonShow.png" width="44" height="44">

</td><td>

Show or hide item

</td></tr>
<tr><td>

<img src="./media/ButtonLocked.png" width="44" height="44"><img src="./media/ButtonUnlocked.png" width="44" height="44">

</td><td>

Lock or unlock item for modification

</td></tr>
</table>

# File Management

<table>
<tr><td>

<img src="./media/image75.jpg" width="44" height="44">

</td><td>

The **file management** menu includes most options for saving and loading, except packages and views, which are available in their respective menus.

</td></tr>
<tr><td>

<img src="./media/ButtonSave.png" width="44" height="44"><img src="./media/ButtonLoad.png" width="44" height="44">

</td><td>

**Save and load configurations** in a `.upv` file. A configuration includes the current settings, clipping, colourisation, view, tags, and more.

</td></tr>
<tr><td>

<img src="./media/ButtonLoadColourFile.png" width="44" height="44">

</td><td>

Load a **colour file**. You can choose between local and online colour files.

</td></tr>
<tr><td>

<img src="./media/ButtonLoadLinkedFile.png" width="44" height="44">

</td><td>

Load a **link file**. You can either replace the existing links or append new ones to them.

</td></tr>
<tr><td>

<img src="./media/ButtonCreateLink.png" width="44" height="44"> 

</td><td>

**Create a link** and copy it to the clipboard. **Example:** `upvapi://http://demo.universalplantviewer.com/demoPlant/4/0/?uid=0003a998-0000-0000-681a-a3ff06552004`

</td></tr>
<tr><td>

<img src="./media/ButtonReport.png" width="44" height="44">

</td><td>

**Create** a report.

</td></tr>
<tr><td>

<img src="./media/image67.jpg" width="44" height="44">

</td><td>

**Save objects to disk** in OBJ format.

</td></tr>
<tr><td>

<img src="./media/ButtonGenerateIsoPDF.png" width="44" height="44">

</td><td>

**Generate a double-sided ISO PDF**. This will create both an isometric view and an orthographic drawing for better visualisation.

</td></tr>
<tr><td>

<img src="./media/ButtonBlueHelp.png" width="44" height="44">

</td><td>

Open the **manual**.

</td></tr>
</table>

> Check the file names you have entered before saving. There is no warning if the file name already exists.

### Save Configuration File

<table>
<tr><td>

<img src="./media/ButtonSave.png" width="44" height="44">

</td><td>

Choose which information to save:

</td></tr>
</table>

<img src="./media/SaveConfigFile.png" width="250" height="">

### Load Configuration File

<table>
<tr><td>

<img src="./media/ButtonLoad.png" width="44" height="44">

</td><td>

UDiTH automatically loads a default configuration file. You can save a custom configuration file as `defaultConfig.upv` in the same location as `UDiTH.exe`.

</td></tr>
</table>

You can also define the path to the settings file in the URI:
`file://C:\Path\To\UDiTH_Web.html?settings=c:\MySettings\Config.upv`

> To use the URI function, the configuration file must be accessible from the machine where `UDiTH_Web.html` is located. If `UDiTH_Web.html` is hosted on an IIS server, only configuration files located on the IIS server can be loaded. To apply a local settings file, use **File > Load Settings** instead. Relative paths can be used to define the location of settings files.

### Save and Load Objects

<table>
<tr><td>

<img src="./media/image67.jpg" width="44" height="44">

</td><td>

You can save selected objects as `.obj` files to edit them with a modelling tool or duplicate them in your model. Click **Import avatar from disk** in the **additional objects panel**, then click a location in your model to place the object. After that, you can move and rotate it.

</td></tr>
</table>

<img src="./media/image179.png" width="181" height="276">

<table>
<tr><td colspan=2>These objects are treated as additional objects if you load them in the 3D view. You can delete them in the additional objects panel. If you load them in Sketch mode, they are treated like objects from the catalogue.

</td><td>

</td></tr>
<tr><td>

<img src="./media/image180.png" width="209" height="123">

</td><td>

If you save objects as OBJ files, there is a size limit that matches the maximum input size UDiTH can handle. If you export more than 20 objects, the following warning message appears:

</td></tr>
<tr><td>

<img src="./media/image181.png" width="237" height="129">

</td><td>

Before saving, you can choose to swap the height axis **(Z)** with the breadth axis **(Y)**.

</td></tr>
</table>

