A Live Paint group among another group's paths gives that group its faces
and edges. A row moved into or out of the inner group's paths now also
makes the faces and edges of every Live Paint group that holds it among
its paths again, innermost first, so the outer group no longer keeps faces
and edges from the paths as they were.
A dropped path named "Live Paint Sources" that lands in front of the
group's sources group made the group stop counting as a Live Paint group,
so the drop failed. The group's own sources group now goes back in front
before the paths are added.
A dropped path named "Face" or "Edge" was read as one of the group's
faces or edges and its paint overwrote the generated part's paint. The
joining paths are now left out of the old parts.
Leaving isolation mode in a Live Paint group drawn in another isolated
Live Paint group, and that group too (object.exitIsolation, or
object.isolate on a level outside both), now adds the drawn paths to each
group, innermost first, one undo step each, so the inner group joins the
outer one. Before, only the innermost group took its paths, and the inner
group and the paths drawn directly in the outer group stayed beside the
outer group's faces.
A Live Paint group drawn in another one now counts as drawn art: its
hidden sources group no longer keeps it out of the outer group.
Dragging one of a Live Paint group's own paths from its hidden sources
into the group made the group's faces and edges again before adding the
path back, so the merge read the paint from the rebuilt parts. With the
path as the only source every face and edge was dropped; with others,
the faces the path bounded lost their fill. The group the rows join is
now made again by the merge alone, which carries the paint of the faces
and edges as they were before the move.
A path directly in a Live Paint group named Face or Edge is taken for one of
the group's faces or edges, so the next rebuild (Merge, Gap Options, a path
dragged in or out, leaving isolation mode) drops it. layer.setProps and
object.setProps now return an error when they would give either name to a
path in the group that does not have it already, and a path pasted directly
into the group under either name is pasted without its name.
A path, compound path or group of them dropped inside a Live Paint group
in the Layers panel, or above or below one of its rows, now joins the
group's paths as livePaint.merge adds them, in one "Merge Live Paint"
undo step that selects the group. An Alt-drag adds copies, and node.move
into the group does the same. With type, an image or another object
among the rows, the drop is refused with Merge's message and nothing
moves.
A row moved into or out of the group's hidden sources makes the group's
faces and edges again, keeping the paint of those that stay; with no
path left the group has no faces until a path joins it again. Before, a
dropped path became a plain child that cut no faces, and a source dragged
out left stale faces behind.
Faces and edges are the group's paths named Face or Edge, so type or a
group drawn in an isolated Live Paint group under one of those names is
no longer counted by Gap Options, Info or Make, and Expand keeps it, as
it keeps type named like the sources group.
Exit Isolation Mode while editing a pattern, an opacity mask or a symbol
applies a shape still being drawn with Real-time Drawing and Editing off
before the paths drawn in an isolated Live Paint group join it.
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
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.
Whether a trace's seam fills are strokes or outlines now depends on the
image object's own transform. A raster decoded scaled down to fit has its
two sides rounded separately, so it was scaled a little differently across
and down and every such trace got outlines. The stroke width now uses the
smaller scale of the raster, so a stroke still covers at most 0.75 pixels
on each side of its edge. The check for an even scale compares the axes'
lengths and angle directly, without a square root of a small difference.
Outlining the seam strokes now stops when the trace is canceled, checking
every 64 strokes. A stroke that reaches the make step without an outline
on a stretched image is left out rather than outlined outside the anchor
limit.
docs/mcp.md: the group clips the strokes or outlines.
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.
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.
File > Revert keeps the document's tab and uid, so a trace prepared
before the revert compared equal to one prepared after it when the
restored image, object and settings were the same. A background trace
that finished after the revert then applied to the restored content, and
a result handed to imageTrace.make or imageTrace.makeAndExpand stood in
for a fresh trace.
The trace inputs now record the document's revert count. A run prepared
before a revert is no longer current, the commands drop its result and
trace the restored image again as one undo step, and the status bar says
"Image Trace finished, but its document was reverted: trace it again".
Reverting another document, or a revert that fails, does not affect the
run.
Merge carried each old edge's paint only to the new edge nearest the old
edge's middle, so when an added path cut a repainted edge, the other
piece went back to its source's stroke. Every new edge whose middle lies
on an old edge now takes that edge's paint, with its rows fitted to its
part of the edge, as Gap Options does.
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.
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.
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.
main's Live Paint Selection double-click (#7342) replaced the tool's
catch-all pointer arm with an explicit DoubleClick arm, so the
TripleClick kind this branch adds left the match non-exhaustive. The
tool now takes no action on TripleClick: the third click's press and
release already select what a click selects, as before the merge.
The merge also took main's import list in the engine's Live Paint
commands, which no longer named Paint while this branch's Merge code
still uses it; Paint is imported again.
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 trace handed in for imageTrace.make or imageTrace.makeAndExpand was
matched by its object, image, pixels and settings alone, so a trace made
in one document could stand in for the command in another open document
with the same image and settings. The trace's inputs now carry the
document's uid: TraceRun::current is false in any other document, and the
commands there drop the trace handed in and trace their own image, as one
undo step.
Test: a_trace_run_applies_only_in_its_own_document.
The preset paragraphs say that the enhanced versions use the same Paths,
Corners and Noise, and that Corners 50 applies to the other eight
presets. The quality notes add the staircase and anchor rises in Line
Art, Outline, 3 Colors, Sketched Art and Silhouettes, and say which
figures were measured at the earlier values. The anchor-limit comments
name the same settings in both places.
Merge copied a face's or edge's appearance to the part it rebuilds in its
place, but not its visibility, opacity or blending mode. A half-transparent
face drawn by its stroke became opaque, and a hidden edge was shown again.
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.
The test for a triple-click whose first click makes the group now also
builds the planar map from the same two paths and checks that the face
at the click takes its fill from the square. The doc comment of the
double-click flood names the three points it checks along each edge
segment.
Every built-in preset other than Auto Color and Flat Logo now traces at
Paths 50. Corners is 100 in Technical Drawing, 75 in Default, Black and
White Logo, Line Art and Outline, and 50 in the others. Noise is 1 px in
Technical Drawing, 5 in High Fidelity Photo, 10 in Low Fidelity Photo, 15
in 3 Colors, 6 Colors, 16 Colors and Shades of Gray, 20 in Sketched Art,
Line Art and Outline, 25 in Default and Black and White Logo, and 90 in
Silhouettes. Palettes, color counts and the other options are unchanged.
This changes the output of every preset but Default, Auto Color and Flat
Logo. The traces take fewer anchors (High Fidelity Photo 5,494 to 3,136
and Black and White Logo 27 to 14 in crates/trace/tests/quality), and
outlines on flat art lie further from the true edge (16 Colors 0.100 to
0.123 px off on average).
Docs: docs/image-trace-adjustments.md, docs/image-trace-quality.md,
docs/target-app-parity.md.