link_parameters
Create a relative HScript channel reference from a source parameter to a destination parameter, preserving links when nodes move and refusing to overwrite existing animation unless allowed.
Instructions
Create a channel reference from one parameter to another.
The destination gets an HScript expression that reads the source as its own type: chs() for a String parameter, ch() for numbers, toggles and menus. The path is relative to the destination node (chs("../CTRL/mat")), so the link survives moving the pair, collapsing into a subnet or instancing an HDA. The reply carries the expression, the function used and the destination's evaluated value.
Two ramps (or two multiparms) are linked entry by entry as well, now and
whenever the source gains or loses keys: the opmultiparm links Promote
Parameter makes. The reply lists multiparm_links and follows_source.
Inside an asset, update_hda afterwards to keep the link in its contents.
Args: source_path: Source node path. source_parm: Source parameter name. dest_path: Destination node path. dest_parm: Destination parameter name. replace_existing: Overwrite a destination that already has keyframes or an expression. Refused otherwise, so animation is never lost by accident. A link whose source already reads the destination through ch() is refused as a cycle in every case.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"source_path": "<source_path>",
"source_parm": "<source_parm>",
"dest_path": "<dest_path>",
"dest_parm": "<dest_parm>"
},
"name": "link_parameters"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dest_parm | Yes | ||
| dest_path | Yes | ||
| source_parm | Yes | ||
| source_path | Yes | ||
| replace_existing | No |