Scripting: New API for 3D Model Layers

Hi, everyone,

Starting with AE 24.4 Build 25 beta, we have introduced a new scripting API which will make it easier to differentiate 3D model layers from other AV layers. We decided to expose it to Beta in response to your feedback.

We are updating the Scripting Documentation, where you will find more detailed information about this new API. Here is a quick overview of the new API:

ThreeDModelLayer object

When you add a 3D model layer to a composition, there was previously no way to differentiate it from another AV layer in script. It simply showed up in the scripting DOM as an AV layer. Customers requested a way to tell them apart. This new API lets you explicitly test whether the layer is a ThreeDModelLayer.

    var importOptions = new ImportOptions();
    importOptions.file = new File("MyModel.glb");
    var threeDModelItem = app.project.importFile(importOptions);
    var threeDModelLayer = comp.layers.add(threeDModelItem);
    if (threeDModelLayer instanceof ThreeDModelLayer)
    {
      ...
    }

As always, we are interested in hearing about the successful use of our APIs and feedback on how they might be made better for your workflow.

Tom Olsen
After Effects Engineering