Skip to content

Settings

Settings are stored in the browser, not in the model. They follow the person at the machine rather than the twin: a colleague opening the same link sees their own settings, and a delivery can lock individual tabs so an operator cannot change them.

Open them from the gear at the bottom of the left bar. The tabs scroll horizontally when the panel is narrow; the arrows at both ends move through them.

The viewer version and build number sit at the bottom of every tab. Quote that line in any support question — it identifies the exact build you are looking at.

The Visual tab: presets, render mode, environment, tone mapping, lighting and shadows

The largest tab, and the one to reach for when the model runs sluggishly or looks wrong.

GroupWhat it holds
Visual PresetsA named set of all visual settings. Save your own with Save settings as preset
Render ModeShaded or a reduced mode, plus how strongly the environment lights the scene
Environment / FloorBackground, floor on/off, floor brightness and colour, checker contrast, reflection strength and blur
Tone MappingThe curve that maps rendered brightness to the screen
Lighting & ShadowsDirectional light, intensity and colour, shadows on/off, shadow intensity, quality, shadow-map size and radius
Post-ProcessingBloom intensity, threshold and radius
DisplayUI zoom from 75 % to 200 %, source markers, the drive axis gizmo, toolbar labels, antialiasing and render resolution
RendererThe 3D backend and static mesh batching — the batching switch is a kill switch for render problems and reloads the viewer
CameraPerspective or orthographic, and the field of view

If the frame rate is low, work down this list: shadow quality, then shadow map size, then resolution, then antialiasing, then reflections. Each step gives back noticeably more than the one before it costs in appearance.

UI zoom is worth knowing about on a panel PC: at 125 % or 150 % the overlay stays legible at arm’s length without touching the operating system’s scaling.

The Mouse & Touch tab: rotate, pan and zoom speed, damping and adaptive navigation

Rotate, pan and zoom speed, the inertia that keeps a movement gliding after you let go, and Adaptive Nav, which scales the speed with how far the camera is from what you are looking at — the setting that stops a large plant from feeling sluggish and a small assembly from flying past you. Reset defaults puts the group back.

Zoom speed applies to the mouse wheel, the trackpad and pinch alike.

The Start View tab: the stored camera position for this model

The camera position a model opens with. Without one, the viewer fits the model into the view — good enough for browsing, rarely right for a delivery.

Frame the view you want, then Save current camera as start view. It is stored per model, so different twins can each open where they should. Clear start view returns to fit-to-bounds.

The Simulation tab: physics for the scene and the full-physics beta

Controls the local simulation rather than the connection to a machine.

Physics (whole scene) decides whether moving parts become physical bodies when they leave a conveyor — falling, sliding and stacking instead of disappearing. Without explicit physics zones in the model, the whole scene counts as one zone.

Full physics — all conveyors is a beta step further: every non-radial conveyor runs as a physical belt. Both take effect on the next model load, which the tab says on the switch itself.

The Groups tab: which visibility groups are hidden at load and which stay out of the overlay

A model brings visibility groups with it — fences, housings, covers. This tab decides two separate things:

  • Default visibility — which groups are hidden when the model loads. Hiding the fence by default is the usual first move on a cell.
  • Excluded from overlay — which groups do not appear in the Groups panel at all. Use it to keep an operator’s list short rather than to hide something.

The Local Folder tab: the expected folder structure and the working folder picker

Points the viewer at a folder on your own machine as a source of models and library components — no server, no upload.

The structure is fixed and the names have to match exactly:

<working-folder>/
├── models/ ← full scenes for the model selector (.glb)
├── library/ ← Layout Planner components (.glb + splats)
│ ├── conveyor/ ← optional category subfolders
│ ├── robot/ (folder name = category in the planner)
│ └── machine/
└── splats/ ← reality-capture point clouds (.splat .ksplat .ply)

Access is read-only, other folders next to these are ignored, and the viewer recurses at most five levels deep. The folder handle lives in the browser, so after a reload you may be asked to grant access again.

The Interfaces tab: protocol selection and how signal chips are rendered

Interface protocol selects how the viewer talks to a controller when it is not going through realvirtual CONNECT.

Signal display decides how much a signal chip shows — from the full name with value down to a compact form — and which details the tooltip adds: value, address and source, comment, binding. It is a global default; a specific usage in the model can override it.

The Multiuser tab: session state, relay server, join code, display name and role

Shared sessions, where a delivery has them: server URL, join code, display name, and the role you connect with — Observer watches, an operator role may interact. The state line shows whether you are connected, and a switch keeps the multiuser button out of the toolbar when the feature is not wanted.

The AI tab: the AI bridge stays closed until its reach has been reviewed

The AI bridge and the documentation index behind AI diagnosis. It opens only after you have seen what it can reach on this device — deliberately, because an assistant with access to a running machine view is not something to switch on absent-mindedly.

The Features tab: every runtime plugin with its own switch, per workspace mode

The runtime plugins that make up this delivery, each with a switch and a column per workspace mode — HMI, DES, Planner, Editor. A tick means the plugin participates in that mode; a dash means it does not, and CORE marks the ones that run in every mode. A lock marks plugins a delivery has protected against being switched off.

Switching a plugin off disables its lifecycle callbacks and mode hooks. UI slots stay visible and resources stay loaded, so this is a diagnostic tool — “does the problem disappear without this plugin?” — rather than a way to slim down a delivery.

The Dev Tools tab: profiler, scene statistics, optimization results and the performance budget

Diagnostics, and the fastest answer to “why is this model slow”:

  • Scene (from GLB) — triangles, meshes, drives, GLB size and load time, straight from the loaded file.
  • Optimization — what the loader did with it: materials merged, geometries shared, static and textured batches formed.
  • Rendering — frame rate, frame time, draw calls, textures, JS heap, and which renderer is active.
  • Picking & Highlight — how long a click takes to resolve, split by acceleration structure.
  • Performance budget — each of those against a target, in percent. The bar that is at 100 % is the one to fix.
  • GPU benchmark, profiler overlay and library cache round it off; clearing the library cache is what you do after swapping a .glb on disk under the same name.

The experimental 3D backend switch replaces the Three.js view with an Omniverse RTX stream while HMI, signals and charts stay as they are.

The Tests tab: the in-browser test runner, available on the development server only

Runs the browser test suite. Available on the Vite development server only — in a delivered viewer the tab reports exactly that.

The Backup tab: export, import and reset of all browser-side settings

Export settings writes everything on this page to a file; Import reads it back — the way to give a second machine the same setup without clicking through every tab.

Reset all settings to defaults clears the saved browser settings and reloads. Clear legacy WebViewer data removes leftovers from an older storage scheme; saved scenes are not affected.