Create hand Ableton mapper
create_hand_ableton_mapperBuild a MediaPipe-hands to TDAbleton control network, outputting pinch and wrist roll maps with skeleton overlay, and optionally relink existing TDA_Mapper.
Instructions
Build a MediaPipe-hands to TDAbleton TDA_Mapper performance control network. It outputs map1=left pinch, map2=right pinch, map3=left wrist roll, map4=right wrist roll, creates a skeleton overlay with star joints plus the thumb-index line, and optionally relinks an existing TDA_Mapper to the generated mapper_send CHOP. Uses TDAbleton directly; AbletonMCP is not required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| parent_path | No | Parent COMP for the mapper network. | /project1 |
| container_name | No | baseCOMP created under parent_path. | hand_ableton_mapper |
| hand_chop | No | Existing hand CHOP with tx/ty/tz/confidence/handedness/screen_x/screen_y. Defaults to setup_hand_tracking's adapter output. | |
| ensure_hand_tracking | No | When hand_chop is omitted, run setup_hand_tracking first. | |
| tox_path | No | Optional MediaPipe.tox path forwarded to setup_hand_tracking. | |
| adapter_name | No | Hand adapter name used by setup_hand_tracking. | mp_hand_adapter |
| coordinate_space | No | Coordinate space forwarded to setup_hand_tracking; world is best for pinch distance. | world |
| hand_count | No | Number of hand slots. | |
| closed_distance | No | Distance where thumb/index are treated as closed. | |
| open_distance | No | Distance where thumb/index are treated as fully open. | |
| smoothing | No | 0=raw, 0.99=very slow smoothing. | |
| min_confidence | No | Minimum landmark confidence to accept a hand slot. | |
| invert_pinch | No | Invert map1/map2 pinch values. | |
| invert_wrist | No | Invert map3/map4 wrist-roll values. | |
| fallback_slots | No | If handedness is missing, treat slot 0 as left and slot 1 as right. | |
| mapper_path | No | Optional explicit TDA_Mapper path. | |
| link_mapper | No | Try to set the TDA_Mapper Oscinputchop/Reorder/range parameters. | |
| create_overlay | No | Create a skeleton overlay TOP with star joints and a thumb-index line. | |
| line_width | No | Overlay line width. | |
| star_size | No | Overlay star-joint size. |