Merge current main and retain both the Pencil snapping documentation and Tech Circuit library evidence. Only docs/mcp.md required manual conflict resolution. Focused checks passed: no conflict markers or whitespace errors, all 28 catalogs retain four unique nonempty labels, and brush implementation/tests remain unchanged. No full local Cargo CI rerun.
A save written in the background reported "Saved <path>" when it
finished, and a background job that failed reported "<label> failed:
<error>", even when another command or job had set a newer status line
in the meantime. Both now use the rule Data Recovery copies already
follow: the result goes to the status bar only while no other line has
been set since the job started, or the only line set since is the job's
own "<label>…" line and it is still shown.
The save itself is unchanged: the file is written, the document counts
as saved, Open Recent lists it, and a failed write still opens its
error dialog.
With Output › Convert to Destination and a CMYK destination, or an RGB
destination other than sRGB that images are converted to, an RGB image
that carries an ICC profile had its numbers read as sRGB, so a Display
P3 image came out with the wrong colors. Such an image is now converted
from its profile to sRGB with the color settings' rendering intent, then
to the destination.
- An untagged image converts from sRGB as before.
- A gray image keeps its profile, as gray is not converted.
- A profile the color engine can't read leaves the numbers read as sRGB,
with a warning.
- Preserve Numbers is unchanged.
docs/mcp.md, the document.exportPdf params text and the progress doc
describe the behavior.
The panel's Lighting tab shows a sphere above the list of lights with
every light of the selected 3D effect at its Rotation and Height, filled
in front of the object and hollow behind it. Dragging a light moves it
on its side of the object, previewed while the pointer is down and one
undo step on release; a press selects it in the list. Move Light to Back
and Move Light to Front change the selected light's side. Each light
takes the keyboard focus, where the arrow keys move it (Shift steps
15 degrees), and screen readers name it with its settings. The widget
sends effect.setParams like the light settings below it.
Objects in an opacity mask's art inside a symbol definition or a pattern
tile are now written with their art styles, as mask art on the layers
already is. A symbol or pattern whose mask art has Offset Path opens with
the effect live in its definition, and its instances and pattern fills
draw as before. Each definition is written with the styled objects of its
own masks only, so art placed as copies inside it is not matched to
another definition's original.
- Mask art linked to a graphic style opens linked to it: the reader's
style linking now goes into opacity masks' art.
- Links in pattern tiles count toward the lost-link warning, the warning
is checked after unused symbols and swatch-only patterns are written,
and links in art left out at the object limit are no longer counted as
kept.
brush.freehand drew the path with one edit and set the brush with a
second, so one Undo left the path without its brush. The brush is now
set in the same edit that draws, continues or redraws the path, and the
step is named Paintbrush whatever the style.
A brush for a path with no stroke (a continued or redrawn path without
one, or a new filled "pencil" path while the stroke is None) was skipped
and the call still succeeded. It is now refused with "cannot apply brush
`<name>`: path has no stroke" before anything changes. The Paintbrush
tool sends brush.freehand when a brush is current, so continuing or
redrawing such a path with it now shows this error. This rule is
VectorCraft's own.
brush.freehand is no longer in UNCHECKED: it takes the path.freehand
keys and `brush`, and any other key is refused with "unknown parameter".
After the last answer in Linked File Not Found (Replace with a path,
a picked file or Apply to All, Ignore with or without Apply to All, or
Relink in the Find Linked Files dialog its Find in Folder... opens), the
status bar shows the open's notes again, so hovering it lists them even
when the relink or another action showed a message meanwhile. With
Update Links: Manually the line about modified files still comes first;
with Ask When Modified the notes show while the update question opens.
Cancel in either dialog stops the remaining questions and shows the
open's notes the same way. A canceled file picker leaves the question
open. An open without notes leaves the message as it is.
A native save now sets the stored brushes' art on the document while it
tells linked images from embedded ones and while it converts placed
documents for older versions, then writes the changed brushes back.
- A linked image shown only in a brush's art is saved as its preview, or
with Include Linked Files as its file's bytes; an image key that the
layers or a brush's art shows embedded keeps its full bytes.
- Saving for an older version replaces placed documents in a brush's art
with groups of their art and its resources, before a precision rounds
it, and the precision preview and PDF use the same conversion.
- Data Recovery copies count the images in brush art the same way.
Docs: docs/target-app-parity.md, docs/mcp.md.
Each piece of a colorized image cut by a Warp effect or an envelope
decoded the image again to work out how much of the color each pixel
shows, although the decoded image was already kept for the pieces that
follow one another. The writer now keeps the coverage next to the
decoded image, for the same data and type, and works it out again only
when the image changes. The file written is unchanged.
While the Rectangle, Rounded Rectangle, Ellipse, Polygon or Star tool has
one closed path selected whole, as right after it draws one, the
contextual task bar shows Edit Path, the Fill and Stroke chips, and
Shape Properties for a live rectangle, rounded rectangle, ellipse or
polygon. The help page lists these items for the five tools:
https://helpx.adobe.com/illustrator/desktop/get-started/learn-the-basics/contextual-task-bar-overview.html
With nothing selected, several objects, a group, an open path, type or
picked-out anchors, those tools show no bar. The selection tools'
Duplicate, Offset Path, Simplify, Recolor Artwork and Lock are left out.
A star, drawn as a plain path, gets no Shape Properties. Gen Shape Fill
and Generate Vectors are not added.
Merge Swatches relinked a gradient stop linked to a merged spot swatch to
the kept swatch but kept the process plates it printed with the old ink,
so a kept spot swatch printed them beside its own tint and a kept global
process swatch held them for a later change back to spot. The merge now
clears those plates in the art, gradient swatches, graphic styles, the art
of brushes and the fill and stroke for new art, in the same undo step.
Stops linked to other swatches keep their plates.
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.
Eraser Tool Options gives Angle, Roundness and Size each a variation menu
(Fixed, Random, Pressure, Tilt, Bearing, Rotation) and a Variation field.
path.eraseRegion takes angleMode, roundnessMode and sizeMode with their
variations, sweeps a varying tip as a Calligraphic nib with what the pen
read along the drag, and refuses an unknown mode or a variation out of
range. The Eraser records the pen's pressure, tilt and rotation when a
mode follows them, and its tip outline at the pointer takes the angle,
roundness and size the pen gives while it erases.
Files saved for versions 10 to 13 place each symbol instance with a
TransformMatrix. On the page it takes the symbol's art to the canvas
(y down); in a symbol's art, it takes the art to that symbol's space. The
reader only knew the RTransformMatrix of newer files, so any such
instance made the editing data unreadable, and the file opened from its
PDF part alone, which holds only the art on the artboards.
The reader now converts a TransformMatrix with the canvas point of art
space's origin that the template box gives. A file whose symbol
instances were the only part it could not read now opens from its
layers, with the art outside its artboards.
The symbols fuzz test also damages the same data in the older form.
Docs: docs/target-app-parity.md, docs/file-format-parity.md.
With Output > Convert to Destination and an sRGB destination, a gray or
RGB image that carries an ICC profile (a Display P3 TIFF, a PNG or JPEG
with an embedded profile) is converted from that profile to sRGB with
the color settings' rendering intent and written without the profile.
Before, it kept its own numbers and profile.
- A 16-bit image that is not resampled or recompressed stays at 16 bits
a sample from PDF 1.5 on.
- A JPEG kept as JPEG whose samples the conversion leaves unchanged (an
sRGB profile) keeps its JPEG data; other JPEGs are encoded again.
- A black-and-white image whose converted levels are gray is compressed
as grayscale.
- A profile the color engine can't read is kept, with a warning.
- Without conversion, and with Preserve Numbers, images keep their
profile as before.
IccProfile::to_srgb_pixels converts a run of pixels in one pass.
Docs: docs/mcp.md, document.exportPdf params, target-app-parity.
An opaque knockout group in Normal mode with isolate off and nothing
blending inside was written as an isolated PDF knockout group (/I true
/K true), and a clipped one was drawn in an isolated form. The group's
elements now start from the art below it, as on the canvas: the /K
group carries no /I, and a clipped group gets no isolated form. An
isolated knockout group keeps /I true.
A click on a symbol instance hit only its art's geometric box, and a
marquee touched only that box, so art that a clipping path's live
geometry effects move past the box could be seen but not selected.
- Outside its box, in Preview, a click hits an instance where its placed
art hits (dynamic overrides and 9-slice placement included), and a
marquee touches the placed art as it touches a group of that art.
Outline view and layers with Preview off keep the box alone.
- The quick reach of an instance takes in the regions of the clipping
paths with live effects in its art, so the groups around it no longer
cull those clicks.
The editable text of an .ai save now lists the Hard and Soft Kinsoku sets
(resource key 4) and writes each paragraph's Kinsoku set (key 27, /nil for
None), Kinsoku Shori Type (25), Burasagari (24) and Bunri-Kinshi (23), in
every paragraph run, the normal paragraph style and the document's
defaults, in the form the .ai reader reads. The four settings reopen as
set, including Burasagari and Bunri-Kinshi under Kinsoku None, and are no
longer reported as left out.
Docs: docs/mcp.md (Bunri-Kinshi), docs/target-app-parity.md.
With Shadows on, the check a command runs for Extrude & Bevel, Inflate
and Rotate built every solid a second time to check its shadow. It now
casts the shadow from the faces kept by the builds that check the solids,
as drawing does, so each solid is built once.
A stroke whose solid is left out of the art past its own limits no
longer gets a solid built for the shadow alone: it casts nothing, as it
draws nothing.
A gradient stop's process plates print beside the tint of the spot swatch
that the stop itself links to. A painted live effect could return a stop
with `plates` and no link, or a link to a process swatch or Registration,
and the result was drawn with plates that no plate ever prints.
- The painted-output decoder refuses `plates` on a stop with no `swatch`
(absent or null). The gradient's own `swatch` does not link its stops.
- The reference check refuses `plates` on a stop linked to a swatch that
is not a spot swatch. It runs again on a cached result, so a result is
refused once its swatch stops being a spot swatch. A missing swatch
keeps the error that names the swatch.
- Either fault refuses the whole result, and `lastError` names the
stop's `plates`. Plates on a stop linked to a spot swatch, all-zero
ones included, are kept. Filter and importer output keep clamping and
unlinking plates as before.
Docs: docs/plugins.md, docs/target-app-parity.md. The new message has a
row in every complete message catalog.
With linkPages and cropTo: crop, a PDF-compatible .ai opened on its crop
boxes, while opening it as art uses its trim boxes. It now uses the trim
boxes too. A page on its trim box shows its bleed box round the
artboard, and the pages' bleed (the widest on each side) becomes the
document's bleed, as the importer sets it.
linkPages read and checked the whole PDF again for every page it
linked. The pages are now read from the file opened once. With
cropTo: bounding, a blank page stopped the open with "has no art to
place"; it now gets its crop box, as opening the page as art does.
Extrude & Bevel, Inflate and Rotate decided whether a fill, stroke or
member casts part of the shadow with `opacity > 0.0` and skipped it with
`opacity <= 0.0`. A NaN opacity failed both tests, so the part was
neither cast nor skipped: the shadow cast from the solids drawn added its
faces with a NaN ink, giving the shadow fill a NaN opacity, and the
shadow built for itself recorded an empty part.
Both paths now use one rule, `shadow::Ink::casts`: art casts only when
its opacity is a finite number above zero. NaN and infinite opacity cast
nothing, as 0 % does, and the art beside it still casts. Finite opacity
casts as before.
- A form other than the default, set with text.setRangeStyle or
text.setFormat, takes away the characters' glyph choice, which would
otherwise keep drawing its own glyph. "default" keeps it.
- With a width form (fwid, hwid, twid, qwid), shaping leaves out palt and
turns kern and apkn off, and SVG output writes font-kerning: none and no
palt, as the OpenType feature list asks. proportionalMetrics and kerning
keep their values.
- The Glyphs panel menu counts a width form as available when a face has
the feature in GSUB or GPOS.
- At a caret, the menu's check marks and its no-op check read all the
text of the object, which is what the command formats. Choosing the
current form again is not skipped when a character has a glyph choice.
An action or journal entry recorded before Scale and Reflect followed the
turned bounding box has no basis value. Replayed, such a step now acts along
the page's axes, as it did when it was recorded; steps recorded now carry
basis "box" and replay along the box. The built-in Reflect Horizontal action
names basis "box", so it keeps reflecting across the box's own axis.
The symbol test that reflects a turned instance names basis "page", which
is the reflection it was written for.
Object › Distribute follows Object › Align and lists Horizontal
Distribute Left, Center and Right, Vertical Distribute Top, Center and
Bottom, Horizontal Distribute Space and Vertical Distribute Space. Each
item runs the button's `align.distribute*` command, so it uses Align To,
the key object and the Distribute Spacing value, and with the Artboard
tool chosen it spaces the selected artboards.
Unit::parse took one level of recursion per + - * / sign, so a text such
as "1+1+...+1" with 200,000 terms overflowed the stack and aborted the
process. Every number field, parse_number and every command parameter read
as a length went through it.
Text with more than 128 + - * / signs now reads as nothing; text with 128
or fewer reads as before. docs/mcp.md states the limit for length strings.
The test a_very_long_expression_reads_as_nothing aborted with a stack
overflow before the change.
The PSB row of docs/file-format-parity.md says the merged image comes in
clipped by the file's clipping path, as the PSD row does, and
docs/target-app-parity.md's evidence list gets a line for it.
The measurement that runs before the style cascade and usvg now covers
the inputs that still got past it:
- usvg matches a selector without keeping what it found, so one whose
leftmost part matches nothing tests every set of ancestors in turn.
The measurement counts those tests for each copy and stops at
50,000,000; past that the SVG is refused with "the SVG's style sheets
take too long to match". An SVG image's matching stops at what the
SVG showing it left.
- A test counts one more for every 16 attributes a lookup scans and
every 16 bytes of the value it compares, so many classes against a
long class list count the work they do, in usvg's matching and in
the import's own cascade.
- The declarations the import's own cascade keeps, once per element,
count toward the 64 MB, including those of `:not()` rules, which usvg
drops. Each `:not()` alternative counts as a test.
- A linked SVG file is measured before its cascade runs. The linked SVG
files share one measurement: once they pass the limits together, the
files after that are shown without their links. The tests a file past
the limits made still count.
- SVG images share the element limit and the selector tests with the
SVG showing them, as they already shared the 64 MB.
The svg_filters reader measures its SVG before the cascade too.
A PSD or PSB file can name one of its saved paths (image resources 2000
to 2997) as its clipping path in resource 2999. psdread::clipping_path
reads that path in the image's pixel space, under the even-odd rule the
file format specification gives, with a subpath around the whole image
first when the initial fill record says the fill starts with all
pixels.
File > Place of such a file, and File > Open of its merged image, put
the image in a clip group of that path with no paint. file.place answers
the image's id as `image`, as for a DCS file. Replacing an image alone
in a clip group with such a file keeps the image's scale and rotation.
links.update and links.relink leave the clip group as it is. Files that
name no clipping path come in as before.
The Rough Pastels dialog has a Load Texture… button, as Glass and
Texturizer have. The image's gray levels become the paper surface,
stored with the effect as `textureImage` and listed as Loaded Texture
in the Texture menu; Scaling, Relief, Light Direction and Invert act on
it as on the built-in surfaces. The dialog's Texture and Light
Direction controls are now menus instead of text fields.
effect.apply and effect.setParams read `textureImage` from a file or
take the stored string and refuse anything else, and a plug-in filter
cannot have the host read a file for it.
In the Effect Gallery's Settings, a file dialog that answers later
(the macOS sheet, the Linux dialog) now gives the texture to the values
that asked: the filter being browsed, or the stack row that asked,
found by a number each row now carries. An answer for a removed row, a
filter no longer browsed or a gallery that closed is dropped.
Params text, docs/mcp.md, docs/control-protocol.md, docs/gaps.md and
the evidence line are updated.
Type on an open path can now start before the path's start: its start
is stored below 0, the span runs from there, and the characters whose
middle falls before the path's start are not drawn, as SVG 2 lays out
text on a path (https://www.w3.org/TR/SVG2/text.html#TextLayoutPath).
The text keeps every character, and the start bracket stays at the
path's start. Past the path's end, text that does not fit is overflow,
as for other type on a path. Type that starts on the path draws every
glyph as before.
- SVG import keeps a <textPath> start before an open path's start
(text-anchor end or middle, or a negative startOffset) instead of
starting the text at the path's start, which drew every character.
- SVG export writes it as a negative startOffset.
- PDF export writes only the characters drawn on the path.
- The legacy .ai and .ai editing data writers write the type from the
path's start with the type attributes warning.
- type.pathOptions takes a start below 0 for type on an open path; on a
closed path it is the path's start, as before. A flip starts the type
at its start bracket. Dragging the center bracket slides it from where
it starts, and no further before the path.
- A click at the path's start places the caret by the first drawn
character, and the caret in the hidden characters stands at the
path's start. The highlight of substituted fonts and glyphs leaves
them out.
- Release Type on a Path keeps the first drawn glyph where it was
drawn, with the hidden characters before it.
- The Touch Type tool shows no box for a hidden character, and
text.touchType returns an error for one. A character with a drawn
glyph is changed by that glyph.
Docs: docs/mcp.md, docs/target-app-parity.md.
The menu item checked a listed script and then ran script.run by its path,
which opened the file again; a link put in place of the file or a folder on
its path in between could make it run a file the check never saw, and the
include folder was looked up from the path again as well.
script.run takes installed: true. With a path it reads the file once through
script::folder::read, runs that text, and reads #include and $.evalFile in the
Scripts folder's real path followed by the names that read found. The menu
item runs script.run {path, installed: true}.
Object › Plug-ins › Packaging Tools is a new built-in add-on for the
dielines of boxes and other folded packaging. A path, compound path or
live shape is a fold line when its top stroke is painted with the swatch
of a line role: Cut, Crease, Partial Cut or Perforation. Each document
has a role table (`packagingRoles`) that names the swatch of each role.
By default the swatches are named after the roles. Native files keep the
table and the strokes. PDF prints a role line on its swatch's separation
when the swatch is a spot color, as the default role swatches are. SVG,
DXF and HP-GL keep the stroke's color, so the default role swatches come
out as four colors.
- `addon.packaging.setRole` (Make Cut Line, Make Crease Line, Make
Partial Cut Line, Make Perforation Line) paints the top stroke of each
path among the objects with the role's swatch at 100%, through groups
and clip groups. Locked and hidden objects are left out, also when
named by id. A path without a stroke gets a 1 pt stroke, a hidden
stroke is shown, and the stroke overprints unless `overprint` is false.
A missing role swatch is made as a global spot swatch in the document's
color mode (Cut 100% magenta, Crease 100% cyan, Partial Cut 100%
yellow, Perforation 50% magenta and 50% cyan). When a color group or a
swatch that can't carry a role has that name, the swatch is made as
"Cut 2" and so on. `none` takes the role away and keeps the color. One
undo step, none when nothing changes.
- `addon.packaging.roles` counts each role in the selection, or in the
document while nothing is selected, locked and hidden lines included.
The Fold Lines panel shows these counts, gives the selected paths a
role when a row is clicked, and says when nothing is selected.
- `addon.packaging.setRoleSwatch` (the panel menu's Role Swatches…) makes
another global or spot color swatch carry a role. It refuses missing,
gradient, pattern, process, tint, [None] and [Registration] swatches
and a swatch another role has.
When `swatch.edit` renames a role swatch, the role stays with it under
the new name. When it turns Global off, the role moves to a new swatch
name that the next Make … Line makes. When `swatch.merge` merges a role
swatch into a global swatch that carries no role, the kept swatch takes
the role.
Docs: docs/mcp.md (Packaging Tools add-on) and ROADMAP.