action.batch refused a bad step before any file opened as `commands[i]`,
counted from 0, while a step that failed as it ran was named
`action step N (`id`)`, counted from 1. A step whose params its command
refused gave only the command's own error, without saying which step it
was.
- The checks before the batch (no command, an unknown command, a nested
batch, prefs.import) now name the step as `action step N (`id`) failed:`,
from 1, as the runtime errors do. A long unknown id is cut short in the
message, as an unknown key is.
- The parameter check names the action.batch step whose params it
refuses the same way. command.batch keeps passing the step's error on
as it is.
- Override Open matches only document.open, and Override Save only
document.save and file.saveAs: file.open, file.save and document.close
are not engine commands, and a step with one is refused as unknown.
The params text no longer lists them, and docs/mcp.md says a step with
file.open or file.save is refused as an unknown command.
- The success level takes a new `success` theme token (the same green)
instead of the 3D axis color.
- docs/mcp.md names the plug-in conditions for `vc_call`, says no step is
recorded while a drag or typing is in progress, says a failed script run
keeps the messages it raised, and names the headless MCP server and
`vectorcraft-cli run` as the sessions without a window. Lines wrap like
the rest of the file.
- The params text and the error say "whitespace", which is what the check
rejects.
- A new test runs a script that draws, raises a message and throws: the
drawing is put back and the message is kept.
- The long-message test also checks that the stack stays inside the
window.
- The evidence line in docs/target-app-parity.md moves after the Scripts
entries.
path.freehand ignored a connect given without extend and drew a new
path. It now refuses it with "connect needs extend". A connect given
with extend is checked (its id, a path other than the one extended
with an open end, and an end of "start" or "end") before a stroke of
one point returns, so a bad connect is refused there too, and
brush.freehand no longer changes the path's brush or the selection
before refusing it. A null connect is still a key left out.
Docs: params text, docs/mcp.md, docs/target-app-parity.md. i18n: the
new message in the catalogs that carry the other connect messages.
Redefine Symbol chosen from the Symbols panel menu with Shift held now
updates the symbol and its instances from the selected art and leaves
that art as ordinary art, as the Edit symbols help page describes
(https://helpx.adobe.com/illustrator/desktop/manage-objects/traces-mockups-symbols/edit-symbols.html).
Without Shift the art still becomes an instance.
- symbol.update takes keepArt (default false). With true the art keeps
its ids, layer and stacking position and stays selected, apart from
art that is hidden or locked, and the result's id is null. A keepArt
that is not true or false is an error.
- Redefining the symbol being edited with keepArt still leaves symbol
editing mode in the same undo step.
Docs: docs/mcp.md, docs/target-app-parity.md.
A graphic style dragged onto another style in the Graphic Styles panel
with Alt held gives that style the dragged style's look. The replaced
style keeps its name, place and id, and the art still linked to it
takes the new look in one undo step; the dragged style and its art stay
as they are. Without Alt the style moves, as before.
graphicStyle.redefine takes {name, from} for this. A style dropped on
itself, or on a style with the same look, records nothing. A `from` that
names no style or is not a string, or `from` with `id`, is an error.
A Type tool click, or a Selection or Direct Selection double-click, on
type whose story is drawn in a font that isn't available as named (a
missing family, or a style its family lacks) now opens a question that
names those fonts instead of starting to edit. OK starts editing with
the caret where the type was clicked; Cancel leaves the document, its
undo history and the selection as they were. Each new edit asks again;
a click within the type being edited, or in another frame of its story,
does not. The fonts the type names are not changed.
The check reads only the clicked story's runs. As in text.missingFonts,
it leaves out CSS generic families and names over 256 bytes; it also
skips inline graphics and empty runs. The CSS generic family list moves
to vectorcraft-text so both share it. The question is the
missingFontEdit dialog, answered through the Type tool's
missingFontEdit option.
Ellipse Properties in the Transform panel and the Properties panel's
Transform section now has a Constrain Pie Angle link beside Pie Start and
Pie End Angle. While it is on, a typed angle moves the other angle by the
same amount, so the pie keeps its size, as the help page describes:
https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/modify-live-shapes/live-shape-properties.html
- object.setLiveShape takes constrainPie with one of pieStart and pieEnd.
Every selected ellipse keeps its own span in one undo step; an angle
equal to the current one records none. constrainPie with both angles,
with neither, or with invertPie is a parameter error.
- VectorCraft's own rules: the link is off at every launch and is not
saved; the two panels share it; the span is counted counterclockwise
from the start angle to the end angle, across 0 degrees; a whole ellipse
stays whole; after Invert Pie the swapped span is kept; the on-canvas
pie widgets still move one angle at a time.
Docs: docs/mcp.md, docs/target-app-parity.md.
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.
With several objects selected, Locate Object (and Locate Layer) now
finds the one frontmost in the stacking order instead of the one
selected last. Objects on different layers and sublayers compare by the
layers' order, and a member selected with its group counts as in front
of it. An id given to layer.locate still locates that object.
A file whose catalog has a CMYK /GTS_PDFX output intent describes its
DeviceCMYK colors with that intent's profile. A DeviceCMYK image in
such a file now opens tagged with that profile, so a CMYK image that a
PDF/X export writes as DeviceCMYK opens with its profile again.
An image drawn where a /DefaultCMYK is in scope keeps no profile, since
the default replaces DeviceCMYK there. The scope is read per image from
the resources it is drawn with, and the image cache keeps the tagged and
untagged reads apart.
An Alt-click (Option-click on macOS) on a plate's eye in the Separations
Preview panel shows that plate alone. Alt-clicking the same eye again,
while that plate is the only one of the document's plates shown, now
shows every plate, spot plates included, as the help page describes:
https://helpx.adobe.com/illustrator/using/printing-color-separations.html
- view.separationsPreview takes soloToggle: plate for this click. A
plate shown among others becomes the only plate shown, as the help
page describes for the first Alt-click. A hidden plate, another plate
while one shows alone, or any plate while none is shown also becomes
the only plate shown (VectorCraft's own rules). only still shows just
the named plate when repeated. Neither adds an undo step.
- The eye's tooltip names the second Alt-click, in every catalog.
Docs: docs/mcp.md, docs/target-app-parity.md.
Art dragged off the canvas and released on a symbol's tile or row in the
Symbols panel with Alt (Option on macOS) held now runs Redefine Symbol
(symbol.update) for that symbol, in thumbnail view and both list views.
The symbol under the pointer is outlined while the art is held over it
with Alt. A drop without Alt still makes a new symbol.
- A canvas art drag records the document it came from; art of another
document, objects the document no longer has and an empty drag are
not taken.
- symbol.update refuses art that holds an instance of the symbol it
redefines, directly, in an opacity mask or through the art of the
symbols it nests, so neither the menu nor the drop can make a symbol
hold itself. The symbol-editing check shares the walk and now also
looks inside opacity masks.
- Panel art drops take only a release of the primary button.
Docs: docs/mcp.md, docs/target-app-parity.md.
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.
With Panel Options > Show Layers Only on, the panel lists no object
rows, so Locate Object highlighted a row that was not there. The panel
menu, the bottom bar's button and a row's menu now read Locate Layer in
that mode and send layer.locate with layersOnly: true, which highlights
the innermost layer or sublayer holding the object (a layer locates
itself) and returns {id, objectId, ancestry}. The panel opens the layers
around it and scrolls to it. With the option off nothing changes.
Help page: https://helpx.adobe.com/illustrator/desktop/manage-layers/create-and-organize-layers/locate-objects-in-the-layers-panel.html
Adds Locate Layer rows to the 28 catalogs that translate Locate Object.
A line drawn with the Line Segment tool now shows Line Properties in the
Transform panel and the Properties panel's Transform section, with the two
properties the help page lists for a line:
https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/modify-live-shapes/live-shape-properties.html
- object.setLiveShape takes lineLength (pt, above 0) and lineAngle
(degrees, brought into 0 to 360). Every selected line changes in one
undo step; a value that changes nothing records none.
- VectorCraft's own rules: the angle runs counterclockwise from 3 o'clock,
as the Rotate field does; a new length keeps the first end in place and
a new angle turns the line about its midpoint; a line whose ends meet
reads 0 degrees; the section shows only while every selected object is a
live line; a line that would reach past the coordinate limit is an error
that changes no line.
Docs: docs/mcp.md, docs/target-app-parity.md.
With Smart Guides' Transform Tools on, a Cmd/Ctrl side-handle shear with
the Free Transform tool now shows its angle next to the pointer, with
the same sign and one decimal place as the Shear tool's label. Before,
a shear showed no value, and a scale drag turned into a shear kept
showing the scale's size. Transform Tools off still hides the label.
Docs: docs/mcp.md (transformToolsGuides), docs/target-app-parity.md.
File > Open's Import PDF dialog now starts with Import PDF pages as links
checked for All, so every page of a PDF opened from its file opens
linked, and clears the box when Range is picked, so a range opens as
art. A box checked or cleared by hand keeps that state until the other
of All and Range is picked; ui.dialog.set of allPages does the same.
The box stays clear for a file without its path, with a password, or
over the 256 MB that linkPages takes (fileio::pages_can_link).
Docs: docs/mcp.md, docs/target-app-parity.md, docs/file-format-parity.md.
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.
Art dragged off the canvas, or the Appearance panel's thumbnail, dropped
on a style in the Graphic Styles panel with Alt held runs
graphicStyle.redefine with that style's name and the object's id (the
first object of the art), in one undo step. The style keeps its name,
id and place in the list, and the art still linked to it takes the new
look. The style is outlined while one is held over it with Alt. An
object already linked to the style with its look changes nothing.
Without Alt the drop still makes a new style, and a style dropped on a
style still moves it.
Undo and redo put back the whole document a step stored, so settings
that change without an undo step went back with it. Undoing any
earlier edit turned the perspective grid's Lock Grid off again, turned
its Snap to Grid back on, showed a hidden grid and switched the active
plane back. It also reset the grid from Gridline every and
Subdivisions, the export settings assets.settings.set stores, and the
current brush and symbol.
Each undo step now also records these settings as the step left them.
Undo and redo compare that record with the document they bring back:
a setting the step did not change stays as it is now, and a setting
the step changed comes back with the step. So undoing a perspective
grid preset still hides the grid the preset showed, and undoing a grid
definition that locked the grid unlocks it. The point Automatic Plane
Positioning holds still follows the steps, and is let go when the
active plane kept is another one.
`app.toast {message, level?, seconds?}` queues a short message that the
desktop app shows at the window's bottom right. It closes after its time
(4 seconds by default, 0.5 to 60) or when clicked. At most 5 show at
once, the newest lowest; a message shows at most 6 lines with the whole
text on hover, and a stack taller than the window scrolls. `level`
(info, success, warning, error) sets the color of its edge.
Scripts raise one with `vc.run`, MCP clients and plug-ins through the
command, and an action records it as a step. The app's own code calls
`Session::toast`. The command edits no document and adds no undo step;
invalid values are errors. Part of #7523: the tick sound is not
included.
Docs: docs/mcp.md, the Automation evidence in docs/target-app-parity.md.
Object › Transform › Rotate Bounding Box… asks for an angle and turns the
bounding box of the selected objects by it, leaving their art where it
is. Reset Bounding Box squares it again.
- object.rotateBoundingBox {angle, absolute?}: by default the box turns
by angle from the angle the selected objects share (0 when theirs
differ); absolute: true turns it to angle. Objects with different
angles get one shared angle, and the objects inside a group or a
linked opacity mask turn with it and keep their relative angle. A path
of a compound path selected on its own turns only its own box, the
same objects the transforms move. An angle within 1e-6° of 0 is
stored as 0. One undo step, none when every box is already at the
angle. A missing or non-numeric angle is an error. changed counts
every box that turned, as object.resetBoundingBox counts the boxes it
squares.
- object.resetBoundingBox squares only the box of a compound path's
path selected on its own, instead of the whole compound path.
- Menu labels in every catalog.
Docs: docs/mcp.md, docs/target-app-parity.md.
Part of #5954.
A command result's menu path now reads as the menus draw it in the UI
language: plug-in submenus and Scripts folders keep their own names.
menu_entries carries that shown path beside the English one. Outside
macOS, items that only the VectorCraft application menu lists are left
out of Help, since the window's menu bar has no such menu.
Help now searches and shows a command by the label its menu draws in
the UI language, so Effect > Pathfinder > Add is found as Réunion in
French. menus::shown_label holds the menus' item-label rule, and the
menu bar and Help both call it.
A PDF/X-3 or PDF/X-4 export tagged every CMYK color with an ICC-based
space of the same profile that the output intent embeds. In PDF/X-3 and PDF/X-4, CMYK colors in the
profile of a CMYK output intent are now DeviceCMYK, and the profile is
written once, as the output intent's DestOutputProfile (ISO 32000-1,
14.11.5:
https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf#page=641).
- With output.profiles none and a CMYK output intent, PDF/X-3 and PDF/X-4
write every CMYK color as DeviceCMYK, unless colors are converted to a
CMYK destination of another profile, which keeps its tag. Before, those
standards tagged every color whatever profiles said.
- RGB and gray colors stay tagged, and so do CMYK colors and images in
another profile.
- A CMYK image that carries the output intent's profile is DeviceCMYK,
and so is every CMYK image when none makes CMYK colors DeviceCMYK. A
CMYK JPEG then loses its ICC_PROFILE segments.
- Transparency groups blend in DeviceCMYK when CMYK colors are
DeviceCMYK, also when the file has no ICC-based CMYK space.
- Files without a standard keep the tags that profiles asks for.
- The Save PDF dialog's note for PDF/X-3 and PDF/X-4 says that CMYK
colors in the output intent's profile are written as DeviceCMYK.
Docs: docs/mcp.md, docs/target-app-parity.md and the document.exportPdf
params text.
A kept command result now takes its menu item's current label and menu
path when the menu state changes, so Show Grid reads Hide Grid once the
grid shows, and a command that no menu lists any more drops out. The
results are brought up to date only when the menus' state hash changes,
with the menu entries looked up by command and params. Help commands
reject parameters that are not an object.
A floating Tools panel dropped on the canvas's left edge, right of panels
docked on the left, stayed floating unless Window > Toolbars > Keep Tools
Beside the Canvas was on. The canvas's left edge is now always a target:
a drop there docks Tools beside the canvas and turns the setting on, and a
drop on the window's left edge docks it there and turns the setting off,
so the menu item's check mark shows where Tools is.
This changes one existing behavior: with the setting on and panels docked
on the left, a drop on the window's left edge used to dock Tools beside the
canvas and keep the setting on. It now docks Tools at the window's edge and
turns the setting off.
With no panels docked on the left, both edges put Tools in the same place
(left of any toolbars made with New Toolbar docked there), so a drop on
either docks it where the setting puts it and leaves the setting as it is.
So does a drop in the column both edges share when left-side panels are
collapsed to icons narrower than the window's edge strip. A release in the
frame right after Tools floats out of its place at the window's edge skips
the canvas-edge strip, which that frame laid out right of the docked panel.
Part of #7837
object.setBounds and guide.move move direct-selected anchors through the
same path as object.move, so they already followed the Interpolate
Control Points preference. They now list `interpolate` in their params
text and reject a value that is not true or false, also when the change
only scales the anchors or only guides are selected. A test covers both
commands with the preference on and off and with the param.
When Add to Swatches brought a library pattern whose art links to a global
or spot color, and the document had that name for another color, the
pattern was relinked to the document's color. Adding the library's color
then made a numbered copy that the pattern did not use. The color now comes
in under a numbered name and the pattern links to it, as an added color
does, and the check for a pattern already in the document compares it the
same way.