Camera options

UniversalPlantViewer offers three camera modes, one of them (Walk) for touch-sensitive devices. After loading a new model UniversalPlantViewer will start with Orbit mode as default. You can choose another mode by clicking on the icon Select camera mode (it indicates the current mode) on the top left of your screen. The camera will rotate around the selected object. If you want it to rotate around the centre of the screen enable “Use old camera rotation behaviour” in the settings tab (focus on centre will be lost).

Mode Left click Hold left mouse button Hold right mouse button Mouse wheel
Select (centre object with double click) Rotate camera around centred object Move camera forward / back (focus on centre will be lost) Move camera to and away from mouse pointer (focus on centre will be lost) W, A, S, D, arrow keys: move camera Shift + W, S: Lift / lower camera Space: lift camera
Select (centre object with double click) Rotate camera Move camera forward / back Move camera to and away from mouse pointer (centre will be lost) W, A, S, D, arrow keys: move camera Shift + W, S: Lift / lower camera Space: lift camera
One finger: Rotate camera left / right Move camera forward / back Two fingers: Move camera left / right & up / down Three fingers / mouse wheel click and hold: Rotate camera

Reset View:

Resets all view options like Camera type, position, Highlighting and so forth; Everything will be the way it was when starting UPV
Near/Far clipping plane: Sets a distance, measured from the camera position, where Objects will be rendered. For example a far clipping plane of 100 would mean Objects further than 100 meter from the camera will not be rendered.
Set Camera Position: Positions the camera at the given position, looking at the given target.
Go to GPS: Positions the camera at the given GPS location. Needs an activated GPS device.

All comments and views will be lost if not saved in a configuration file.

Mini map

If you activate the mini-map via Settings you can quickly navigate with it in the lower right corner of the screen regardless of camera mode. If you hover your mouse over it, the background colour will change. After that you can move (left mouse button) and rotate (right mouse button) the camera and directly bring it to a point on the map (left or right click). The 90° angle shows the camera’s field of vision.
You can zoom in and out with the magnifying glass icons.
With the bar on the right you can change the camera’s height. The lower half represents the total height of your model.

Common views cube:

The cube in the upper right corner of the screen gives you directions: N – North, W – West, S – South, E – East, U – Up, D – Down.
You can click on any face of the cube and the small spheres connecting two or three faces to look straight at that face(s). For example, if you click on Up the camera will point straight down.
You can decide to show / hide the cube or change from compass to XYZ mode in the settings menu.

You can also use custom text on the cubes faces by changing the models configuration file. Add the following line to the defaultconfig.upv: “CommonViewsCubeText”: " S | E | N |W | U | D ".

Select (multiple) objects by clicking on them or their name in the navigation bar (tree bar) on top of the screen.

In the settings menu, you can toggle between tree bar (“breadcrumb navigation”) on top and tree view inside the additional functions window on the right.

The tree bar will always be visible even when you open a PDF, PID or isometric.

Select and fit: If you want to centre and fit objects to your screen, select them and click on “Centre and fit the currently selected objects”.


Enter your search term in the search box and click the button or press enter. Results are sorted by categories (attributes). Expand results with a click on the small angle on the right.

? stands for any single character or number
* stands for any number of characters or numbers (a* matches a, abc, a-12, …).


When selecting objects that have attributes by clicking on them (or tapping in case of touchscreens), the objects information will be shown on the menu to the right beneath the Attributes tab.

  • The number of objects you have selected.

  • A list of links for that object.

  • All attributes of that object(s). In the settings tab you can decide if you want to show / hide empty attributes.

Drag an attribute to the main window to transform it to a comment.

Double-click on an attribute to copy it to your clipboard as text.

Example: For FileName > Equipment you get Equipment


Button Description
Deletes the currently selected tree-object
Undoes the last change to the tree
Redoes the last undone change to the tree
Saves the currently selected tree object as a .upvtree file
Opens a .upvtree file

The Files tab shows a tree hierarchy of the models work items. You can create additional UPVfiles by clicking on the dropdown on the left side of the menu beneath the Attributes and Files Tab. You may add the UPVfiles shown in the table below to the tree.

Button UPVfile Edit option 1 Edit option 2 Edit option 3
Folder to store actual UPV file
Comment for a selected 3D object Edit the Comment Show/Hide Comment
Markup Edit the Markup Show/Hide Markup
View of the current camera position Edit the view Show the view
Package Edit Package Save Package Select Package
3D Sketch Save Sketch Open Sketch
Animation Edit Animation Open Animation
Spraying Edit Spraying Save Spraying
Screenshot of the current view Show screenshot
Drawing Open Drawing Save Drawing


A click on this icon opens the views panel where you can save the current camera position. Return to a position by clicking on the name of the view. You can create multiple views to quickly switch between them.

Views can be saved in file management > save configuration. If you don’t save your views they will be lost after closing UniversalPlantViewer or clicking on “Reset view”.