How to use Distribute Points on Faces node in Oraphim

Type ID: geometry.distribute_points_on_faces
Category: Generator

What this node does

The Distribute Points on Faces node is registered in Oraphim's Generator category and performs the graph operation represented by its sockets and controls below.

The current Oraphim runtime registers 10 sockets and 8 properties for this node. Its main registered inputs are Mesh, Selection, Distance Min; its main outputs are Points, Normal, Rotation. The tables below are generated from the runtime registry rather than a handwritten approximation.

Inputs

Socket	Key	Type
Mesh	mesh	Geometry3D
Selection	selection	Bool
Distance Min	distanceMin	Float
Density Max	densityMax	Float
Density	density	Float
Density Factor	densityFactor	Float
Seed	seed	Int

Outputs

Socket	Key	Type
Points	out_geometry	Geometry3D
Normal	normal	Vector3
Rotation	rotation	Transform

Controls

Control	Key	Type	Group	Registry default
Distribution Method	distribute_method	String	Node	RANDOM
Legacy Normal	use_legacy_normal	Bool	Node	0.0
Selection	selection	Bool	Inputs	1.0
Distance Min	distanceMin	Float	Inputs	0.0
Density Max	densityMax	Float	Inputs	10.0
Density	density	Float	Inputs	10.0
Density Factor	densityFactor	Float	Inputs	1.0
Seed	seed	Int	Inputs	0.0

How to use it

1. Add Distribute Points on Faces from node search. Use geometry.distribute_points_on_faces when you need the exact registry entry.
2. Connect a compatible Geometry3D source to Mesh. Add the other inputs only when the operation needs them.
3. Start with the registry defaults and adjust Distribution Method, Legacy Normal, Selection first so you can see the node's effect in isolation.
4. Route Points (Geometry3D) into a compatible downstream node, viewer, or output path.
5. Preview a representative frame, change one input/control at a time, and save/reopen reusable graphs to verify persistence.

Practical example

Create a small test graph with Distribute Points on Faces. Feed a compatible source into Mesh. Change Distribution Method away from its registry default and compare the result. Connect Points to a compatible downstream stage so the result is visible. Keeping this test graph small makes socket-type, context, and parameter mistakes easier to diagnose before the node is used in a production graph.

Troubleshooting

• If a connection is rejected, compare the exact socket data types in the tables above; Oraphim graph connections are typed.
• If the result looks unchanged, confirm this node is on the active path to the viewer/output and that the expected graph/resource is selected.
• If a control is unavailable, check required inputs and whether the property belongs to an internal or mode-dependent group.
• If a saved graph behaves differently later, reopen it and verify node identity, connections, and edited property values before rendering.

Related nodes

• Arc — geometry.curve_primitive_arc
• Cone — geometry.mesh_primitive_cone
• Cylinder — geometry.mesh_primitive_cylinder
• Curve Circle — geometry.curve_primitive_circle
• Distribute Points in Grid — geometry.distribute_points_in_grid

Return to the complete Oraphim node reference.