Omniverse CAD Converter [omni.kit.converter.jt_core]

Overview

omni.kit.converter.jt_core uses the Siemens JT Open Toolkit (JTTK) SDK to convert JT data formats to USD. This extension is the backend core used for CAD Converter Services and JT Converter front end.

When this extension loads, it will register itself with the CAD Converter service (omni.services.convert.cad) if it is available.

Licensing Terms of Use and Third-Party Notices

• NVIDIA Omniverse is licensed to use the Siemens Open JT Toolkit SDK for the Omniverse JT Converter.

• Omniverse JT Converter is free to use for NVIDIA End Users and Companies that agree to the NVIDIA Software License Agreement, the Product-Specific Terms for NVIDIA Omniverse, and the Siemens License Terms. The First Party user is prohibited from redistributing, transferring, or otherwise sharing the software with any third parties, without express written consent from the software provider.

• Please read the Siemens License Terms in the Third_Party_Notices.md for details.

Related Extensions

These related extensions make up the JT Converter. This extension provides import tasks to the extensions through their interfaces.

CAD Converter: omni.kit.converter.cad

• The primary CAD Converter extension, which enables all of the CAD Converter Extension dependencies.

Converter Common: omni.kit.converter.common

• Common Kit Extension of shared functions and helpers for the different Converters.

JT Converter: omni.kit.converter.jt

• Kit extension for handling UI input of parameters to pass to the jt.core extension for converting JT files in kit applications.

JT Converter Core: omni.kit.converter.jt_core

• Headless Kit extension for converting JT files.

CAD CONVERTER CONFIG FILE INPUTS:

Conversion options are configured by supplying a JSON file. Below are the available configuration options.

Documentation Changes:

This section lists changes to this extension’s documentation for this release (202.0.0).

What Was Added

• iUpAxis - override the up-axis of the converted USD’s stage to Y-up, Z-up, or default to the converter’s up-axis setting.

• dMetersPerUnit - set the meters per unit converted USD’s stage metric. If set to 0.0, the converted USD will retain the meters per unit from conversion.

• sOptimizeConfig - (Experimental feature) Provide a path to a saved Scene Optimizer JSON configuration file or a JSON formatted string for executing a predefined optimization process stack.

• Instructions on how to run core extensions via CLI:

  • Please refer to omni.services.convert.cad for more information.

JSON Converter Settings:

• Format: “setting name” : default value

Converter Option: Convert Curves

• Description: If true, convert curve elements into USD Basis Curves; else, ignore these elements.

• Default Value: false

• Value Ranges: true, false

• Data Format: bool

Config File Example Entry:

"bConvertCurves" : false,

Converter Option: Generate UVs

• Description: If true, use Scene Optimizer to generate uvs for any Mesh prims that do not have them.

• Default Value: true

• Value Ranges: true, false

• Data Format: bool

See Scene Optimizer Service documentation for details.

Config File Example Entry:

"bOptimize " : true

Converter Option: Instancing Style

• Description: Style of instancing to use in USD when handling instanced Parts and Assemblies in the JT file;

  • eNone = 0, eReference = 1, eInstanceableReference = 2.

• Default Value: 0

• Value Ranges: [0, 2]

• Data Format: integer (enumeration)

"instancingStyle" : 0

Converter Option: Override Tessellation Geometry

• Description: If true, embedded tessellation geometry will be ignored in favour for explicit tessellation of surface geometry.

• Default Value: false

• Value Ranges: true, false

• Data Format: bool

Config File Example Entry:

"overrideTessellationGeometry" : false

Converter Option: Override Tessellation Parameters

• Description: If true, embedded tessellation parameters will be ignored in favour for explicit tessellation parameters.

• Default Value: false

• Value Ranges: true, false

• Data Format: bool

Config File Example Entry:

"overrideTessellationParameters" : false

Converter Option: Override Up-Axis

Description: Override the up-axis of the converted USD’s stage to Y-up, Z-up, or default to the converter’s up-axis setting.

Default Value: 0 Value Ranges: [0, 2]

• 0 to default to converter’s up-axis

• 1 to override to Y-up

• 2 to override to Z-up Data Format: integer

Config File Example:

"iUpAxis" : 0

Converter Option: Meters Per Unit

Description: Set the meters per unit converted USD’s stage metric. If set to 0.0, the converted USD will retain the meters per unit from conversion.

Default Value: 1.0 Value Ranges: Positive numbers Data Format: double

Config File Example:

"dMetersPerUnit" : 1.0

Converter Option: Scene Optimizer Config

Description: (Experimental feature) Provide a path to a saved Scene Optimizer JSON configuration file or a JSON formatted string for executing a predefined optimization process stack.

See Scene Optimizer Service documentation for details.

Default Value: “” Data Format: string

Config File Example:

"sOptimizeConfig" : "optimize_sample_config.json"

Full Example JT Conversion Config file sample_config.json:

{
  "bConvertCurves" : false,
  "bOptimize " : true,
  "instancingStyle" : 0,
  "overrideTessellationGeometry" : false,
  "overrideTessellationParameters" : false,
  "iUpAxis": 0,
  "dMetersPerUnit": 1.0,
  "sOptimizeConfig": "optimize_sample_config.json"
}