meshy-dev/meshy-dcc-adapters/houdini-interchange

houdini-interchange

Typed import/export tools for moving geometry and scenes across DCCs. Exports return structured written_files, skipped, and warnings fields so an agent can tell what actually landed on disk versus what the installed runtime could not produce.

Tool groups

• `interchange-probe`: probe_file (affinity: any, pure filesystem).
• `interchange-import`: import_geometry (File SOP into a SOP network).
• `interchange-export`: export_geometry (native/OBJ via saveToFile),

export_alembic, export_fbx, export_usd.

Format selection guidance

export_fbx defaults to convert_units=true: it enables the native Filmbox unit-conversion toggle and reports its readback as unit_conversion_enabled. Without conversion, a meter-authored object can arrive 100 times too small when the FBX declares centimeters. Engines must honor the exported node transforms and units once; do not add another factor of 100 after conversion. Use convert_units=false only for a pipeline intentionally managing numeric units itself. An unavailable or mismatched conversion toggle fails before rendering. Always verify physical world bounds and pivot in the target engine.

Tracer-bullet flow (local, no render farm)

1. houdini_geometry__create_primitive(parent_path="/obj/geo1", primitive="box")
2. export_geometry(node_path="/obj/geo1/box1", output_path="/tmp/box.bgeo")
3. probe_file(file_path="/tmp/box.bgeo") → exists: true, format: geometry
4. import_geometry(parent_path="/obj/geo2", file_path="/tmp/box.bgeo") → round-trip

Export tools that drive a ROP are async with generous timeout_hint_secs because caches and FBX writes can be long-running.