Artisan API: Accessing native material assignments and Substance parameters
Hello,
I’m developing a third-party 3D renderer plug-in using the Artisan API and would like to support After Effects’ native Material Assignment and Substance materials.
My main test environment is After Effects Beta 27.1x38 on Windows. I have also reviewed the public headers in the After Effects 27.0 SDK.
I’m looking for guidance on the following issues:
1. Accessing the current Substance parameter values
Through ExtendScript’s materialSource, I can retrieve the assigned Substance item and its SBSAR file path. However, I haven’t found a public API to retrieve the Substance-specific input values edited in After Effects, the selected graph, or the output resolution.
This concerns the parameters exposed by the Substance material itself, rather than AE’s projection, scale, rotation, and other mapping controls. I also need to distinguish multiple material instances using the same SBSAR with different settings.
Is there a supported API for reading this current state?
2. Retrieving layer and precomp material references
In the cases I tested, assigning a layer or precomp as the material source on a text layer or GLB model caused ExtendScript’s materialSource to return null, so I could not retrieve the assigned source reference.
What public API should be used to retrieve the source layer reference or layer ID from AE’s native Material Assignment?
I would also appreciate guidance for parametric mesh layers, although I have not yet verified this specific assignment case on them.
3. Accessing Substance maps evaluated by After Effects
Is there a public API that allows an Artisan renderer to access the Base Color, Roughness, Metallic, Normal, Height, and other maps evaluated by After Effects using the material’s current settings?
4. Material Assignment becomes hidden with an Artisan renderer
When switching from Advanced 3D to a custom Artisan renderer, the Material Assignment group itself becomes hidden on text and parametric mesh layers. This is a visibility issue, rather than the group simply collapsing.
Is there a supported way for third-party renderers to keep AE’s native material assignment UI available for editing? I would also like to preserve the native front, bevel, side, and back assignments on text and shape layers.
5. Notifications for material changes
Is there a public notification API for material assignment changes, Substance input edits, assignment removal, relinking, and Undo/Redo?
I need to reflect unsaved changes in rendering and would like to receive change notifications without polling.
If any of these capabilities are available through C++/AEGP, ExtendScript, or UXP, could you point me to the relevant APIs, required AE/SDK versions, documentation, or examples?
If they are currently unavailable, are there plans to expose them to third-party Artisan renderers?
Thank you.
