photoshop_recipe_gradient_fade
Applies a one-shot black-to-white gradient on the active layer mask to fade a layer into the background or layers below, creating the mask if needed in a single undoable step.
Instructions
One-shot gradient fade on the active layer mask: creates a reveal-all mask if needed, then paints a linear black-to-white gradient for soft edge blending. Wrapped in a single undoable history step.
Users often say: fade into background, gradient mask, blend subject, soft edge fade, arka planı yumuşat.
This applies a linear gradient on the layer mask channel — not a Gradient Fill layer. Use when: the user wants the active layer to fade into the background or layers below through its mask. Do NOT use when: the subject is not isolated — use photoshop_recipe_remove_background first. Do NOT use when: replacing the sky with an external image — use photoshop_recipe_sky_blend.
Returns: { ok, summary, undo_history_states_consumed, details: { direction, start_pct, end_pct, mask_created, layer_name } }.
Preconditions: active document with an active layer. Side effects: creates or modifies the active layer mask; one undo reverts everything.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "photoshop_recipe_gradient_fade"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_pct | No | Gradient end along fade axis (0-100) | |
| angle_deg | No | Optional gradient angle override in degrees | |
| direction | No | Gradient fade direction on the mask (default bottom_to_top) | bottom_to_top |
| start_pct | No | Gradient start along fade axis (0-100) | |
| document_id | No | Optional Photoshop document id from photoshop_get_state / photoshop_list_documents. When set, the tool activates that document before running so a UI tab switch cannot retarget the edit. |