Settings
The Settings toolbar button opens a menu for accessing the 3D viewer and camera settings, and for updating the 3D model if it has changed on the disk after loading it into the 3D viewer.
Settings
In the Settings menu, select Settings to change the following viewer settings.
View/Movement | Measurement | Visualization | Point clouds | Advanced | Other options
View/Movement
On the View/Movement tab, you can change settings that affect viewing the model and moving in it.
-
The View distance setting controls the distance at which objects become visible to the user. If set to automatic (default), all objects are visible regardless of distance. You can try to improve performance by limiting the view distance, especially if you already tried to adjust the frame rate in optimization settings and it did not help.
- The Near plane distance setting controls the distance from the camera to the plane from which the objects start to be visualized. If set to automatic (default), the distance is set automatically. To manually define the distance, select Manual and enter the desired distance.
- The Near plane clipped objects setting controls how the objects are rendered. If set to Hollow, the back faces of objects are drawn. If set to Solid, a solid surface is created on top of the clipped area.
-
The View angle setting controls the view angle of the camera. Adjust this setting if needed. The default view angle is defined in Plant Modeller, in the Walkaround tool, and the setting is saved in the Scene.
-
The Moving settings allow you to adjust the speed of moving in the model and turning the view. You can try different speed settings to find a level where it feels natural to control the movements. Slower computers and larger models typically require a smaller speed because slow visualization makes it more difficult to move around. Note that you can also try to affect the visualization speed by selecting a smaller subset of objects to display or by changing the view distance.
If "Accelerated moving speed" is not selected, the moving speed is linear (not accelerated).
-
The Optimization settings control the frame rate at which the view is updated when the user moves around in the model. You can select the target frame rate with the slider bar. If optimization is enabled, the system tries to reach the specified frame rate by decreasing the detail level of rendered images. Disabling the optimization forces every frame to be fully rendered, and this might cause performance issues especially in large models.
Measurement
On the Measurement tab, you can select the unit to use in measurements. It can be one of the following: millimeters, centimeters, meters, inches, feet+inches.
Visualization
On the Visualization tab, you can set visualization settings.
-
You can select the materials used to highlight objects and to indicate that an object is selected.
The default materials depend on the model's publisher, but you can change them for the current session. The changes are not saved to the model.
-
You can select the background color/image; see Background visualization for details. The background color setting is saved to the model.
-
You can specify transparency intensity.
-
You can define how objects clipped by clipbox are handled.
-
You can define the line color for reference grid lines.
-
You select to show:
-
Edges – Objects display feature edges (sharp edges and seams, such as welding joints). If not selected, objects have no distinct edge line. This is the fastest visualization mode and recommended for very large models.
-
Coordinate display – If selected, the current camera coordinates are displayed at the bottom of the 3D view. By default it shows named coordinates, but if named coordinates are not available, Cartesian coordinates are shown instead.
-
Coordinate marker – If selected, a main axis marker is displayed in the bottom-left corner of the 3D view.
-
Point clouds
On the Point clouds tab, you can set point cloud details.
-
You can define the scale size of the point clouds. This setting configures the base size for each point. The size of the scale has an effect on the rendering performance.
-
Scale point size by scanner distance – Adjusts the size of each point according to its distance from the scanner. Points close to the scanner are drawn larger and distant points smaller, which gives the point cloud a stronger sense of depth and reduces visible gaps between points when you view surfaces up close. When this option is off, all points are drawn at the same size regardless of distance.
-
You can define the tolerance for the difference comparison, which is given in millimeters determining how much the 3D model and the point cloud are allowed to differ while still colored as common to both. The default value is 50.0 mm. You can also specify the colors used for highlighting the differences.
-
You can specify the number of detailed clouds shown while navigating.
-
Show remaining point clouds when idle – Displays additional point cloud data when the view is not moving. While you navigate, the program shows a reduced amount of point cloud data to keep movement smooth. When you stop, it loads and displays more data to show the model in greater detail. Turn this option off, if you want consistent display density, or if loading extra data slows down your computer.
-
You can select to cache mesh textures (dds files) to eShare App project cache on client. This will take some disc space. If mesh textures are not cached, after eShare App is closed the texture cache will be cleared and disc space is freed.
-
If textured meshes are included, you can enable showing the texture on both sides.
Advanced
On the Advanced tab, you can specify advanced visualization settings.
-
The OpenGL info button opens a text file that displays information about your system’s support for OpenGL based visualization.
-
Enable occlusion culling – If selected (default), occlusion culling is enabled.
-
Enable screen space ambient occlusion (SSAO) – If selected (default), the screen space ambient occlusion technique is used to approximate the occlusion (diminishing) of light on objects in shaded views. This technique provides realistic, real-time shading effects without putting too much stress on the hardware.
-
Enable Vsync – Enables Vsync. When vsync is enabled GPU can smoothen the moving image and uses the best refresh rate for the current display. Disabling vsync might help if navigation causes image to stutter. Vsync is controlled by Windows and GPU setting and they might overrule this application setting.
-
Enable anti-aliasing – Anti-aliasing smoothens lines in rendered image and tries to fade jagged edges. Enabling this option adds workload to GPU.
-
Enable pipe wireframes – If selected (default), pipe wireframes are included. If disabled, some GPU memory is saved but pipe wireframe representation will be missing some core feature lines.
-
Enable image-based lighting (IBL) – If this option is selected (default), the background image is used for applying lighting effects to shaded views; use the slider to adjust the intensity of lighting. If this option is disabled, the more realistic background images cannot be used; on the Visualization tab you can set the background to be blue gradient, solid black, or solid white.
-
Detect integrated display adapter usage – If selected (default), the note about using software with integrated display adapter is shown.
Other options
On the Other options tab you can specify the following settings.
-
Property tip settings – Opens the Property Tip Settings dialog where you can define which model attributes are displayed in the tooltip of an object or disable the function. See Property tip settings.
-
Identification label settings – Opens the Identification Label Settings dialog where you can define which object attributes can be displayed in object identification labels. By default the labels are set to use key object attributes and the pli attribute.
Move attributes from the left pane to the right pane to allow the attributes to be shown in object identification labels. The order of the items in the list defines their priority; each label shows the value of the attribute that is highest in this list, and if the object does not have any of the listed attributes the label is not displayed.
The displaying of labels can be enabled or disabled, as described in Object identification labels.
-
Scene saving settings – Opens the Scene Saving Settings dialog where you can define how the visibility of objects and transparency of objects is saved in scenes.
-
Sidebar location – Select whether the sidebar is located on the left or right.
-
Enable 3Dconnexion 3D mouse – If selected, you can use a 3Dconnexion 3D mouse to move in the 3D view. Use the slider to adjust mouse sensitivity.
Memory settings
In the Settings menu, select Memory Settings to define how much memory the application can use when loading the model.
If you limit the memory, the application loads objects that are further away as simple geometrical elements. When the user moves in the model and the objects get closer, the application loads the details of the object.
To activate the memory settings, click the Use CPU memory target checkbox and define the memory target. The minimum value is 500 MB.
If CPU memory target is not used, GPU memory can be used. Stream geometry to GPU controls the streaming of triangulated geometry to GPU. Enabling or disabling this option requires
If Maximize objects cached to GPU is enabled before loading, the model tries to cache as much objects to GPU as possible, which improves the rendering performance. If disabled, only the largest objects are cached to GPU.
Note that the system may slightly exceed the memory limit for a short time if the system must work close to the target memory value.
To save hard disk space, the system automatically removes cache directories that have not been used for over 30 days. The option has been set on by default, but you can turn it off by deselecting the Remove old cache directories checkbox. If you open the model again, the system will automatically recreate the removed cache folders.
Show in VR
Show in VR opens the current eShare view in a separate Virtual Reality window. The window only shows the objects that are currently visible in eShare.
Note: VR view is available only in eShare App.
Using the VR view
You can open the eShare application window's view to a Virtual Reality headset (VR glasses) connected to the computer.
Prerequisites
- The Steam client and the SteamVR application by Valve. You can review the system requirements and download the application from the Steam store: https://store.steampowered.com/app/250820/SteamVR/.
- OpenVR headset such as HTC Vive, Oculus Rift, or Windows Mixed Reality.
Do the following:
-
Only the visible objects are displayed in VR. Showing fewer objects can make it easier to navigate and improves the performance—for best performance, send as few objects as possible to VR. Trying to open too many objects in VR at the same time shows a performance warning.
You can limit the number of objects to be shown by hiding the unnecessary objects or by using a clip box in eShare.
-
Navigate to the position from where you want to open the VR view.
-
Select Visualization Control > Show in VR. The CadmaticVR window opens and the active 3D objects are converted to the VR format (this can take some time).
Tip: If the VR does not seem to open, start the SteamVR application manually and then click Show in VR.
Now you can put on your VR headset.
-
You can use the VR controller to navigate in the model and select objects.
Note: Use the VR menu to switch between teleport mode (default) and normal movement.
Teleportation:
- Step forward by pushing the touchpad forward (shows a parabolic pointer) and then releasing it.
- Step backward by tapping the bottom of the touchpad.
- Rotate camera by pressing the side of the touchpad.
Movement:
- Move to a direction by tapping the touchpad. Move up or down by pressing the touchpad up or down.
- Rotate camera by pressing the side of the touchpad.
Object selection:
- Point the object with the VR controller and press the trigger button.
-
You can use a keyboard and mouse to navigate in the model and select objects.
Teleportation:
- Teleport to an object by right-clicking.
Movement:
- Move horizontally with W–A–S–D or arrow keys.
- Move up by pressing R or Space.
- Move down by pressing F or the left Ctrl key.
- Rotate camera with Q–E or by holding down the middle mouse button while dragging.
Tip: Default movement speed can be adjusted from the VR menu. Hold down the left Shift key to temporarily double your movement speed.
Object selection:
- Point and click with the mouse.
-
You can open the VR menu by pressing the VR controller's menu button or the Tab key.
The menu contains the following items:
-
Query Tool – Allows viewing object data by pointing at an object and clicking. The Query Object Data dialog opens, showing the object attributes.
Note: Not all object attributes are shown in VR.
-
Measure – Allows taking measurements from the model by first pointing at an object and then clicking to select the first and the second measurement point.
You can specify the following settings:
- Snap to vertices – If selected, the measuring tool snaps to vertices.
- Snap to perpendicular – If selected, the measuring tool snaps to perpendicular lines.
Click Clear all measurements to remove all measurements from the VR view.
-
Rendering settings – These settings should be configured so that navigation is smooth at approximately 90 frames-per-second.
-
Rendering quality – Specify how detailed the VR view should be. Selecting higher rendering quality enables advanced features such as more detailed shadows, but it might decrease the performance.
-
Hide faraway objects – Hiding objects that are far away might improve the performance.
-
Objects to draw – Each model object is drawn using small triangles. This setting specifies the maximum amount of triangles to draw in "Hide faraway objects" mode. You can set the slider to a value between 0.1 – 1.0, where 1.0 means one million triangles.
-
Minimum draw distance – Objects that are closer than this value are always drawn, regardless of the "Objects to draw" setting.
-
-
-
Key Mappings – Allows changing the keyboard mappings.
-
Exit VR – Closes the CadmaticVR window.
Movement Settings
-
Movement type – Specifies movement type when using the VR controller (does not affect keyboard/mouse).
- Teleport – If selected, using the touchpad teleports the view forward or backward.
- Controller – If selected, using the touchpad moves the view in the specified direction.
-
Lock up / down movement – Locks the movement to be horizontal only. When disabled, you can move freely in the model.
-
Movement speed – Specifies movement speed when using the VR controller or the W–A–S–D keys.
-
FPS – Displays the current frames-per-second count.
-
-
If you change object visibilities or move to a different camera position in eShare, you can update the open VR view by selecting the Show in VR command again.
-
Close the CadmaticVR window by selecting Exit VR from the VR menu. You can also press Esc to show the exit dialog.
Show in presentation mode
Presentation mode is a visualization mode deploying live-rendered ray tracing. Using it requires meeting certain system requirements. See Presentation Mode.
Note: Presentation mode is available only in eShare App.
Showing/hiding or selecting objects in presentation mode is not supported, so if any parts of the model need to be hidden in the model in presentation mode, this needs to be done in normal visualization before launching presentation mode.
Panning by holding the middle mouse button down or zooming with the mouse wheel do not work.
Many of the user interface features are disabled in presentation mode. The following features work in presentation mode:
-
In the sidebar Clip box tab is available.
-
In the main toolbar:
-
Move back or forward in navigation sequence
-
Navigation menu: all features except projection selection (Perspective projection is used) and Zoom to area
-
Settings:
-
Settings > View/Movement: only View angle and Moving speed have any effect.
-
Camera Location
-
Update Model works but reverts back to normal visualization
-
-
Scenes
-
Do the following:
-
Select Visualization Control > Show in Presentation Mode. Launch presentation mode dialog opens.
-
In the Launch presentation mode dialog, specify the following:
-
Select the mode:
-
Optimize for speed – The speed mode is the default and recommended choice, because it runs much faster (around 2x the frame rate when compared to the memory efficiency mode), but uses higher amount of VRAM.
-
Optimize for memory efficiency – Memory efficiency mode should be used if the user's GPU has a low amount of VRAM and are opening a large model. This mode runs much slower, but it allows opening larger models when limited by VRAM.
Note: The mode selection has no effect on the system RAM usage, only the GPU memory usage.
-
-
Generate metallic materials – This setting is used to control if some objects have shiny/mirror-like/metallic material. Some objects like cylinders, toruses, cones, and spheres are given metallic materials and the saturation of the original color controls the shininess. This means that the objects with metallic materials and the level of shininess may vary.
-
Selected objects as emissive – This setting allows any object to produce light and illuminate its surroundings. First select some objects in model view, then launch Presentation Mode with the option Selected objects as emissive enabled. If the Use object color option is enabled, then the emissive color for each object will be the same as the object's normal color. If Use white color is enabled, all emissive colors are set to white.
-
-
Select Launch. The dialog closes and the current model will start loading in presentation mode. The loading status is shown in a separate dialog. If all of the system requirements are not met, the loading will stop and display an error message. If the application runs out of GPU VRAM, first a warning is given, and then an error message if loading the model fails due to VRAM being full.
-
The presentation mode opens with a floating Settings dialog.
The Settings dialog has the following options specific to presentation mode:
-
Rendering options
-
Quality preset – Quality selection for the presentation mode. The options are Low, Medium, High, and Ultra. Lower values increase performance with the cost of rendering quality, and higher values increase rendering quality with the cost of performance, respectively.
Ambient occlusion produces a clear visualization with higher quality and high performance and allows seeing the interiors of a model without any incoming light. When ambient occlusion is selected, none of the options in Lighting options will have an effect.
-
-
Lighting options
-
Sun – If enabled, the direct light from the sun is visible.
Note: Even when sun light is disabled, the atmosphere remains unchanged and provides some illumination that depends on the position of the sun.
-
Elevation – The elevation of the sun, measured from the horizon to the middle of the sun. The range is -10 - 90 degrees. A negative value means the sun is below the horizon.
-
Azimuth – The direction of the sun in xy-plane, where 0 is in direction of positive y-axis. The range is 0 - 360 degrees.
-
Spotlight – If enabled, a secondary light source is used.
-
Follow camera – If enabled, the spotlight is attached to the camera and moves with the camera. If disabled, the spotlight will remain in the current position when the camera is moved.
-
Luminosity – Controls the brightness of the spotlight. The brightness is exponential.
-
Spot cone – If enabled, the spotlight illuminates only in a conical direction. If disabled, it acts as a point light radiating in all directions.
-
Angle – Adjusts the angle of the spot cone (angular diameter). The range is 1 - 180 degrees.
-
-
Post-processing
-
Auto Exposure – If enabled, automatically adjusts the exposure of the current scene to become brighter or darker. It increases the brightness of the image in dark lighting conditions to make the environment more visible, and in bright conditions lowers the brightness to prevent clipping.
-
Exposure – Adjusts the overall lightness or darkness of the colors. Primarily affects highlights.
-
Brightness – Alters the overall light level of the colors more evenly across shadows and highlights. Gentler adjustment than exposure.
-
Contrast – Increases or decreases the difference between the dark and light areas. Higher contrast makes the shadows darker and the highlights brighter, and lower contrast makes the view look flatter.
-
Saturation – Controls the intensity of the colors. Increasing saturation makes colors more vivid, and decreasing it moves colors toward gray.
-
Bloom – If enabled, a bloom effect is added to bright highlights to add to the perceived realism of the image.
-
Strength – Scales the intensity of the whole bloom effect.
-
Radius – Scales the size of the bloom effect around bright highlights.
-
-
Display
-
HDR10 – If enabled, enables output in High Dynamic Range (HDR) displays' HDR10 format with Rec. 2020 color space. This offers features such as higher contrast and a wider color gamut. To use this feature you must have a display with HDR support. Additionally, you must enable HDR in Windows display settings for the active display.
-
Max nits – Sets the maximum peak brightness for the outputted image in nits (cd/m²). You should set this value to the maximum peak nits of your display to avoid clipping or under exposure.
To reset settings, select Reset settings.
To view presentation mode in full screen mode, select Full Screen Mode. Click Esc key to exit full screen mode.
-
-
-
Select Exit Presentation Mode in Settings dialog to return to normal visualization.
Full screen mode
Opens the 3D view in full screen mode for model browsing. Click Esc key to exit full screen mode.
Camera location
In the Settings menu, select Camera Location to view the absolute coordinates of the camera position in millimeters.
You can move the camera by adjusting the X, Y, and Z coordinates, rotate the camera horizontally, and tilt the camera vertically by specifying the slope angle (90 degrees is straight down, -90 degrees is straight up).
Update model
In the Settings menu, select Update Model to reload the model into the 3D viewer. Models are cached locally, and when you open a model the system checks whether the model has been updated. If the model is being loaded over the Internet, you are prompted to confirm the updating, while locally stored models are automatically updated.
Typically, you perform this if you know that the model has been updated while you were browsing it. If the 3D viewer is embedded on a web page, refreshing the web page also updates the model.