Skip to main content

I can’t import a specific file into the Pixyz software.

Updated
Symptoms:
  • The software crashes or displays an error message during file import.
  • Imported 3D models appear incorrectly, showing issues such as missing parts, distorted geometry, incorrect positioning, or unexpected material and color changes.
  • The original file's characteristics, like hierarchy or metadata, are altered after import.
  • The import process freezes or becomes unresponsive.

 

Cause:
 
  • Unsupported File Format or Version: The primary reason for import failures or crashes is attempting to load a 3D file format or a specific version of that format that is not supported by your Pixyz product (Unity Asset Transformer Studio, SDK, or Toolkit).
  • File Complexity: Very large, intricate, or potentially corrupted 3D models can strain system resources, causing the software to become unresponsive or crash during import or subsequent operations.
 
Resolution:
 
  1. Verify Supported Formats: Always confirm that the file format and its specific version are officially supported by your Unity Asset Transformer (formerly Pixyz) product. Refer to the official product documentation for the comprehensive list of compatible formats.
  2. Utilize Alternative Importers: If your file format supports it, try enabling the "Prefer Alternative Importers" option.
    • For Unity Asset Transformer Studio:
      1. Open Unity Asset Transformer Studio.
      2. Go to PREFERENCES (accessible via F9 or through the menu, e.g., Edit > Preferences).
      3. Navigate to the IO (Input/Output) section.
      4. Locate the PreferAlternativeImporters option.
      5. Set this option to True.
      6. Attempt to import your file again. This setting allows Pixyz Studio to try an alternative method for importing CAD files if the default importer encounters issues for that specific format.
    • For Unity Asset Transformer SDK:
      1. Use the core.setModuleProperty function to set preferences.

      2. Set PreferAlternativeImporters using core.setModuleProperty

        IO PreferAlternativeImporters Boolean False Up to two different import implementations exist for some formats
    • For Unity Asset Transformer Toolkit (formerly Pixyz Plugin):
      1. From the Toolbox menu, click Import Model or Import Point Cloud

      2. Select the source file to import.

        A new CAD Importer Scriptable Object script with the name of the source file is created in the 3DModels folder, and automatically focused in the Inspector. It stores the link to the source file and the import parameters.

      3. From the Inspector, toggle the Debug mode, clicking the More Items (⋮) button
      4. From the list of parameters listed in the Inspector, enable the Prefer Alternative Importers parameter
      5. From the Inspector, toggle the Normal mode, clicking the More Items (⋮) button
  3. Update Your Software: any known import issues and regressions are being addressed in ongoing development. Ensure you are using the latest available version of your Unity Asset Transformer product.
  4. Contact Support: If the file format is supported and the issue persists after applying the above resolutions, or if you suspect you've encountered a new bug or regression, please contact Pixyz Support. Provide a detailed description of the problem, the specific Unity Asset Transformer product and version you are using, and, if possible, the problematic file for reproduction.
 
More Information:
 
 

Related to

Related articles