P, a click on the active Pen's button and `tool.select {tool: "pen"}`
now end the path being drawn through the same cleanup as Escape: the
path stays open and selected (a path inside a compound path leaves the
compound path selected), the Pen stays chosen, no undo step is added,
and the next click starts a new path. An anchor or handle being dragged
is committed first. With no path being drawn nothing changes.
Before this change the Pen kept drawing the same open path when it was
chosen again; the Blend test that stated that rule now checks the new
behavior.
When the Color Guide's base is a spot color, or a tint of one, picked in
the Swatches panel, with the Color panel's tint slider or with the base
chip, the cells right of the center in the base row of Tints/Shades are
now tints of that spot color. A click paints the art with the tint, a
drag carries it, and Save Colors as Swatches and Save Color Group to
Swatches make tint swatches linked to the spot color, so they follow an
edit of it. Shades, other rows, Warm/Cool, Vivid/Muted and a Limit to
Library give process colors, as before.
A cell's tint is the base's tint reduced by the share the cell goes
toward white. The guide follows a rename of the spot color swatch.
`swatch.new {colors}` and `swatch.newGroup {colors}` take
`{swatch, tint}` entries: a tint below 100% of a global or spot color
becomes a tint swatch ("Name 40%") linked to it.
A swatch or color group dragged from the Swatches panel, in any view,
and released on the Delete Swatch button is deleted through
swatch.delete, even while nothing is selected and the button is
disabled for clicks. A swatch that is part of the selection carries the
other selected swatches of its kind with it. The drop asks first as a
plain click does, and Alt does not skip the question; Cancel keeps
everything, and OK deletes them in one undo step. None and Registration
are never taken. The button is enabled while swatches are selected or
while a swatch or group of the active document is being dragged, and it
is outlined only while such a swatch or group is held over it. A paint
from another panel, art, and a swatch dragged from another document
delete nothing.
The list's drop zone now ends where the list does. It used the list's
height before the list shrank to its rows, so with few rows it reached
over the buttons below and took a release on them: a paint dropped on
Delete Swatch became a new swatch.
A selected live polygon shows a small diamond beside the middle of the
right side of its bounding box, with the Selection tool and with the
Rectangle, Rounded Rectangle, Ellipse, Polygon and Star tools, while the
bounding box and edges are shown. Dragging it sets the side count from 3
to 11: down adds a side and up removes one for every 12 screen pixels
along the box's own vertical axis, and the pointer shows the count while
measurement labels are on. A polygon of more than 11 sides keeps its
count until the drag goes up, which gives it 11. The drag sends
object.setLiveShape {sides} in one undo step, none when the count ends
where it began, and Escape puts the count back. Typed counts keep their
3 to 1000 range. The widget is drawn only while the box is drawn, so it
hides during a move, a turn and its own drag.
The help page describes the widget and its 3 to 11 range:
https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/modify-live-shapes/add-or-remove-sides-from-polygons.html
The widget's look and place, the drag direction, the step and the rule
for more than 11 sides are VectorCraft's own.
Docs: docs/target-app-parity.md and docs/ui-parity.md.
On a path or compound path, a Transform effect with copies listed after
the object's own Rasterize effect now places the one image Rasterize
makes of the art before it on the original and on each copy: copy k
through the effect's map applied k times, with its pixel grid and its
room around the art, the last copy lowest and the original on top.
Before, the Transform effect copied the art and Rasterize made one image
of all the copies on a grid square to the page.
The image is made once for every placement, also when a shadow or glow
is listed between the Rasterize and Transform effects. The canvas, the
object's bounds, Expand Appearance and PDF export use the same
placements; Expand Appearance and PDF export make a group of images that
share the one image's pixels. Copies stop where the copied art stops,
and a copy scaled to nothing is left out.
The line under the Preferences fields now describes each of the 12 Guides
& Grid settings, from Snap to Grid to Pattern Editing's Tile Edge Color,
when the pointer is over the row or its control has the keyboard focus,
and a screen reader gets the same sentence. Each sentence states what
VectorCraft does with the setting. Rows are added to every complete
catalog.
Tests: the one-sentence-per-setting test now covers Guides & Grid, and
two new tests check the sentence on hover and on keyboard focus.
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.
Two settings of a blend read from the editing data came from rounding
instead of from the file:
- The orientation was whichever of Align to Page and Align to Path laid
the steps out closer to where they are drawn. The check compares the
steps' centers, which turning the steps along the spine leaves in
place, so on a straight spine both fit and the rounding of the drawn
steps decided. The reader now reads the record's word 5 (0 is Align to
Page; a 32-bit float of 8 or more is Align to Path) and keeps that
orientation when it lays the steps out as drawn: in place, at their
drawn sizes and with each one's outline where it is drawn, which
turning a step moves. Otherwise it takes the closest, as before.
- A blend with no spine part opened with a straight spine and an anchor
at each key. When its record names the keys in their order, it now
opens with no spine of its own, which lays out the same straight
lines between the keys' centers. A record that names them in another
order still gets the straight spine in the record's order.
Blend Options, orientation and spines:
https://helpx.adobe.com/illustrator/desktop/manage-colors/apply-transparency-and-blending/blend-options-overview.html
Tests: the record's word 5 (0, 8, 8 plus an angle, and values that name
no orientation); the record's orientation kept where both lay out alike,
and not taken where it would turn the drawn steps (rectangles on a
vertical spine, triangles on a spine running right to left); outlines
that match whatever anchor a path starts at, with another anchor on a
side, with contours in another order and with a lone anchor, and live
art compared by its size; a blend with no spine part in record order
and in the other order.
When the saved preset the Save PDF dialog has chosen is deleted while
the dialog is open, Reset now returns an error naming it, shown in the
status bar, and leaves every field, passwords included, as it is. A
dialog's reset callback returns a Result for this; Flare Tool Options
and Objects on Path Options return Ok. The ui.dialogReset params text
and docs/mcp.md name the error.
The parity line said a soft-edged gray stroke running out of black loses
"3 or 4 pixels" where it meets black. It now says 3 or 4 of the 16 pixel
centers along its middle nearest black, as docs/image-trace-adjustments.md
and the test count them.
In docs/image-trace-adjustments.md, gray near black on blurred edges now
traces gray at fewer of its pixel centers instead of "losing pixels", a
wider band loses some or most of its gray instead of part of it (bands 3
and 4 pixels wide at a blur of 1 pixel keep about 60 of 336), and the
paragraph is wrapped to the file's line width.
A graphic style dropped on the Graphic Styles panel's Delete Graphic Style
button is deleted the way the button deletes: after asking, or at once with
Alt held, in one undo step. The button takes the drop with no style
highlighted and is outlined while a style is held over it. A highlighted
style brings the other highlighted styles with it; art linked to a deleted
style keeps its look and is no longer linked. Other drags are ignored.
Docs: docs/mcp.md (graphicStyle.delete), docs/target-app-parity.md.
The band test now also sums the samples traced gray for bands 3 and 4
pixels wide blurred by 1 pixel (about 60 of 336 over the three grays;
16 without the sharp-edge stop) and for bands 4 pixels wide blurred by
3 pixels (about 39 of 192).
across_edge decides from the first step alone whether one side's edge is
sharp, so each side's path is walked once. On 856 code-drawn band and
stroke cases and 39 images the results are the same as before.
The docs count pixel centers instead of pixels, write "0.6 pixels"
throughout, give the parity line's band claim its bound of 1 in 16, and
state again that a light gray stroke 6 or 8 pixels from black keeps its
gray because its pixels do not reach black in 5 steps.
Text on more than one line is placed a line at a time at every
alignment, and each line splits where an advance that tracking can't
give puts its characters, as a single line does. An underline or
strikethrough also runs on to the end of a line's last advance when
tracking can't reach it.
While a stop is dragged on the Tabs panel's ruler, the canvas draws a
line through the text whose stops the ruler shows, where the stop would
land. For area type it crosses the frame cell the paragraph starts in,
measured from where the first line starts (inside the inset, or past a
text wrap object); for point type it crosses the paragraph's lines from
the type's origin. It turns with rotated type and runs across the
columns of vertical type. In a Ctrl-drag (Command on macOS) it follows
the grabbed stop. No line shows while a release would delete the stop,
and it goes on release, Escape, when no button is down, or when the
panel is not drawn. It is not a document object and records no undo
step.
A stop drag whose release the ruler does not get now ends once no
button is down, as a marker drag already did.
The help page describes this guide:
https://helpx.adobe.com/illustrator/desktop/measure-and-align/grids-and-guides/manage-tab-stops.html
Its extent, color and the rules above are VectorCraft's own.
object.blend.options wrote the first selected blend's spacing, orientation,
type, ramp and shift onto every selected blend, whatever the call gave. Each
blend now takes only the values given and keeps its own for the rest, through
one closure used for the selection and for `id`.
- `id` edits that blend alone. A hidden or locked blend and an object that
is not a blend are errors, and the blend's own spine decides whether
easing is allowed.
- A call that changes no blend records no undo step.
- The Blend panel's Ramp and Shift sliders share one helper: a drag
previews on the canvas and records one undo step on release, instead of
one per frame.
Builds on #8022 by ruchirguitar.
Docs: docs/mcp.md, docs/target-app-parity.md.
Direction Handles cleared the selection and then added each path on its
own, and each add searched the paths already selected, so building the
selection took time that grows with the square of the path count. The
command now selects the paths with one Selection::set call and adds the
anchor sets in one extend. The selection is the same: paths keep their
order, a repeated path keeps its first place and its last anchor set,
and the side fields are cleared as before.
crates/engine/examples/direction_handles_bench.rs times both ways on the
same paths in one process. With 20,000 four-anchor paths, building the
selection takes 1.9 ms of thread CPU time against 69 ms one path at a
time.
Centered or right aligned text on more than one line was placed by the
span of all its advances together, so a second line moved the first.
Layout also leaves the tracking after each line's last character out of
the width it aligns, so one object can't align every line by its
advances. Such text now becomes one point type object per line, each
aligned by its own advances and placed on its line's baseline. Left
aligned text stays one object.
Optimize to File Size… under Preset opens rows for a desired size in K (1024 bytes), Start With
(Current Settings, Auto Select GIF/JPEG) and, with slices, Use (Total of All Slices, Each Slice,
Current Slice). OK takes the settings whose files fit, measured by encoding, and the dialog shows
the size found or says that no setting tried fits.
- webExport.optimizeToFileSize searches JPEG quality or GIF/PNG-8 colors, then GIF lossy 100,
encoding at most 32 trial settings. A lower value can give a larger file, so it measures up to
6 values spread over the range before it narrows the step. It writes no file and changes no
remembered setting.
- A desiredK that is missing, not a number, 0 or less, or above 1048576 is an error, as are an
unknown startWith or use and a bad slice.
- The slices share one setting, so every Use choice changes all of them.
- The result line is dropped when the art or the selection changes.
Docs: docs/mcp.md, docs/target-app-parity.md.
WebP Options has a Compression menu (Lossless, Lossy) and a Quality
slider from 0 to 100 that is enabled for Lossy. document.export,
document.serialize and Export for Screens take lossless: false with
quality (default 90) and write a VP8 file, with an ALPH chunk that keeps
the alpha exactly when some pixels are not opaque. Lossless stays the
default. A WebP quality above 100, or one that is not a whole number,
is refused with an error.
The encoder is the one craft-image-codecs already provides; no
dependency changes. The note that lossy WebP isn't available, its
catalog rows and the format text that described it are removed.
The print raster stopped after two halvings, so a 2,048-pixel print seen
far out sampled a 512-pixel level and fine art aliased. It is now halved
down to one pixel, and each halving weighs an odd last row or column by
the part of the print it covers, so an edge color does not spread across
a small level.
A swatch whose name starts with # could not be the inside color, and one
named like a hex color drew that hex color. The inside is now looked up
as a swatch first and read as #rrggbb only when no swatch with a plain
color has that name.
The Navigator panel menu item View Artboard Only is renamed View Artboard
Contents Only and is now on by default. While it is on, the thumbnail
fits the artboards and draws only the art inside them: art on the
pasteboard and in the gaps between artboards is left out, and a shape
that crosses an artboard's edge is cut there. Before, the option only
narrowed the thumbnail to the artboards' bounding box, so art in the
gaps and past an artboard's edge still showed.
The choice is kept with the UI state for every document, instead of
being lost on restart. UI state saved without it reads it as on, and a
saved off stays off. A user who wants the pasteboard art in the
thumbnail turns the menu item off, or runs
ui.navigatorPanelOptions {viewArtboardContentsOnly: false}.
- ui.navigatorPanelOptions takes viewArtboardContentsOnly (true or
false; any other value is an error and changes nothing) and answers
{color, solidDashes, viewArtboardContentsOnly}.
- The renamed label has a row in every catalog that had the old one.
Docs: docs/mcp.md (Navigator panel options), docs/target-app-parity.md.
While Alt (Option on macOS) is held, the Save PDF dialog's Cancel button
reads Reset. Reset (or ui.dialogReset) puts every option back to the
chosen preset's settings, clears the passwords and their checkboxes, and
leaves the dialog open with its preset, path, artboard range and section.
A saved preset deleted while the dialog is open leaves the options as
they are.
Choosing a preset now also clears the Security section's password
checkboxes, which stayed checked with an empty password before.
The Transform panel measured the selected objects' Align to Pixel Grid state on every frame, looking up each object and its parent and collecting their ids. With Select All in a large document that cost tens of milliseconds a frame. The state (on, off or mixed, and whether every object can be aligned) is now kept in the canvas cache for the document's uid and revision, and the ids are listed only when the box is clicked.
Follows #7608. Text from EMF, WMF and EMF+ pictures was laid out with the
font's own spacing, so the per-character advances the file gives
(ExtTextOut's lpDx, EMF+ DrawDriverString glyph positions) were dropped.
- Characters are spaced by their advances as tracking, with pair kerning
off. When a ligature forms at one tracking and breaks at the next,
standard ligatures are turned off for that text.
- On a single left to right line, an advance that tracking can't give
(wider than its range, or a tab) starts a new point type object where
the advance puts it, also between the letters of a ligature the
tracking breaks apart. An underline or strikethrough is filled across
the space between. Right to left and multi-line text stays one object.
ExtTextOut: https://learn.microsoft.com/en-us/windows/win32/api/wingdi/nf-wingdi-exttextoutw
DrawDriverString: https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-emfplus/b794b780-e9a8-4682-af65-9b614aecfbe6
With Rectangle, Rounded Rectangle, Ellipse, Polygon or Star active, a
double-click on a visible corner widget of a selected live rectangle or
polygon shows and selects the Transform panel (window.panel.activate),
wherever it is: closed, docked behind another tab, floating, in an icon
column or in a dock hidden by Tab. A second double-click keeps it on show.
The tool, the selection, the document and the undo history stay as they
were. Pie widgets, spots off the widgets, Line Segment, plain paths and
hidden or angle-excluded widgets do nothing; the Selection and Direct
Selection tools keep their double-click behavior.
Tools return the new Action::Panel, which the engine forwards as
UiRequest::Panel; the desktop app activates the panel, and a headless
pointer_gesture reply carries {"panel": id} in its requests.
Docs: docs/ui-parity.md (#5477 row, also correcting its statement that the
bounding-box handles scale only with the Selection tool) and
docs/target-app-parity.md.
While Alt (Option on macOS) is held, the dialog's Cancel button reads
Reset. Reset puts the remembered settings back, or the defaults when none
are remembered, on the current document's active artboard. It drops a
pending preset, a pending Done left by a Done that failed, the preset name
being typed and the selected color table entry, and keeps the view, zoom,
connection speed and path. It does not remember or write anything, and the
dialog stays open. `ui.dialogReset` does the same.
The line under the Preferences fields now shows a sentence for each of
the 23 Type settings when the pointer is over the setting's row or its
control has the keyboard focus, and a screen reader gets the same
sentence. Each sentence states what the app does with the setting, such
as which keys step by each increment and which panels show the East
Asian and Indic options. Every complete catalog has a row for each
sentence.
The empty-line test now points at Guides & Grid › Gridline every, a row
that still has no sentence.