How to use Sample UV Surface node in Oraphim

Type ID: geometry.sample_uv_surface
Category: Utility

What this node does

Samples uv surface data for downstream field or geometry operations.

The current Oraphim runtime registers 6 sockets and 4 properties for this node. Its main registered inputs are Mesh, Value, UV Map; its main outputs are Value, Is Valid. The tables below are generated from the runtime registry rather than a handwritten approximation.

Inputs

Socket	Key	Type
Mesh	mesh	Geometry3D
Value	value	Float
UV Map	uvMap	Vector3
Sample UV	sampleUv	Vector3

Outputs

Socket	Key	Type
Value	outValue	Float
Is Valid	isValid	Bool

Controls

Control	Key	Type	Group	Registry default
Value	value	Float	Inputs	0.0
UV Map	uvMap	Vector3	Inputs	0.0
Sample UV	sampleUv	Vector3	Inputs	0.0
Data Type	data_type	String	Node	FLOAT

How to use it

1. Add Sample UV Surface from node search. Use geometry.sample_uv_surface 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 Value, UV Map, Sample UV first so you can see the node's effect in isolation.
4. Route Value (Float) 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 Sample UV Surface. Feed a compatible source into Mesh. Change Value away from its registry default and compare the result. Connect Value 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

• Geometry Proximity — geometry.proximity
• Raycast — geometry.raycast
• Sample Nearest Surface — geometry.sample_nearest_surface
• Attribute Statistic — geometry.attribute_statistic
• Image Info — geometry.image_info

Return to the complete Oraphim node reference.