Mapping Template
Authoring node for defining mappable parameters on a target HDA. Used when building custom modules or wrappers that need their own promotable parameter surface.
Marked experimental in the Houdini node title. Behaviour and parameters may shift.
Mapping Template is the authoring surface for defining a set of mappable parameters on a target HDA. Used when building custom modules or wrappers that need to expose their own promotable, Map-chain-driven parameter surface, similar to the way Grow and other built-in modules expose mappable parameters today.
For the broader concept of how mapping works, see Mapping. A sibling Custom Module authoring node is not yet documented.
Parameters
| Parameter | Description |
|---|---|
| Target HDA | The HDA receiving the mappable-parameter surface. |
| Mode (Promotion Mode) | How the mappable parameters get promoted onto the target. |
| Folder Name | Folder name on the target that holds the promoted parameters. |
| Multiparm Name | Name of the multiparm count parameter on the parent (for example, mappings produces mappings=3). |
| Promote to Target | Performs the promotion onto the target HDA. |
Mappable Parameters
A multi-parm with one row per mappable parameter. Each row exposes:
| Parameter | Description |
|---|---|
| Mapped | Whether the parameter has been mapped. |
| Folder | Folder within the target where this parameter lands. |
| Name | Parameter name. |
| Value | The value or value-menu entry. |
| Map | The map chain (or map menu) driving the value. |
Notes
- To install a mappable surface: author the module as an HDA, set Target HDA to it, define each mappable parameter in the multi-parm, then click Promote to Target. The promoted parameters appear on the module's parameter pane.
See also: Mapping · Map (the runtime node that consumes the mappable surface) · Building Your Own Decorations