How to create a .usdz animation?

Question

You can now convert 3D models to .usdz files (uncompressed zip archive) using Apple's command line tool bundled with Xcode 10 beta.

Example code to convert an .obj file to .usdz:

xcrun usdz_converter magnifying_glass.obj -g frame magnifying_glass.usdz 
-color_map gold-basecolor.png -normal_map gold-normal.png
-roughness_map gold-roughness.png -metallic_map gold-metallic.png

The following input 3D file types are supported:

• OBJ file
• Single-frame Alembic (ABC) file
• USD file either .usda (ascii) or .usdc (binary)

It's my understanding the OBJ file does not support animation natively.

A single-frame Alembic file won't support animation either as its a single-frame.

So I'm guessing you need to use usda file which link to a sequence of single-frame Alembic or single-frame OBJ files to generate animations.

Is there any Publicly Available documentation on how to go about this?

A usda file can use payload files to reference single-frame meshes. The example below references a Treasure Chest single-frame alembic file geometry.

#usda 1.0

def "Chest_Base" (
     references = [ @./Chest.abc@</Chest_Base> ])
{

}

But I haven't found any concrete way of linking a sequence of .obj or single-framed alembic .abc files together to create say a 10-second animation.

Any help or hint would be greatly appreciated.

Edit 30th June:

I’ve now managed to animate a USDZ file. I’ve got a live demo here of a rotating gears and helicopter.

Basically, I needed to download the usd pipeline from github and build it on my mac. You can get good instructions on how to do that from here

Be warn set aside at least a couple of hours, the build itself takes about an hour.

After that i ran the animated tutorial example in the usd pipeline bundle. Step5.usda (ascii usd file) has an animation example which I followed to create my own animations using rotations.

Running this usdz command will create a simple animation of a spining top if you create the Step5.usda file following the pixar tutorial at the link above.

xcrun usdz_convertor Step5.usda animationTest.usdz

Edit 10th July 2018:

usdz also supports alembic assets (with animations).

I have now managed to get a simple animation working in usdz (using the alembic file format). However, a bone animation on a character I tried didn't work.

I exported Alembic assets with both the Blender & Modo Alembic exporters... same results.

UV materials were also not mapping correctly to the mesh. Something wrong with the uv scaling & mapping... materials come out fragmented. At this stage I don't know if this is a bug, or whether I'm not doing something wrong here. There is some discussion about this uv mapping issue on the Apple forum

Edit 8th Sept 2018:

This is a rapidly evolving area and I'm sure more ways to tackle usdz animation creation will appear over time. However, at present the best & least costly way (open source) to make transform, bone, blend-shape or morph animations usdz files is using a command-line tool hosted on GitHub called glTF2usd.

The tool can convert a glTF animation file into a usda file (the intermediary file type) for creating the usdz file. It should also support direct usdz creation shortly, negating the need to use Apples usdz_converter command line tool to go from usda -> usdz.

Only currently supports 1 animation group. Some bugs still exists regarding rotations, --use-euler-rotation handle can be used to help with smoother rotations.

I've been posting usdz animations I have been creating with the tool to an online usdz gallery www.fusionar.app

Answer 1

Updated: June 02, 2023

USDZ with Animation

You can easily import, animate and then export binary or ascii USD models using Autodesk Maya 2024 software. All you need to do is to know how to animate your model in Maya (whether it's an Asset Animation or Transform Animation), the rest is as easy as saying "cheese".

Read this post to find out how to unzip a USDZ model.

Also, simple Transform Animation for USDZ models is possible in Apple Reality Composer.

For that, just drop USDZ model into Reality Composer's scene, apply any behavior you need to, and then export a resulted scene as USDZ or Reality file.

Note that Transform Animations are programmatically available in RealityKit.

In SceneKit, unlike RealityKit, the animation in USDZ model plays automatically, as soon as the model is loaded. In SceneKit, don't forget to activate the autoenablesDefaultLighting = true option.

USDZ Schemas

If you like Python scripting you can apply simple Transform Animations using USDZ Schemas.

FBX with Animation

If you created an animation in Maya version that doesn't support USD export, bake your animation using a main menu:

Edit -> Keys -> Bake Simulation

After that you can export your scene as .fbx:

File –> Export All (option box) –> FBX Export (dropdown menu)

Now it's time to prepare your .fbx file for Xcode 14 using the following Terminal command:

usdzconvert ~/Desktop/model.fbx -v

If you're using Xcode 10, a command in Terminal looks like this:

xcrun usdz_converter ~/Desktop/model.fbx ~/Desktop/model.usdz -v

A detailed description of how to use the usdzconvert command in Terminal you can see here.

---

And of course, Reality Converter is an easy way for those who prefer GUI:

Answer 2

Now Apple provided a much easier way to convert almost any file (I would recommend using glTF/ glb as export option in Blender):

Reality Converter

It is a simple GUI tool released in January 2021, where you drop your files onto and it will give you a usdz file. Including mesh, materials and animation. For the download you need an Apple developer account.

Answer 3

I had an character with a simple armature animation in .fbx file, and I used "Reality Converter" by Apple to make it into a .usdz file that contains the animation. The animation even works in "Reality Composer".

The link for Reality Converter can be found here.