Skip to main content

Import Settings Guide

RapidPipeline 3D Processor logo

info

RapidPipeline 3D Processing Configuration Settings adhere to the 3D Processing Schema and are designed to achieve any 3D processing goal. They operate directly on a 3D model and are able to alter the entire structure or re-create meshes, materials, UVs, texture maps and other 3D model properties.

General Import Settings​

The following settings are applied to all assets on import, regardless of file format.

Convert Z-Up to Y-Up​

Convert Z-Up to Y-Up will rotate the whole asset 90 degrees on the world X-axis.

tip

The asset pivot can be edited with the 3D Edit function Center Object to center, rearCenter, bottomCenter, or topCenter.

Engine asset is shown before and after rotation, with red 3D arrow

Clean Up Animation Data​

Fixes animation data by summing all skin weights for each vertex to 1.0, and assigns all weights with zero strength to bone 0.

Normal Map Y Flip​

Inverts the green channel of all normal maps. If the bump maps look indented instead of out-dented, this option can help fix them. DirectX uses the Y-down convention as shown on the left, while glTF uses the Y-up convention as shown on the right.

A normal map of a sphere is shown before and after flipping the green channel

USD Import Settings​

USD logo

These settings are applied to all USD file imports.

USD Import Profile​

Defines how input USD files are interpreted. There are two options:

  • generic: Most USD files should use this option.
  • arkit: Use this profile if a USD file was generated for use with ARKit using the Apple ARKit schema.

USD Purpose​

Defines the purpose of rendering a prim, used to control render visibility and classify prims into visibility categories.

  • render: This is the default string, but this can be replaced with another strong if desired.

Convert Display Colors​

USD kitchen set

In some pipelines, USD display colors are used as lightweight lookdev lower-fidelity proxies for more complex material data; this setting controls how this data should be handled.

  • never: Display colors are not converted. Display colors are preserved only if a non-optimized or non-flattened USD file is exported. This is the default setting.
  • auto: Same as vcolor.
  • vcolor: Tries to set display colors as vertex colors, but doesn't override existing vertex colors. If vertex colors exist already, sets display colors as material values instead. Regardless, never overwrites existing values.
  • mtcolor: Sets display colors as material values.

CAD Import Settings​

These settings are applied to all CAD file imports. When any of these settings are altered from the default, then the CAD file will be re-imported from the original input file and the new settings will be applied.

Tessellation Resolution​

Imported CAD surfaces are tessellated to fine by default. Assets can be re-imported and tessellated to medium or coarse resolution if desired.

A car asset with three different resolutions shown

CAD Remove T-Junctions​

This setting attempts to remove T-junctions after tessellation has been completed. This is currently an experimental feature.

Illustration of a t-vertex

CAD Sewing Tolerance​

Tolerance for the sewing operation on the b-reps before tessellation.

Car door wireframes, before and after sewing

Minimum 0, maximum 1,000,000,000,000.

A setting of 0 will disable the function.

Discard Properties on Import​

Properties of the 3D assets can be discarded on import.

Discard Cameras​

All cameras will be removed from the 3D assets.

Discard Lights​

All lights will be removed from the 3D assets.

Discard Animations​

All animations will be removed from the 3D assets. Assets will show the state at frame zero.

Discard Morph Targets​

All morph targets will be removed from the 3D assets.

Discard unused UV sets​

All texture coordinates which are not referenced by any textures will be removed from the 3D assets.

Import Material Settings​

Import Material Defaults​

Materials can be assigned default properties, which are applied on import if the material model doesn't define default properties already.

Import Default Base Color​

Materials can be assigned a default base color.

Note this color has four components: red, green, blue, and alpha.

Import Default Metallic​

Materials can be assigned a default metallic value.

Minimum 0, maximum 1, default 0.

Import Default Roughness​

Materials can be assigned a default roughness value.

Minimum 0, maximum 1, default 0.5.

Further Documentation​

For the full Documentation on all available data operations commands and system settings, please refer to the CLI Commands Guide and 3D Processor System Schema & Settings.

info

The 3D Processor is available for multiple interfaces: