Leaving isolation mode in a Live Paint group (object.exitIsolation, or
object.isolate on a level outside the group) adds the shown, unlocked
paths, compound paths and groups of them drawn in it to the group as
Live Paint > Merge does, in one undo step. Faces and edges the new paths
do not cross keep their paint. This also applies when a group drawn in
the Live Paint group was isolated in turn. An exit with nothing to add
changes nothing and records no undo step.
Type, images, and hidden or locked objects drawn in the group, and
groups holding one, stay in it as they are. Gap Options, Merge and
Release now keep them; before, they replaced every child of the group
with the rebuilt parts, so such objects were deleted. Only the group's
sources group and paths named Face or Edge count as its parts.
Help page: https://helpx.adobe.com/illustrator/desktop/paint-and-fill/learn-painting-basics/modify-live-paint-groups.html
High Fidelity Photo traced with a Limited palette of 64 colors as
overlapping shapes. It now traces with Palette Full Tone at Color detail
85 and Method Abutting; Paths, Corners and Noise stay 50, 50 and 5.
These are VectorCraft's own values.
Palette Full Tone splits its colors until none is wider than its limit,
then, while it has fewer colors than Color detail's value, splits the
narrower ones too, where the image has that many. Its colors then merge
as one only when they look alike: thoroughly mixed and less than 5 apart
in Oklab x 100, or mixed in patches (compression blocks) and less than
1.5 apart. This applies to every Full Tone trace, so an existing Full
Tone trace or saved preset traces differently when traced again.
Automatic's continuous-tone colors keep the earlier count and the RGB
merge.
On 19 photos, cartoons and synthetic shapes, the mean pixel difference
summed over the inputs falls from 80.5 to 65.6 levels: by more than 1%
on 14 inputs and by less than 1% either way on the other 5. Anchors
rise 1.66 times, the SVG size 1.31 times and the trace time 1.9 times;
flat synthetic art costs the most (12 to 400 anchors on one image).
Low Fidelity Photo, 16 Colors, 6 Colors, Black and White Logo and Auto
Color give byte-identical results.
Supersedes #2699 by andeecollard, which moved the photo presets to Full
Tone.
A press on an edge (Shift with Paint Fills alone, or a plain press with
Paint Strokes on) now starts a drag, as a press on a face does. The drag
paints the edge and every visible edge of the same group that it crosses
or comes within 0.0001 pt of, between pointer events and on the release,
as one undo step; Escape cancels it. Edges of other groups and hidden
edges keep their strokes, a drag over edges that already have the stroke
records no undo step, and a drag that starts on a face still fills only
faces. A double-click after such a drag joins through the edges the drag
stroked as the paint they had before it.
livePaint.strokeEdge takes the drag's points and continuation as
livePaint.fill does, and both refuse them with scope connected or
samePaint.
Help page: https://helpx.adobe.com/illustrator/desktop/paint-and-fill/learn-painting-basics/paint-with-the-live-paint-bucket-tool.html
The Seam Fills group's clipping path was the image's box. A group with a
clip is measured by its clipping path, so on a trace with transparent or
ignored margins the expanded trace measured as the whole image, and
selection, alignment and resizing used that box. The clipping path is now
the image's box cut to the box of the traced paths: on a turned image it
has up to eight corners, and the anchor limit counts eight for it.
docs/mcp.md, the params text and the progress line describe the clip.
On an image stretched more one way than another, a seam stroke was as
wide as 1.5 pixels at the larger scale, so across the less stretched
direction it reached far past its edge: on a 40 x 20 image scaled 20x
across, a stroke along a horizontal edge covered 15 pixels on each
side, over transparent rows too.
On such an image, the seam fills are now each stroke's outline in image
pixels (butt caps, round joins), filled with the stroke's paint. An
image scaled alike in every direction keeps strokes. The anchor limit
counts the outlines' anchors. Outline views and Expand by color
recognize a seam fills group of filled outlines as they do one of
strokes, and Expand by color again recognizes the unclipped seam fills
group of a trace made before the seam fills were clipped.
`through` now takes only the ids of the group's edges, each once: a face's
id, an unknown id, another group's edge or an edge given twice is an error
and changes nothing. A hidden edge in it is still skipped by the join. For
a double-click the Bucket passes only edges of the group, each once, so an
earlier click that filled a face whose fill was the edge's stroke paint
(Paint Fills and Paint Strokes both on) no longer sends that face.
The Bucket finds the faces a fill drag crossed among those whose bounds
meet the drag's bounds only.
A canvas test covers the middle-button press and the Space-held press
between two Bucket clicks. The progress-doc line lists the new tests, and
docs/mcp.md says which edges the tool passes in `through`.
Follows #7875.
The Brushes panel menu gains Options of Selected Object…. It opens the
brush type's options dialog for the selected brushed paths, without the
Name row, and OK stores the changed values on those paths' strokes only.
The brush and its other strokes keep their settings.
- brush.objectOptions {ids?, params?, reset?} sets the settings, clears
them with reset, and returns them when given neither. It refuses
params with reset, a selection with no brushed path, brushes of
different types, a bristle brush, a field the type does not take and
a value of the wrong kind. One undo step, none when nothing changes.
- The stroke saves the settings as brush_options in the native file, and
the brush renderer, the expansion of pattern tiles whose brushes vary
at random and color conversion of Hue Shift keys read them.
- Applying another brush, removing the brush or a brush change carried
by Global Edit clears them; renaming the brush keeps them.
- Docs: docs/mcp.md, docs/ui-parity.md; i18n rows for the new strings.
A region below Noise joined the color it shares the longest border with, so
the specks of a thin dark line on a light ground joined the ground and the
line broke into dashes. When that color is 10 or more apart from the region's
own (Oklab x 100), the region now joins the neighboring color nearest its
source pixels, among the colors sharing at least a tenth of the longest
border. A single pixel tied between colors still joins by border.
6 Colors and 16 Colors move from Noise 15 to 8, and Black and White Logo from
25 to 5.
When a click's press lands in one face and its release in the next, the
drag fills both. The bucket now notes the fill every face the drag
crosses had before the press, the release included, so a double-click
or triple-click that follows on such a face compares that fill instead
of the one the first click gave it. This also holds when the release of
the last click crosses into the clicked face.
When the first click makes the Live Paint group, or merges the selection
into a selected group, the crossed face counts with the fill it was made
with: a kept face's paint from the merged group (an unplaced gradient
fixed to its fit), else the fill Make gives it, the topmost fill that
draws of the front-most source path over it that has one. A selected
group's edges no longer count as source paths.
A double-click whose two clicks land on two joined edges now paints the
edges joined through the other edge its clicks painted:
livePaint.strokeEdge takes `through`, edge ids that the join counts as
drawing with `match`, and the tool passes that edge. When the second
press lands on the next edge and is released back on the first, the
double-click matches the first edge's stroke paint from before the
first click.
A press that the view tools take (held Space, the middle button), or
that holds Cmd/Ctrl and goes to the lent selection tool, now counts as
a press that paints nothing, so the clicks around it are not taken for
one triple-click's: the session tells the tool through the new
Tool::press_elsewhere.
The tool doc, docs/mcp.md and the progress-doc line now say that a click
records an undo step only when it changes a paint, and that a
triple-click paints the faces that have the clicked face's fill (and the
edges that draw with the clicked edge's stroke paint) with the bucket's
paint.
Follows #7291.
- The Seam Fills group is a clip group whose clipping path is the
image's box, so a stroke that ends at the image's border stays inside
it, and so do the trace's bounds. Where a shared edge ends at, or runs
within 0.75 image pixels of, a transparent area or a color left out,
its stroke can reach up to 0.75 image pixels into it.
- Paths that became live shapes take no part.
- Expand by color names the seam fills' group when it was moved above a
path, instead of the Auto Grouping message.
- Outline views leave the group out.
- Canceling a trace run also stops it before the seam fills are found.
Docs: docs/mcp.md, the params text, docs/target-app-parity.md.
An Abutting trace with Fills now holds a "Seam Fills" group under its
paths. For each color it has one stroke, 1.5 image pixels wide, along
the edges where a filled path of that color meets a filled path drawn
after it, in that color. A renderer that anti-aliases each path on its
own no longer shows a light hairline along those edges. The traced
paths and their shared edges do not change, and edges against the
image's border, a transparent area or a color left out get no stroke.
- vectorcraft-trace: `seam_fills` finds the segments two filled paths
share and strokes them in the lower path's color (one stroke per
gradient path). Overlapping, traces without Fills and Flat Logo get
none.
- Image Trace commands: the group comes under every path (right above
the hidden image in a live trace). Expand keeps it, Expand by color
leaves it under the color groups, and a trace whose paths have more
than half of the anchor limit gets no seam fills.
Docs: docs/mcp.md, the params text, docs/target-app-parity.md.
livePaint.fill set only a face's topmost fill, and livePaint.strokeEdge
only an edge's topmost shown stroke. A lower fill or stroke kept drawing
under the new paint, a fill or stroke of none left it drawing, and a
hidden or half-transparent top row with the paint stopped the click.
The bucket now replaces every fill of a face, or every stroke of an
edge, with one row of the paint, shown, fully opaque and blending
normally, in the place of the topmost row of that kind. The row keeps
the dashes, caps, arrowheads and effects of the topmost shown row. The
face's strokes, the edge's fills and the part's own opacity stay as
they are. A click changes nothing, with no undo step, only when the
part already has that one row. This changes the earlier rule that kept
an edge's hidden strokes. The help page says the tool paints faces with
the current fill and edges with the current stroke; the row rule is
VectorCraft's own.
When Merge added a path that cut a painted edge, the piece holding the
old edge's middle took the old edge's stroke rows unchanged, so its
dashes started again and it kept both arrowheads. It now takes them
fitted to its part of the old edge, as Gap Options does.
A closed path that crosses itself is cut into closed loops. The loop
holding the path's first anchor counted as the whole path, so it kept
the path's width profile and brush. A closed edge now counts as the
whole path only when it is as long as the path.
livePaint.strokeEdge wrote the paint and weight into an edge's topmost
stroke even when that stroke was hidden. An edge whose hidden top stroke
sat over a drawn one kept drawing its old paint, and since the edge
scopes now match the paint an edge draws, a samePaint or connected
stroke reached such edges and changed nothing on screen. The command now
paints the topmost stroke that is shown, and adds a stroke above the
others when every stroke is hidden or there is none. The "nothing
changes" check reads the same stroke.
The doc comments of the scopes and of the press record describe the
drawn stroke paint, and the engine names Paint through its parent module
instead of in the import list. Live Paint Selection's comment on a
triple-click states that the tool takes no action on it.
New tests cover the edge the tool matches on a multi-click over a hidden
or fully transparent edge, the connected edge scope through transparent
and hidden edges, and painting the shown stroke.
When Gap Options cut an edge in two, each piece took the old edge's
stroke rows unchanged: both arrowheads, the dash phase of the edge's
start, and a brush or width profile spread over the whole edge. Each
piece now takes those rows fitted to its part of the old edge, as Make
fits a source path's rows to the edges cut from it.
The Live Paint Bucket's connected and samePaint scopes kept their own
copies of the face flood and the edge walk. They read an edge's stored
stroke paint, so an edge that is fully transparent or whose stroke is
hidden stopped a face flood and matched as stroked. The face flood also
required outlines within 0.0001 pt of an edge, which a curved face that
the planar map refits can miss.
The engine now calls the shared flood_faces and connected_edges that
Live Paint Selection uses (#7342), and compares edges by lp_stroke_paint,
the paint of the topmost stroke that draws. The tool records that same
paint as the match for a double-click or triple-click on an edge. The
params text and docs/mcp.md describe the drawn stroke paint.
The edge built from a closed path that nothing cuts started at the anchor the
planar map gave it, so dashes, a width profile or a brush began at a different
place than on the path. The edge now starts at the anchor where its path
starts. An edge with no anchor there takes its dashes from its own start and
leaves off the profile and brush.
The command description and the progress doc say that dashes aligned to
corners and path ends are not fitted to cut edges.
Consider Open Filled Paths as Closed decided whether an open path was
filled from its top fill row only. A path whose top fill is None over a
painted lower fill stayed open, and one whose only painted fill was
hidden or at 0% opacity closed. The region map, merge inputs and the
Clicking Stroke Splits the Path cut now use Appearance::has_drawn_fill,
so any shown, painted fill row above 0% opacity counts, as the canvas
paints it.
The Shape Builder's Live Paint face and edge filters had the same
top-row check; they now use has_drawn_fill and has_drawn_stroke, so a
face or edge is taken when one of its rows draws.
livePaint.info reported only the top fill of each face and the top
stroke and weight of each edge, so a lower row that draws under an
unpainted top row was not visible to a client. Each face and edge now
also carries `appearance`: every fill and stroke row, bottom first, as
{index, kind, paint, opacity, visible, width (strokes only), drawn}.
`drawn` follows Expand's rule row by row: the part is shown with an
opacity above 0, and the row is shown, has paint and an opacity above
0, and a stroke has a weight above 0. The existing `fill`, `stroke`,
`width`, `bounds`, `sources`, `gapOptions` and `gaps` fields are
unchanged.
The params text no longer says the group defaults to the selection:
the command takes `group`, or `id` when `group` is left out, and
returns an error without either.
A stroke whose only setting that depends on direction is a gradient along or
across the stroke now goes through the same edge fitting as dashed strokes, so
each cut edge runs the way its source path does and the gradient keeps its
direction.
Object > Live Paint > Make gave each new face and edge one fresh row
built from only the source's topmost fill or stroke paint and the top
stroke's weight. A lower row that draws was lost, a hidden top row
became visible, and the rows' opacity, blending mode, effects and
stroke settings were dropped.
- A face takes every fill row that draws (shown, with paint and an
opacity above 0) of its front-most covering source that has one and
an opacity above 0, in order with their settings. A source in front
whose fill does not draw no longer hides the fill behind it.
- An edge takes every stroke row of its source that draws (also with a
weight above 0). Faces and edges take the source's opacity and
blending mode; gradients keep their fit on the source, and pen
pressure stays with the source.
- Where a path is cut into several edges, each edge runs the way the
path does, its dashes go on from where it starts along the path, the
arrowheads stay at the path's own ends, and a width profile or brush
stays only on an edge that runs the whole path.
- Rows that draw nothing stay with the stored sources, which Release
returns unchanged. Merge and Gap Options build their new parts the
same way.
Docs: livePaint.make params, docs/mcp.md, docs/target-app-parity.md.
Expand kept a face only when its topmost fill had paint, and an edge only
when its topmost stroke had paint and a weight. A face or edge drawn by a
lower row under an unpainted top row was removed, and one whose only
painted row was hidden was kept as a visible path.
Expand now keeps a face or edge when it is shown, its opacity is above 0,
and any fill or stroke row is shown, has paint and an opacity above 0 (a
stroke also a weight above 0), with all of its rows. The rows are checked
with the new Appearance::has_drawn_fill and has_drawn_stroke.
Merge carried a face's topmost fill paint by the same topmost-row test.
It now carries every row of each face that draws by this rule, and of
each edge, pins their unplaced gradients to the old outline as
repaint_from does, and leaves the strokes' pen pressure, tilt, bearing
and rotation behind, since the rebuilt parts are other paths.
Docs: livePaint.expand params text, docs/mcp.md, and a line in
docs/target-app-parity.md, which also drops a repeated Live Paint
Selection marquee line.
livePaint.fill's description listed "not with points" as its own entry, which
the params parser reads as a parameter name, so every_description_parses
failed. The note now sits inside the samePaint value's parentheses and says
that "connected" and "samePaint" are refused with points, as lp_fill does.
A Live Paint Bucket click or drag over faces that already have the
fill, a stroke on an edge that already has the paint and width, Gap
Options with the options the groups have and no gap to close, and Make
or Merge given one Live Paint group alone now leave the document, the
undo and redo steps and the saved state as they are, and reply as
usual. Such a fill or stroke also leaves the recent colors as they are.
Gap Options with Close Gaps With Paths makes a group's faces again only
when it adds a path or what paint stops at changes, so the faces keep
their ids otherwise.
With the Live Paint Bucket, a double-click on a face fills it and every
face reached across edges that are hidden or draw no stroke; a stroked
edge, a hidden face and a Gap Detection gap stop it. On an edge, a
double-click paints the edges joined to it end to end with the same
stroke paint. A triple-click fills every face of the group with the
clicked face's fill, or paints every edge with the clicked edge's
stroke. Shift and the Paint Fills and Paint Strokes options choose a
face or an edge as for a click; Alt held paints nothing.
- livePaint.fill and livePaint.strokeEdge take scope ("one", the
default, "connected" or "samePaint") and match, the paint compared,
and reply with count. A bad scope or match is an error, and scope
with a drag's points is refused.
- Each click of a double-click or triple-click paints as it arrives,
as its own undo step. For a triple-click, and for a double-click on
an edge, the tool sends as match the paint the face or edge had
before the first of those clicks, including a first click that makes
the Live Paint group from the selected paths. A double-click on a
face sends no match.
- PointerKind::TripleClick is new: the canvas sends it on egui's
triple-click unless a modal dialog is open, as for a double-click,
and ui.pointer and pointer_gesture take "tripleclick".
Docs: docs/mcp.md, docs/control-protocol.md, docs/target-app-parity.md.
With logoColors named, Flat Logo measured how flat the image is against
the named colors. A solid pixel counts as flat only within 22 (RGB
distance) of one of those colors or white. Flat art whose named colors
were 20 levels off in every channel was refused as not flat, and the
refusal score of a gradient changed with the names.
The check now uses the image's own colors, found the same way as when
no colors are named. It looks for as many colors as are named, with
white, or as the Colors setting gives, whichever is more. How far the named colors are
from the image's colors no longer changes whether the image is refused.
This changes one existing behavior: an image with large areas of a
color that was not named used to be refused, and it is now traced in
the named colors.
Docs: docs/image-trace-adjustments.md, docs/target-app-parity.md, the
imageTrace.make params text.
Commands that need an object id read it with `id_param`, which returns
None for a value that is not a non-negative integer, so `{"id": "5"}` or
`{"id": -1}` was refused with "missing id". They now read it with
`object_param`, which refuses such a value with "`id` must be a whole
number", naming the key. This covers `document.node`, the `path.*` anchor
and handle commands, the `text.*` range and path commands, the mesh,
envelope and slice point commands, `layer.target`, `layer.move`,
`node.move`, `select.magicWand`, and the `source`, `target`, `group` and
`path` keys of `appearance.transfer`, `appearance.copyFrom`, the
`livePaint.*` commands and `text.createInPath`.
The optional `group` of `livePaint.fill` and `parent` of `node.move` are
refused the same way when given. Before, a malformed `parent` moved the
object to the top level and a malformed `group` fell back to the
selection.