While the Type tool edits text on Windows and Linux, Alt+8, Alt+G, Alt+;,
Alt+7, Alt+6, Alt+2, Alt+R, Alt+-, Alt+Shift+-, Alt+[, Alt+Shift+[, Alt+]
and Alt+Shift+] type a bullet, copyright sign, ellipsis, pilcrow, section
sign, trademark sign, registered sign, en dash, em dash and curly quotes at
the caret, or in place of the selected text, as one undo step. Text that
the keyboard layout or an input method types for the chord is typed as it
came, and AltGr (Ctrl+Alt) keeps its own characters. On macOS, Option
types these characters as before. Outside text editing the chords type
nothing.
- The Blend Options dialog sends the spacing, count or orientation only
when it was set in the dialog or differs from the first blend's, so
OK on several blends no longer copies the first blend's spacing and
orientation onto the others.
- object.blend.options: a spacing mode without a count keeps the count
of a blend already in that mode. An orientation other than page or
path, a spacing that is not a string, and `value` without `spacing`
are errors (orientation also in object.blend.make and the options new
blends start with).
- The Blend panel dims Type and Ramp while any selected blend has no
spine, since the command refuses easing for such a selection.
- Tests check the live preview while a Ramp or Shift drag is under way.
Supersedes #8022 by ruchirguitar.
Each spot ink in the Output section's Document Ink Options list now has
an icon before its name. Clicking it prints that ink as process: its art
separates onto the process plates and it gets no plate of its own, while
the other spot inks keep theirs. Clicking again keeps it as a spot ink.
While Convert All Spot Colors to Process is on, every spot ink converts
and the icons are dimmed; each ink keeps its own choice for when the
option is turned off. A converted ink's Print box, frequency and angle
are dimmed.
file.print and print.preview take convertToProcess on an output.inks
entry, and print.preview lists every document ink, converted ones
included, in documentInks.
The writer measured which way each patch turns only at its first corner,
along the straight lines to the next corners. A patch whose point is
dragged across it, or whose handles cross at a corner, passed as a
plain patch and was written as a mesh. Each corner of each patch is now
measured along the straight lines and along its handles, and a mesh
whose corners turn different ways is written as its drawn look with the
warning.
- Tests: a patch folded at a corner by a moved point and by crossed
handles; a reflected mesh read back draws the same points and opacity
across each patch; an envelope in a symbol's art with its grid and
contents in the symbol's own space opens as the art it draws, and one
in a file without a template box is left unread.
- The fuzz case for written meshes moves next to the other editing-data
cases in import_fuzz.rs.
- Docs: file-format-parity.md says a reflected mesh opens with each
row's points in reverse order, and how envelopes in symbols open;
target-app-parity.md links the help page on mesh point opacity.
Type > Insert Break Character > Forced Line Break (type.insert
{char: "forcedLineBreak"}) inserted a line feed, which starts a new
paragraph. It now inserts U+2028, the character Shift+Enter types, so the
new line stays in the same paragraph; paragraphReturn still inserts a line
feed.
While the Type tool edits text and no ids are given, type.insert (every
Insert Special, Whitespace and Break Character item) now replaces the
tool's selection or inserts at its caret, as one undo step, and moves the
caret after it. After Select All in threaded text it replaces the whole
story. With ids or id it appends to the objects they name, and without a
Type tool edit it appends to the selected type objects.
A Shift-click with the place cursor now opens the current file's import
options (Text, DXF, Place PDF or Place PSD) before it is placed, whether
the cursor was loaded with Show Import Options on or off or by
file.place.queue. OK places the file at the click and the cursor moves to
the next file. The options the cursor was loaded with for the file's
format are put aside so the dialog opens, and are used when no dialog
opens for the file (a PNG image, a one-page PDF, a linked PSD file). A
Shift-drag places at the dragged size, as a drag does. Headless, where no
dialog can open, a Shift-click places as a click does.
The place tool marks a Shift-click's file.place with
showImportOptions: true.
Docs: docs/mcp.md, docs/target-app-parity.md.
select.magicWand searched lists in three places: paintable looked up
each object's parent in the list of compound paths, add mode looked up
each hit in the selection, and subtract mode looked up each selected
object in the hits. These lookups now use HashSets. The output is still
built by walking the lists, so the wand selects the same objects in the
same order as before.
A test compares paintable, added, subtracted and select.magicWand in
set, add and subtract mode with copies of the earlier searches on a
20,000-path document. An ignored release-build probe times both.
While the palette is open, the highlighted result is marked where it
lives, in the same frame the arrow keys or the pointer move the
highlight. A result with an item of the in-window menu bar has that
menu's title outlined, and a box under it shows the item's whole path
(Effect › Stylize › Round Corners…). A panel points at the Window menu.
A tool has its slot's button outlined on the toolbar its row names, or
its own button on a strip torn off its group. The box beside it, on
the canvas side of the toolbar, names the tool, or reads "In the Direct
Selection Tool group: press and hold to open it" for a tool hidden in a
group; screen readers hear that sentence with the search field's
description. The box stays inside the window and off the button and
the palette's popup: beside a button, its text wraps to up to three
rows to fit before the popup or the window's edge, and where it still
would not fit, the footer shows the text and only the outline is
drawn. When the popup covers the control,
nothing is drawn and the footer names the home. Highlighting a result
opens no menu, flyout or All Tools drawer, shows no toolbar and leaves
the chosen tool as it is.
With the system's menu bar, nothing is drawn over it, and the footer
reads "In the menu bar:" and the path. When no control in view shows
the home (Presentation Mode, toolbars hidden by Window › Tools or Tab,
a button scrolled out of view or under a floating panel or another
toolbar), the footer names the home followed by "not shown now". A
command with no menu item reads "No menu item" there, with its
shortcut.
The menu bar, the Tools panel, the toolbars made with New Toolbar and
the strips torn off them note where they draw each control only while
the palette is open, and only controls wholly in view. The list keeps
one pass of each window. The palette uses
only the controls noted in the current pass of its own window, and
shows no footer line for the home in the pass that opens it, before
anything is noted.
learn.locateTool's search for a tool's place moves into a function
without side effects (locate::find), which the palette calls with the
order its rows use. Learn calls it and then shows the toolbar, flyout
or drawer as before, and the mark's outline is shared.
New strings have rows in every catalog.
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.
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.