Forged/Docs/Forged ImageProducts ↗

Nodes · 3D

GeoPrimitive

3Dv1app

Overview

A geometry primitive (cube, sphere, plane, cylinder) with transform and colour — stand-ins and simple set pieces.

How to

How-to

Pick the primitive and its color; place it with the transform knobs.
catcher makes it a shadow catcher — occludes and receives shadows, shows no surface.
display overrides how the viewport draws it.

Inputs

Input	What it takes
in	the image this node works on

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.
primitive	Choice	cube	Which primitive: a `plane`, `cube`, `sphere` or `cylinder`, one unit across at the origin — place it with the transform knobs. `planecubespherecylinder`
color	Color	[0.6, 0.6, 0.6, 1.0]	The colour.
catcher	Bool	false	Shadow catcher: the surface never renders, but it still occludes and still catches contact shadows from geometry above it — over a plate, only the shadow shows (its alpha carries the density for the comp). Scene+'s ground plane arrives with this ON; untick to see the plane as geometry. Casts clip to the plane's own edge, and anything BELOW the plane casts nothing.
point_deltas	Text		Component edits over the primitive's points, as JSON `[[point, dx, dy, dz], …]` — written by the component gizmo, one SetKnob per drag. Not hand-edited.
ue_actor	Text		The Unreal actor this primitive mirrors (its path), when the bridge is live. Empty = not linked.
display	Choice	inherit	How the viewport draws it: `inherit` follows the scene's setting, else force shaded, wire or bounds for this prim. `inheritshadedwireframeshaded_wirepointsbboxhidden`
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).

See also

The 3D system — How to put geometry, cameras and volumes in the comp — without becoming a 3D application.