add_color_ramp_element
Add a color stop to a ColorRamp node in a material. Specify position and color to shape gradients for procedural materials.
Instructions
Add a colour stop to a ColorRamp (ShaderNodeValToRGB) node.
A new ramp starts with two stops, black at 0.0 and white at 1.0. Add stops to shape a gradient: fire needs dark red, orange, yellow, white bunched toward the top; rust needs a hard break between metal and oxide.
Args: material_name: Name of the material. node_name: Name of the ColorRamp node. position: Stop position along the ramp, 0.0 to 1.0. color: RGB or RGBA color, components 0.0 to 1.0. RGB gains alpha 1.0.
Returns: Dict with the new element's index, position, and color.
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": {
"material_name": "<material_name>",
"node_name": "<node_name>",
"position": "<position>",
"color": "<color>"
},
"name": "add_color_ramp_element"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | Yes | ||
| position | Yes | ||
| node_name | Yes | ||
| material_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||