The Circle tool, in the Ellipse tool's flyout, draws a circle with
shape.circleThroughPoints. A drag from one point to another, or a click
on each, draws the circle with the two points as the ends of a diameter.
A click on a first point, then a press on a second point dragged to a
third, draws the circle through the three. Shift keeps the second point
at 45° steps from the first. For a circle on two points, Alt rounds the
diameter to the nearest ruler tick at the current zoom in the General
unit. Each point snaps to Smart Guides. Until the release the tool shows
the circle as a dashed outline (solid once it is more than 50,000 screen
points around), a cross at its center, a line from the center to each
point and, with Measurement Labels on, the diameter by the pointer.
Three different points on one line, or a circle past the canvas, show
"Circle too large" by the pointer instead, and the release draws
nothing. Escape, a dropped press, and an edit, Undo or Redo made outside
the tool drop the first point. A second press within 3 screen points of
the first point, or one that snaps to it, places nothing when let go
there, and draws the circle on the diameter it drags out when dragged.
Each circle is one undo step. The tool's icon is new and drawn for
VectorCraft.
shape.circleThroughPoints also takes two points, or two selected anchor
points, as the ends of a diameter. Its two errors about the number of
points now say "two or three", in every catalog that translates them.
Part of #7178.
Making a new symbol from the selected art with Shift held now adds the
symbol and leaves the art as ordinary art, as the Create a symbol section
of the help page describes
(https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=192).
Without Shift the art still becomes an instance.
- symbol.new takes keepArt (default false). With true the art keeps its
ids, layer and stacking position and stays selected, apart from art
that cannot be selected, frames of threaded text stay in their
thread, and the result's id is null. A keepArt that is not true or
false is an error.
- The Symbols panel's New Symbol button and its New Symbol... menu item
read Shift when clicked and carry it through Symbol Options' OK;
Shift with Alt on the button makes the symbol at once and keeps the
art. Art dragged onto the panel reads Shift as it is released.
- ui.symbolOptions takes keepArt for a new symbol and refuses it when
editing a symbol.
Docs: docs/mcp.md, docs/target-app-parity.md.
DXF export with Use Artboards baked the whole document's live effects
and placed symbol art again for every artboard. export_drawings now
checks the options and every region, bakes once, and writes each
drawing from the same baked document. export calls it with one drawing,
and the encoder makes one call for all the chosen artboards. Each
drawing's bytes, linked images, warnings and setting notes are the same
as before; the tests compare them with drawings baked one at a time.
The Shear dialog's Axis now has Angle beside Horizontal and Vertical, with
an Axis Angle field (0 degrees when the dialog opens) that takes input
while Angle is chosen and keeps its value otherwise. object.shear takes a
numeric axis from -359 to 359 degrees, a line on the page measured
counter-clockwise from horizontal, as object.reflect's numeric axis is; the
shear angle stays a separate value. 0 shears as horizontal and 90 as
vertical. An angle outside the range, a number written as a string, or any
other value is an error naming it, and nothing changes.
Behavior reference: https://helpx.adobe.com/illustrator/desktop/manage-objects/reshape-transform-objects/shear-objects.html
describes the angled axis and its range. The counter-clockwise direction
and the 0 degree start are VectorCraft's own.
Docs: docs/mcp.md, docs/target-app-parity.md. Catalogs: an "Axis Angle"
row in every language.
The color table's trash button and Delete Color in its new menu delete
the selected GIF or PNG-8 colors. Pixels that used a deleted color take
the nearest color left, with the current reduction's color distance and
dither, and the preview matches the saved file. A click selects one
color and makes it the anchor, Shift-click selects the range from the
anchor, and Ctrl-click (Command-click on macOS) adds or removes one.
- colorTable.deleted lists the deleted colors by source. A deleted color
leaves the locked, transparent and webShift lists.
- colorTable.customPalette fixes the palette at the first deletion, so a
deleted color is not made again; the table reads Custom. Restore
Generated Table in the menu, or another reduction, clears both.
- Deleting every opaque color, or every color not mapped to transparent,
is an error and changes nothing.
- Presets and the remembered settings keep the edit.
- quantize_to uses all 256 fixed colors when no pixel is transparent.
Docs: docs/mcp.md, docs/target-app-parity.md.
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.
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.
An EMF or WMF export with Use Artboards applied the document's live
effects (geometry effects, and symbol art with effects) once for each
chosen artboard. vectorcraft_metafile::export_regions now checks every
region, applies the effects once and writes one metafile per region.
export is its one-region case, and the engine's encode calls
export_regions once for all chosen artboards. Each file's bytes and
warnings are unchanged.
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.
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.
object.setLiveShape reports no change when the rounded ends stay where they
are. The Line Length and Line Angle fields send every edited value in one
call, so a length committed in the same frame as an angle step is applied.
Width points selected before their stroke took a brush show no handles,
but the Width tool still took Delete, Backspace and Escape for them. The
tool now leaves those keys to the app, as it does with no width points
selected.
- The Profile list shows its hover border whenever a click opens it,
including on a brushed stroke with a profile, where it lists Uniform.
- A test checks that the list's hover text and the Width tool's status
message are the same string, so the two share their catalog rows.
- An engine test checks that a press or a double-click on a brushed
compound path puts the message in the status bar and runs no command.
- The doc comment of Session::brushed_strokes_profiled says when type
counts, and the progress-doc line names the double-click and says that
art and pattern brushes do not follow a width profile yet.
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.
After an edit of a document with symbols, the refresh of inline graphics
walked every node of every layer. It now keeps the document the last
refresh left resolved, with the symbol bounds it measured, and checks
only the layer trees that are not the same nodes as that document's,
as long as the symbols, graph designs, pattern tiles and foreign data
(which holds the symbols' natural sizes and 9-slice guides) are the
same and each measured symbol still measures the same. Otherwise the
full pass runs, as before. Visit order is unchanged, so the document
and the ids of the texts laid out again equal the full pass's.
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.
Add Used Colors and New Color Group link the selected art's paints to
global swatches through Document::map_solid_paints_in, which drops each
id that sits inside another listed id. It searched the whole id list for
each ancestor of each id, so the work grew with the square of the
selection. It now looks each ancestor up in a set of the ids, as
without_inner in crates/engine/src/cmd/edit.rs does. The roots keep the
order of the list, duplicates and ids missing from the document, so the
same paints are linked in the same order.
- mapping_within_ids_matches_a_search_of_the_ids compares the count, the
paints visited and the resulting document with the search for every
list of up to three ids from a nested tree (nested ids in both orders,
duplicates, a missing id and an empty list).
- crates/engine/examples/link_colors_bench.rs times both ways in one
process. With 20,000 selected rectangles the call takes 16 ms of CPU
time instead of 128 ms; with 2,000 it takes 1.4 ms instead of 2.5 ms.
A Stroke panel edit with no item lists the selected groups and layers
that have a stroke of their own, then adds the leaves of the other
targets, and it checked each leaf against the growing list, so
collecting the targets took time that grows with the square of the
object count. The command now checks each leaf against a set seeded
with the listed groups and layers. The list is the same: its order is
kept, a group or layer named twice is still listed twice, and a leaf is
listed once.
crates/engine/examples/stroke_targets_bench.rs times both merges on the
same leaves in one process. With 20,000 paths in one group, collecting
the targets takes 0.66 ms of thread CPU time against 55 ms with the list
search, and the whole command takes 60 ms.
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.