Appearance
Model
Brings 3D work into the comp — a model's meshes, materials and animation, a point cloud, or Gaussian splats, as made — for the camera to draw.
Category: 3D Menu path: 3D > Model
Ports
| Port | Type | Direction | Description |
|---|---|---|---|
out | model | output | The model. Wire it through a Transform3D to Output; wherever it meets an image input, the comp camera draws it. Into PointScatter's shape input it is a surface to scatter points over |
points | points | output | The file as Caddis points, fitted like the model with depth in z and colors in color: a cloud's points, the splats' centers, or a mesh's vertices at this moment of its animation. Wire through a Transform 3D to Draw Points, Clone to Points, an emitter… |
Parameters
| Param | Type | Default | Description |
|---|---|---|---|
path | string | — | File: a glTF (.gltf, .glb), FBX (.fbx) or OBJ (.obj, with its .mtl) model; an Alembic cache (.abc: animated meshes and particle caches, read as they stream from disk); a PLY (.ply: a mesh, a point cloud, or 3D Gaussian splats as trained by 3DGS) or XYZ (.xyz) point cloud |
fit | boolean | on | Scale the model so its largest side is Size px, centered on the layer's origin |
size | scalar | half the comp height | With Fit on: the model's largest side, in px. With Fit off: px per unit of the file (glTF units are meters) |
pointSize | scalar | 3 | Point Size: a point cloud's dots, in px across where the camera shows 1:1 (smaller farther away). Shown for point clouds only |
animation | string | the file's first | Which of the file's animations plays; None shows the rest pose |
speed | scalar | 1 | Playback speed of the animation |
timeOffset | scalar | 0 | Seconds added to the animation's clock |
loop | boolean | on | Loop the animation; off holds its last frame |
environment | string | — | An equirectangular image (.hdr, .exr, or any image) that lights the model. Empty: a soft built-in studio |
environmentIntensity | scalar | 1 | Intensity: brightness of the environment's light |
environmentRotation | scalar | 0 | Rotation: turns the environment about the vertical (degrees) |
How It Works
The model looks the way it was made: its base color, metal, roughness, normal, occlusion and emissive maps (glTF's standard material, and FBX's and OBJ's colors and maps) are drawn as authored and lit only by the environment image, as a web 3D viewer shows them. Caddis does not edit materials.
An Alembic cache plays its meshes and particles sample by sample (particles carried along their velocities between samples, for motion blur); its meshes are drawn in a neutral gray, since Alembic carries no materials. A cache holds its last frame by default (Loop off). A Camera layer can follow the camera in a glTF, FBX or Alembic file (its From Model).
An FBX file brings its meshes, hierarchy, skins, blend shapes, cameras and every animation take (each take is one choice in Animation). Its colors and color, normal and emissive maps are read, whether the images are embedded in the file or sit beside it (or in a textures folder next to it); a model whose materials were not exported with it is drawn in gray. FBX animation curves play as straight lines between keys, which matches baked animation exactly. FBX 6 and older files are not read; export them again as FBX 2014 or later.
A point cloud is drawn as round dots in their colors; 3D Gaussian splats are drawn as soft splats, sorted far to near on every frame (the same result every render), in the color they have from every side.
The camera draws the model wherever it meets an image input: at Output, or at the first effect after it. Its depth comes along, so it crosses cards, 3D shapes and points correctly, in either layer order. The animation runs on the layer's clock, with skins and morph targets, and motion blur follows it.
A glTF model is +Y up; Caddis turns it upright on the way in (an FBX is turned by the up axis and units it records). Fit centers the model's rest pose on the layer's origin, so a Transform 3D places and turns it about its middle.
Usage Examples
Basic: A product turning in light
Drag a .glb into the timeline (or the Viewer): you get Model → Transform 3D → Output. Key the Transform 3D's Rotation Y from 0 to 360, set Environment to a studio HDR, and turn on the layer's motion blur.
Creative: A model inside a 2D comp
Give the model layer a Glow after its Transform 3D: the glow works on what the camera sees of the model, and the layer still crosses other 3D layers by depth. Cards above and below it in the stack composite around it as in 2D.
Tips
- Parent the model to a Null (3D) for orbit rigs, as any 3D layer.
- For points spread evenly over the surface (rather than at the mesh's vertices, which the Points output gives), wire the Model output into PointScatter. Those points ride the surface as the model animates and carry the direction it faces, for clones, images and particles.
- Large textures and very dense meshes cost time on every frame of an animated model; a still model costs one draw per frame.
- To combine several Alembic files from one scene, turn Fit off on each and give them the same Size (px per unit), so they keep their places relative to each other.
- An environment image that cannot be read lights the model with the built-in studio, and the status console says so.
Related Nodes
- Transform3D — places the model in 3D space
- PointScatter — scatters points over the model's surface
- Camera — the camera that draws it