photoshop_recipe_gradient_fade
Applies a linear gradient to the active layer's mask to fade the layer into the background or layers below. Creates the mask if missing, and wraps the change in a single undo 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.
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. |