New in Beta: Parametric Mesh Scripting APIs

Hello AE beta users! 

Version 26.3.058 of After Effects Beta introduces scripting APIs for Parametric 3D Meshes. 

 
These new APIs enable you to use scripting to create and customize the six types of parametric 3D meshes introduced in After Effects 26.0: cube, sphere, plane, torus, cone and cylinder.

Whether you want to create precise data visualizations or just fill a comp with dozens of colorful cubes and spheres, scripting makes it easy. 

New APIs 

Check layer type 

     Layer instanceof ParametricMeshLayer 

     Description 

     Enables the script author to check whether layer is a parametric 3D mesh layer. 

     Type 

     Boolean; read-only. 

Create mesh layer 

     LayerCollection.addParametricMesh(name, parametricMeshType) 

     Description 

     Creates a new parametric 3D mesh layer. 

     Parameters 

     Returns ParametricMeshLayer  object. 

ParametricMeshLayer object 

     Description 

     Return true if it is a parametric mesh layer, and false otherwise. 

     Type 

     Boolean; read-only. 

     Example 

     comp.layer(index); 

     if (layer instanceof ParametricMeshLayer) 

     { 
            // do something... 
     } 

ParametricMeshOptions object 

     comp.layer(index).parametricMeshOptions 

     Description 

     Return Mesh Options based on the ParametricMeshType of the layer. 

     Type 

     Property group; read-only. Types of sub-properties vary; read-write. 

     Parametric Cube properties 

     parametricMeshOptions.width 

     parametricMeshOptions.height 

     parametricMeshOptions.depth 

     parametricMeshOptions.smoothingAngle 

     Parametric Sphere properties 

     parametricMeshOptions.radius 
     parametricMeshOptions.sides 
     parametricMeshOptions.sliceCaps 
     parametricMeshOptions.sliceStart 
     parametricMeshOptions.sliceEnd 
     parametricMeshOptions.smoothingAngle 

     Parametric Plane properties 

     parametricMeshOptions.width 
     parametricMeshOptions.length 
     parametricMeshOptions.cornerRadius 
     parametricMeshOptions.cornerSides 

     Parametric Torus properties 

     parametricMeshOptions.ringRadius 
     parametricMeshOptions.pipeRadius 
     parametricMeshOptions.ringSides 
     parametricMeshOptions.pipeSides 
     parametricMeshOptions.caps 
     parametricMeshOptions.sliceStart 
     parametricMeshOptions.sliceEnd 
     parametricMeshOptions.smoothingAngle 

     Parametric Cone properties 

     parametricMeshOptions.topRadius 
     parametricMeshOptions.bottomRadius 
     parametricMeshOptions.height 
     parametricMeshOptions.sides 
     parametricMeshOptions.topCap 
     parametricMeshOptions.bottomCap 
     parametricMeshOptions.sliceCaps 
     parametricMeshOptions.sliceStart 
     parametricMeshOptions.sliceEnd 
     parametricMeshOptions.smoothingAngle 

     Parametric Cylinder properties 

     parametricMeshOptions.radius 
     parametricMeshOptions.height 
     parametricMeshOptions.sides 
     parametricMeshOptions.topCap 
     parametricMeshOptions.bottomCap 
     parametricMeshOptions.sliceCaps 
     parametricMeshOptions.sliceStart 
     parametricMeshOptions.sliceEnd 
     parametricMeshOptions.smoothingAngle 

ParametricBevelOptions 

     comp.layer(index).parametricBevelOptions 

     Description 

     Returns Bevel Options based on the ParametricMeshType of the layer.

     Note: only cubes, cones and cylinders support bevels. 
     When trying to access bevel options on parametric mesh types that don’t have bevels, you will get a 
     "mesh type does not have bevel options” warning. 

     Type 

     Property group; read-only. Types of sub-properties vary; read-write.

     Parametric Cube properties 

     ParametricBevelOptions.radius 
     ParametricBevelOptions.sides 

     Parametric Cone properties 

     ParametricBevelOptions.topRadius 

     ParametricBevelOptions.topSides 

     ParametricBevelOptions.bottomRadius 

     ParametricBevelOptions.bottomSides 

     Parametric Cylinder properties 

     ParametricBevelOptions.radius 
     ParametricBevelOptions.sides 

Please give this new functionality a try and let us know how it’s working for you.