Nodes · Anvil

BS_GeoTracker

Anvilv1app

Overview

Tracks a model through a shot and holds it there. The correction workflow is the point: grab a pin on any frame, nudge it, and the solve re-fits around what you stated.

How to

Wire the plate and the geometry.
Position the model on the clearest frame using the viewport handles (the Select tool returns the ordinary camera controls).
Track, then correct where it slips.

Inputs

Input	What it takes
geo	the geometry
src	the source image
mask	limits the effect to this matte — the engine's universal mask slot, applied for every node that declares it
cam	the camera to project through

Outputs

Output	Type
out	Scene

Parameters

Parameter	Type	Default	What it does
tx	Float	0.0	Translate X — position along the world X axis, metres.
ty	Float	0.0	Translate Y — position along the world Y axis (up), metres.
tz	Float	0.0	Translate Z — position along the world Z axis, metres. The camera looks down −Z.
rx	Float	0.0	Rotate around X, degrees.
ry	Float	0.0	Rotate around Y (turntable), degrees.
rz	Float	0.0	Rotate around Z (roll), degrees.
sx	Float	1.0	Scale along X. 1 = unchanged.
sy	Float	1.0	Scale along Y.
sz	Float	1.0	Scale along Z.
prim_path	Text		Which prim of the wired geometry tracks. Empty takes the input's first mesh.
mode	Choice	object	`object`: the camera is fixed and the MODEL's motion bakes onto this node's transform. `camera`: the model is static and the CAMERA moves — the bake creates a keyed Camera3D. `objectcamera`
focal_mode	Choice	fixed	`fixed` trusts `focal_px`; `solve` finds one focal length for the whole shot and re-tracks at it; `zoom` solves a focal curve, frame by frame. `fixedsolvezoom`
anchor_frame	Float	-1.0	The frame where you PLACED the model — its transform there is the anchor statement the track grows from. −1 is the project range's start.
samples	Int	48	How many sub-steps the effect integrates over. More is smoother and slower.
smoothness	Float	0.15	How much the baked motion is smoothed across frames: 0 trusts every frame's solve, higher irons out jitter at the cost of lag on a sharp move.
focal_px	Float	0.0	The focal length in pixels for object mode's fixed camera. 0 guesses 1.2 × the plate width, the CameraTracker's own guess.
pins	Text		The pins, as the node stores them. Place them in the viewer.
atlas_res	Int	1024	🖼 Build texture: the size of the texture atlas it bakes the plate onto, pixels square.
selectivity	Float	2.0	🖼 Build texture: how strongly frames facing the camera win over grazing ones when the plate is gathered onto the surface. Higher is sharper and needs more coverage.
status	Text		What the last track or solve did: frames, the residual, the lens, and any refusal.
disabled	Bool	false	Bypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back.
label	Text		A note shown under the node in the graph — what this node is FOR. Never affects the render or the cache.
hide_input	Bool	false	Draw the node without its input wire — a tidy graph for a node whose source is obvious (a Dot, a viewer tap).

Since

27 Aug 2026 — its own one-liner (it had none)