Documentation

​
​

Development

User Acquisition

Monetization

Industry

Asset Transformer SDK

2026.1

Supported
​

User Manual

Python API

C# API

Changelog

Discussions

Asset Transformer SDK

2026.1

Supported
​
​
​
Get started
  • System requirements
  • Licensing
  • Setup
  • Migrate from Scenario Processor
Framework
  • Framework
  • Preferences
Input/output files
  • Supported formats
  • Import files
    • Import Autodesk Alias files
    • Import Autodesk VRED files
    • Import RVM files
    • Import Autodesk ReCap files
  • Export files
  • Export textures
  • CAD vs Mesh
Scene
  • Product structure
  • Occurrence
  • Component
  • Material
  • Image
Algorithms
  • CAD
  • Healing
  • Optimization
  • Combine and bake
  • Reconstruction
  • UVs
Viewer
  • Viewer
Pixyz UI
  • Setup
  • Overview
  • Create a custom UI
Guidelines
  • Data preparation
  • Process point clouds
Debug and diagnose
  • Log files
  • Debug best practices
Other
  • Samples
  • Glossary
  1. Asset Transformer SDK (ex Pixyz)

Importing VRED Files

Learn how to import VRED .vpb files into Pixyz, including configuration, best practices, and handling variants, animations, and materials.
Read time 3 minutes
Last updated 9 months ago
VRED models usually are pretty advanced scenes including a lot of manual work and knowledge. Those scenes can be imported within Pixyz for seamless usage in various virtual experiences. made with other realtime engines, such as Unity.
Importing a .vpb file in Pixyz requires Autodesk VRED Pro or Design to be installed (with a valid license) on the same computer on which Pixyz is running.
Note
Only geometries (meshes or BREP surfaces) and equivalent materials are directly imported inside a Pixyz scene.

Configuring Pixyz API

To start importing .vpb files in Pixyz, the software needs to be configured when executing a Python file. See the preferences:
pxz.core.setModuleProperty("IO", "VredExecutablePath", "C:/Program Files/Autodesk/VREDPro-11.0/bin/WIN64/VREDPro.exe")

Best practices when importing a VRED model using Pixyz

vred

Without 
PreferLoadMesh

  1. If the .vpb model contains NURBS data
    nurbs
    , you can choose to import these by setting your Pixyz IO preferences as follow:
pxz.core.setModuleProperty("IO", "PreferLoadMesh", "False")
  1. Due to the nature of .vpb files, all surfaces will be divided in different occurrences. This will considerably increase the import time and the number of parts. We strongly advise to use the Merge Final Occurences , followed by a CAD repair (orient = False) functions after importing:
a. Importing (wireframe view): 94 235 parts, surfaces are not stitched together
vred
b. MergeFinalLevel, RepairCAD and meshing: 3 545 parts and surfaces are stitched together. Part Occurrences number is significantly lower:
vred

With 
PreferLoadMesh
set to 
True

If the preference setting 
PreferLoadMesh
is set to 
True
, the mesh displayed in VRED will be imported (any existing UVs and ambient occlusion maps are then preserved).
VRED existing mesh → 50M triangles:
vred
To import ambient occlusion as vertex colors, open Autodesk VRED and set ExportVertexColors to True in Preferences > FileIO > FBX > Export:
vred

Importing Variants

If the preference setting 
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:
vred
  • 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:
vred

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:
vred

Importing Realistic materials

Properties of VRED shaders included in a .vpb file can now be retrieved at import as "Custom Materials", by enabling the ImportRealisticMaterial parameter:
pxz.core.setModuleProperty("IO", "ImportRealisticMaterials", "True")
The purpose of keeping this information is for digital continuity. For example, if a user wants to recreate VRED-like shaders in an application like Unity and its HDRP renderer (HD Render Pipeline)
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 Pixyz API

    • Best practices when importing a VRED model using Pixyz

      • Without PreferLoadMesh

      • With PreferLoadMesh set to True

      • Importing Variants

      • Importing animations

      • Importing Realistic materials

Report a problem with this page