Nodes · Anvil

BS_PinTool

Anvilv1coreForge

Overview

Places a 3D model against a frame by pinning it: click points on the model, drag them where they belong in the image, and the solver finds the pose. One pin slides it in the image plane; two add scale and roll; three or more give full rotation — and the panel tells you which. The foundation of the Anvil tracking suite.

How to

How-to

Wire the plate into src and pick the model in the 3D branch.
Click a point on the model, then drag it where it belongs on the frame; three or more pins solve the pose.
auto_solve re-solves as pins move; focal_px fixes the lens (0 guesses).

Inputs

Input	What it takes
src	the source image

Outputs

Output	Type
out	Image

Parameters

Parameter	Type	Default	What it does
pins	Text		The pins, as the node stores them. Place them in the viewer.
focal_px	Float	0.0	The focal length in pixels the pins are solved against. 0 guesses 1.2 × the plate width.
auto_solve	Bool	true	Re-solve the camera pose the moment a pin moves. Off waits for ◉ Solve.
status	Text		What the last solve did: pins used, the residual in pixels, or why it refused.
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.
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).