The editing copy of a PDF-compatible .ai wrote every gradient mesh as
its drawn look. Meshes the .ai reader reads back as they are are now
written as meshes:
- Each mesh is a /Mesh record: 2 /Version, its type and grid size,
/Data, then each patch row by row with its place, the color space
where it changes (gray, RGB or CMYK) and its four corners: color,
opacity, point, and the handles towards the next corner and the one
before it. Its opacity, blending mode and knockout shape are set
before the record, and its name and opacity mask follow it.
- A reflected mesh, whose patches all turn the other way, is written
with its columns in reverse order, which draws the same mesh.
- In a symbol's art the corners are written about the canvas point of
the ruler origin, y up, as an image's matrix there is. An envelope's
grid in a symbol's art is now written in the same space, and the
envelope's contents in its dictionary in the canvas's space, y down.
- Each mesh is checked with the reader's own reading before it is
written. Written as their drawn look with a warning: meshes with a
point in a Lab color, with more than 128 rows or columns, folded
meshes (patches that turn different ways), meshes the reader would
read with other points, handles or colors, meshes in pattern tiles
and in art cut to a clipping object, and every mesh on a large
canvas. A mesh's drawn look is written at any depth of nested
symbols and live objects.
Each construct is written in the form the .ai reader at e142c5fcee
reads: /CS, /Type, /Size, /P, /N and /E in mesh.rs:180-234, corners
with or without an opacity by their count of values in read_corners
(mesh.rs:239), the patches joined into one mesh in one_mesh
(mesh.rs:298); /Mesh X!, X# and /End X! in read/ops.rs:219-232; the
transparency after the record in read/art.rs:281 (end_mesh) and
read/ops.rs:344. /Version and /Data are passed over by that reader
(mesh.rs:234). Corners in a symbol's art rest on a reader change in
this commit.
The reader changes how any .ai opens:
- Mesh records and envelope grids in a symbol's art are read in canvas
space (read/document.rs:947 image_space), and an envelope's contents
in its dictionary in the canvas's space, y down. In a file without a
template box such a mesh is left unread, its symbol is not read
whole, as with an image there (read/art.rs:634), and its instances
open as the page draws them. Envelopes in symbols in .ai files saved
by earlier VectorCraft builds open differently.
- A point of a patch whose corners differ in color model keeps its own
color when the patches are joined into one mesh.
Gradient meshes, mesh points and their opacity:
https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=200
Patch meshes (corners joined by cubic edges with control points):
https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/pdfreference1.7old.pdf#page=321
Tests: the round trip of meshes with RGB, CMYK and gray points, a moved
point with handles of its own, part-transparent points, a name,
opacity, blending mode and knockout shape, hidden and locked, with an
inverted, unlinked opacity mask, in groups, opacity masks, symbols,
opacity masks in symbols, a document of two artboards and eight levels
down, compared point by point, handle by handle and channel by channel
at the 4 decimals written; reflected meshes, mirrored across and
along; the record's form, including corners in a symbol's art and an
envelope's grid and contents there; an envelope in a symbol read back
with its contents and their gradient in place; the same bytes on a
second write; each case written as its drawn look, with its paths read
back over the mesh's box; reading a mesh in a symbol's art with and
without a template box; /Version and /Data passed over; the color
model rule; fuzz cases for damaged written meshes, a symbol's
included.
Docs: docs/file-format-parity.md, docs/target-app-parity.md.
With Link, File > Place now places an EPS file, a PostScript file and a
PostScript .ai as a linked placed document, but the Place dialog still
counted them as other files, so Link's tooltip did not say they become one
locked object, and the dialog test expected a PostScript .ai to be
embedded.
- `is_vectorcraft_file` counts an EPS, EPSF or PostScript file on disk, and
a PostScript .ai, as a document, and leaves out a DCS file, which is
placed as a linked image.
- Where the platform reads part of a file, it reads only the file's start
and tells a DCS file from it with `place::head_is_dcs` (the check Links
uses), binary EPS headers included.
- The dialog test now checks the .ai, .eps and .ps cases, the bounded read,
DCS files plain and behind a binary header, and a file named .eps that
isn't PostScript.
The rows of Select by Artboards and the Variables panel, and every
collapsible section header, reported their state through
`WidgetInfo::selected`. egui writes that value as the node's toggled
state for every role, so the accessibility tree showed these rows and
headers as toggled. AccessKit keeps a list item's selection in its
selected property and a disclosure control's state in its expanded
property.
- `widgets::list_item_info` gives a row the list item role and sets its
selected property, and both lists use it.
- `section_toggle_name` sets the header's expanded property, as egui's
own collapsing header does.
- Tests draw both lists and a section header and check the role and
state of each node in the accessibility tree.
The drag check took any line intersection kurbo reported, and kurbo also reports
one a tiny step before the start or after the end of a cubic. On a long curve that
step reached past the 0.0001 pt join tolerance, so a drag 0.0002 pt short of an edge
stroked it. Only intersections inside the segment count now; the checks on the
edge's ends still cover touches there.
With variation cells selected, the Save Color Group to Swatches button
now saves those cells as one swatch group, in grid order (row by row,
left to right, each cell once), named after the harmony rule, in one
undo step, each color in its own model. With no cell selected it saves
the harmony colors as before.
A cell selection now ends when the guide it was made in changes: the
base, the Color Guide Options, the variation mode, the harmony rule, the
library limit, or the colors the grid shows. Before, changing the
variation mode or the options kept the old cell positions selected, so
Save Colors as Swatches could save colors that were never picked.
With a gray between black and white, an edge pixel of black on white
took the black-and-white blend only when one of its eight neighbors lay
past the gray on each side and the flat black and white areas lay nearer
than the flat gray. On an edge blurred by a pixel or more neither holds,
so gray slivers lined black shapes: a black disc beside a gray square on
white traced up to 35 gray paths at blurs of 1 to 3 pixels.
The check now walks from the pixel along the line between the two outer
colors, up to 5 steps each way, each step to the neighbor that lies
farthest toward one of them while the pixels keep getting darker (or
lighter). The blend of the outer two lies as near as the farther of
their flat areas, or as the larger of the two step counts to a pixel of
each outer color when that is smaller. The first step is the old
neighbor check. The same disc and square now trace with one gray path
at blurs of 1 to 2 pixels. At 3 pixels, with the colors named, a gray of
128 is one path, a gray of 200 leaves 4 slivers with no area, and a gray
of 230 leaves 8 slivers of up to 21 pixels (14 gray paths before).
On edges blurred by a pixel or more, gray near black loses pixels. A
soft-edged gray band up to 4 pixels wide along black traces as black
and white at blurs of 1.5 and 2 pixels, and one up to 3 pixels wide at
blurs of 1 and 3 pixels. A soft-edged gray stroke 2 pixels from black
can lose some or all of its gray, and one 4 pixels away a few pixels. A
soft-edged gray stroke running out of black, blurred by 1 or 1.5
pixels, loses 3 or 4 of the 16 pixels nearest black. Sharp-edged bands
and strokes keep their gray.
Docs: docs/image-trace-adjustments.md, docs/target-app-parity.md.
A click on the isolation bar's empty space, or on the isolated object's
name at the end of the breadcrumbs, leaves isolation mode altogether, as
Exit Isolation Mode does, nested isolation included. The back arrow, the
breadcrumbs of the levels above and the pattern buttons keep their own
actions, and a drag across the bar does not exit.
While an opacity mask is edited the click stops editing the mask. In
symbol editing mode it leaves the mode, also from a group isolated inside
the symbol's art and together with the isolation the mode was entered
from. While a pattern is edited it does nothing; Save a Copy, Done and
Cancel end pattern editing.
Docs: docs/target-app-parity.md.
With `pdfs: "single"` and several assets, layers or selected objects
(`selection: "each"`), document.exportForScreens wrote one PDF named
after the document holding only the first item's art, and every other
item's PDF was left out. Single file puts artboards on the pages of one
PDF; each asset, layer or object is cut out of the document with its own
art, so the export now refuses that combination before it writes any
file, and the Example line refuses it too. `pdfs: "multiple"` still
writes a PDF of each item, and `selection: "one"` writes one PDF either
way.
Docs: params text, docs/mcp.md, docs/target-app-parity.md.
With the Selection tool, every Character and Paragraph field read its
value through selected_stories, which walked the selected objects and
looked up each type object's story again. With the default panels open
that was 24 builds of the same list per frame.
selected_stories and selected_story_texts now keep the last list,
with the document (a held Weak keeps its address from being reused),
its revision and a copy of the selected objects. A change to any of
them builds the list again. Type objects are still resolved from the
current document on every read, so the panels show the same values.
Tests compare the kept list with a fresh build after an edit, a
reordered or replaced selection, a selection set without a new
revision, a selected group and a switch to another document at the
same revision; compare what both panels draw and their field values
with and without the kept list; and count one build per frame.
A style with no fill and no stroke whose Characters row sits above some of
its rows showed its type preview with the characters' own fill over the
white backing when Override Character Color was off. The backing now puts
every row above the contents, so the white fill covers the characters.
A drag that starts with Backtick already down set the copy spacing origin at the first drag event, so a short first stretch of the drag could leave no copy. The press now sets it.
A release over another document's floating window is handled before the
frame's drag cleanup. When another document became current after a tab
hover started the transfer, cleanup would have canceled it, but the
floating window still copied the artwork. The pane drop now also checks
that the transfer's target is still the current document, as cleanup does.
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