meshy-dev/meshy-dcc-adapters/houdini-uv

houdini-uv

Typed UV authoring for Houdini's native UV SOPs. Texturing work previously had to go through execute_python or generic node creation; this package covers the unwrap → pack → inspect loop that texture authoring needs.

Tracer-bullet flow

1. unwrap_uv(parent_path="/obj/geo1", unwrap_type="auto", source_path="/obj/geo1/box1")
2. transform_uv(parent_path="/obj/geo1", transform_type="layout", source_path="/obj/geo1/uvunwrap1")
3. inspect_uv(node_path="/obj/geo1/uvlayout1") → UV sets and UDIM tiles

Each call returns node_path; feed it into the next step's source_path to build the chain.

Supported node types

UDIM readback

inspect_uv reports udim_tiles computed as 1001 + floor(u) + 10 * floor(v) from the first UV set, sampled with a bounded limit. Read udim_detection to interpret it:

Parameter policy

The tools create and wire nodes; they do not guess parameter values. SOP parameters vary between Houdini releases, so an override the node does not expose fails the call and rolls back rather than being silently skipped.

Honesty contract

• inspect_uv uses the shared guarded geometry read: a dirty node reports

geometry_available=false instead of being cooked implicitly. Cook first, then inspect.

• unwired nodes report the setup they still need; the tools never claim a UV

set exists without reading one.

• Creation failures destroy only the nodes owned by the failed request, and

parameter writes roll back values, expressions and animation.