Create pose ControlNet driver
create_pose_controlnet_driverGenerates a canonical OpenPose stick figure image from a pose CHOP to drive ControlNet conditioning in Stable Diffusion pipelines.
Instructions
Render a canonical OpenPose-colored stick figure TOP (per-limb RGB lines + per-joint colored discs on a black background, default 512×512) from an existing pose CHOP produced by create_pose_tracking. The render is GPU-rasterized in a single GLSL TOP that samples the pose CHOP via a CHOP-to-TOP. Optionally auto-wires the output to a Syphon/Spout or NDI sender for a downstream Stable Diffusion / ComfyUI / StreamDiffusion ControlNet node. No model inference — this tool produces the driver conditioning image that ControlNet consumes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Where the pose stream comes from. 'existing_tracker' reads a 33-sample pose CHOP at pose_chop_path. 'synthetic' auto-spins-up a synthetic Script CHOP inside this container for device-free preview. | existing_tracker |
| pose_chop_path | No | Required when source='existing_tracker'. Absolute TD path to the canonical 33-sample pose CHOP (tx/ty/tz/confidence). | |
| resolution | No | Square render size. ControlNet SD1.5 wants 512; SDXL wants 768/1024. | 512 |
| joint_radius | No | Filled-disc radius (px) for each keypoint joint. Exposed as live JointRadius knob. | |
| limb_thickness | No | Line thickness (px) for each limb. Exposed as live LimbThickness knob. | |
| coordinate_space | No | How to map landmark tx/ty to pixel space. 'normalized' maps [-1,+1] to full square. 'world' recenters using hip_midpoint and auto-scales to body height. | normalized |
| mirror | No | Flip horizontally (selfie cam vs. ControlNet expectation). | |
| confidence_gate | No | Skip drawing landmarks/limbs whose endpoint confidence falls below this. Exposed as live knob. | |
| color_preset | No | Canonical OpenPose 18-keypoint COCO palette by default. | openpose_coco |
| custom_limb_colors | No | When color_preset='custom'. Length must equal 17 (limb count). | |
| custom_joint_colors | No | When color_preset='custom'. Length must equal 18 (joint count). | |
| output_mode | No | When 'internal' stops at a Null TOP. When 'syphon_spout'/'ndi' adds an FM-01 external sender. | internal |
| sender_name | No | Sender/source name advertised on the network when output_mode != 'internal'. | tdmcp_controlnet_pose |
| expose_controls | No | Expose live JointRadius, LimbThickness, ConfidenceGate, Mirror knobs. | |
| parent_path | No | Parent network for the pose_controlnet_driver baseCOMP. | /project1 |