Documentation

​
​

Development

User Acquisition

Monetization

Industry

Asset Transformer Studio

2026.5.0

Supported
​

User Manual

Python API

Changelog

Asset Transformer Studio

2026.5.0

Supported
​

​
​
Get started
  • About Asset Transformer Studio
  • Getting started
  • Additional Resources
User Interface
  • Overview
  • Menu Bar
  • Toolbars
  • Window
  • Customizing the User Interface
Data Preparation Fundamentals
  • Overview
  • General Information
  • Typical Data Preparation Workflow
  • About 3D Models Types
  • About the Product Structure (Tree)
  • About Occurrences
  • About Instances & Prototypes
  • About Face and Vertex Normals
  • About UVs
  • About Tessellation
  • About Decimation
  • About Animation
  • Glossary
Working With Asset Transformer Studio
  • Overview
  • Videos and Tutorials
  • Supported File Formats
  • Importing Files
    • Import Mode
    • Guided Import
    • Importing Alias Files
    • Importing VRED Files
    • Importing RVM Files
    • Importing ReCap Files
  • Exporting Files
  • Scripting With the Python API
  • Interrupting a Process
  • Plugins
  • Errors in Asset Transformer Studio
Python API Reference
  • Overview
Changelog
  • Changelog
  1. Asset Transformer Studio
  2. Working With Asset Transformer Studio
  3. Importing Files

Importing VRED Files

How to import Autodesk VRED .vpb files in Asset Transformer Studio
Read time 3 minutes
Last updated 9 hours ago

VRED models can be imported within Asset Transformer Studio, in order to optimize and reuse them in other virtual experiences.
Importing a *.vpb file in Asset Transformer Studio requires
Autodesk VRED Pro
or
Autodesk VRED Design
to be installed (with a valid license) on the same computer on which Asset Transformer Studio is running.
Note
Only geometries (meshes or BRep surfaces) and equivalent materials are directly imported inside Asset Transformer Studio's scene.

Configuring Asset Transformer Studio

To start importing *.vpb files in Asset Transformer Studio, the software needs to be configured first from the menu Preferences:
  1. Press
    F9
    or go to Edit menu > Preferences >
    IO
    >
    Import
    >
    Vred
  2. Fill the path in the
    VredExecutablePath
    field: browse to the
    VREDPro.exe
    file (most likely located in the
    bin/WIN64/
    directory).
VRED configuration
If the path is not properly configured, Asset Transformer Studio will prompt the following error message:
VRED error

Importing a *.vpb file

VRED import

PreferLoadMesh
: False

If the *.vpb model contains NURBS data, you can choose to import these by setting the preference
IO
>
Import
>
PreferLoadMesh
to 'False'.
Because of how *.vpb files are formatted, all the surfaces will be divided in different occurrences. This will considerably increase the import time and the number of parts.
We strongly advise to use Merge Final Level, followed by Repair CAD (
orient
= 'False') functions after importing:
  1. Importing (wireframe view): 94 235 parts, surfaces are not stitched together.
    Import wireframe
  2. MergeFinalLevel
    and
    RepairCAD
    : 3 545 parts and surfaces are stitched together.
    After merge
  3. Tessellation: 5M triangles.
    After tessellation
If the preference
IO
>
Import
>
PreferLoadMesh
is set to 'True', the mesh displayed in VRED will be imported (UVs and ambient occlusion are imported).

PreferLoadMesh
: True

VRED Mesh: 50M triangles:
VRED mesh
To import ambient occlusion as vertex colors, open Autodesk VRED and set
ExportVertexColors
to 'True' in Preferences >
FileIO
>
FBX
>
Export
:
Export vertex colors

Importing Variants

If the preference
IO
>
Import
>
LoadVariant
is set to 'True', geometrical variants and material variants are imported:
  • The custom property
    _PIXYZ_TRANSFORM_SWITCH_TAG
    is added to the switch occurrences.
  • The custom property
    <_PIXYZ_MATERIAL_SWITCH_TAG, *switch material name*>
    is added to occurrences having a material switch.
  • Material variants can be retrieved in the material library or in the
    _Pixyz_MATERIAL_POOL
    occurrence in the Product Structure:
    Material pool
  • More information regarding the imported *vpb materials and variants can be found in additional files (created at import). Their links are attached to the
    Root
    node as custom properties:
    Custom properties

Importing animations

An *.fbx file containing information on the *.vpb animations is exported during the process (animations are preserved when importing a *.vpb file). The link is attached to the
Root
node as a custom property:
Animation custom property

Importing Realistic materials

Properties of VRED shaders included in a *.vpb file can be retrieved at import as Custom Materials, by enabling the preference
ImportRealisticMaterial
in
IO
>
Import
>
Vred
.
Importing these Custom Materials will not create a VRED-like shader/material ready to display in Asset Transformer Studio. The purpose of keeping this information is for digital continuity.
For example, if a user wants to recreate VRED-like shaders in an application, they can use the
Custom Materials
properties to do so.
Realistic materials

Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page
    • Configuring Asset Transformer Studio

    • Importing a *.vpb file

      • PreferLoadMesh: False

      • PreferLoadMesh: True

      • Importing Variants

      • Importing animations

      • Importing Realistic materials