Omniverse DGN Converter [omni.kit.converter.dgn]#

Overview#

The Omniverse DGN Converter converts Bentley Microstation DGN files to OpenUSD format for use in NVIDIA’s Omniverse platform. Built on the Open Design Alliance (ODA) Drawings SDK, it ensures accurate conversion of 3D data to enable DGN models in USD-based workflows.

The extension serves as the user-facing component that configures and initiates conversions, while delegating the conversion work to the core converter running in a separate process to maintain stability.

Key Features#

  • GUI-Based Workflow: Provides an intuitive graphical interface for converting DGN files within Omniverse applications

  • Configurable Parameters: The import options panel exposes the same converter parameters documented for JSON configuration in DGN Converter Core (omni.kit.converter.dgn_core), including advanced options (tessellation, level filtering, model name patterns, custom attribute import, and more). List options are edited as comma-separated plain text in the UI—do not wrap each token in JSON-style double quotes (unlike the quoted strings in a JSON config file). The Attributes field accepts a JSON array of objects (same schema as the attributes key in the config file).

  • 2D Layout Support: When Curve Conversion Style is set to Renderable, 2D layout Shape and ComplexShape boundaries are converted to USD Basis Curves. Nested 2D geometry inside cell headers keeps its placement from 2D cell-header transforms. See the DGN Core 2D layout curve output section for details.

  • USD Format Support: Converts DGN files to USD format while preserving model data and structure

  • Integration with Core Converter: Utilizes omni.kit.converter.dgn_core for the actual conversion process

Supported CAD file formats#

The following file formats are supported by DGN Converter:

  • DGN (*.DGN)

Troubleshooting DGN Errors#

If a DGN conversion fails with an ODA error such as OD_ERROR_DEF: Error code = <code>, Description = <message>, see the DGN Converter Core troubleshooting section. The core documentation explains the DGN/ODA error format, links to the public ODA OdResult enum reference, and lists common read-failure examples.

Installation#

To begin conversion of a DGN file, open an Omniverse App. Once open, confirm the omni.kit.converter.dgn is enabled:

  • Navigate to Window -> Extension Manager

  • Search for omni.kit.converter.dgn

  • Locate and click on the extension.

  • If needed, download and enable the extension.

Getting Help#

For support and issue reporting:

Licensing Terms of Use and Third-Party Notices#

The omni.kit.converter.dgn and related CAD converter Extensions are Omniverse Core Extensions. Do not redistribute or sublicense without express permission or agreement. Please read the Omniverse License Agreements and the Third_Party_Notices.md for detailed license information.