User Guide

RealityConnect for Revit is designed to bridge the gap between high-fidelity digital twins and your BIM environment. It allows you to stream large-scale reality capture data directly into Revit without draining system resources and provides a streamlined interface for asset management.

---

Accessing your data

To access your data, you must first establish a connection to Prevu3D.

1. In Revit, click the Connect button in the Prevu3D ribbon.
   A web browser will open and redirect you to the Prevu3D authentication page.

2. In your web browser, sign in to your Prevu3D account if required.

3. In the web browser, authorize the plugin to access your organization’s data.

4. Back in Revit, the connection dialog opens with your Organization and signed-in account shown in the header. Select:

   • the Division,

   • then the Site that contains the desired RealityTwin.

5. Click Continue to confirm the connection.

6. Once connected, the Display Environment and Manage Assets buttons become available.

Note

Your session is cached securely on your machine, so you stay signed in between Revit sessions and reconnecting no longer reopens the browser. To sign in with a different account or organization, use the Switch button in the connection dialog header.

Environment Display

The Environment Display tool streams the selected RealityTwin directly into the active 3D view, providing immediate site context for your project.

• Show / hide environment
  Click Display Environment to stream and display the environment in the current view.
  Once active, the button changes to Hide Environment, allowing you to remove the environment overlay with a single click.

• In-memory streaming
  The environment is streamed entirely in memory, without creating or loading files on disk, ensuring fast interaction and minimal impact on system resources.

• View-dependent refinement
  The scene is progressively refined based on the camera position in both orthographic and perspective 3D views, improving visual quality where it matters while maintaining smooth performance.

For details about rendering options, HLOD behavior, and performance limits, refer to the Environment Settings documentation.

Asset Manager

The Asset Manager allows you to browse, manage, and import assets from the selected RealityTwin into your Revit model.

Note

Loaded assets adapt to the current display style. When the environment overlay is shown, assets imported in Embedded mode are flat-coloured and filled by the overlay, while assets imported as a Textured Family keep their real texture and can be displayed at the same time as the streamed environment.

Asset operations

• Load Selected
  Load the selected assets into the active Revit view.

• Unload Selected
  Remove the selected assets from the scene if they are currently loaded.

• Locate
  Move the camera to focus on the selected asset.
  The asset must be loaded in the scene for this action to be available.

Global actions

• Refresh
  Reload the asset list from the RealityTwin to synchronize the panel with the latest data.

• Reset
  Restore the Asset Manager to its default state.

Asset filtering

• Search
  Filter assets by name.

• Status filter
  Filter assets based on their current state.

Operation feedback

• Progress column
  Displays the progress of ongoing operations for each asset.

• Status summary
  Displays the number of available, selected, and loaded assets.

For configuration options such as asset quality, positioning, and import behavior, refer to the Asset Settings documentation.

Settings

Use the Settings menu to customize the behavior, performance, and appearance of the Prevu3D plugin.
Settings are organized into three main sections: General, Environment, and Assets.

General

General settings control the overall behavior and appearance of the plugin.

• Import Alignment
  Defines the default alignment used when importing assets into Revit:

  • Shared Coordinates

  • Origin to Origin

• Theme
  Select the visual theme of the plugin:

  • Light

  • Dark

  • Same as Windows

Environment

Environment settings control how the RealityTwin is streamed and displayed in the 3D view.

• Triangle Budget
  Sets the target level of geometric detail for the streamed environment.
  Higher values increase visual fidelity but require more system resources (RAM, GPU, and CPU). The default is 4,000,000. As a rough guide, based on your hardware:

  • ~2,000,000 — entry-level machines or laptops

  • 4,000,000 — balanced default, suitable for most workstations

  • 8,000,000 or more — high-end workstations with a dedicated GPU

  If navigation becomes choppy, lower this value or reduce the Frame Time Budget.

• Frame Time Budget
  Controls navigation smoothness by limiting the amount of processing time per frame.
  Lower values prioritize responsiveness during camera movement, potentially reducing visible detail while navigating.

• Display Mode
  Defines how the environment is rendered:

  • Colored — uses vertex colors from the RealityTwin

  • Shaded — displays geometry using a neutral gray material

• System Statistics
  Displays real-time performance indicators, including:

  • Triangle Count

  • Last Frame Time

  These metrics help evaluate whether the current environment settings are appropriate for your hardware and performance expectations.

Assets

Asset settings define how individual objects are loaded and imported into Revit.

Asset quality levels

Each asset quality level is defined by a target triangle count, allowing you to balance visual detail and performance.

• Low Quality Triangles
  Sets the maximum number of triangles used for assets loaded at low quality.

• Medium Quality Triangles
  Sets the maximum number of triangles used for assets loaded at medium quality.

• High Quality Triangles
  Sets the maximum number of triangles used for assets loaded at high quality.

Each value can be reset individually to its default.

Default asset behavior

• Default Quality
  Defines the quality level used by default when loading assets.

• Import Mode
  Defines how assets are imported into the Revit project:

  • Textured Family — writes a textured OBJ, imports it into a Revit family (Generic Model), and places an instance in the scene while keeping the reusable .rfa in the generated files folder for later standalone re-import. The asset keeps its real texture and Revit’s default look, and the streamed environment is carved out behind it so both can be shown together.

  • Embedded — bakes the geometry directly into the Revit file with no file on disk (flat per-region colours, no texture) for better project portability

• Generated files folder
  Specifies the local folder used to store the generated files (.obj and .rfa) when using the Textured Family import mode. Embedded mode writes nothing. Leave blank to use the default location.