Skip to content

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 ​

PortTypeDirectionDescription
outmodeloutputThe 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
pointspointsoutputThe 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 ​

ParamTypeDefaultDescription
pathstring—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
fitbooleanonScale the model so its largest side is Size px, centered on the layer's origin
sizescalarhalf the comp heightWith Fit on: the model's largest side, in px. With Fit off: px per unit of the file (glTF units are meters)
pointSizescalar3Point Size: a point cloud's dots, in px across where the camera shows 1:1 (smaller farther away). Shown for point clouds only
animationstringthe file's firstWhich of the file's animations plays; None shows the rest pose
speedscalar1Playback speed of the animation
timeOffsetscalar0Seconds added to the animation's clock
loopbooleanonLoop the animation; off holds its last frame
environmentstring—An equirectangular image (.hdr, .exr, or any image) that lights the model. Empty: a soft built-in studio
environmentIntensityscalar1Intensity: brightness of the environment's light
environmentRotationscalar0Rotation: 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.