set_shape_key
Adjust a shape key's blend amount and slider range, mute it, or restrict it to a vertex group to control mesh deformation in Blender.
Instructions
Set how strongly a shape key applies, and its options.
Args: object_name: Mesh object. key_name: Shape key. value: Blend amount, normally 0.0 to 1.0, within the slider range. slider_min: Lowest allowed value, -10.0 to 10.0 (0.0 by default). Negative values let a "smile" key also frown. slider_max: Highest allowed value, -10.0 to 10.0 (1.0 by default). mute: Switch the key off without losing its value. vertex_group: Limit the key to this vertex group's weights; "" clears it. relative_key: Key this one is measured against (the Basis by default).
Returns: Dict with the key's settings after the change.
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": {
"object_name": "<object_name>",
"key_name": "<key_name>"
},
"name": "set_shape_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mute | No | ||
| value | No | ||
| key_name | Yes | ||
| slider_max | No | ||
| slider_min | No | ||
| object_name | Yes | ||
| relative_key | No | ||
| vertex_group | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||