meshfx // USD SCALE

How to fix the scale of a USD file

You fix a USD file's scale by checking the stage's metersPerUnit value, which says what one unit means, and its upAxis. When metersPerUnit is missing, USD assumes 0.01, which is centimeters. Set it to match the numbers in the file, or scale the root prim, then import into your engine again.

pyrofx effects work today, and new accounts start with $5 of usage.

MODULE // meshfx AVAILABLE

meshfx measures faults, checks repairs and makes LODs for a triangle budget. meshfx runs on the hosted API: try it in the Playground.

  • metersPerUnit: 1 for meters, 0.01 for centimeters
  • Unset, USD assumes 0.01
  • upAxis: Y or Z, set on the stage

01 // WHY

Two ways a USD file can be off

USD keeps units as stage metadata. metersPerUnit tells importers how to read every coordinate, and upAxis says whether Y or Z points up. If an editor writes positions in meters but leaves metersPerUnit out, an importer that honors the metadata reads centimeters and shrinks the model 100 times. If the metadata is right but the model was built at the wrong size, scale the geometry instead of editing the metadata.

USD does not rescale a referenced file whose units differ from the stage. A prop authored in centimeters, referenced into a meter scene, comes in 100 times too big while everything around it looks right.

02 // HOW TO

Check and fix the units

  1. Open the file as text (convert a binary .usdc to .usda with usdcat) and read the stage metadata at the top, where metersPerUnit and upAxis sit.
  2. Compare with a known size. A 2 m door with coordinates near 2 needs metersPerUnit = 1; coordinates near 200 need 0.01.
  3. If the metadata is wrong, fix it in your 3D editor's stage or export settings, or in the .usda header.
  4. If one referenced file uses different units, add a scale to its root prim (xformOp:scale) so it matches the stage.
  5. Import again. Unreal Engine's USD importer reads metersPerUnit and upAxis; for an engine without a USD importer, export GLB, which is always meters.

FBX and USD input are not supported by meshfx. Export glTF, GLB, OBJ, STL or surface PLY first, then inspect the measured output. Hosted meshfx runs are available in the Playground.

04 // FAQ

USD scale questions

All questions →

README.FIX_MODEL_SCALE_USD
Does Unreal Engine read USD units?

Yes. Its USD importer reads metersPerUnit and converts to centimeters, so wrong metadata gives a wrong size.

Can Unity import USD files?

Yes, through Unity USD package; the default Model Importer does not read USD. You can also convert USD to FBX or GLB for Unity.

Does Godot import USD?

Not with its standard importers. Convert the USD to GLB in a 3D editor, which also turns the units into meters.

How do I fix incorrect object scale before exporting USD?

Apply the scale and set metersPerUnit to the unit you modeled in, 1 for meters. Check upAxis while you are there.

Explore meshfx outputs

Inspect compiled meshfx outputs and their reports. Hosted meshfx runs are available in the Playground.

All effects, guides and explainers →