G5: document gradient, pattern, opacity and blend on a picked part

The MCP guide and the Eyedropper spec still said those were refused for a Direct Selection of a dynamic symbol part.
This commit is contained in:
Fabio William Conceição
2026-11-09 13:12:49 +00:00
parent 6def1c6b04
commit 0216bd58c5
2 changed files with 11 additions and 10 deletions
+1 -1
View File
@@ -126,7 +126,7 @@ pub fn specs() -> Vec<CommandSpec> {
"Eyedropper",
[],
None,
"{source: id, ids?, pickUp?, apply? (trees as eyedropper.setOptions, merged over the Eyedropper Options for this call), reverse?: bool, append?: bool, defaultsOnly?: bool} copy the attributes both picked up and applied (by default the whole appearance stack, opacity and blend mode, and from type to type the character and paragraph attributes) from `source` to ids (default: highlighted characters while editing type, after Select All in a frame of threaded text the text of the story's frames, leaving out `source`, otherwise the object selection; highlighted characters reject enabled non-neutral object transparency), the fill, stroke and weight also to the paint defaults; `defaultsOnly` updates only paint defaults and cannot be combined with ids, reverse or append; `reverse` (Alt-click) copies from the first selected object (or ids) onto `source` instead, or with nothing selected what the Eyedropper picked up last (a click without Alt); `append` (Shift+Alt-click) adds the source's fills, strokes and effects on top of each target's stack; placed gradients land at the same place relative to each target's bounds (defaults: fitted to new art); with an object of a dynamic symbol instance selected by Direct Selection and no ids, reverse, append or defaultsOnly, that object takes the source's solid fill and stroke for this instance only, as the Eyedropper Options allow, and a sampled gradient or pattern, a source that is not a path, compound path or type, or options that pick up neither color, are refused. On a path directly in a graph series, the graph also stores the paint, weight, opacity and blend mode of the topmost visible fill and stroke and the object's opacity and blend mode (exceptions: docs/mcp.md) → {ids}",
"{source: id, ids?, pickUp?, apply? (trees as eyedropper.setOptions, merged over the Eyedropper Options for this call), reverse?: bool, append?: bool, defaultsOnly?: bool} copy the attributes both picked up and applied (by default the whole appearance stack, opacity and blend mode, and from type to type the character and paragraph attributes) from `source` to ids (default: highlighted characters while editing type, after Select All in a frame of threaded text the text of the story's frames, leaving out `source`, otherwise the object selection; highlighted characters reject enabled non-neutral object transparency), the fill, stroke and weight also to the paint defaults; `defaultsOnly` updates only paint defaults and cannot be combined with ids, reverse or append; `reverse` (Alt-click) copies from the first selected object (or ids) onto `source` instead, or with nothing selected what the Eyedropper picked up last (a click without Alt); `append` (Shift+Alt-click) adds the source's fills, strokes and effects on top of each target's stack; placed gradients land at the same place relative to each target's bounds (defaults: fitted to new art); with an object of a dynamic symbol instance selected by Direct Selection and no ids, reverse, append or defaultsOnly, that object takes the source's fill and stroke (solid, none, gradient or pattern) for this instance only, as the Eyedropper Options allow, and a source that is not a path, compound path or type, or options that pick up neither color, are refused. On a path directly in a graph series, the graph also stores the paint, weight, opacity and blend mode of the topmost visible fill and stroke and the object's opacity and blend mode (exceptions: docs/mcp.md) → {ids}",
has_doc,
copy_from
),
+10 -9
View File
@@ -1859,16 +1859,17 @@ already walks Image Trace. Short agent entry points:
one back to the symbol. It is refused for a static symbol and for a path that names no object. On the canvas (VectorCraft's own rule), a Direct Selection click on an instance of a
dynamic symbol selects the path, compound path or type object of its art under the pointer and outlines it
(`symbol.instance.selectPart {id, path}`; Alt or Shift selects the instance whole). While it is selected,
`paint.setFill` and `paint.setStroke` with a solid color or none, `paint.invert` and `paint.complement` on a solid
color, all without `ids`, `id` or `item`, and the Eyedropper's `appearance.copyFrom` with a solid fill and stroke
change that object's fill or stroke for this instance only, each as one undo step. A painted stroke on type without a
weight gets 1 pt. A gradient or pattern for the object is refused with a status message, and so are `paint.invert` and
`paint.complement` on type whose characters differ in color, Eyedropper options that pick up neither color, an
Eyedropper source that is not a path, compound path or type (a symbol instance or a group, for which the paint defaults
stay as they are too), and a click
or `symbol.instance.selectPart` on any other object of the art (a group, image, blend or nested instance among them).
`paint.setFill` and `paint.setStroke` (solid, none, gradient or pattern), `paint.invert` and `paint.complement` on a
solid color, all without `ids`, `id` or `item`, `transparency.set` with opacity and/or blend, and the Eyedropper's
`appearance.copyFrom` (fill and stroke, including a gradient or pattern) change that object for this instance only,
each as one undo step. A painted stroke on type without a weight gets 1 pt. `paint.invert` and `paint.complement`
on a gradient or pattern, or on type whose characters differ in color, are refused with a status message, and so are
Eyedropper options that pick up neither color, an Eyedropper source that is not a path, compound path or type (a
symbol instance or a group, for which the paint defaults stay as they are too), isolate, knockout, knockoutShape,
aligned and target on `transparency.set`, and a click or `symbol.instance.selectPart` on any other object of the art
(a group, image, blend or nested instance among them).
The commands that change the selected objects without `ids` are refused the same way and change nothing, among them
opacity and blending mode, moving and transforming, `path.moveAnchors`, `file.place` with `replace`, Puppet Warp, Delete
moving and transforming, `path.moveAnchors`, `file.place` with `replace`, Puppet Warp, Delete
and Cut, Group, Hide, Lock, Arrange, Expand,
Recolor Artwork, plug-in filters, effects, the gradient commands, `gradient.selectStop`, the Appearance panel's rows and
`symbol.instance.setAppearance`. A Cmd-drag that lends the Selection or Group Selection tool selects the instance whole