Skip to main content

Import Settings Guide

General Import Settings​

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

Setting TitleSetting NameLevelType [Range] (Default)Description
Convert Z- to Y-UprotateZUpbasicboolean (false)turns rotation to z-axis pointing upwards on/off
Fix Animation DatafixAnimationDataadvancedboolean (true)cleans up weights so they sum up to 1 and assigns bone 0 for 0-weights
Normal Map Y FlipnormalmapYFlipexpertboolean (false)flip normalmaps Y axis on import. Only affects fbx data.
Examples: | JSON | WebUI | PluginUI |

{
  "version": 1.4,
  "import": {
    "general": {
      "rotateZUp": false,
      "fixAnimationData": true,
      "normalmapYFlip": false
    },
    "USD": {
      "profile": "arkit", 
      "purpose": "render",
      "convertDisplayColors": "never"
    },
    "CAD": {
      "tessellationResolution": "fine",
      "removeTJunctions": false,
      "sewTolerance":0.0 
    },
    "discard": {
      "cameras": false,
      "lights": false,
      "animations": false,
      "morphTargets": false,
      "unusedUVs": false
    },
    "materials": {
      "undefinedDefaults": {
          "baseColor": [1,1,1,1],
          "metallic": 0,
          "roughness": 0.5
       }
    }
  },
  "export": [
    {
      "fileName": "",
      "textureMapFilePrefix": "",
      "discard": {},
      "format": {
        "gltf": {
          "pbrMaterial": {}
        }
      }
    }
  ]
}

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

Fix 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.

Setting TitleSetting NameLevelType [Range] (Default)Description
USD Profileprofilebasicstring [generic, arkit] (arkit)Defines how input USD files are interpreted
USD Purposepurposeexpertstring [render] (render)Defines the purpose of rendering a prim, used to control render visibility and classify prims into visibility categories
Convert Display ColorsconvertDisplayColorsexpertstring [never, auto, vcolor, mtcolor] (never)How to convert USD display colors

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.

Setting TitleSetting NameLevelType [Range] (Default)Description
ResolutiontessellationResolutionbasicstring [coarse, medium, fine] (fine)Tessellation resolution for imported CAD surfaces
CAD Remove TJunctionsremoveTJunctionsexpertboolean (false)Attempts to remove T-Junctions after CAD tessellation (experimental)
CAD Sewing TolerancesewToleranceadvancednumber [>=0 && <=1.7976931348623157e+308] (0)Tolerance for the sewing operation on the b-reps before tessellation

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.

Setting TitleSetting NameLevelType [Range] (Default)Description
Discard Camerascamerasbasicboolean (false)if true, discards any imported cameras
Discard Lightslightsbasicboolean (false)if true, discards any imported lights
Discard Animationsanimationsbasicboolean (false)if true, discards any imported animations
Discard Morph TargetsmorphTargetsadvancedboolean (false)if true, discards any imported morph targets (shape keys, blend shapes)
Discard unused UVsunusedUVsexpertboolean (false)"if true, discards unused UV sets (if possible)

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​

Settings for the directly imported Materials from the source data set(s).

Setting TitleSetting NameLevelType [Range] (Default)Description
Import Default Base ColorbaseColorbasicarray [>= 4 && <= 4] ([1,1,1,1])default base color values, applied on import if the material model doesn't define a default base color values already
Import Default Metallicmetallicbasicnumber [>= 0 && <= 1] (0)default metallic value, applied on import if the material model doesn't define a default metallic value already
Import Default Roughnessroughnessbasicnumber [>= 0 && <= 1] (0.5)default roughness value, applied on import if the material model doesn't define a default roughness value already

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: