mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-19 06:38:44 +00:00
Merge main into fix/i18n-drop-old-control-characters-rows
This commit is contained in:
@@ -265,7 +265,9 @@ My Themes tab lists the saved themes; every action runs a command (`colorTheme.s
|
||||
Color Wheel panel (`window.panel {panel: "colorWheel"}`): a hue ring around a saturation and brightness square. A
|
||||
pick runs the commands the Color panel's sliders run: `paint.setFill` or `paint.setStroke` with `keepModel`,
|
||||
`paint.editGradient` for a gradient's selected stop, and `paint.freeform.setPoint` for a freeform gradient's selected
|
||||
point (the first stop or point when none is selected).
|
||||
point (the first stop or point when none is selected). `ui.colorWheel {view?, channel?}` shows the wheel or the box (a
|
||||
color field with a channel strip at its right) and picks the box's channel; it returns the settings, and `ui.inspect`
|
||||
reports them as `ui.color_wheel`.
|
||||
|
||||
Edit Colors dialogs: `ui.colorBalanceDialog` opens Adjust Colors (`colorBalance`: fields `mode` `gray`/`rgb`/`cmyk`/
|
||||
`global`, the channels `r` `g` `b` / `c` `m` `y` `k` / `gray` / `tint` (global mode) from −100 to 100, `convert`, `fill`, `stroke`,
|
||||
@@ -302,7 +304,11 @@ right-click menu has Remove Color too. The base color can't be removed. A remove
|
||||
has current colors and art or a group is open: it then keeps them with `to: null`, that art keeps its colors, and the
|
||||
group's swatch at that place is removed. A row with no current colors recolors no art; with a group, the new color of
|
||||
one with `added: true` that is not excluded is added to the group after the group's other colors, and a row made with New Row adds none.
|
||||
Setting `colors`, a preserve flag or `limitTo` reduces the rows again (also on `ui.dialog.confirm`). The dialog previews
|
||||
`groupStorage` shows the Color Groups list (true when the dialog opens); setting `group` to a color group's name makes
|
||||
it the group being edited, as opening on it does, and refuses a name no group has; `groupAction` (`save`, `new` or
|
||||
`delete`) runs the list's Save Changes, New Color Group or Delete button on the next frame, or first on confirm (see
|
||||
`docs/mcp.md`). Setting `colors`, a preserve flag or `limitTo` reduces the rows again (also on `ui.dialog.confirm`).
|
||||
The dialog previews
|
||||
`recolor.apply` on the canvas; confirm keeps it as one undo step (with a group, the group is rewritten in the same
|
||||
step; with no art selected only the group changes). In the Swatches panel, double-clicking a colour group's folder,
|
||||
or the options button while a group is selected, opens it.
|
||||
@@ -496,7 +502,10 @@ the desktop each floating window is an OS window of its own; on the web and on W
|
||||
window. `ui.toolbar_pos` in `ui.inspect` is the Tools panel's corner (null: docked); `window.panel.float` and
|
||||
`window.panel.dock` with `panel: "tools"` float it at `x`, `y` or dock it on the window's left edge. With
|
||||
`window.toolsBesideCanvas {on?}` (Window › Toolbars › Keep Tools Beside the Canvas, off by default; `ui.tools_beside_canvas`)
|
||||
the docked Tools panel sits between left-side panels and the canvas, and `window.panel.dock` docks it there.
|
||||
the docked Tools panel sits between left-side panels and the canvas, and `window.panel.dock` docks it there. Dropping
|
||||
a floating Tools panel on the canvas's left edge, right of panels docked on the left, turns the setting on, and on the
|
||||
window's left edge turns it off; with no panels docked on the left, a drop leaves the setting as it is
|
||||
(`docs/mcp.md` › Tools panel placement).
|
||||
|
||||
Flatten Transparency: `ui.flattenTransparencyDialog` opens the `flattenTransparency` dialog for the selection
|
||||
(fields `preset`: a preset name, setting it loads that preset's options; the option keys of
|
||||
@@ -735,7 +744,8 @@ type with those options (`file.place {text: {…}}`).
|
||||
|
||||
System clipboard formats: through the desktop app, `edit.copy`, `edit.cut`, `artboard.copy` and `artboard.cut` publish what `clipboard.flavours`
|
||||
lists to the system clipboard (once they are written, the status bar shows the first of the PNG's and PDF's
|
||||
`warnings`, such as an image that couldn't be decoded), and every Paste command first loads what another app copied (`clipboard.importSvg`,
|
||||
`warnings`, such as an image that couldn't be decoded, and how many there are, and hovering the message lists them, unless
|
||||
another message has replaced the Copy or Cut's meanwhile), and every Paste command first loads what another app copied (`clipboard.importSvg`,
|
||||
`importPdf`, `importEps`, `importText` or `importImage`, centred in the view; the desktop app reads PDF and EPS from
|
||||
the Windows clipboard and, with SVG, from the macOS pasteboard, and an `.eps` file, or a `.ai` or `.ait` file that holds a PDF or PostScript, copied in a file manager anywhere; a copied `.ai` or `.ait` file that holds a PDF loads with `importPdf {editingData: true}`, which reads its editing data); an import error answers the Paste with that error
|
||||
and pastes nothing. Cmd+V also pastes a bitmap or PDF with no text beside it (on the key's release, as egui sends no
|
||||
@@ -818,13 +828,21 @@ selected slices. Hidden or locked slices (`view.slices.hide`, `view.slices.lock`
|
||||
EPS Options: Export As… with the EPS format (`file.exportAs {format: "eps"}`, then the save dialog), or
|
||||
`ui.epsOptionsDialog {path?, …document.exportEps options}` for agents, opens the `epsOptions` dialog. Its fields are
|
||||
`document.export` params: `previewFormat` (`none`, `tiffBw`, `tiffColor`), `transparentPreview`, `overprints`
|
||||
(`preserve`, `discard`), `flattenerPreset` (a built-in or saved preset's name), `includeLinkedFiles`, `thumbnails`,
|
||||
(`preserve`, `discard`), `flattenerPreset` (a built-in or saved preset's name), `flattener` (custom flattener options
|
||||
over the preset, as `object.flattenTransparency` takes them), `includeLinkedFiles`, `thumbnails`,
|
||||
`cmykPostScript`, `compatibleGradients`, `level` (`2`, `3`), plus `path` and the artboard choice (`useArtboards`,
|
||||
`range`). `ui.dialog.confirm` checks them (a bad value or an unknown preset keeps the dialog open), remembers them for
|
||||
the next EPS Options and writes the file(s), asking for a path when there is none. With Use Artboards and two or more
|
||||
artboards, it writes a central file of the whole document under the chosen name and one `{stem}_{artboard}.eps` per
|
||||
artboard. When no art shows, it writes only the artboard files.
|
||||
|
||||
The Custom… button beside the preset opens the `epsFlattenerOptions` dialog over EPS Options, on the options the
|
||||
export would use. Its fields are the flattener options; `preserveAlpha` is always off, and overprints are kept only
|
||||
with `overprints: "preserve"`. Its `ui.dialog.confirm` sets every option as `flattener` (the preset then shows
|
||||
[Custom]) and goes back to EPS Options; `ui.dialog.cancel` goes back with the options unchanged. Choosing a preset,
|
||||
in the dropdown or with `ui.dialog.set {flattenerPreset}`, drops `flattener`, and so does `ui.epsOptionsDialog` with
|
||||
a `flattenerPreset` and no `flattener`.
|
||||
|
||||
Data Recovery: at launch, copies left behind by a crash open the `recovery` dialog (never copies another running
|
||||
instance keeps, so instances started side by side for screenshots don't get it). Fields: `copies` (`[{file, title,
|
||||
saved}]`, from `file.recovery.list`) and `discard`. `ui.dialog.confirm` restores them all (`file.recovery.restore`
|
||||
|
||||
@@ -84,6 +84,7 @@ The canvas is rasterized on the CPU (`vectorcraft-render`, vello_cpu); the GPU (
|
||||
- On Linux with Mesa, `MESA_VK_DEVICE_SELECT=10de:2f04!` (vendor:device as `vulkaninfo --summary` or `lspci -nn` show it) leaves only that GPU to Vulkan, and `DRI_PRIME=1` picks the other GPU.
|
||||
- Help › About and the control channel's `ui.inspect` (`graphicsAdapter`) show the adapter in use, and the app logs it at startup.
|
||||
- **How frames reach the display.** By default the window presents with `autovsync` and lets the display queue one frame. With `autovsync`, wgpu uses relaxed vsync (FifoRelaxed, which tears a frame that arrives late) where the driver offers it, else vsync (Fifo). For a launch, `--present-mode` (or `VECTORCRAFT_PRESENT_MODE`) sets the present mode to `fifo` (vsync), `autovsync` or `novsync` (wgpu uses Immediate, else Mailbox, else Fifo, whichever the driver offers), and `--frame-latency` (or `VECTORCRAFT_FRAME_LATENCY`) sets the frames the display may queue, `1` to `3`. A flag overrides its variable, and a value that is not one of these stops the app with a message. On Windows and Linux, a launch with either one set opens its files in a new window, as with `--new-instance`, instead of handing them to a running VectorCraft. At startup the log records what the app asks the window surface for, for example `requested window surface: autovsync, frame latency 2 (override)`. The driver chooses the mode that `autovsync` and `novsync` resolve to and may clamp the latency, and on macOS egui uses at least 2 frames while the window is being resized. The code is `apps/vectorcraft/src/presentation.rs`.
|
||||
- **Preferences › Performance › Low-Latency Drawing** (`lowLatencyDrawing`, off by default) presents with `novsync` and is read when the app starts, so a change applies after a restart. The present mode comes from `--present-mode` first, then `VECTORCRAFT_PRESENT_MODE`, then this preference, then the default (`autovsync`); `--frame-latency` and `VECTORCRAFT_FRAME_LATENCY` still set the latency with it on. The log names where the mode came from: `requested window surface: novsync (preference), frame latency 1`. Whenever the window presents without vsync (`novsync`, from the preference or an override), frames start at most 240 times a second (about 4.17 ms apart); with vsync the display paces them and no cap applies.
|
||||
|
||||
## Logs
|
||||
|
||||
|
||||
@@ -183,7 +183,7 @@ VectorCraft choices; an original approximation, never compared with another appl
|
||||
| Materials panel, lighting, ray-traced render | Window › 3D and Materials panel with the object types (Plane, Extrude, Revolve, Inflate) and the Object, Rotation and Lighting settings of the applied effect, Render Settings › Wireframe, which draws the live effect as the edges of its faces, and Quick Actions › Expand as Wireframes ([three-d.md](three-d.md#3d-and-materials-panel)); one to ten directional lights with per-light Color (opaque RGB, white by default), Intensity, Rotation, Height, Softness and neutral Ambient Light, Revolve and colored Inflate use smooth vector shading; Extrude & Bevel and Rotate retain planar shading; original Standard, Diffuse, Top Left and Right lighting rigs; shadows behind or below the object from the first light, blurred by its Softness ([three-d.md](three-d.md#shadows)); the Materials tab's Graphics, document symbols mapped onto Extrude & Bevel's caps and onto a plane, moved with an artboard handle, and wrapped around Revolve's side ([three-d.md](three-d.md#graphics)); no base materials, graphics on Inflate or on Extrude & Bevel's walls and bevels, or ray tracing |
|
||||
| 3D (Classic): Extrude & Bevel, Revolve, Rotate | Extrude & Bevel (Classic) initial: live, round seam joins, Extrude Depth, Cap, five original bevel shapes with Height and Bevel Extent In or Out, Position presets and rotation gizmo, Perspective, Wireframe, No Shading, Diffuse and Plastic surfaces with one to ten lights, Light Intensity, Ambient Light, Highlight Intensity and Size, Blend Steps, Black, Custom, Black Overprint or no Shading Color ([Black Overprint](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=188)), Draw Hidden Faces ([create 3D objects](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/create-3d-objects.html)); Revolve (Classic) initial: live, round seam joins, Angle, Cap, Offset from the left or right edge, Position presets and rotation gizmo, Perspective, the same four surfaces, lights, highlight, Blend Steps and Shading Color, groups and layers revolved about one shared axis (same page); Rotate (Classic) initial: live, round seam joins, every fill and stroke turned as one plane, Position presets and rotation gizmo, Perspective, No Shading and Diffuse surfaces with lights, Ambient Light, Blend Steps and Shading Color ([rotate objects in 3D](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/rotate-objects-in-3d.html)); Preserve Spot Colors in all three, unavailable with a Custom Shading Color ([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); all three: a lighting sphere on the Lighting tab whose lights drag, move to the back or front, and are added at the front center or deleted down to one ([lighting options](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=272)); all three: the track cube (face, edge, Shift and ring drags, keyboard steps; [three-d.md](three-d.md#track-cube)); Map Art: none |
|
||||
| Turntable (30.0 beta) | none |
|
||||
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object, and the 3D and Materials panel's Export 3D Object button (which then shows Asset Export with the new assets selected, [three-d.md](three-d.md#3d-and-materials-panel)), collect an object with Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, and Export writes its solids as a USDA (the default), USDZ, glTF or OBJ mesh with a material in each solid's paint color (`assets.add3D`, `assets.set3DFormat`, `assets.export3D`); no textures, map art or shading ([3D export help](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)) |
|
||||
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object, and the 3D and Materials panel's Export 3D Object button (which then shows Asset Export with the new assets selected, [three-d.md](three-d.md#3d-and-materials-panel)), collect an object with Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, and Export writes its solids as a USDA (the default), USDZ, glTF or OBJ mesh with a material in each solid's paint color (`assets.add3D`, `assets.set3DFormat`, `assets.export3D`); graphics mapped onto a plane or Extrude & Bevel's caps are exported as PNG textures of those faces, flat and unlit; no graphics on Revolve's side, no materials and no shading ([3D export help](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)) |
|
||||
|
||||
The `three-d` crate (depends on `geom` and `pathops`, with no UI or GPU dependencies) builds, rotates, projects, shades and depth-sorts the surfaces;
|
||||
the effects crate turns them into art. What's left (materials and shadows, ray-traced rendering,
|
||||
|
||||
File diff suppressed because one or more lines are too long
+7
-5
@@ -490,8 +490,8 @@ macOS cursor delivery (#2292) is narrowed to a native host adapter using the exi
|
||||
Until a choice is made (`default`), the panels follow General › Transform Pattern Tiles as before, and the menu
|
||||
checks Transform Both while it is on and Transform Object Only while it is off; a choice overrides it.
|
||||
Estimate unchanged.
|
||||
- **Done (2026-10-21, #394):** General › Constrain Angle turns the arrow keys' axes (guides stay on the page's), holds Shift drags of the Selection, Direct Selection, Free Transform, Slice Selection, Reshape and Measure tools and the Pen's handles to the turned axes, and new rectangles, rounded rectangles, ellipses, grids, point and area type, Shift-drawn polygons and stars and the shape size dialogs are drawn along it with their bounding box turned; 0° and whole turns are exactly as before, quarter turns exact (<https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>). Spirals, flares and the Pen's new paths are not turned yet. Estimate unchanged.
|
||||
- **Done (2026-10-21, #394):** General › Constrain Angle turns the arrow keys' axes (guides stay on the page's), holds Shift drags of the Selection, Direct Selection, Free Transform, Slice Selection, Reshape and Measure tools and the Pen's handles to the turned axes, and new rectangles, rounded rectangles, ellipses, grids, point and area type, Shift-drawn polygons and stars and the shape size dialogs are drawn along it with their bounding box turned; 0° and whole turns are exactly as before, quarter turns exact (<https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>). Spirals, flares and the Pen's new paths are not turned yet. Estimate unchanged. **2026-10-24:** General › Corner Radius is the Rounded Rectangle tool's radius: the tool takes the preference when chosen and when it changes while the tool is active (or lent a selection tool for a drag), and the radius ↑/↓ set while drawing one, or a Tool Options value, becomes the preference, clamped to its 0–1296 pt range (<https://helpx.adobe.com/illustrator/using/drawing-simple-lines-shapes.html>). Estimate unchanged.
|
||||
- **Done (2026-10-21, #394):** General › Constrain Angle turns the arrow keys' axes (guides stay on the page's), holds Shift drags of the Selection, Direct Selection, Free Transform, Slice Selection, Reshape and Measure tools and the Pen's handles to the turned axes, and new rectangles, rounded rectangles, ellipses, grids, point and area type, Shift-drawn polygons and stars and the shape size dialogs are drawn along it with their bounding box turned; 0° and whole turns are exactly as before, quarter turns exact (<https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>). Flares and the Pen's new paths are not turned yet. Estimate unchanged.
|
||||
- **Done (2026-10-21, #394):** General › Constrain Angle turns the arrow keys' axes (guides stay on the page's), holds Shift drags of the Selection, Direct Selection, Free Transform, Slice Selection, Reshape and Measure tools and the Pen's handles to the turned axes, and new rectangles, rounded rectangles, ellipses, grids, point and area type, Shift-drawn polygons and stars and the shape size dialogs are drawn along it with their bounding box turned; 0° and whole turns are exactly as before, quarter turns exact (<https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>). Flares and the Pen's new paths are not turned yet. Estimate unchanged. **2026-10-24:** General › Corner Radius is the Rounded Rectangle tool's radius: the tool takes the preference when chosen and when it changes while the tool is active (or lent a selection tool for a drag), and the radius ↑/↓ set while drawing one, or a Tool Options value, becomes the preference, clamped to its 0–1296 pt range (<https://helpx.adobe.com/illustrator/using/drawing-simple-lines-shapes.html>). Estimate unchanged.
|
||||
- **Done (2026-10-17):** Background Export shows its progress in a dialog with Cancel and Continue in Background (#2564), on the shared cancel token (#2546); a cancelled export writes no file. Save As, Export for Screens and Export Selection don't show it yet. Estimate unchanged. **2026-11-06:** opening a file that takes longer than 0.4 s shows a progress window too, with a moving bar, Cancel and Continue in Background (part of #5930); Save and Place still show only the status bar's spinner. Estimate unchanged.
|
||||
- **Done:** quick Image Trace presets trace at once and leave the panel as it was; the Image Trace button (Control bar, Properties) opens the controls with Threshold and Advanced (Paths, Corners, Noise), as the public documentation describes (<https://helpx.adobe.com/illustrator/using/image-trace-results-optimization.html>). Other context-specific Properties gaps remain.
|
||||
- **Done (2026-10-31, #394):** Units › East Asian Type is read, and Q and Ha are units. 1 Q and 1 Ha are each a
|
||||
@@ -517,8 +517,9 @@ macOS cursor delivery (#2292) is narrowed to a native host adapter using the exi
|
||||
afterwards opens in a floating window of its own (G7's Float in Window); documents already open stay where they
|
||||
are. Estimate unchanged.
|
||||
- **Done:** Hyphenation › Default Language is the language of new type, unless Document Setup chose one, and each
|
||||
run hyphenates in its own language (Character panel). English and eleven Indian languages have break
|
||||
points; other languages stay whole apart from the Exceptions list (#394, #4947).
|
||||
run hyphenates in its own language (Character panel). English, eleven Indian languages, Bulgarian, Turkish
|
||||
and Russian have break points, and German, Polish, Portuguese and Italian have them in builds that embed
|
||||
their patterns; other languages stay whole apart from the Exceptions list (#394, #4947).
|
||||
- **Done (2026-11-14):** Layers panel row context menu: right-clicking a layer, group, or object row shows a context menu (Options…, Duplicate, Delete, Lock Others / Unlock All, Hide Others / Show All, Locate Object, Collect for Export) with proper selection behavior and Undo/Redo tracking. Tests in `crates/ui-egui/src/panels/layers/tests.rs`.
|
||||
- **Missing:** 2 Preferences options stored but not acted on (#394), each waiting on a subsystem of its own:
|
||||
Plug-ins & Scratch Disks › Primary and Secondary (documents are kept in memory; nothing pages to
|
||||
@@ -703,7 +704,8 @@ macOS cursor delivery (#2292) is narrowed to a native host adapter using the exi
|
||||
Extrude & Bevel, Inflate and Rotate with Position presets ([three-d.md](three-d.md), #1407). Colored Inflate has automatic smooth vector lighting from shared membrane normals. White-light Inflate keeps its polygon shading. Every 3D facet's seam has round joins ([three-d.md](three-d.md#seams)). All four take one to ten colored directional lights, with neutral ambient applied once, a light list and independent previewing controls. Standard, Diffuse, Top Left and Right select original rigs, shared with commands; manual settings show Custom.
|
||||
- **Missing:** materials (base, Substance, graphics), shadows,
|
||||
ray-traced rendering, angular cut caps, exact visibility for intersecting and concave surfaces, the rest of 3D
|
||||
Classic (Map Art), Turntable, textures, map art and shading in 3D export.
|
||||
Classic (Map Art), Turntable, and in 3D export the graphics on Revolve's side, materials and shading (graphics on
|
||||
planes and Extrude & Bevel's caps are exported as textures).
|
||||
- **Impact:** specialist; Materials is the one menu stub left.
|
||||
- **Estimate:** 25–45 h; plan in `plan/` before coding.
|
||||
|
||||
|
||||
@@ -23,7 +23,10 @@ versions. Among those presets, Corners is 100 in Technical Drawing, 75 in Defaul
|
||||
Logo, Line Art and Outline, and 50 in the other eight. Noise is 1 px in Technical Drawing, 5 in High Fidelity Photo and Black and White Logo, 8 in 6 Colors
|
||||
and 16 Colors, 10 in Low Fidelity Photo, 15 in 3 Colors and Shades of Gray, 20 in Sketched Art, Line
|
||||
Art and Outline, 25 in Default, and 90 in Silhouettes (see
|
||||
[image-trace-quality.md](image-trace-quality.md#preset-paths-corners-and-noise)).
|
||||
[image-trace-quality.md](image-trace-quality.md#preset-paths-corners-and-noise)). High Fidelity Photo
|
||||
traces with Palette › Full Tone at Color detail 85 and Method › Abutting (VectorCraft's own values; see
|
||||
[image-trace-quality.md](image-trace-quality.md#high-fidelity-photo-in-full-tone)); Low Fidelity Photo
|
||||
traces with a Limited palette of 20 colors, Overlapping.
|
||||
|
||||
Sliders apply on release, and their numeric fields can be edited directly. Each committed
|
||||
adjustment re-traces the selected object as one undo step and changes the preset to Custom.
|
||||
@@ -83,9 +86,9 @@ leaves out every white area whatever `ignoreBackground` is.
|
||||
color nearest to it in lightness and hue, with a difference in hue or chroma counted three times
|
||||
as much as one in lightness, so a gray or a muted brown takes a black, white or other neutral
|
||||
library color rather than a saturated color of the same lightness.
|
||||
**Abutting and Overlapping.** Abutting is the default Method, and the Default, Auto Color, 3 Colors,
|
||||
6 Colors and 16 Colors presets use it. With Abutting, two neighboring colors share one exact edge. The
|
||||
canvas smooths the edges of each path on its own, so each of the two paths covers only part of the
|
||||
**Abutting and Overlapping.** Abutting is the default Method, and the Default, Auto Color, High Fidelity
|
||||
Photo, 3 Colors, 6 Colors and 16 Colors presets use it. With Abutting, two neighboring colors share one
|
||||
exact edge. The canvas smooths the edges of each path on its own, so each of the two paths covers only part of the
|
||||
pixels along that edge, and a thin line of the background can show between the colors. Web browsers
|
||||
and PDF viewers usually draw an exported SVG or PDF file the same way and show the same line. Raster
|
||||
exports (PNG, JPEG, TIFF and the other bitmap formats) with None anti-aliasing do not show it at any
|
||||
|
||||
@@ -83,8 +83,9 @@ gradient, texture, sensor noise):
|
||||
Photo trace was 86,000 anchors under the old limit; a noisier scan of the same size would have been
|
||||
refused. At 8,000,000 anchors a trace keeps about 0.7 GB, with a peak of about 0.9 GB while tracing.
|
||||
The preset rows were measured with the earlier preset values: High Fidelity Photo at Paths 90, Corners 25
|
||||
and Noise 4, Low Fidelity Photo at Paths 60, Noise 12 and 16 Colors at Paths 70, Corners 55 and Noise 10
|
||||
(see [Preset Paths, Corners and Noise](#preset-paths-corners-and-noise)).
|
||||
and Noise 4 with a Limited palette of 64 colors and Overlapping, Low Fidelity Photo at Paths 60, Noise 12
|
||||
and 16 Colors at Paths 70, Corners 55 and Noise 10 (see [Preset Paths, Corners and
|
||||
Noise](#preset-paths-corners-and-noise) and [High Fidelity Photo in Full Tone](#high-fidelity-photo-in-full-tone)).
|
||||
## Collapsed loops keep few segments
|
||||
A small closed loop (or a piece that returns to its own junction) whose fit collapsed to a single
|
||||
cubic cannot stay as one, so it kept every positioned point as a straight segment. A looser Paths
|
||||
@@ -250,7 +251,8 @@ Every built-in preset other than Auto Color and Flat Logo traces at Paths 50. Co
|
||||
The palettes, color counts, thresholds and other options of the presets did not change. The enhanced
|
||||
versions of these presets use the same Paths, Corners and Noise. 6 Colors and 16 Colors were at Noise 15
|
||||
and Black and White Logo at 25 until [Noise joins the nearest color](#noise-joins-the-nearest-color);
|
||||
the measurements below were made at those values.
|
||||
the measurements below were made at those values. High Fidelity Photo's palette and Method changed
|
||||
later (see [High Fidelity Photo in Full Tone](#high-fidelity-photo-in-full-tone)).
|
||||
|
||||
Measured with the harness below (section 1, each preset on the inputs it is meant for), before and after:
|
||||
anchors fall in 10 of the 12 changed presets, for example 5,494 to 3,136 (High Fidelity Photo), 33 to 27
|
||||
@@ -271,6 +273,47 @@ the other sections of this file, and in the Image Trace entries of
|
||||
[target-app-parity.md](target-app-parity.md), were measured at the earlier values.
|
||||
Test: `presets_have_their_paths_corners_and_noise` in `crates/trace/src/tests.rs`.
|
||||
|
||||
## High Fidelity Photo in Full Tone
|
||||
High Fidelity Photo traces with Palette › Full Tone at Color detail 85 and Method › Abutting. It traced
|
||||
with a Limited palette of 64 colors, Overlapping, before. Paths, Corners and Noise stay 50, 50 and 5.
|
||||
These are VectorCraft's own values. Low Fidelity Photo keeps its Limited palette of 20 colors.
|
||||
|
||||
Palette › Full Tone splits its colors until none spans more than its width limit. Then, while it has
|
||||
fewer colors than Color detail's value (85 at 85), it splits the narrower ones too, where the image has
|
||||
that many colors. The colors that look alike merge after that, and a merged color can merge again, so a
|
||||
trace can end with far fewer colors than that count: a gray-to-green ramp 256 px wide with up to 8 levels
|
||||
of grain a channel ends with 6 colors at Color detail 85, where the RGB test leaves 4. Full Tone's colors
|
||||
merge when they are thoroughly mixed and less than 5 apart in Oklab × 100, or mixed in patches
|
||||
(compression blocks) and less than 1.5 apart. The other palettes, Automatic included, keep the RGB test
|
||||
(under 30 levels and thoroughly mixed, or under 12 and mixed in patches), and Automatic's continuous-tone
|
||||
colors do not take the least count. These rules apply to every trace with Palette › Full Tone, so an
|
||||
existing Full Tone trace or saved preset traces differently when it is traced again.
|
||||
|
||||
On 19 photos, cartoons and synthetic shapes of 400 to 4,000 px, the mean pixel difference summed over the
|
||||
inputs fell from 80.5 to 65.6 levels. It fell by more than 1% on 14 inputs (2.88 to 2.19 and 2.59 to 2.48
|
||||
on two photos, the second a JPEG at quality 40; 1.88 to 1.45 on a 4000 × 3000 photo; 12.40 to 7.44 on an
|
||||
upscaled cartoon) and changed by less than 1% on the other 5. Anchors rose 1.66 times (1.98 million to
|
||||
3.29 million) and the SVG size 1.31 times. The trace time rose 1.7 times (18.9 to 31.5 s for all 19, with
|
||||
both builds tracing 3 images at a time in the same run). Flat synthetic art costs the most: 12 to 400
|
||||
anchors on a 4000 × 3000 image of two flat colors, and about 3 times the anchors on two images of
|
||||
synthetic shapes (400 × 300 and 1600 × 1200), with the same pixel difference. A flat gray 192 × 128 with
|
||||
up to 3 levels of grain a channel traces as 25 colors and 244 anchors, where the Limited palette of 64
|
||||
traced 1 color and 4 anchors; with up to 5 or 8 levels both trace it as 25 to 37 colors, on each of the
|
||||
grays tested (28, 60, 128 and 200).
|
||||
|
||||
In the same run, peak memory fell on 16 of the 19 inputs, for example 906 to 625 MiB on a 1536 × 2048
|
||||
cartoon, and rose on 3 small ones (by 5 to 11 MiB). Abutting accounts for the fall: the earlier preset
|
||||
with Method › Abutting peaked at 523 MiB on the same cartoon, against 924 MiB with Overlapping, in another
|
||||
run. Low Fidelity Photo, 16 Colors, 6 Colors, Black and White Logo and Auto Color give byte-identical
|
||||
SVGs. On three flat colors stored in 8 × 8 blocks, each block off by up to 8 levels a channel, High
|
||||
Fidelity Photo traces 3 colors as 3 paths; without the patch rule it traced 7 colors as 74 paths.
|
||||
|
||||
Tests: `high_fidelity_photo_traces_in_full_tone`, `full_tone_keeps_more_of_a_noisy_ramps_tones`,
|
||||
`full_tone_traces_a_noisy_dark_ground_like_a_light_one` and
|
||||
`full_tone_merges_a_flat_colors_compression_blocks` in `crates/trace/src/tests.rs`,
|
||||
`full_tone_merges_only_mixed_colors_that_look_alike` in `crates/trace/src/quantize.rs`, and
|
||||
`full_tone_makes_one_color_per_step_of_color_detail` in `crates/trace/src/quantize/palette.rs`.
|
||||
|
||||
## A simpler contour walk
|
||||
`contour::trace_mask` follows each region's outline along the pixel cracks with the inside on the
|
||||
right. It used to build a table of outgoing directions for every pixel corner in a raster pass and
|
||||
|
||||
@@ -66,7 +66,7 @@ plus review. Native-speaker review is human work and isn't in the hours.
|
||||
| Swedish | `sv` | 8,991 rows, 3,106 of them `@msg` and 48 `@msgplural` (counted 2026-11-14): the untranslated report lists 518 missing messages for it, and 12 menu strings, 1 `tl!` literal and 3 undo labels; one/other plurals | full; native review welcome |
|
||||
| Bulgarian | `bg` | 5,245 rows, 763 of them `@msg` (counted 2026-10-21): menus and `tl!` literals complete when counted; its messages are partial | full; AI-drafted, native review pending |
|
||||
| Greek | `el` | 5,251 rows, 795 of them `@msg` (counted 2026-10-21): menus, `tl!` literals and messages complete when counted | full; native review welcome |
|
||||
| Georgian | `ka` | 5,200 rows (counted 2026-10-21): menus, panels, dialogs, plurals (one count-neutral form) and messages, tested complete; reviewed by a native speaker | full |
|
||||
| Georgian | `ka` | 9,758 rows, 3,740 of them `@msg` and 49 `@msgplural` (counted 2026-11-15): menus, panels, dialogs and plurals (one count-neutral form); the untranslated report lists 1 missing Georgian message; reviewed by a native speaker | full |
|
||||
| Turkish | `tr` | 9,175 rows, 3,446 of them `@msg` and 48 `@msgplural` (counted 2026-11-13); 41 messages, 62 menu strings, 26 `tl!` literals, 13 undo labels and the default swatch names still fall back to English | full |
|
||||
| Catalan | `ca` | 5,626 rows, 881 of them `@msg` (counted 2026-10-28): menus, `tl!` literals and messages complete when counted; one/other plurals; every `ca-*` locale resolves here | full; AI-drafted, native review welcome |
|
||||
|
||||
|
||||
+549
-69
@@ -270,9 +270,22 @@ the suite) keep the agent to the folders you give it:
|
||||
selected objects only, and `clipboard.exportSvg` checks the copied objects, following a relative path from
|
||||
the document they came from while it is open; in a frame a request drives, Copy then puts no SVG on the
|
||||
system clipboard. An image whose pixels the document holds exports embedded, and a URL is not checked.
|
||||
- With `preserveEditing`, the document an SVG or SVGZ of these outputs carries leaves out the Export for Screens
|
||||
folder (`export_settings.folder`) when it is outside the read roots, as `document.exportSettings` does; the
|
||||
other export settings and the art are kept, and the open document keeps the folder.
|
||||
- The same error refuses, before any file or folder is written, every output of these commands and
|
||||
`document.exportPdf` that carries the native document (the native file or template, EPS, `.ai`, `.ait` and
|
||||
PDF files the JavaScript rule above lists, with `selectedOnly` and `document.exportSelection` the selected
|
||||
objects' document) when that document names a file outside the read roots: a linked image or placed file, the
|
||||
relative path kept of one (taken from the document's folder), or a data set's image, in every symbol,
|
||||
pattern, graph design and brush, used or not. A stored brush entry that does not read as a brush is refused
|
||||
too, since its links cannot be checked. Files that carry no native document are written as before, and the
|
||||
document keeps every link and data set.
|
||||
- The document these outputs carry (an SVG or SVGZ with `preserveEditing`, a native file or template, an EPS
|
||||
file, a `.ai` or `.ait` file, a PDF with Preserve Editing, and the document `file.package` writes and the
|
||||
linked native documents it rewrites) leaves out the Export for Screens folder (`export_settings.folder`) when
|
||||
it is outside the read roots, as `document.exportSettings` does; the other export settings and the art are
|
||||
kept, and the open document keeps the folder. `file.package` copies a linked PDF, `.ai` or EPS file, and a
|
||||
linked native document with `relink: false`, as it is: when the native document such a file is or carries
|
||||
keeps a folder outside the read roots, the package is refused before anything is written with "a linked
|
||||
file's export folder is outside the read roots", which names no file or folder.
|
||||
- `plugin.list`, `plugin.safeMode`, `file.recovery.*` and `ui_inspect`'s `scriptReport` leave out the paths
|
||||
outside the read roots, also those the person or an earlier request put there. In `plugin.list`, the plug-in
|
||||
folder last loaded is `null` in `folder.folder`, and a failed file in `folder.failed` and a plug-in's `source`
|
||||
@@ -657,6 +670,11 @@ applied colors still join the list while it is hidden. `ui.colorPanel {"rgbPerce
|
||||
RGB fields in percent, as a double-click right of an RGB field does, and `false` shows them from 0 to 255 again.
|
||||
`ui.colorRgbPercent` (Toggle RGB Percent in the command palette and Keyboard Shortcuts) switches between the two
|
||||
and answers true when the fields show in percent.
|
||||
`ui.colorWheel {"view": "box", "channel": "red"}` shows the Color Wheel panel's box (a color field with the channel's
|
||||
strip at its right) in place of the wheel, as the panel menu's Box View and Box Channel do, and `"view": "wheel"`
|
||||
shows the wheel again. Keys left out keep their values. Params that are not an object, another key or a value off
|
||||
the list return an error and change nothing. The command returns `{view, channel}`, and both settings are kept with
|
||||
the preferences.
|
||||
|
||||
In remote desktop mode, `invoke_menu` with `{"command":"ui.sampleScreenColor","params":{}}` shows the system's
|
||||
screen color sampler and returns `null` before a color is picked: the system's sampler on macOS, the XDG desktop
|
||||
@@ -723,8 +741,9 @@ For SVG/SVGZ, `export`'s top-level `outlineText: true` writes text as paths; DXF
|
||||
PDF instead uses `options: {"advanced": {"outlineText": true}}`; its default is false (live text).
|
||||
|
||||
With `mods.shift`, a marquee dragged with the Selection tool toggles the objects it reaches (the selected ones leave
|
||||
the selection, the others join it, the rest stays), and one dragged with Direct or Group Selection toggles the anchors
|
||||
inside it (a path left with none leaves the selection, one with all of them is selected whole). The Lasso adds anchors
|
||||
the selection, the others join it, the rest stays), one dragged with Group Selection toggles the objects it touches,
|
||||
whole, and one dragged with Direct Selection toggles the anchors inside it (a path left with none leaves the
|
||||
selection, one with all of them is selected whole). The Lasso adds anchors
|
||||
with `mods.shift` and takes them away with `mods.alt`. They run `select.toggle {ids}` and `select.anchorsMany {items,
|
||||
mode: "set"|"add"|"toggle"|"subtract"}`:
|
||||
|
||||
@@ -769,6 +788,17 @@ Constrain Angle's negative. `shape.arc` takes `rotation` in degrees clockwise on
|
||||
reference point `x`, `y`; the arc's bounding box turns with it. Without `rotation`, or at 0° or a whole turn, the arc is
|
||||
upright, and a `rotation` that is not a number is an error that adds nothing.
|
||||
|
||||
A Spiral tool drag sends `shape.spiral` with the spiral's outer end at the pointer: `radius` is the pointer's distance
|
||||
from the center `cx`, `cy` and `rotation` its direction in degrees clockwise on the page from the x axis, left out when
|
||||
it is 0, so dragging around the center turns the spiral. A pointer less than 0.01 pt from the center keeps the last
|
||||
direction (none before the first). Shift and General › Constrain Angle do not change a dragged spiral's direction. The
|
||||
Spiral dialog's spiral, placed by a click, takes a `rotation` of the Constrain Angle's negative when the angle is other
|
||||
than 0° or a whole turn, so its outer end starts along the turned x axis, and its bounding box turns with it.
|
||||
`shape.spiral` takes `rotation` in degrees clockwise about `cx`, `cy`; without it, or at 0 or a whole turn, the outer
|
||||
end is at `cx + radius`, `cy` as before, and a `rotation` that is not a number is an error that adds nothing. The
|
||||
bounding box turns only when `rotation` is the Constrain Angle's negative, as for `shape.polygon` and `shape.star`, so a
|
||||
drag that points along the turned x axis makes the same spiral, with the same turned box, as the dialog.
|
||||
|
||||
`shape.arc` checks `reference`, `baseAlong` and `slope` in both of its forms. `reference` is a whole number from 0 to 8
|
||||
(`4.0` is 4) and is 0 when left out; `baseAlong` is `x` or `y` in either case and is `x` when left out; `slope` is
|
||||
from −100 to 100 and is 50 when left out with `lengthX` and `lengthY`, or 100 with `x1`, `y1`, `x2`, `y2`. A
|
||||
@@ -1118,7 +1148,12 @@ data larger than 8 MiB or holding more than 2,000,000 XML nodes is left out (the
|
||||
reads), each with a warning. With `outlineText`, the bound type is written as outlines, so its text variables open
|
||||
unbound (with a warning). `document.open` reads the variable data of an SVG back (unless the SVG reopens from
|
||||
Preserve Editing): its text variables and data sets, no active data set, and each text variable bound to the type
|
||||
object its `docRef` names; the art stays as the file draws it. Variable data that `variable.loadLibrary` would refuse
|
||||
object its `docRef` names; the art stays as the file draws it. Variables of other kinds are left out with one warning
|
||||
that names each kind once, in the order it first comes, with its count: ``variables that aren't text were left out:
|
||||
Visibility (2), Linked File (1), Unknown (1), `custom` (1)``. Visibility, Linked File and Graph Data are the
|
||||
`visibility`, `fileref` and `graphdata` traits, Unknown is a variable without a `trait`, and any other `trait` is
|
||||
written as the file writes it, in backticks, with each backtick in it doubled. The status bar shows the kinds VectorCraft
|
||||
names in the interface language. Variable data that `variable.loadLibrary` would refuse
|
||||
is left out with the warning "the file's variable data wasn't read", and the art opens. `svgz` takes the same options and writes the SVG gzipped (`.svgz` files also open,
|
||||
place and paste). `run_command document.save {path: "x.svg", svg: {…}}` saves as SVG (or `.svgz`).
|
||||
Colorized grayscale and 1-bit images export in their fill color; linked mode writes a coverage PNG, and Tiny 1.2 writes a colorized PNG.
|
||||
@@ -1660,7 +1695,8 @@ its noise). PDF exports write it the same way, except for a linear, radial, coni
|
||||
stops whose other stops are all paper white or written in CMYK or gray, that is not a dithered fill and whose curve
|
||||
does not have too many stops (a diamond as four such shadings). An export that converts colors to a CMYK destination profile writes RGB and Lab stops in CMYK, and so does a
|
||||
CMYK document unless the export converts colors to an RGB destination profile. PDF writes tints of one spot ink as a Separation shading in that ink, and spot inks mixed with other spot, CMYK
|
||||
or gray inks as a DeviceN shading.
|
||||
or gray inks as a DeviceN shading. A legacy `.ai` file gets the colors between a Perceptual gradient's stops as stops
|
||||
of their own, in process colors (at most 256, with a warning).
|
||||
`hue-clockwise` and `hue-counterclockwise` (VectorCraft's own methods) mix a linear, radial, conic or diamond
|
||||
gradient's colors around the hue wheel: hue, saturation and brightness each change evenly from one stop to the next.
|
||||
With `hue-clockwise` the hue angle falls (red, magenta, blue, cyan, green, yellow, red), which is clockwise on the
|
||||
@@ -1741,7 +1777,8 @@ vectorcraft-cli run --cmd file.new --params '{"width":800,"height":600}' \
|
||||
|
||||
`run` prints one JSON line per step (`open`, `cmd`, `export`) and exits non-zero on the first failure, naming the step
|
||||
(counting from 0, as `"$N"` references do) and its command. `--params` applies to the `--cmd` just before it. `run`
|
||||
also accepts the host commands `file.open`, `file.save`, `file.export`, `file.exportForScreens` and `tool.select`.
|
||||
also accepts the host commands `file.open`, `file.save`, `file.export`, `file.exportForScreens`, `tool.select` and
|
||||
`tool.selectLastSelection`.
|
||||
`run --in`, `convert` and `info` read every format `document.open` reads (`vectorcraft-cli --help` lists them).
|
||||
|
||||
### Steps from a file or standard input
|
||||
@@ -2076,7 +2113,10 @@ commands fail and change nothing, and `appearance.removeItem` removes nothing. A
|
||||
`artboard.reorder`, `graphicStyle.move`, `appearance.moveItem`, `appearance.duplicateItem` and `effect.move`) puts
|
||||
the item last. A text `start` or `end` is past the end of the text. `object.slice.divide` refuses such a `rows` or
|
||||
`columns`, `recolor.reduce` keeps each color in its own row for such a `colors`, and `layer.setProps` refuses such a
|
||||
`color`. `object.setBounds` reads a `reference` past 8 as 8, as `object.transformEach` does.
|
||||
`color`. `object.setBounds` reads a whole-number `reference` past 8 as 8, as `object.transformEach` does.
|
||||
For `object.setBounds`, `reference` accepts whole numbers of 0 or more, including floating-point representations
|
||||
such as `0.0`. Negative and fractional values are errors. An omitted or null `reference` uses the center point, 4.
|
||||
These rules apply to both whole objects and directly selected anchors.
|
||||
An index or place given as a value that is not a whole number of 0 or more, such as `"3"`, `2.5`, `-1` or `true`, is
|
||||
refused with `` `anchor` must be a whole number ``, naming the key: `anchor` of `path.setHandle`, `path.moveAnchor` and
|
||||
`text.setPathHandle`, `segment` of `path.insertAnchor`, `to` of `artboard.reorder`, `library.moveGroup` and
|
||||
@@ -2664,8 +2704,8 @@ script reads files with them:
|
||||
- `open('r')` opens a file to read, and `read([chars])`, `readln()`, `readch()`, `seek(pos[, mode])`, `tell()`, `eof`
|
||||
and `close()` read it. `read`, `readln` and `readch` count characters, and `seek` and `tell` count bytes. `readln`
|
||||
and `readch` take CR, LF, CRLF and LF CR as one line end. `folder.getFiles([mask])` lists a folder, sorted by name;
|
||||
the mask matches `*` and `?` without regard to case, and a function as the mask keeps the entries it returns true
|
||||
for.
|
||||
the mask matches `*` and `?`, without regard to case on Windows and macOS and with case elsewhere, and a function
|
||||
as the mask keeps the entries it returns true for.
|
||||
- A method that fails returns `false`, `null` or an empty string and sets `error`, such as `Script file access
|
||||
denied`, `Script file does not exist` or `Script file is not open`. A count or a position that is not a finite
|
||||
number, or a negative count, throws a `RangeError`.
|
||||
@@ -2680,7 +2720,9 @@ VectorCraft reads files by these rules of its own:
|
||||
`getFiles` leaves such an entry out. A missing file is refused the same way unless the nearest folder above it that
|
||||
exists is inside the script's folder. It is also refused when a link above it leads to a folder that does not exist.
|
||||
- `open` reads the whole file. A file larger than 8 MiB is refused from its size before any of it is read, with
|
||||
`Script file exceeds 8 MiB`, and a run that opens more than 32 MiB in all ends with an error. A run has at most 256
|
||||
`Script file exceeds 8 MiB`, and a run that opens more than 32 MiB in all ends with an error. A file opened again
|
||||
after its objects closed counts only the bytes it grew by, and a file that another object has open counts again. A
|
||||
run has at most 256
|
||||
files open at once; another `open` returns `false` with `Script has 256 files open` until one is closed.
|
||||
- The encoding is the one the file's byte order mark gives (UTF-8, UTF-16LE or UTF-16BE), otherwise the `encoding`
|
||||
the script set before `open`, otherwise UTF-8 when the bytes are valid UTF-8, otherwise CP1252. `BINARY` reads each
|
||||
@@ -2691,11 +2733,116 @@ VectorCraft reads files by these rules of its own:
|
||||
folder gives `null` with `Script folder mask takes too many steps to match`.
|
||||
- A path longer than 32,767 characters throws a `RangeError` (`Script file path exceeds 32,767 characters`) when a
|
||||
`File` or `Folder` is made from it.
|
||||
- Writing is not available yet: `open('w')`, `open('e')`, `open('a')`, `write`, `writeln`, `copy`, `remove`,
|
||||
`rename`, `create` and `createAlias` return `false` with `Script file writing is not available`, and setting
|
||||
`length`, `hidden` or `readonly` sets `error` to that message and changes nothing. The file
|
||||
and folder dialogs return `null`, and `execute` opens nothing and returns `false`. In the web build every lookup
|
||||
fails with `Script file access is unavailable on the web`.
|
||||
- `createAlias` returns `false` with `Script files cannot make aliases`, setting `hidden` sets `error` to `Script
|
||||
file hidden setting cannot be changed` and changes nothing, and `execute` opens nothing and returns `false`. In the
|
||||
web build every lookup fails with `Script file access is unavailable on the web`.
|
||||
|
||||
The help page's writing members work as it describes
|
||||
(<https://extendscript.docsforadobe.dev/file-system-access/file-object/>,
|
||||
<https://extendscript.docsforadobe.dev/file-system-access/folder-object/>):
|
||||
|
||||
- `open('w')` empties the file, or makes it, `open('e')` opens a file that is there, and `open('a')` opens it at its
|
||||
end. `write(...values)` writes the values as `String(value)` gives them, and `writeln(...values)` adds the line end
|
||||
`lineFeed` names: CR LF for `Windows`, CR for `Macintosh` and LF for `Unix`. A byte order mark is written only
|
||||
when the script writes `\uFEFF`.
|
||||
- `copy(target)` copies the file to a path or a `File` and replaces a file that is there. `remove()` deletes a file,
|
||||
or a folder only when it is empty (`Script folder is not empty`), at once and without the trash. `rename(name)`
|
||||
takes a name without a folder; a name that is in use gives `Script file name is already in use`, and the object
|
||||
takes the new path; another object that has the file open writes to the new path. An object whose changes
|
||||
`close` could not write does not remove or rename its file, and another object that has a removed file open
|
||||
drops its changes and takes no more writes. `copy` of a file over 8 MiB gives `Script file exceeds 8 MiB`, and `copy` of a file that
|
||||
is open copies what the open file holds; an object that has the target open then holds the copy. `folder.create()` makes the folder and the folders above it, and gives `Script file access denied` without making any when one of them is outside the places the script may write. Setting `length` cuts the file or
|
||||
pads it with zero bytes, also in an object that has the file open, and setting `readonly` changes the file (on
|
||||
Unix, setting it clears every write bit, and clearing it gives back the bits the run cleared, or else the owner's
|
||||
write bit). `changePath` of an object whose changes cannot be written gives `false` with `error` set and keeps its path. `copy` onto the file itself leaves it as it is, and `open('w')` with an
|
||||
encoding that is not one gives `false` and leaves the file as it is.
|
||||
- `File.openDialog(prompt, filter, multiSelect)`, `File.saveDialog(prompt, filter)` and `Folder.selectDialog(prompt)`,
|
||||
and the objects' `openDlg`, `saveDlg` and `selectDlg`, give a `File` or a `Folder`, or `null` when the person
|
||||
cancels; `multiSelect` gives an array of the files picked. A string `filter` such as `"JavaScript:*.jsx;All
|
||||
files:*.*"` gives the file types the dialog shows: each `name:pattern` starts a type, a pattern without a name adds
|
||||
to the type before it, and patterns are separated by `,` or `;`. `*.ext` patterns name extensions and `*` or `*.*`
|
||||
every file; other patterns are left out. A `filter` that is a function is called with a `File` for each file
|
||||
picked, and the files it gives a false value for are left out of the result; when none is left, the dialog
|
||||
gives `null`. The dialog itself then shows every file.
|
||||
|
||||
VectorCraft writes files by these rules of its own:
|
||||
|
||||
- A script writes only in `Folder.temp`, `Folder.userData` and what a person allowed it in a file dialog. Its own
|
||||
folder is only read. `Folder.temp` is a folder for the run, made when the script first names it and deleted when
|
||||
the run ends; `new File()` names a new file there. `Folder.userData` is the script's own folder in the Script Data
|
||||
folder next to the settings, kept between runs; a script given as `source`, or a session without a settings
|
||||
folder, gets one inside `Folder.temp`. When that folder is a link, `Folder.userData` is `null` and the place the
|
||||
link leads to is not granted. When automation write roots are set and do not take the folder, `Folder.temp` or
|
||||
`Folder.userData` is `null` and the folder is not made; the same holds when they do not take a missing folder above it. When automation write roots are set, the place written must also be inside
|
||||
them. Opening a file with `e` or `a` reads it, so the automation read roots apply to it as well. The folder that
|
||||
holds the settings (the Scripts and Plug-ins folders among them) is kept out of every grant, also before it has
|
||||
been made, apart from the script's own `Folder.userData`, and a folder that holds it cannot be renamed. Anything
|
||||
else gives `false` with
|
||||
`Script file access denied`.
|
||||
- What a script writes is written when it closes the file or when the run ends, also when the run fails. At the
|
||||
run's end the files left open are written in the order they were opened. A file
|
||||
that `close` could not write stays open, so a later `close` tries again, and is written again when the run ends; a
|
||||
`write` that would pass the run's limit
|
||||
is not written. A run that
|
||||
would otherwise succeed fails when a changed file it left open cannot be written, with
|
||||
`Error: the script left open files that could not be written` and the files' paths. One file
|
||||
holds at most 8 MiB, and a run that writes more than 32 MiB in all ends with an error. `write` encodes in the
|
||||
file's encoding: `ASCII` and `ISO-8859-1` give `false` with `Script file cannot encode the text` for a character
|
||||
they cannot hold, and `BINARY` writes each character's low byte. `write` and `writeln` turn their values into text
|
||||
only for an open file, and stop once the text is longer than 16,777,216 UTF-16 code units, giving `false` with
|
||||
`Script file exceeds 8 MiB`. Each object that has a file open holds its own bytes, so the 32 MiB counts what
|
||||
setting `length` adds to the file and to each such object, and what `copy` writes to its target and to each such
|
||||
object of the target. The report's `written` names each file written, at most 4,096 of them; a run that wrote more
|
||||
also has `writtenMore: true`.
|
||||
- In the app a file dialog shows the script's prompt and what the script asks for: a file to read (open), a file to
|
||||
read and write (save), or a folder to read and write with everything in it. The person chooses with Choose…, whose
|
||||
dialog picks several files at once, and adds them to those chosen before, when the script asked for several with
|
||||
`multiSelect` (Choose… keeps at most 2,048, and the dialog says when it left out the files picked after them), and
|
||||
then picks Allow Once, Always Allow This Script or Deny; Deny, Enter, Escape and Cancel give `null`, and Stop ends
|
||||
the run. Choose… for a folder's `selectDlg` opens the host's folder dialog in that folder.
|
||||
The prompt and what the dialog says the script asks for come from the script's request, so `ui.dialog.set` on the
|
||||
dialog's `kind` or `prompt` does not change them. Only the person at the keyboard allows access: an `answer` of
|
||||
`once` or `always` from `ui.dialog.set`, `ui.dialog.confirm` or synthetic input gives `Only the person at the
|
||||
keyboard can allow a script's file access`, and the dialog stays open; `deny` and `stop` are taken from automation.
|
||||
Always Allow This Script keeps the grant in `Script Grants.json` next to the settings for that script file with
|
||||
that text with the files it includes, by its SHA-256, so a changed or moved script, or a changed included file,
|
||||
asks again. It is offered only for a script run from a file. The grant also keeps the SHA-256 of each source the
|
||||
run evaluated up to its end (a file `$.evalFile` ran, a string given to `eval` or `Function`, at most 256). A later
|
||||
run loses the grant before it evaluates a source the grant does not list, and from the start when its
|
||||
`#targetengine` engine holds code the grant does not list, such as another script's. A file opened under a
|
||||
grant the run loses gives `Script file access denied` when it is read or `seek` is called after that. A kept grant stays on the
|
||||
real path that was allowed: when that path now leads elsewhere, through a link put in its place or in a folder
|
||||
above it, the grant is not used.
|
||||
- A command a script runs with `vc.run` reads and writes files only where the script's `File` and `Folder` objects
|
||||
may, and in the files the open documents were opened from or saved to. Anything else fails with
|
||||
`Script file access denied` and the path, saving into a user library (swatches, brushes, symbols or graphic
|
||||
styles) included; reading the app's own libraries is allowed. A script given as `source` that a person allowed nothing writes only in
|
||||
its `Folder.temp` and `Folder.userData` and to the open documents' own files.
|
||||
A pick inside the folder that holds the settings gives `null` and sets `error` to `Script file access to the app's
|
||||
own folders is not allowed`.
|
||||
- A run with nobody to ask, as over MCP or the command line, gives `null` from every file dialog and sets `error` to
|
||||
`Script file dialogs need a person to answer them`, and takes no kept grant. In the app, a file dialog inside a
|
||||
built-in's callback, a getter, a conversion or a file `$.evalFile` runs throws an error.
|
||||
|
||||
`script.grants {}` lists the kept grants: `{grants: [{script, sha256, code, path, write, folder}], file}`, with `code`
|
||||
the SHA-256 of each evaluated source (of its UTF-16 code units in little-endian order), `folder` true for a folder's
|
||||
grant, which covers everything in the folder (a file's grant covers its own path only, also when a folder later
|
||||
takes its place), and `file` the grants
|
||||
file's path, or `null` without a settings folder. Under automation read roots, a `script`, `path` or `file` outside them
|
||||
is given as its file name alone. `script.grants.revoke {script?, path?, all?}` removes the grants of
|
||||
a script file, of a path, of both together, or with `all: true` every grant, and returns `{removed}`. A path is
|
||||
matched after its links are followed; under automation read roots, a path outside them is matched as given. While a script
|
||||
runs it is refused with the busy error, as the run keeps the grants it started with. A grants file that is there but
|
||||
cannot be read is left as it is: `script.grants.revoke` fails, and a grant picked with Always is not kept. A script
|
||||
cannot run either command.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"script.grants.revoke","params":{"all":true}}}
|
||||
```
|
||||
|
||||
```sh
|
||||
vectorcraft-cli run --cmd script.grants --params '{}'
|
||||
```
|
||||
|
||||
Window › Script Console shows the session's script lines, oldest first: each run's start, its `$.write` and
|
||||
`$.writeln` output, its `vc.log` entries, its uncaught error as `name:line:column: message` (or `name: file:line:column: message` when the error is in another
|
||||
@@ -2758,6 +2905,10 @@ The rest of this section is VectorCraft's own rules:
|
||||
read finds new names after the menus have shown 16,384 different script and folder names since VectorCraft started.
|
||||
When the folder is there and cannot be read, the menu shows
|
||||
`The Scripts folder cannot be read`.
|
||||
- Until the first read ends, the menu shows `Loading scripts…` in place of the listing, and
|
||||
`The Scripts folder is still being read` once that read has taken 2 seconds. A first read that cannot start, or
|
||||
ends without a listing, shows `The Scripts folder cannot be read`, and the next read tries again. Later reads keep
|
||||
the last listing in the menu while they run.
|
||||
- A listed file is checked again when it is chosen. A file that is gone, is no longer a `.js` or `.jsx` file under
|
||||
the folder, or is or lies behind a link ends with `the script is no longer in the Scripts folder`, and nothing runs.
|
||||
The file is read once for that check, and the text that read checked is the text that runs; its `#include` lines
|
||||
@@ -3160,16 +3311,26 @@ dropped.
|
||||
## Navigator panel options
|
||||
|
||||
The Navigator panel menu's Panel Options… opens the `navigatorPanelOptions` dialog (fields `color`, `solidDashes`),
|
||||
and `ui.navigatorPanelOptions {color?, solidDashes?}` sets the options without it → `{color, solidDashes}`; with
|
||||
neither key it opens the dialog. `color` is the color the panel's view box is drawn in: `#rrggbb` or a preset name.
|
||||
and `ui.navigatorPanelOptions {color?, solidDashes?, viewArtboardContentsOnly?}` sets the options without it →
|
||||
`{color, solidDashes, viewArtboardContentsOnly}`; with none of the keys it opens the dialog. `color` is the color the
|
||||
panel's view box is drawn in: `#rrggbb` or a preset name.
|
||||
The presets are VectorCraft's own list: Light Red (`#ff3030`, the default), then the layer colors ("Light Blue",
|
||||
"Red", "Green" and the rest). `solidDashes` (Draw Dashed Lines as Solid Lines, off by default) makes the panel's
|
||||
thumbnail draw dashed strokes without their dashes; the canvas, printing and exports keep the dashes. Both are kept
|
||||
with the UI state. A `color` that is not a color, or a `solidDashes` that is not true or false, is an error and
|
||||
changes neither option. Behavior reference: [View artwork](https://helpx.adobe.com/illustrator/using/viewing-artwork.html).
|
||||
thumbnail draw dashed strokes without their dashes; the canvas, printing and exports keep the dashes.
|
||||
`viewArtboardContentsOnly` is the panel menu's View Artboard Contents Only, on by default: the thumbnail fits the
|
||||
artboards and draws only the art inside them, so 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. Off, the thumbnail also fits and draws the art outside the
|
||||
artboards. The view box still shows the canvas's view either way. All three are kept with the UI state and apply to
|
||||
every document; UI state saved without `viewArtboardContentsOnly` reads it as on, and a saved off stays off. Fitting
|
||||
the thumbnail to the union of the artboards with a small margin, cutting the art at each artboard, and keeping the
|
||||
choice with the UI state are VectorCraft's own rules. A `color` that is not a color, or a `solidDashes` or
|
||||
`viewArtboardContentsOnly` that is not true or false, is an error and changes none of the options. Behavior
|
||||
references: [View artwork](https://helpx.adobe.com/illustrator/using/viewing-artwork.html) and
|
||||
[Navigate and zoom artwork](https://helpx.adobe.com/illustrator/desktop/get-started/learn-the-basics/navigate-and-zoom-artwork.html).
|
||||
|
||||
```json
|
||||
{"name":"invoke_menu","arguments":{"command":"ui.navigatorPanelOptions","params":{"color":"Light Blue","solidDashes":true}}}
|
||||
{"name":"invoke_menu","arguments":{"command":"ui.navigatorPanelOptions","params":{"viewArtboardContentsOnly":false}}}
|
||||
```
|
||||
|
||||
## Info panel
|
||||
@@ -3210,10 +3371,15 @@ By default the docked Tools panel sits at the window's left edge, outside any pa
|
||||
`window.toolsBesideCanvas {on?}` (Window › Toolbars › Keep Tools Beside the Canvas, remote mode, `invoke_menu`)
|
||||
docks it between those panels and the canvas instead (`on: true`), back at the window's edge (`on: false`), or
|
||||
toggles it (`on` omitted or null), and answers the new state. Any other value of `on` is an error and changes
|
||||
nothing. With the setting on, a floating Tools panel docks when it is dropped on the canvas's left edge as well as
|
||||
on the window's left edge, and `window.panel.dock {panel: "tools"}` docks it beside the canvas. A floating Tools
|
||||
panel stays floating when the setting changes. The setting is VectorCraft's own layout option, off by default; it is
|
||||
kept with the workspace, and built-in workspaces and workspaces saved without it keep Tools at the window's edge.
|
||||
nothing. A floating Tools panel dropped on the canvas's left edge, right of any panels docked on the left, docks
|
||||
beside the canvas and turns the setting on; dropped on the window's left edge, it docks there 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), and 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. With the setting on, `window.panel.dock {panel: "tools"}` docks it beside the canvas. A
|
||||
floating Tools panel stays floating when the setting changes. The setting is VectorCraft's own layout option, off
|
||||
by default; it is kept with the workspace, and built-in workspaces and workspaces saved without it keep Tools at
|
||||
the window's edge.
|
||||
|
||||
```json
|
||||
{"name":"invoke_menu","arguments":{"command":"window.toolsBesideCanvas","params":{"on":true}}}
|
||||
@@ -3560,7 +3726,7 @@ already walks Image Trace. Short agent entry points:
|
||||
- Brushes: `brush.list`, `brush.get {name}`, `brush.apply {name, ids?}`, `brush.new {type, name?, params?, ids?}`,
|
||||
`brush.setCurrent {name}`, `brush.options {name, params?, newName?}`, `brush.delete {name} | {names}`,
|
||||
`brush.duplicate {name, newName?} | {names}`, `brush.freehand {…path.freehand params, brush?}`,
|
||||
`object.expandBrush {ids?}`. `brush.freehand` draws the plain path when `brush` is left out or null. It refuses a
|
||||
`object.expandBrush {ids?}`, `brush.objectOptions {ids?, params?, reset?}`. `brush.freehand` draws the plain path when `brush` is left out or null. It refuses a
|
||||
`brush` that is not a string with "`brush` must be a string", a name that no brush in the document has (an empty
|
||||
name included) with "no brush named `<name>`", a `style` other than "pencil" or "brush", 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)
|
||||
@@ -3593,6 +3759,28 @@ already walks Image Trace. Short agent entry points:
|
||||
words. Corner tiles also take `autoCentered`, `autoBetween`, `autoSliced` and `autoOverlap`. A swatch choice copies its whole art and tile frame into the brush. `original`
|
||||
keeps the current art and clears its swatch label. `side_tile: "none"` fails with "You must choose a
|
||||
side pattern." An unknown swatch name also fails; neither error edits the brush or adds an Undo step.
|
||||
`brush.objectOptions {ids?, params?, reset?}` (the Brushes panel menu's Options of Selected Object…, from the
|
||||
[Modify brushes](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/modify-brushes.html)
|
||||
page) changes the brush settings of the selected brushed paths on those paths only; the brush and its other strokes
|
||||
keep their settings. The fields a path can set are VectorCraft's own choice: calligraphic `angle` (counter-clockwise from
|
||||
level), `roundness`, `size`, `variation` and `modes`; scatter `size`, `spacing`, `scatter`, `rotation`
|
||||
(counter-clockwise), `modes`,
|
||||
`rotation_relative_to_path` and `colorization`; art `width`, `width_mode`, `width_max`, `flip_along`, `flip_across`,
|
||||
`overlap` and `colorization`; pattern `scale`, `spacing`, `fit`, `flip_along`, `flip_across` and `colorization`.
|
||||
Values outside their ranges are clamped as in `brush.options`, a `colorization` object changes only the fields it
|
||||
gives, a `null` item of an array (`size: [40, null]`) keeps each path's own item, else the brush's, and a setting
|
||||
equal to the brush's own value is dropped. The dialog sends only the items and fields changed in it, so editing one
|
||||
end of a range leaves each selected path's other end as it was. A mode that `params` does not set (no `modes`, or
|
||||
a `null` item) stays the one each path draws with, so a changed calligraphic variation or scatter range does not
|
||||
change it. An art `width` without a `width_max` keeps the largest width of each path whose width follows the pen,
|
||||
and a calligraphic path's `modes: null` (modes that follow its values) stays when another value changes. The dialog
|
||||
changes nothing when another document has become the active one. `reset: true` clears a path's settings. The command
|
||||
refuses `params` together with `reset`, a selection with no brushed path, paths whose brushes are of different
|
||||
types, a bristle brush and a field the type does not take. It records one undo step, and none when nothing changes.
|
||||
`brush.options` edits still reach the settings a path does not set, `brush.apply`, a brush change in
|
||||
`stroke.setAdvanced`, Global Edit or a `brush.freehand` extend, and removing the brush clear the path's settings,
|
||||
and renaming the brush keeps them. Without
|
||||
`params` or `reset` the command only returns the first path's settings. The native file saves them on the stroke as `brush_options`.
|
||||
- Pen tilt, bearing and barrel rotation (#764): `path.freehand` and `brush.freehand` take points as
|
||||
`[x, y, pressure, tiltX, tiltY, rotation]` or `{x, y, pressure?, tiltX?, tiltY?, rotation?}`, with `null` for what a
|
||||
point lacks, and a `pointer_gesture` event takes `tiltX`, `tiltY` and `rotation`, which the Paintbrush records.
|
||||
@@ -3651,7 +3839,7 @@ already walks Image Trace. Short agent entry points:
|
||||
- Data sets: `dataset.list`, `dataset.new {name, values?}`, `dataset.set {name, newName?, values?}` (`newName` also
|
||||
renames the row, in the same undo step; Edit Data Set's Name field sends it), `dataset.rename`,
|
||||
`dataset.delete`, `dataset.capture`, `dataset.update`, `dataset.select {name}`, `dataset.next` /
|
||||
`dataset.prev` (each `dataset.select` / next / prev is one undo step over every bound object), `dataset.import {path|data|dataBase64|csv}` /
|
||||
`dataset.prev` (each `dataset.select` / next / prev is one undo step over every bound object), `dataset.import {path|data|dataBase64|csv, base?}` /
|
||||
`dataset.export {path?}` (CSV: one column per variable, and no column of data set names). `dataset.import` also
|
||||
reads tab-separated files. Every header cell is a variable, whatever its case (`name` and `Name` included). The
|
||||
first row holds the field names, as the
|
||||
@@ -3659,16 +3847,33 @@ already walks Image Trace. Short agent entry points:
|
||||
describes. The rows replace every data set of the document and are named `Data Set 1`, `Data Set 2` and so on, in file order;
|
||||
the document's variables and their bindings stay, and the reply's `deletedDataSets` lists the data sets that were replaced. An import error
|
||||
about a row's values gives the file line the row starts on. A header cell that names no variable defines one, unbound, in the same undo step as the
|
||||
rows. `#Shown` defines a visibility variable `Shown`, `@Photo` defines an image variable `Photo`, and a cell without
|
||||
a prefix defines a text variable. `dataset.export` writes a visibility variable's header as `#Shown` and an image
|
||||
variable's as `@Photo`, and a text or graph variable's as its name alone. Its reply's `warning` names the variables
|
||||
whose header or values make an import into a document without them refuse the file (a `%` header, a `#` header
|
||||
whose values aren't true or false). Otherwise it names the variables that such an import does not read back with
|
||||
their kind: text variables whose names start with `#` or `@`, and graph variables. Export is refused, naming both variables, when a variable's header is
|
||||
another variable's name (a visibility variable `Show` next to a text variable `#Show`). A prefixed cell whose name
|
||||
is already a variable of the prefix's kind names it;
|
||||
one whose name is a variable of another kind fails the import. A `%` cell that isn't a variable's exact name (graph
|
||||
data files) is refused, and so are two cells that name one variable (`City` twice, or `Shown` and `#Shown`). The
|
||||
rows. `#Shown` defines a visibility variable `Shown`, `@Photo` defines an image variable `Photo`, `%Sales` defines a
|
||||
graph variable `Sales`, and a cell without a prefix defines a text variable. The cells of a `%` column are paths of
|
||||
graph data files, as the set-up page's example shows. Each file is read as the Graph Data window's Import Data reads
|
||||
one ([add graph data](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/visualize-data/add-graph-data.html)):
|
||||
at most 1 MB; tab-separated when any line holds a tab, else comma-separated; the first row holds the series labels
|
||||
and the first column the category labels; UTF-16 by the rule below, else UTF-8. The data becomes the data set's
|
||||
graph value, which `dataset.select` applies as `graph.setData` applies it, so the graph gets the data that Import
|
||||
Data and Apply give it. The files are read at import. A relative path is taken from `dataset.import`'s `base`
|
||||
folder, else from the folder of the CSV file at `path`; with neither (`csv`, `data` or `dataBase64` and no `base`),
|
||||
it fails the import. This is VectorCraft's own rule, and it differs from an `@` column's: an image path is kept as
|
||||
the cell gives it, and a relative one is taken from the document's folder when a data set is selected. A `%` path is
|
||||
followed as an image path is: a path on another computer, or on a network share other than the one `base` or the
|
||||
CSV file is on, a device, and a URL other than a `file:` URL without a host fail the import with the line, the
|
||||
column and the reason, and no file is read. A file that is missing, can't be read or is larger than 1 MB, a file
|
||||
that gives a graph value longer than 256 KB, and `%` columns whose files and graph values hold more than 256 MB in all fail the import with
|
||||
the line and the column, and the document is left as it was. Each file is read once per import, however many cells
|
||||
name it, and counts once toward the 256 MB; each cell's graph value counts every time. `dataset.export` writes a
|
||||
visibility variable's header as `#Shown` and an image variable's as `@Photo`, and a text or graph variable's as its
|
||||
name alone. Its reply's `warning` names the variables whose header or values make an import into a document without
|
||||
them refuse the file (a `%` header over values, which such an import reads as file paths, and a `#` header whose
|
||||
values aren't true or false). Otherwise it names the variables that such an import does not read back with their
|
||||
kind: variables whose names start with `#`, `@` or `%` and aren't of that prefix's kind, and graph variables. Export
|
||||
is refused, naming both variables, when a variable's header is another variable's name (a visibility variable
|
||||
`Show` next to a text variable `#Show`). A prefixed cell whose name is already a variable of the prefix's kind names
|
||||
it; one whose name is a variable of another kind fails the import, and so do two cells that name one variable
|
||||
(`City` twice, or `Shown` and `#Shown`). A cell that is a variable's exact name, prefix included, names that
|
||||
variable, so the cells under a graph variable named `%Sales` are read as graph data in CSV form. The
|
||||
reply's `defined` lists the variables the import defined. While the variables are
|
||||
locked, an import whose header would define a variable fails with "variables are locked".
|
||||
A `dataset.import` file that isn't UTF-8 is read as Windows-1252, unless it starts with the UTF-8 byte-order mark.
|
||||
@@ -3788,6 +3993,19 @@ already walks Image Trace. Short agent entry points:
|
||||
than 8 MiB`. The Actions panel menu's Save Actions… and Load Actions… run these; Load Actions… is
|
||||
disabled where there is no open dialog (the web). `ui.actionSet.load` also reads the action sets other apps save as
|
||||
text (`.aia`); see "Action sets from other apps".
|
||||
`ui.actionSet.replace {path? | data?}` is the Actions panel menu's Replace Actions…. It reads the file at `path`, else
|
||||
a picked one, or the file's text `data`, as `ui.actionSet.load` does, with the same formats (`.vcactions` and `.aia`),
|
||||
limits, errors and reports of left-out steps and unknown commands, and replaces every set in the panel, the built-in
|
||||
Default Actions set included, with the file's set, which keeps its name. It returns `{changed, set: 0, name,
|
||||
actions}` with `unknownCommands` and `unknownCount`, or `skipped` and `leftOut`, as a load does. The set becomes
|
||||
current and selected, the panel's selected action and step and its expanded actions are cleared, and an open Set
|
||||
Options, New Action, Batch or step dialog that names a set closes; when the panel already holds only a set that saves
|
||||
alike, in that state, nothing changes, the set keeps its ids and `changed` is false. Omitted params count as `{}`.
|
||||
Params of another type, another key, a `path` or `data` that is not a string, a file that can't be read or is
|
||||
refused (an empty one too), a canceled pick (`cancelled`), or a replace while an action records or plays (also while
|
||||
it waits at a stop) is an error and changes nothing. Replace records no undo step. The menu item asks no question
|
||||
first, and it is disabled where there is no open dialog (the web) and while an action records or plays. These are
|
||||
VectorCraft's own rules.
|
||||
- Actions: `ui.action.rename {set, action, name}` renames the Actions panel's action at `action` in set `set` (0 is
|
||||
the top set) to `name` with spaces trimmed from both ends, keeps its steps, function key and color, and returns
|
||||
`{name}`. An index past the last set or action, or an empty name, is an error, and then nothing is renamed. So is a
|
||||
@@ -3863,8 +4081,11 @@ already walks Image Trace. Short agent entry points:
|
||||
menu step (`ui.action.insertMenuItem`) plays at every speed in its place among the steps, as its menu item runs, and
|
||||
adds no undo step. At Accelerated the steps before it and the steps after it are one undoable batch each, and the
|
||||
result is `{results}` with every step's result in order. A step that fails ends the playback with its error: the
|
||||
batch it is in changes nothing, and the steps before that batch stay done. While another action records, the View
|
||||
menu step is recorded too. Batch… refuses an action with an included View menu step.
|
||||
batch it is in changes nothing, and the steps before that batch stay done. At every speed, and after
|
||||
`ui.action.continue`, the error names the step by its place in the action, 1 for the first step, counting excluded
|
||||
steps and stops (``action step 4 (`object.align`) failed: …``). A failing step of a recorded `command.batch` is
|
||||
named by the batch's place and its own command. An error about the whole batch names no step. While another action
|
||||
records, the View menu step is recorded too. Batch… refuses an action with an included View menu step.
|
||||
- Actions: `ui.action.playAt {set, action}` plays the action at `action` in set `set` (0 is the top set) as
|
||||
`ui.action.play` plays it and returns what `ui.action.play` returns. A click on an action's button in Button Mode
|
||||
runs this. A missing index, or one that is not a whole number or is past the last set or action, is an error, and
|
||||
@@ -4756,9 +4977,13 @@ linked moves and the Color Theme Picker leave its new color as it is, and Save A
|
||||
from colors alone leave its new color out. With `limitTo`, a row's `tint` (a percentage, default 100) gives the art
|
||||
linked to the global or spot swatch its new color is that share of its tint; `tint` must be a number. `recolor.randomize`
|
||||
moves a row's `tint` with its new color and removes it from a color it changes, and moves a row's `model` with its new color. `swatch.editGroup {group, colors, rename?}` rewrites a colour group in one undo
|
||||
step (art linked to its global swatches follows), and `recolor.apply` with `group` recolours the art and rewrites the
|
||||
step (art linked to its global swatches follows); a `null` in `colors` removes the group's swatch at that place, and
|
||||
given the group's own colors in order and no new name, it records no undo step. A color key (`recolor.colors`) that
|
||||
names a swatch's color, rounded to the key's steps, counts as that color, and the swatch keeps its color unrounded. And `recolor.apply` with `group` recolours the art and rewrites the
|
||||
group together. A `null` in `groupColors` removes the group's swatch at that place, and the swatches after it keep
|
||||
their colors and names; art linked to a removed global swatch keeps its color and is no longer linked to it. Art linked to one of the group's global swatches stays linked when the swatch is rewritten with its
|
||||
their colors and names; art linked to a removed global swatch keeps its color and is no longer linked to it. `"keep"` in
|
||||
`groupColors` leaves the swatch at that place its color, without the Global Adjust; past the group's swatches it adds
|
||||
nothing, and it is refused for a swatch that is not a color. Art linked to one of the group's global swatches stays linked when the swatch is rewritten with its
|
||||
row's new color (the default without `groupColors` when the rows follow the group's order), so a later `swatch.edit` still
|
||||
reaches it; the reply's `relinked` counts the other linked paints that took the group's new colors. Art in a row that
|
||||
is linked to a swatch rewritten with another color keeps its row's new color, even an unchanged one, and is no longer
|
||||
@@ -4824,6 +5049,35 @@ become the `weights` field, which moves the rows' current colors and previews th
|
||||
beside the link button runs `swatch.newGroup` right away, as its own undo step: Save All Colors saves the new colors
|
||||
of the rows that are not excluded and hold current colors, in row order, and Save Prominent Colors saves the bar's colors in the bar's order.
|
||||
|
||||
The Recolor Artwork dialog lists the document's color groups on its right, or under the tabs in a window too narrow
|
||||
for both ([Advanced recolor options overview](https://helpx.adobe.com/illustrator/desktop/manage-colors/learn-color-basics/edit-colors-dialog-overview.html)).
|
||||
The Show Color Groups button beside the tabs shows or hides the list (the `groupStorage` field, true when the dialog
|
||||
opens). A click on a group, or `ui.dialog.set` of the `group` field to a group's name, makes it the group being
|
||||
edited: with art the art is reduced again to a row per color of the group, which become the rows' new colors, and
|
||||
without art the rows are the group's colors. A name that no group has is refused with `` no colour group `<name>` ``,
|
||||
and a `group` of null selects none. The buttons under the list are the `groupAction` field. Setting it checks the value, and the next frame of the
|
||||
dialog runs it (OK with it set in the same request runs it first):
|
||||
`save` (Save Changes) runs `swatch.editGroup` on the selected group with the colors OK would give it and the name in
|
||||
`groupName`, `new` (New Color Group) saves the new colors of the rows that are not excluded as `swatch.newGroup` does,
|
||||
and `delete` (Delete) runs `swatch.delete` on the selected group. Each is its own undo step, and the art keeps its
|
||||
preview. An excluded row leaves its swatch its own color, with or without art, and an excluded row past the group's
|
||||
swatches adds none. When several rows list a swatch's color, the swatch follows a row that gives the color a new color
|
||||
before an excluded row or one that removes the color, as `recolor.apply` maps the art. When the art has colors of the group,
|
||||
`save` and OK keep the group's swatches in order: a swatch whose color a row lists, or to which an earlier `save` gave
|
||||
a row's new color, takes that row's new color (its own color when the row is
|
||||
excluded), so art linked to the swatch takes the color its row shows, and every other swatch keeps its color. A row whose color was removed (`to: null`) and is not excluded
|
||||
removes its swatch, and the colors added on the Edit tab follow the group's other colors, as at OK. After a `save` with art, the rows' new colors take the Global
|
||||
Adjust and it goes back to 0%; when the save recolored linked art, the rows are read from the art again and a row with a
|
||||
color the save gave the art is excluded, also when other art has that color, since a row recolors every use of its
|
||||
colors alike. Until the rows or the Global Adjust change, OK changes the saved group only by the name
|
||||
in `groupName`. `save` and `delete` with no group selected answer `` missing `group` ``. `save` on a group with a
|
||||
swatch that is not a color (a gradient, pattern or None swatch) is refused, because the rows hold only the group's
|
||||
colors. Any other value is refused. After a Delete without art, OK saves the rows as a new color group.
|
||||
|
||||
```json
|
||||
{"name":"answer_dialog","arguments":{"set":[{"field":"group","value":"Brights"},{"field":"groupAction","value":"save"}]}}
|
||||
```
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"recolor.weigh","params":{"map":[{"from":["rgb 255 0 0","rgb 128 0 204"],"to":"#00ff00"},{"from":["rgb 0 0 255"],"to":"#ffff00"}],"weights":[1,1]}}}
|
||||
```
|
||||
@@ -4958,10 +5212,18 @@ spot or process swatches and keeps their color groups. A color book (such as a P
|
||||
CMYK or Lab colors named with the book's prefix and suffix ("PANTONE 185 C"), as spot colors unless the book marks
|
||||
them as process colors; `.acb` files are read, never written. A file in the user library folder, or a file with the
|
||||
same extension and bytes as one there, loads as that User Defined library (category `user`).
|
||||
From a document, such as a `.ai` or `.eps` swatch library, it reads the colors, tints, gradients and pattern swatches
|
||||
in the document's order and color groups; `swatch.library.add` brings a pattern swatch's pattern, with its tile and
|
||||
art, into the document as a pattern swatch under the library swatch's name and in its color group. A global or spot
|
||||
color the pattern's art links to keeps the library's color: when the document gives its name another color, it comes
|
||||
in under a numbered name ("Ink 2") and the pattern links to that. A document with
|
||||
no swatches, and a `.ai`, `.eps` or PostScript file whose swatches are only the default ones, are refused with
|
||||
"`<file>` has no swatches of its own". The Swatch Libraries filter of Other Library… lists `.ai`, `.ait` and `.eps`
|
||||
(`.epsf`) files as well as the library files.
|
||||
`swatch.library.copyToUser {library}` copies a loaded library into the user library folder of the desktop
|
||||
app (a library file as it is; a document's swatches or a library loaded from `data` or `dataBase64`
|
||||
as `.vcswatches`) under a name no file there has, and lists it as User Defined from then on; until the app
|
||||
quits, commands given its loaded id use the copy → `{library, name, count, path, copied}` (`copied: false`
|
||||
as `.vcswatches`; a library with pattern swatches is refused) under a name no file there has, and lists it as User
|
||||
Defined from then on; until the app quits, commands given its loaded id use the copy → `{library, name, count, path, copied}` (`copied: false`
|
||||
when the folder already held the same file). Without a user library folder the command is disabled.
|
||||
These commands refuse a parameter of the wrong form with an error that names it: `library`, `apply`, `path`, `data`,
|
||||
`dataBase64`, `format` and `name` must be strings, `names` must be a list of names, and `focus`, `replace` and `user`
|
||||
@@ -5321,7 +5583,10 @@ anchors that don't change a result's shape off it, and `removeUnpainted` makes D
|
||||
of objects with no fill (or only hidden fills). Both default to false; `{}` reads the options. Each Shape Mode and
|
||||
Pathfinder command (`object.pathfinder.unite` … `minusBack`) also takes `precision`, `removeRedundantPoints` and
|
||||
`removeUnpainted` for one run; the values it used join its journal entry, so a replay or an action gives the same art
|
||||
whatever the options are then.
|
||||
whatever the options are then. Unite, Minus Front, Intersect, Exclude and Minus Back close open paths, so a straight
|
||||
line encloses no area and does not change the result's shape. When a selected object is or holds such a path, the reply's
|
||||
`warning` says so and names Object › Path › Outline Stroke. When such a path leaves the result empty (Intersect, a line
|
||||
at the back in Minus Front, or a line in front in Minus Back), the error says so too.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"object.pathfinder.options","params":{"precision":0.1,"removeUnpainted":true}}}
|
||||
@@ -5425,7 +5690,11 @@ and `layerRows`, the rows highlighted in the panel.
|
||||
runs Hide or Lock Others for the row's layer, or Show or Unlock All when the others already are), `layer.pasteRemembersLayers`,
|
||||
`object.isolate {id?}` (a group, a layer or a single object, by default the first selected object; not type, not a
|
||||
hidden or locked object or one in a hidden or locked group or layer, not a guide path while Lock Guides is on, and
|
||||
while a symbol is edited only the editing layer or art on it) / `object.exitIsolation`.
|
||||
while a symbol is edited only the editing layer or art on it) / `object.exitIsolation`. Leaving an isolated Live
|
||||
Paint group (`object.exitIsolation`, or `object.isolate` on a level outside it) adds the paths, compound paths and
|
||||
groups of them drawn in it, shown and unlocked with everything in them, to the group as `livePaint.merge` does, in
|
||||
one undo step; type, images and other objects stay in it as they are, and with nothing drawn no undo step is
|
||||
recorded.
|
||||
- **Dialogs and panel state** (control channel and the app's MCP): `ui.layerOptions {ids?}` and `ui.newLayer
|
||||
{sublayer?}` open Layer Options (dialog `layerOptions`: name, color, template, locked, visible, printable, preview,
|
||||
dimImages, dimPercent; OK is one undo step; `ui.dialog.set` of `template` also sets `locked` and `dimImages`, as the
|
||||
@@ -5734,6 +6003,17 @@ link, the dimension stays where it was, no longer linked (see [dimensions.md](di
|
||||
`object.expand` rejects a param of the wrong type, such as `"fill": "yes"`, `"gradient": 3` or `"steps": "16"`, and
|
||||
changes nothing. Omitting a param or giving null keeps its default.
|
||||
|
||||
`ui.expandDialog {immediate?}` opens the Expand dialog (`object.expand` with no params opens it too). The dialog opens on
|
||||
the Object, Fill, Stroke, Expand Gradient To and steps choices that OK last expanded with since the app started, and on
|
||||
the defaults before that; Cancel and an OK that fails leave the kept choices as they were, and they are not kept across
|
||||
launches. Choosing Object → Expand… in the in-window menu bar with Alt (Option on macOS) held sends `immediate: true`, which expands the selection
|
||||
at once with those choices, or the defaults before any OK, in one undo step, as OK in the dialog would
|
||||
([the help page](https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/expand-objects.html)
|
||||
describes this shortcut for a gradient; VectorCraft applies it to whatever the choices expand). When none of the kept
|
||||
choices has something to expand in the selection, `immediate: true` opens the dialog on them instead and changes
|
||||
nothing. A selection with appearance attributes refuses both, as the dimmed menu item does. An `immediate` of null is
|
||||
treated as omitted, and any other value that is not true or false is an error.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"object.expand","params":{"stroke":false,"gradient":"mesh"}}}
|
||||
{"name":"run_command","arguments":{"command":"object.expand","params":{"steps":16}}}
|
||||
@@ -6053,6 +6333,10 @@ with `` `t` must be from 0 to 1 ``, with `segment` or with `anchor`. The documen
|
||||
recorded. Left out or null, `angle` is 0° and `roundness` is 100%; left out, `t` is 0.5. The Eraser's ranges are
|
||||
VectorCraft's own values.
|
||||
|
||||
`path.eraseSegments` (the Path Eraser) refuses a `width` outside 0.001 to 1000 pt with
|
||||
`` `width` must be from 0.001 to 1000 ``. The document and the selection do not change and no undo step is recorded.
|
||||
Left out or null, `width` is 8 pt. The range is VectorCraft's own value.
|
||||
|
||||
These commands refuse a string, a number or another value that is not true or false with
|
||||
`` `closed` must be true or false ``, naming the key; the document does not change and no undo step is recorded:
|
||||
`independent` in `path.close` and `path.setHandle`; `patterns` in `path.moveAnchors`; `closed`, `keepSelected` and
|
||||
@@ -6070,6 +6354,15 @@ macOS, Ctrl elsewhere), drags with the selection tool chosen last (`select_tool`
|
||||
Curvature and anchor tools until one is chosen; the release gives the tool back as it was, so the Pen goes on drawing
|
||||
the path it had begun while that stays selected. Its reply's `tool` is the tool given back.
|
||||
|
||||
`tool.selectLastSelection` (Select Last Selection Tool, `{}`) chooses the selection tool chosen last, as Ctrl+` does on
|
||||
Windows and Linux ([the help page](https://helpx.adobe.com/illustrator/using/default-keyboard-shortcuts.html) lists the
|
||||
shortcut among those for selections). Only Selection, Direct Selection and Group Selection count: choosing Magic Wand,
|
||||
Lasso or any other tool leaves the remembered one as it was. Before any of the three is chosen it chooses the Selection
|
||||
tool; with the remembered tool already active it keeps it, so running it again does not cycle. It returns `{tool}` and
|
||||
adds no undo step. On macOS it has no default shortcut, because the system uses Command+` to switch between an app's
|
||||
windows; Edit › Keyboard Shortcuts can assign one. The Selection tool as the first choice and the macOS default are
|
||||
VectorCraft's own rules. The headless backend and `vectorcraft-cli run` run it too.
|
||||
|
||||
```json
|
||||
{"name":"pointer_gesture","arguments":{"tool":"pen","events":[{"kind":"down","x":100,"y":300},{"kind":"up","x":100,"y":300},{"kind":"down","x":200,"y":300},{"kind":"drag","x":250,"y":300},{"kind":"up","x":250,"y":300}]}}
|
||||
{"name":"pointer_gesture","arguments":{"mods":{"cmd":true},"events":[{"kind":"down","x":250,"y":300},{"kind":"drag","x":250,"y":260},{"kind":"up","x":250,"y":260}]}}
|
||||
@@ -6954,6 +7247,11 @@ is converted on its own.
|
||||
osManaged}`, where `source` is `profile`, `srgbProfile` (a profile that shows sRGB unchanged), `system`, `none`,
|
||||
`pending` or `unsupported`, `applied` says whether the canvas is converted, and `reason` says why not.
|
||||
|
||||
`lowLatencyDrawing` (Preferences › Performance › Low-Latency Drawing, off by default; desktop app) is read when the app
|
||||
starts. On, the window presents without vsync (wgpu's `AutoNoVsync`) and frames start at most 240 times a second.
|
||||
`--present-mode` and `VECTORCRAFT_PRESENT_MODE` take precedence over it (see `docs/development.md` › Desktop graphics
|
||||
processor). A value that is not a boolean is an error.
|
||||
|
||||
`ctrlWheelScrollsSideways` (on by default): on, Cmd/Ctrl with a mouse wheel's whole notches scrolls the canvas sideways
|
||||
instead of zooming while `zoomWithMouseWheel` is off; off, Cmd/Ctrl-wheel zooms about the pointer. Alt + Cmd/Ctrl-wheel
|
||||
and a pinch on a Mac trackpad, on a touch screen or in the web build still zoom about the pointer. Under either
|
||||
@@ -7157,7 +7455,10 @@ Guides off, this drag leaves a 70 × 50 and a 90 × 50 copy and the 110 × 70 re
|
||||
`type.highlightTracking` (no default key) and `type.highlightFontName` (Cmd+Alt+Shift+F) show the Character panel and
|
||||
give its Kerning or Tracking field the keyboard focus with the value selected, or open its font family menu with the
|
||||
search field focused; each replies `{field: "kerning" | "tracking" | "fontName"}`. Without selected type or text the
|
||||
Type tool edits, the panel shows and the command fails.
|
||||
Type tool edits, the panel shows and the command fails. Type › Size › Other… runs `type.highlightFontSize` (`{}`, no
|
||||
default key), which gives the Character panel's Font Size field the keyboard focus the same way (blank when the
|
||||
selected sizes differ; the size typed and Enter apply through `text.setStyle {size}` as one undo step) and replies
|
||||
`{field: "fontSize"}`; the menu item is dimmed without selected type or text the Type tool edits.
|
||||
The UI command `type.underline` (Cmd+Shift+U,
|
||||
in remote mode `press_key {key: "U", mods: {cmd: true, shift: true}}` or `invoke_menu`) does what the Character
|
||||
panel's Underline button does: it underlines the Type tool's selected text or the selected type objects, or removes
|
||||
@@ -7406,15 +7707,22 @@ document current, and its tool keeps its state; closing the current document mak
|
||||
current, or the one before it when it was the last tab. In the desktop app a modified document comes to the front first,
|
||||
to ask whether to save it.
|
||||
`window.arrange.tile` (Window › Arrange › Tile) shows every open document in its own pane, edge to edge in the document
|
||||
area, in a grid of as many columns as the square root of the number of documents, rounded up, and fits each document to
|
||||
its pane; with fewer than two documents open it leaves the view and `tiled` as they are. It returns `{tiled, panes}`.
|
||||
The current document's pane is the canvas, and a press in another pane makes its document the current one.
|
||||
`window.arrange.consolidateAllWindows` (Window › Arrange › Consolidate All Windows) shows one document under its tab
|
||||
again and returns `{tiled: false}`. The arrangement is not saved. `ui.inspect` reports `tiled` and `panes` (each pane's
|
||||
`document` index, `rect` and whether it is `active`); canvas coordinates map to the current document's pane
|
||||
(`canvasRect`).
|
||||
its pane; it returns `{tiled, panes}`. The current document's pane is the canvas, and a press in another pane makes its
|
||||
document the current one. `window.arrange.floatInWindow` (Window › Arrange › Float in Window) moves the current document
|
||||
area, in a grid of as many columns as the square root of the number of windows, rounded up, and fits each document to
|
||||
its pane. Each view of a document counts as a window (see `window.newWindow` below). With fewer than two windows open it
|
||||
leaves the view, `tiled` and the layout as they are. It returns
|
||||
`{tiled, panes, layout}`. `window.arrange.tile {layout}` picks another layout, as the other Tile items of Window ›
|
||||
Arrange and of the application bar's Arrange Documents button do: `grid` (the default), `vertical` (Tile All
|
||||
Vertically: side by side in one row), `horizontal` (Tile All Horizontally: stacked in one column), and `2up`, `3up`,
|
||||
`4up` and `6up`, which show at most that many windows (2-Up and 3-Up side by side, 4-Up two by two, 6-Up three by
|
||||
two) and leave the others under their tabs. Those layouts show the first windows in tab order, and the current
|
||||
window takes the last pane when it is not among them, so a click on another tab brings that window into the last
|
||||
pane. Any other `layout` is an error, and the view stays as it is. The set of layouts and how each one places the panes
|
||||
are VectorCraft's own. The current document's pane is the canvas, and a press in another pane makes its document the
|
||||
current one. `window.arrange.consolidateAllWindows` (Window › Arrange › Consolidate All Windows, also first in Arrange
|
||||
Documents) shows one document under its tab again and returns `{tiled: false}`. The arrangement is not saved.
|
||||
`ui.inspect` reports `tiled`, `tileLayout` and `panes` (each pane's `document` index, `rect` and whether it is
|
||||
`active`); canvas coordinates map to the current document's pane (`canvasRect`).
|
||||
`window.arrange.floatInWindow` (Window › Arrange › Float in Window) moves the current document
|
||||
out of the tab strip into a floating window of its own, `window.arrange.floatAllInWindows` (Float All in Windows) does
|
||||
so for every tabbed document, and `window.arrange.cascade` (Cascade) floats every document and stacks the windows 30 pt
|
||||
apart from the upper left of the document area; each returns `{floating}`, the floating documents' indices. On the
|
||||
@@ -7582,6 +7890,12 @@ they can't be read, as with a PNG cut short by a download or a sync still runnin
|
||||
can't be read" and places nothing; `clipboard.importImage` fails the same way. A JPEG cut short is placed when its
|
||||
pixels still decode. Both keep the decoded pixels (except a CMYK JPEG's) in the image store the renderers share, so the first render
|
||||
that draws the image does not decode the file again.
|
||||
Opaque CMYK PSD/PSB merged images retain their 8-bit or 16-bit ink samples, CMYK ICC profile, resolution, and
|
||||
clipping path when placed, linked, relinked, updated, or embedded. `file.place.info`, `image.info`, and `links.info`
|
||||
report CMYK for these images. VectorCraft's native CMYK limit is 67,108,864 pixels. Composites with transparency,
|
||||
images beyond that limit, and native samples beyond the allocation allowance use the RGB import path, subject to
|
||||
its allocation limit. Importing individual layers with `layers: true` retains its existing behavior.
|
||||
|
||||
`file.place.info` describes a file without placing it and `image.info` reports a placed image's link, colour mode and
|
||||
effective ppi. `file.place.queue` loads the place cursor (the `place` tool) with several files: headless, drive it
|
||||
with `pointer_gesture` (a click places at 100% with the top-left corner there, a drag at the dragged size) and
|
||||
@@ -8276,7 +8590,9 @@ area). For a caller with read roots, the list leaves out `image/svg+xml`, and th
|
||||
(a one-page PDF, the page the objects' visual bounds) and `clipboard.exportPng {scale?}` (cropped to the objects,
|
||||
transparent around them). As in `document.export`, the PDF's and the PNG's replies list their notes in `warnings`
|
||||
(type written in the fallback font…; the PNG's also say when an image couldn't be decoded). After Copy or Cut the app
|
||||
shows the first note of the PDF and PNG it offers in the status bar.
|
||||
shows the first note of the PDF and PNG it offers in the status bar and how many there are, and hovering the message lists
|
||||
them all, unless another message has replaced the Copy or Cut's while the formats were made. A Copy or Cut without
|
||||
notes clears the notes message that an earlier Copy or Cut left. The `clipboard.export*` replies still list every note.
|
||||
|
||||
What other apps copied goes into the clipboard with `clipboard.importSvg`, `clipboard.importPdf {dataBase64, page?,
|
||||
password?, editingData?}` (the page's objects; with `editingData: true` the data is a `.ai` or `.ait` file, and every
|
||||
@@ -8418,6 +8734,18 @@ every object in the layers each time the list is read. A `dcsTransparency` that
|
||||
returns `{id, onCanvas: false, owner}`, and the panel says the link has no place on the canvas. `links.embed {ids?}` keeps linked files' pixels in the document (an image whose
|
||||
file is missing stays linked: relink it first); `links.unembed {id, path}` writes an embedded image to a file
|
||||
(another extension converts it) and links to it, and without `path` returns `{name, dataBase64}`.
|
||||
`ids` of one image works as `id` does. `links.unembed {ids?, folder}` writes each embedded image of `ids` (or of
|
||||
`id`; default: the selected embedded images) to a new
|
||||
file in `folder`, in the format it is stored in (as PNG when that format is not one of VectorCraft's raster file formats), and links each image to its file, keeping its bounds, in one undo
|
||||
step; undo does not remove the files. A file is named after its image, with each character a file name can't hold
|
||||
(`/ \ : * ? " < > |` and control characters) as `_` and `Image` when nothing is left; when the name is taken it is
|
||||
`Name 2.png` … `Name 99.png`, and a file already in the folder is never replaced. Linked images among `ids` are left
|
||||
as they are and listed in `skipped`. It returns `{unembedded: [{id, path}], skipped}`. When an image can't be written,
|
||||
the files the call wrote are removed and the document does not change. A folder outside the automation write roots,
|
||||
`id` given with `ids`, `path` given with `folder`, `ids` of more or fewer than one image without `folder`, an id given twice, and `ids` with
|
||||
no embedded image are errors. The Links
|
||||
panel menu's Unembed… with several embedded images selected asks for one folder and runs this form (on the web it
|
||||
downloads each image instead and links none).
|
||||
`links.placementOptions {ids?, preserve?: transforms|bounds|fileDimensions|fit|fill, align?: topLeft…bottomRight,
|
||||
clip?}` decides how a relinked or updated file takes an image's place (default `bounds`: stretched into the old
|
||||
bounds; `clip` puts it in a clip group of the old bounds when it is larger). The UI commands `links.editOriginal` and
|
||||
@@ -8436,6 +8764,7 @@ malformed `ids`, or nothing to copy is an error, and the clipboard is left as it
|
||||
{"name":"run_command","arguments":{"command":"links.list","params":{"show":"missing"}}}
|
||||
{"name":"run_command","arguments":{"command":"links.placementOptions","params":{"ids":[12],"preserve":"fit","align":"top"}}}
|
||||
{"name":"run_command","arguments":{"command":"links.unembed","params":{"id":14,"path":"/tmp/logo.png"}}}
|
||||
{"name":"run_command","arguments":{"command":"links.unembed","params":{"ids":[14,15],"folder":"/tmp/images"}}}
|
||||
```
|
||||
|
||||
## Package and Document Info
|
||||
@@ -8465,7 +8794,14 @@ file name, null for a built-in face; `embedding` is `allowed`, `editing`, `previ
|
||||
face is found), `imageObjects` (`[{name, width, height, linked, file}]`: the image objects in the order the
|
||||
linkedImages and embeddedImages categories list them, with the file a linked image's row shows and null for an
|
||||
embedded one), `document.unitId` (the document's units as Preferences › Units names them, such as `millimeters`, beside
|
||||
the English `document.units`), `brushNames` (the brushes the art's strokes use, each once, hidden strokes, strokes at an opacity of 0, strokes with no
|
||||
the English `document.units`), `document.transparency` (`{gridSize, gridColors, gridColorsName, simulatePaper,
|
||||
flattenerPreset}`: File › Document Setup's transparency settings, the grid's size (`small`, `medium` or `large`), its
|
||||
two colors as `#rrggbb`, their preset's name or `Custom`, Simulate Colored Paper and the flattener preset, which the
|
||||
document category lists as Grid Size, Grid Colors (two custom colors by their values), Simulate Colored Paper and
|
||||
Flattener Preset), `document.selectedArtboards` (`[{index, name, width, height, x, y}]`: while the Artboard tool is the
|
||||
current tool, the artboards it has selected, in artboard order and in the document's units, with `x` and `y` those of
|
||||
the top-left corner measured from the ruler origin of the tool's active artboard; the document category lists each
|
||||
after the artboards as Artboard, Width, Height, X and Y; empty with any other tool), `brushNames` (the brushes the art's strokes use, each once, hidden strokes, strokes at an opacity of 0, strokes with no
|
||||
paint or width, guides, paths with no segment, type that draws no characters, a group's or layer's own strokes, a compound path member's own strokes and an image's strokes without a
|
||||
shape left out; with `selectionOnly`, the brushes the selected
|
||||
objects' strokes use), `brushes` (`[{name, type}]`: those brushes with their types, `calligraphic`, `scatter`, `art`,
|
||||
@@ -8635,8 +8971,9 @@ Colorized grayscale and 1-bit images use their process or spot ink; the flattene
|
||||
|
||||
PostScript has no transparency: it is flattened first with `flattenerPreset` (`high`, `medium` (default), `low` or a
|
||||
saved preset, see `flattener.presets.list`) and `flattener: {…}` options over it (those of
|
||||
`object.flattenTransparency`); a warning says so. `previewFormat` adds a TIFF preview behind a binary header (`tiffColor`
|
||||
(default), transparent unless `transparentPreview: false`, or 1-bit `tiffBw`; `none` writes plain PostScript),
|
||||
`object.flattenTransparency`); a warning says so. EPS Options' Custom… button sets every `flattener` option.
|
||||
`previewFormat` adds a TIFF preview behind a binary header (`tiffColor` (default), transparent unless
|
||||
`transparentPreview: false`, or 1-bit `tiffBw`; `none` writes plain PostScript),
|
||||
`thumbnails` a PNG thumbnail in comments, and the native document always rides along in the trailer's comments (with
|
||||
linked images whole when `includeLinkedFiles`), so a later EPS import can reopen the file as it was. Export for
|
||||
Screens doesn't write EPS.
|
||||
@@ -8832,10 +9169,22 @@ starts a new point type object at the position the advance gives, and an underli
|
||||
of the last character's advance. Type on more than one line is placed a line at a time: each line is aligned by its own advances and
|
||||
split as a single line is. An EMF that
|
||||
draws with EMF+ records is read from them. Hatched and pattern brushes fill with their average color. Records VectorCraft doesn't read are skipped with one warning.
|
||||
Each of these adds one warning, with a count: a file, or a metafile image inside it, cut short by one of the reader's
|
||||
limits; images and pattern brushes whose bitmap can't be read, which are left out; clips that can't be applied as the
|
||||
file sets them; and raster operations other than a plain copy, drawn as a plain copy or left out.
|
||||
`clipboard.importEmf {dataBase64, center?}` loads an EMF or WMF picture into the clipboard for `edit.paste`; the app
|
||||
pastes `image/emf` from the system clipboard ahead of text and bitmaps when the platform's clipboard service offers it
|
||||
(the Windows desktop service doesn't read metafiles yet).
|
||||
|
||||
The type size comes from the font's height. A negative height is the em. A positive height is the character cell, and
|
||||
the em is the cell times the face's units per em divided by its OS/2 `usWinAscent` plus `usWinDescent`, with a
|
||||
variable font's `MVAR` changes at the face's instance (its ascent plus descent when it has no OS/2 table). When the face gives an average width (OS/2 `xAvgCharWidth`), a font's average
|
||||
character width, negative or positive, becomes Horizontal Scale: the face's average width at the type size is
|
||||
stretched or narrowed to the font's width. VectorCraft's own rules are that a negative width is read as its absolute
|
||||
value and that the width is ignored when the height is 0. For a font the system doesn't have, both values are measured
|
||||
in the face that replaces it. Characters that face has no glyph for are drawn from other faces at the same size and
|
||||
Horizontal Scale.
|
||||
|
||||
```json
|
||||
{"name":"export","arguments":{"path":"/tmp/logo.emf"}}
|
||||
{"name":"run_command","arguments":{"command":"document.export","params":{"format":"wmf","useArtboards":true,"path":"/tmp/icons.wmf"}}}
|
||||
@@ -9077,13 +9426,28 @@ default), `usdz`, `gltf` or `obj`; the panel shows a Format row for the 3D asset
|
||||
`assets.set3DFormat {assets, format}` sets it (an undo step only when the format changes). `assets.list` gives each
|
||||
asset's `format3D` (null for a picture asset).
|
||||
|
||||
`assets.export3D {assets?, folder?, zip?}` writes each 3D asset (default: all of them) as a mesh file named after it:
|
||||
`assets.export3D {assets?, folder?, zip?, textureSize?}` writes each 3D asset (default: all of them) as a mesh file named after it:
|
||||
`.usda`, `.usdz`, `.gltf` (glTF 2.0, its buffer embedded) or `.obj` with its `.mtl` (whitespace and `#` in an OBJ's
|
||||
name become `_`). Every solid of the object (the
|
||||
fill's, each stroke's, a group's members') is its own mesh, with a two-sided material in the color it is painted
|
||||
(a gradient's stops averaged, a pattern gray). The mesh holds the solid's faces before they are projected onto the
|
||||
page, those turned away from the viewer included, at the object's 3D rotation, y up, about the point the object turns
|
||||
about: in points (USD's layer gives `metersPerUnit`), in meters in glTF. Files that would share a name get `-2`, `-3` and so on.
|
||||
Graphics mapped onto a plane or onto Extrude & Bevel's front or back cap (`threeD.mapGraphic`) are exported as a PNG
|
||||
texture of that face: the face's color with its graphics drawn over it, flat and unlit, on a mesh of the face's own
|
||||
triangles with texture coordinates and a material that shows the texture. A face that is not opaque keeps its opacity
|
||||
in the texture's alpha: as on the canvas, the graphics take the opacity of the face's fill or stroke, and the object's
|
||||
opacity applies to the face and its graphics together. glTF embeds the PNG as a data URI
|
||||
(`TEXCOORD_0`, `baseColorTexture`), USDZ stores it after the layer, USDA reads it through `primvars:st`, a
|
||||
`UsdPrimvarReader_float2` and a `UsdUVTexture` connected to the surface's `diffuseColor`, and OBJ gives `vt` coordinates
|
||||
and an MTL `map_Kd`; OBJ and USDA write the PNG beside them as `<name>-texture-1.png`, `-texture-2.png` and so on
|
||||
(whitespace, `#` and `@` become `_`). USD reads a face's opacity from the texture's alpha (`outputs:a`), and an OBJ
|
||||
whose face is not opaque also gets `<name>-texture-1-opacity.png`, the alpha as gray levels, for the MTL's `map_d`.
|
||||
Faces with the same color, graphics and bounds share one texture. `textureSize` (128 to
|
||||
4096, default 1024, VectorCraft's own values) is the number of pixels along the longer side of each texture; one export
|
||||
draws at most 67,108,864 texture pixels in all, and past that it is refused. Graphics on Revolve's side are not
|
||||
exported yet. The layouts follow glTF 2.0, UsdPreviewSurface (<https://openusd.org/release/spec_usdpreviewsurface.html>)
|
||||
and OBJ/MTL (<https://www.loc.gov/preservation/digital/formats/fdd/fdd000508.shtml>).
|
||||
With `zip`, the files go into one ZIP named after the document with `-3D` added (`Untitled-1-3D.zip`), or
|
||||
`3D Assets.zip` when the document's title gives no file name.
|
||||
An object whose face has a hole that crosses the face's outline or another hole is refused, by `assets.add3D` and
|
||||
@@ -9465,7 +9829,11 @@ stay square to it, as in the reference app. `object.distort` turns it as the war
|
||||
(see Free Distort on a turned bounding box). `object.rotate {angle, absolute: true}` turns the selection to an angle
|
||||
(the Transform and Properties panels' Rotate field), and `object.setBounds` measures width, height and the reference
|
||||
point along the turned box (x, y stay page coordinates). Objects turned together share the box. A new group starts
|
||||
square to the page. `object.resetBoundingBox` squares the box again without moving the art. It also squares every
|
||||
square to the page. `object.rotateBoundingBox {angle}` turns the selection's box by `angle` without moving the art
|
||||
(`absolute: true` turns it to `angle`; the menu's Rotate Bounding Box… asks for the angle). Selected objects with
|
||||
different angles get one shared angle, and the objects inside them keep their angle relative to them. A path of a
|
||||
compound path selected on its own turns or squares only its own box. A box already at the angle adds no undo step.
|
||||
`object.resetBoundingBox` squares the box again without moving the art. It also squares every
|
||||
object inside the selected ones: the children of groups, compound paths, clip groups, blends, envelopes, repeats and
|
||||
intertwines, and the art of linked opacity masks (an unlinked mask's art keeps its angle). Ungroup, Release Clipping
|
||||
Mask, Release Compound Path, Blend Expand, Release Envelope, Release Repeat, Release Intertwine and Release Opacity Mask
|
||||
@@ -9566,6 +9934,23 @@ Native files save it only when it is `rows`, so files from before it open by col
|
||||
{"name":"run_command","arguments":{"command":"text.areaOptions","params":{"rows":2,"columns":3,"flow":"rows"}}}
|
||||
```
|
||||
|
||||
### First baseline
|
||||
|
||||
`text.areaOptions {firstBaseline: ascent|capHeight|xHeight|leading|emBoxHeight|fixed, firstBaselineMin?: pt}` (Area
|
||||
Type Options › First Baseline and Min) sets how far below the top of the type area, inside the inset, the first line
|
||||
of each row/column cell sits. `emBoxHeight` (Em Box Height) puts the top of the line's ideographic em box at that
|
||||
top; on a line of several sizes the largest em box is used, and vertical type measures it from the frame's right
|
||||
edge. The em box is the one leading measured from em box top to top uses: an ideograph's cell in the font's
|
||||
vertical metrics, or 0.88 em above the baseline when the font has none (VectorCraft's own rule). With every kind but
|
||||
`fixed`, `firstBaselineMin` is the least distance from the top to the first baseline; with `fixed` it is the
|
||||
distance. Each threaded frame keeps its own setting. Native files and `.ai` files save `emBoxHeight` and open it again; other values are refused. The help
|
||||
page describes the option:
|
||||
https://helpx.adobe.com/illustrator/desktop/design-with-text/add-manage-text/add-margins-to-text-and-adjust-the-first-baseline.html
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"text.areaOptions","params":{"firstBaseline":"emBoxHeight","firstBaselineMin":6}}}
|
||||
```
|
||||
|
||||
## Fitting area type: Auto Size, Shrink Text to Fit, overflow
|
||||
|
||||
`text.areaOptions` (and `text.create`'s `area`, `text.createInPath` in area mode) take a `fit`:
|
||||
@@ -9771,6 +10156,20 @@ on again.
|
||||
{"name":"run_command","arguments":{"command":"type.convertToAreaType","params":{"ids":[42]}}}
|
||||
```
|
||||
|
||||
## Insert Special, Whitespace and Break Characters
|
||||
|
||||
`type.insert {char?, text?, code?, unicode?, ids?|id?}` inserts one character (`char` names it, `code` and `unicode` give
|
||||
its code) or the string `text`. While the Type tool edits text and neither `ids` nor `id` is given, it replaces the
|
||||
tool's selection, or inserts at its caret, and the caret goes after the insertion; otherwise it appends to the end of each
|
||||
selected text object. Each call is one undo step; an empty `text` at the Type tool's caret changes nothing and records no undo step.
|
||||
`char: "forcedLineBreak"` (Type › Insert Break Character › Forced Line Break) inserts U+2028, which starts a new line in
|
||||
the same paragraph, as Shift+Enter does; `char: "paragraphReturn"` inserts a line feed, which starts a new paragraph. A
|
||||
`text` that holds U+2028 inserts the same break.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"type.insert","params":{"char":"forcedLineBreak"}}}
|
||||
```
|
||||
|
||||
## Smart Punctuation
|
||||
|
||||
`type.smartPunctuation` replaces keyboard characters in the selected type, or in every text object with `scope:
|
||||
@@ -10423,6 +10822,25 @@ after Remove Threading or Release Selection, in a frame converted to point type,
|
||||
duplicated, copied in the Layers panel, or taken out of a symbol or a placed file). A symbol made of a thread keeps the
|
||||
numbers in the symbol's art.
|
||||
|
||||
`text.setFormat {startNumber: 1..999999999}` gives a numbered paragraph a number of its own, and
|
||||
`text.setFormat {restartNumbering: true}` gives it 1. Both are VectorCraft's own. The number goes to the first numbered
|
||||
paragraph the call touches: the first that holds text, or the first when none does, taking the type objects in the
|
||||
order of `ids`. A threaded frame's first paragraph is passed over when it continues from the frame before. The
|
||||
paragraph given the number shows it, and the numbered paragraphs after it at its level count on from it,
|
||||
through the frames of threaded type. Deeper levels count from 1 after it, as after any list paragraph, and a paragraph in
|
||||
no list still starts the count again. `restartNumbering: false` takes the number away from every paragraph the call
|
||||
touches except such a continued first paragraph, and they count on from the paragraph before. `startNumber` is a whole number (`5` or `5.0`); 0, a negative
|
||||
number, a fraction, a number past 999999999 and any other type are errors, and giving both keys is an error. A call
|
||||
that touches no numbered paragraph, or that gives the number the paragraph already has, changes nothing and records no
|
||||
undo step. A call that also puts paragraphs in a numbered list gives the number after the list is set. Return in a
|
||||
paragraph with a number of its own does not give the number to the new paragraph; Return, or pasted text that starts
|
||||
new paragraphs, at the start of its text moves the number with the text. Making the paragraph bulleted or taking it out of its list removes the number, and Convert to
|
||||
Text writes the numbers the paragraphs showed. The list saves the number (`"start": 5`) only when it is set; a file's
|
||||
number below 1 or past 999999999 opens as the nearest of them. A paragraph style made from the paragraph does not keep
|
||||
the number, and a paragraph style's `list` with a `start` is an error (`unknown attribute`). A graph keeps one paragraph
|
||||
style for every label of a kind, so a graph label loses its number when the graph is drawn again. The canvas and the formats
|
||||
that write the marker (below) write the number the paragraph shows.
|
||||
|
||||
The canvas, EPS, PDF and Type › Create Outlines draw the marker. PDF writes the marker as text of its own, where the
|
||||
canvas draws it, and a PDF viewer selects, copies and finds its characters. Each of its glyphs stands for the marker
|
||||
character that the glyph's font maps to that glyph in its character map. Glyphs that an OpenType feature such as
|
||||
@@ -10443,11 +10861,14 @@ More Options at the end of the Paragraph panel's Bullets and Numbered List prese
|
||||
dialog (`bulletsAndNumbering`) on the paragraphs the Paragraph panel acts on, on that tab; without `tab` it opens on
|
||||
Numbers when the paragraphs are a numbered list and on Bullets otherwise. On both tabs the Level field, above the
|
||||
presets, holds the paragraphs' list level (1 to 9; 1 for paragraphs in no list). The Bullets tab has the five bullet
|
||||
presets and the Numbers tab has None and the seven number styles. The Position group has Alignment (Left or Right),
|
||||
presets and the Numbers tab has None and the seven number styles, then Start at, a box with a number from 1 to
|
||||
999999999 (1 until one is typed). The box is on when the paragraphs have the same number of their own, off when none
|
||||
has one, and blank when they differ; on, OK sends `startNumber` with the number, and off, it sends
|
||||
`restartNumbering: false`, unless a preset makes the paragraphs bulleted or takes them out of their list. The Position group has Alignment (Left or Right),
|
||||
Left Indent and First Line Indent. The dialog opens with the values the Paragraph panel shows; where the paragraphs
|
||||
differ, no preset is picked and the field is blank. Its fields are `tab`, `list` (`none`, `bullet` or `number`: the
|
||||
kind of the preset picked), `bullet`, `number`, `listAlign`, `listLevel`, `leftIndent` and `firstLineIndent` (points),
|
||||
and `ui.dialog.set` sets them, including those the dialog opened blank or without. The type shows the dialog's values while it is open. A preset picked for paragraphs that are in no list and have
|
||||
`startAt` (true or false) and `startNumber`, and `ui.dialog.set` sets them, including those the dialog opened blank or without. The type shows the dialog's values while it is open. A preset picked for paragraphs that are in no list and have
|
||||
no indents fills in 18 pt and -18 pt, and None takes them out again while they are unchanged. OK runs `text.setFormat`
|
||||
with the values that changed, as one undo step, and Cancel puts the type back as it was. When a preset puts the
|
||||
paragraphs in a list, OK also sends the indents the dialog shows, and the paragraphs take them, 0 included. OK does not
|
||||
@@ -10508,6 +10929,8 @@ the paragraph's text now starts; when the text before `at` starts no list, nothi
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"number":"upperRoman"}}}
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"listAlign":"right"}}}
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"listLevel":2,"start":4,"end":4}}}
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"startNumber":5,"start":4,"end":4}}}
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"restartNumbering":true,"start":12,"end":12}}}
|
||||
{"name":"invoke_menu","arguments":{"command":"ui.bulletsAndNumbering","params":{"tab":"numbers"}}}
|
||||
{"name":"run_command","arguments":{"command":"text.convertListToText","params":{}}}
|
||||
```
|
||||
@@ -11935,7 +12358,9 @@ EPS files hold its drawn steps, as they do for every blend:
|
||||
|
||||
With the Blend tool active, `tool.select {tool: "blend"}` finishes the blend, as a click on the tool's button or W
|
||||
does: it drops the object clicked first and stops the next click adding to the blend just made. The document and the
|
||||
selection stay as they are. Choosing any other tool that is already active leaves its work as it is.
|
||||
selection stay as they are. With the Pen active, `tool.select {tool: "pen"}` ends the path being drawn as Escape does,
|
||||
and so do P and a click on the Pen's button: the path stays open and selected (a path inside a compound path leaves
|
||||
the compound path selected), and the next click starts a new path. Choosing any other tool that is already active leaves its work as it is.
|
||||
|
||||
A blend's spine is the straight lines between its key centres until it is edited. `object.blend.info` lists it
|
||||
(`spine.anchors`, `keyAnchors`: the point each key sits on). `object.blend.spine.addAnchor {x, y}` adds a point where
|
||||
@@ -12203,7 +12628,12 @@ away); its click on a gradient mesh's line picks the line's two
|
||||
ends, and a click inside a patch picks the four points around it. The picked points show filled. Dragging one of them
|
||||
moves them all as one undo step (`object.mesh.movePoints`), a click on one of several picked points picks it alone,
|
||||
and the arrow keys nudge them by the keyboard increment. The active tool lists them in its options
|
||||
(`tool.setOption {}` returns them as `meshPoints: [{id, index}…]`). On gradient meshes a solid fill colour (`paint.setFill`, from the
|
||||
(`tool.setOption {}` returns them as `meshPoints: [{id, index}…]`). Switching to the Eyedropper keeps them picked, its
|
||||
options list them too, and the Mesh tool, Direct Selection or a Lasso chosen next picks them again. While a selected, editable mesh has
|
||||
points picked, an Eyedropper click or Shift-click on an image or other art samples the color under the pointer into
|
||||
those points alone as `paint.sampleColor {color, stroke: false, ids}` with the meshes that have points picked: one undo
|
||||
step, none when the color is unchanged. Other selected objects keep their paint. A click on one of those meshes, and
|
||||
Alt-click and Shift+Alt-click anywhere, are unchanged. On gradient meshes a solid fill colour (`paint.setFill`, from the
|
||||
Color panel, Swatches or the Eyedropper) recolours just the picked points, and when every target of
|
||||
`transparency.set` is a gradient mesh with points picked, its `opacity` fades those points instead of the objects
|
||||
(`transparency.info` then shows their opacity, `null` when it differs). Both are one undo step, and neither goes to the
|
||||
@@ -12213,6 +12643,16 @@ picked point's color, and `fillMixed` compares the picked points' colors with ea
|
||||
selected objects. The Transparency panel shows the picked points' opacity (blank when it differs), and the Control
|
||||
bar shows the first picked point's opacity.
|
||||
|
||||
A solid color dragged from the Color or Swatches panel or a Fill proxy and dropped on a selected gradient mesh, while the
|
||||
Fill proxy is active, recolors the mesh point under the pointer (within 5 screen pixels), else the four points around the
|
||||
patch there, as `object.mesh.setPointColor {id, points, color, keepModel: true}`. With a gradient mesh selected and a
|
||||
solid fill color set, a plain Eyedropper click does the same with the fill color: on a point of any selected mesh, or
|
||||
inside a patch of the selected mesh the click hits. A gradient, a pattern, a fill of None, a stroke proxy or a mesh that
|
||||
is not selected keeps the earlier behavior (the whole object takes the paint, and the Eyedropper copies the appearance),
|
||||
and so does an unselected object on top of the mesh at that place.
|
||||
See [Edit mesh objects](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=312);
|
||||
the 5-pixel reach is VectorCraft's own.
|
||||
|
||||
`object.mesh.movePoints {id, points: [index…], dx, dy}` (or `{items: [{id, points}…], dx, dy}` over several meshes)
|
||||
moves points by (dx, dy), their handles with them; `object.mesh.setPointColor` takes `points` or `items` the same
|
||||
way to colour or fade several points at once. An index out of range, an index that is not a whole number ≥ 0, or a
|
||||
@@ -12520,8 +12960,9 @@ Commands:
|
||||
- `addon.pathtools.crossings {cut?, selfCrossings?, ids?}` adds anchors where the selected paths cross one another (and
|
||||
where each crosses itself, with `selfCrossings`), or with `cut` also cuts them there: a path of one subpath becomes a
|
||||
path per piece. Segments that meet at an anchor they share, or with only segments of no length between them, don't
|
||||
cross there, and they cross where they meet again elsewhere. With `selfCrossings`, a curved segment that loops over
|
||||
itself crosses itself. At most 10,000 segments at once.
|
||||
cross there, and they cross where they meet again elsewhere. An open end of a path that lies within 0.001 pt of
|
||||
another path crosses it there. With `selfCrossings`, a curved segment that loops over itself crosses itself. At most
|
||||
10,000 segments at once.
|
||||
- `addon.pathtools.divideDashes {dash?, gap?, fit?, removeGaps?}` cuts the selected paths into separate open paths
|
||||
along the curve, each `dash` long (0.01 to 1,000,000 pt, 10 by default) with `gap` between them (0 to 1,000,000 pt,
|
||||
0 by default: the pieces touch), every piece keeping the path's appearance, as one undo step. The gap pieces are left
|
||||
@@ -12603,7 +13044,7 @@ Commands:
|
||||
Every path that can be edited takes part, selected or not, compound path members included. Hidden and locked paths,
|
||||
guides and clipping paths are not trimmed and do not count as crossing, the members of a compound clipping path
|
||||
included; type, images and symbol instances take no part. In isolation mode only paths inside the isolated object
|
||||
are trimmed, and paths outside it still count as crossing. A path that ends on another marks a place on the other. Paths that lie along each other do not cross there.
|
||||
are trimmed, and paths outside it still count as crossing. A path that ends on another, or within 0.001 pt of it, marks a place on the other. Paths that lie along each other do not cross there.
|
||||
Crossings are found on the paths' own outlines, without strokes, brushes or effects. A closed path that loses a
|
||||
stretch becomes open. An open path that loses a middle stretch becomes two paths with its appearance, in its place in
|
||||
the stacking order. A path that nothing crosses is removed whole, a compound path that loses its last member is
|
||||
@@ -13523,6 +13964,45 @@ Path Options' Preview does (#5360).
|
||||
{"name":"run_command","arguments":{"command":"addon.type.releasePath","params":{"mode":"path","keepOriginal":true}}}
|
||||
```
|
||||
|
||||
## Unit Converter add-on
|
||||
|
||||
Unit Converter is a built-in add-on that shows one length in every unit at once (#5528): its commands are
|
||||
`addon.units.convert` and `addon.units.selectionSize`, and in the desktop app it lives in Object › Plug-ins › Unit
|
||||
Converter and in its panel (`window.panel {panel: "unitConverter"}`). Neither command changes the document.
|
||||
|
||||
`addon.units.convert {value, unit?}` reads `value` as a number field reads it: a number, or text with a unit suffix and
|
||||
`+ - * /` arithmetic (`"10mm"`, `"1in/2"`, `"2p6"`, `"1080/2 px"`, `"3cm*50%"`, `"13q"`), a decimal comma read as a point
|
||||
(`"0,5 mm"`) and a single number with a thousands comma (`"1,000 mm"`) refused, in at most 1024 bytes with at most 128 `+ - * /` signs. A
|
||||
number without a suffix is in `unit` (a unit's name, suffix or key: `points`, `picas`, `inches`, `millimeters`,
|
||||
`centimeters`, `pixels`, `feetInches`, `meters`, `yards`, `feet`, `q`, `ha`; default `points`); a suffix in the text
|
||||
takes precedence over `unit`. It works without an open document. The command fails when `value` is missing, does not
|
||||
read, or is not finite in every unit, and when `unit` is not a unit. Result: `{points, units: [{unit, label, number,
|
||||
text}]}`: the length in points, then one row per unit of Preferences › Units › East Asian Type (pt, picas, in, mm, cm,
|
||||
px, ft & in, m, yd, ft, Q, Ha) in that order, with the unit's key, its label, the number without its suffix and the
|
||||
text with it, rounded as the number fields round them (3 decimals in pt, px, picas, Q and Ha, 4 in the others). Pixels
|
||||
are points.
|
||||
|
||||
`addon.units.selectionSize {}` gives the selection's width and height as the Transform panel shows them: the bounding
|
||||
box (rotated with rotated objects), the visual bounds with Use Preview Bounds, or the box around the selected anchor
|
||||
points with Direct Selection. It fails with nothing selected. Result: `{width, height}`, each as
|
||||
`addon.units.convert` gives a length.
|
||||
|
||||
The panel has one field per unit. A value typed in any field updates the others as it is typed, and text that does not
|
||||
read leaves them as they were. Each field's copy button puts its value on the clipboard, with the unit when Copy with
|
||||
Units is on. From Selection reads the selection's size (`addon.units.selectionSize`), and Width or Height picks which
|
||||
of the two the fields show; the size read is dropped when the document, its selection, Use Preview Bounds or Measure
|
||||
Type by Glyph Bounds changes, and the fields keep the length they show. Apply sets that side of the selection to the length with `object.setBounds`, as the Transform
|
||||
panel's W or H field does: from its reference point (a symbol instance's registration point with Use Registration Point
|
||||
for Symbol on), with the other side scaled too under Constrain Width and Height Proportions, and with the panel menu's
|
||||
Transform Object Only, Transform Pattern Only or Transform Both. It is one undo step, and none when the size is already
|
||||
that length.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"addon.units.convert","params":{"value":"10mm"}}}
|
||||
{"name":"run_command","arguments":{"command":"addon.units.convert","params":{"value":2.5,"unit":"in"}}}
|
||||
{"name":"run_command","arguments":{"command":"addon.units.selectionSize","params":{}}}
|
||||
```
|
||||
|
||||
## Save location errors
|
||||
|
||||
A save refused by the filesystem with PermissionDenied or ReadOnlyFilesystem returns
|
||||
|
||||
+3
-2
@@ -37,8 +37,9 @@ Window → Help Bar toggles the bottom tool-help strip independently of the stat
|
||||
**Feature evidence last updated:** 2026-11-03.
|
||||
|
||||
M1 selection: Enclosing Lasso selects whole objects enclosed by a freehand loop. It is an add-on
|
||||
under Object › Plug-ins and has its own heading in All Tools. It has no default shortcut or Basic
|
||||
toolbar slot. Shift adds and Alt subtracts enclosed objects; Escape cancels the loop.
|
||||
under Object › Plug-ins, and its tool is also in the Lasso tool's group in both shipped toolbars,
|
||||
after the Lasso. It has no default shortcut. Shift adds and Alt subtracts enclosed objects; Escape
|
||||
cancels the loop.
|
||||
This is a VectorCraft addition; milestone estimates and parity scores are unchanged.
|
||||
|
||||
The shared assessment status line and revision history are current upstream; this dated section records the submission's feature evidence and revisions without rescoring upstream or claiming a new combined build or runtime measurement.
|
||||
|
||||
+67
-13
File diff suppressed because one or more lines are too long
+3
-3
@@ -26,7 +26,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| Point, area and type-on-a-path type; vertical variants | done / partial | vertical point, area and path type have initial support; fullwidth `!` / `?` keep the nominal glyph upright when no vertical alternate exists (Unicode Tu); in a non-rectangular area a word too wide for the top lines moves down to the first line that holds it (#1615); Escape while typing ends the edit, keeps the type selected and switches back to the tool whose double-click on type chose the Type tool (kept until another tool is chosen or another document or window becomes active, so later edits with the Type tool return there too), or to the Selection tool when there is no such tool, as when the Type tool was chosen from the toolbar or after such a switch (#1802), and Cmd+Enter (Ctrl+Enter on Windows and Linux) does the same unless a command is bound to it; `text.create` and `text.createInPath` take `justify` (#1752); MCP `add_text` forwards `vertical` to both commands; Type › Type Orientation sets every frame of a thread, and a thread's frames share one writing direction; the Type and Vertical Type tools make area type when a closed path's outline is clicked and type on a path when an open one is, with pointers that say which, as the public help describes ([Create text](https://web.archive.org/web/20220127090642/https://helpx.adobe.com/illustrator/using/creating-text.html), [Create type on a path](https://web.archive.org/web/20220127090635/https://helpx.adobe.com/illustrator/using/creating-type-path.html)) |
|
||||
| Area Type Options (rows, columns, inset, first baseline, Text Flow by rows or by columns, Auto Size, Shrink Text to Fit) | done | Text Flow fills the cells down each column first (By Columns, the default, as files from before it open) or across each row first (By Rows), in the dialog and `text.areaOptions {flow}` (#4978); the commands that make or restyle type say when it does not fit its frame; MCP `add_text` takes Auto Size and Shrink Text to Fit (#1471) |
|
||||
| Threaded text, Fit Headline, Text Wrap | done | Fit Headline sees wrapping in a frame one line tall (#1444); a thread holds area type and type on a path in any mix, as Illustrator links type in an area or along a path ([help](https://helpx.adobe.com/illustrator/using/manage-text-area.html)); a frame's empty last paragraph keeps a format given to it when the story flows again |
|
||||
| Threading from the ports: selected area type and type on a path show an in port and an out port, empty, with an arrow on a side where the frame is threaded, or with a red "+" in the out port when the text doesn't fit; a click on either port loads the text; a click on a closed path, area type or type on a path threads into it, a click on empty canvas makes a frame of the same kind, shape and size there, a drag draws a rectangular frame; the frame placed comes after the clicked one from its out port and before it from its in port (the story then starts there); Escape or another tool cancels; a double-click on a threaded port breaks the thread there | partial | #2572: the Selection tool, `text.thread.add {from, to?, rect?, at?, before?}`, as the reference app's help describes ports and threading ([archived help, Threading text between objects](https://web.archive.org/web/20210119051048/https://helpx.adobe.com/illustrator/using/creating-text.html), [create text threads](https://helpx.adobe.com/illustrator/desktop/design-with-text/add-manage-text/create-text-threads-between-objects.html)); area type's in port sits on the left side below the top-left corner, type on a path's just before its start bracket; Show Text Threads draws its lines between the same ports; with more than 1,000 such objects selected no ports are drawn. a double-click on a port where the frame is threaded breaks the thread there, the story flowing into the frames before the break and the frames after it left empty, still threaded with each other when two or more (`text.thread.break`, [archived help](https://web.archive.org/web/20220127090642/https://helpx.adobe.com/illustrator/using/creating-text.html)). Remaining: the ports only take clicks with the Selection tool, and the loaded cursor borrows the I-beam until it's drawn |
|
||||
| Threading from the ports: selected area type and type on a path show an in port and an out port, empty, with an arrow on a side where the frame is threaded, or with a red "+" in the out port when the text doesn't fit; a click on either port loads the text; a click on a closed path, area type or type on a path threads into it, a click on empty canvas makes a frame of the same kind, shape and size there, a drag draws a rectangular frame; the frame placed comes after the clicked one from its out port and before it from its in port (the story then starts there); Escape or another tool cancels; a double-click on a threaded port breaks the thread there | partial | #2572: the Selection tool, `text.thread.add {from, to?, rect?, at?, before?}`, as the reference app's help describes ports and threading ([archived help, Threading text between objects](https://web.archive.org/web/20210119051048/https://helpx.adobe.com/illustrator/using/creating-text.html), [create text threads](https://helpx.adobe.com/illustrator/desktop/design-with-text/add-manage-text/create-text-threads-between-objects.html)); area type's in port sits on the left side below the top-left corner, type on a path's just before its start bracket; Show Text Threads draws its lines between the same ports; with more than 1,000 such objects selected no ports are drawn. a double-click on a port where the frame is threaded breaks the thread there, the story flowing into the frames before the break and the frames after it left empty, still threaded with each other when two or more (`text.thread.break`, [archived help](https://web.archive.org/web/20220127090642/https://helpx.adobe.com/illustrator/using/creating-text.html)). The loaded text has a cursor of its own; over a closed path, area type or type on a path that a click threads it into the pointer adds a link badge, as the [archived help on threading text between objects](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=476) describes the pointer changing over the object's path. The frame the text came from, a frame already in a thread, a path inside a compound path and other art show no badge, and a click there makes a new frame (`select::tests::loaded_text_shows_the_link_cursor_where_a_click_threads_it_into_the_object`). Remaining: the ports only take clicks with the Selection tool |
|
||||
| Type on a Path effects and options; brackets | done | #429; Type on a Path Options has a Preview checkbox (#5360, as public tutorials of the dialog show); Direct Selection shows the anchors and direction handles of selected type on a path's path and drags both, the brackets keeping their fractions of the path and the text reflowing along it (#3980, #3565; `text.reshapePath`, `text.setPathHandle`), as the [Direct Selection page](https://helpx.adobe.com/illustrator/using/tool-techniques/direct-selection-tool.html) describes for a path; Type › Dynamic Text (`type.dynamicText`, also on the Contextual Task Bar) sizes type on a path to fill the span between its brackets and fits it again after each edit, as the [Dynamic Text overview](https://helpx.adobe.com/photoshop/desktop/text-typography/work-with-dynamic-text/dynamic-text-overview.html) describes; the 0.1 pt steps, the 0.1 to 1,296 pt range and keeping the drawn sizes when it is turned off or threaded are VectorCraft's own rules (`crates/text/src/tests/fit.rs`, `crates/engine/src/tests/dynamic_text.rs`) |
|
||||
| Character and Paragraph panels, styles with overrides | done | Character-style Auto-leading resets, partial definitions, local leading overrides, override markers, Undo/Redo and native serialization have regression coverage; differing paragraph alignments leave the shared alignment buttons unselected (headless regressions, full integration CI and visual review pass); mixed-value display for other paragraph fields remains missing. Double-clicking a user character style's row opens its Character Style Options, and the dialog keeps a fixed width while its sections scroll when the window is shorter, so its buttons stay on screen; a paragraph style's row opens the same Paragraph Style Options dialog as the panel menu, with General, Basic Paragraph Formats, Tabs, Composition, Hyphenation, Justification and East Asian Composition Settings. Evidence: `panels::text_styles::tests::double_clicking_a_character_style_row_opens_its_options`, `dialogs::char_style_options::tests::the_sections_scroll_in_a_window_shorter_than_the_general_list`, `dialogs::para_style_options::tests::every_section_draws_its_fields`, `dialogs::para_style_options::tests::tabs_section_edits_the_style_stops` |
|
||||
| Copy or Cut selected characters, then paste as separate text art | done | A Type-range copy keeps the selected characters' font family, size and color when pasted on the canvas after leaving text editing, in the same document or another. On desktop the clipboard offers plain text to text consumers and rich art for canvas Paste; Paste Without Formatting while editing uses the destination text's style. `tests::clipboard::type_range_copy_stays_styled_when_pasted_as_art` (#5636) |
|
||||
@@ -50,7 +50,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| Roman Hanging Punctuation | done | Paragraph panel menu › Roman Hanging Punctuation, `text.setFormat {romanHangingPunctuation}` (#2756): per paragraph, Optical Margin Alignment's punctuation and amounts without the letters; paragraph styles carry it. Evidence: `tests::roman_hanging_punctuation_hangs_punctuation_but_not_letters`, `typecmd::area_tests::roman_hanging_punctuation_is_set_per_paragraph_and_saved_only_when_on` |
|
||||
| Hyphenation… and Justification… options | done | Eleven Indian languages use attributed patterns and preserve syllables in both composers (#4947). Hyphenation… (`ui.hyphenation`, `text.setFormat`) sets each paragraph's Words Longer Than, After First, Before Last, Hyphen Limit, Hyphenation Zone (Single-line Composer only) and Hyphenate Capitalized Words, and paragraph styles carry them (#2310). Justification… (`ui.justification`, `text.setFormat`, #2755) sets Word Spacing, Letter Spacing and Glyph Scaling (Minimum, Desired, Maximum), Auto Leading and Single Word Justification; Desired applies to every line, justified lines and the Every-line Composer use the ranges. Vertical type isn't glyph scaled. Auto Leading also sets the Leading the Character panel shows for Auto type, the leading Alt+↑/↓ (`type.step`) steps from, per paragraph, and the lines Fill with Placeholder Text counts. Evidence: `crates/text/src/tests/justify.rs`, `dialogs::justification::tests`, `tests_prefs::auto_leading_steps_and_fills_from_the_paragraph_auto_leading`, `panels::character` test `leading_field_shows_the_paragraph_auto_leading` |
|
||||
| Tab stops and leaders; Tabs panel | partial | Tabs panel and stops with leaders in the model (`text.tabs.set`); a stop drags from where the press landed (#1458); leaders fill the tab's gap, repeated on a grid so they line up from line to line (#1877); Ctrl-dragging a stop (Command on macOS) moves all the stops together; in right-aligned area type the text before a line's last tab sits at its stops, from the left edge, and the text after it against the right edge, as Illustrator's own layout in a user's `.ai` sets a price list (evidence: `tests::right_aligned_area_type_sets_the_text_after_its_last_tab_against_the_edge`; centred lines are still aligned as a whole); in justified area type the text up to a line's last tab keeps its spacing and its tabs their stops, and the text after the last tab takes the line's room to the far edge, VectorCraft's own rule (evidence: `tests::justify::a_justified_line_with_a_tab_spreads_the_text_after_it_to_the_edge` and the other tab tests in `crates/text/src/tests/justify.rs`) |
|
||||
| Hidden characters (Show Hidden Characters) | done | `type.hiddenCharacters` |
|
||||
| Hidden characters (Show Hidden Characters) | done | `type.hiddenCharacters`: marks spaces, tabs, nonbreaking and narrow nonbreaking spaces, the spaces of a set width, discretionary hyphens, forced line breaks, paragraph ends and the story's end, in horizontal, vertical and right-to-left type and on a path; the mark shapes are VectorCraft's own. Evidence: `canvas::tests::hidden_characters_*` |
|
||||
| Spell check (Check Spelling, Auto Spell Check, custom dictionary) | done | the engine (#4936): `text.spelling.check` lists the unknown words of the document's type, each run in its Language, at the bytes `text.editRange` changes, and `text.spelling.suggest` gives suggestions, both from craft-proof, each paragraph on its own (English from the first dictionary it finds: a Hunspell dictionary in the user's dictionaries folder, the SCOWL dictionary built in from craft-i18n, a system Hunspell dictionary, and last the public-domain Moby word list built into it; other languages from the dictionaries craft-proof finds for them). The custom dictionary commands are done: `text.spelling.addWord`, `removeWord` and `changeWord` (Add, and Edit Custom Dictionary's Add, Delete and Change), and `text.spelling.dictionary` lists the words, saved to `Custom Dictionary.txt` beside the preferences; Ignore All: `text.spelling.ignoreAll` skips a word in the active document while it is open. Auto Spell Check is done: Edit › Spelling › Auto Spell Check (`edit.autoSpellCheck`, off at first, saved with the view settings) draws a red wavy line under the unknown words of the visible type, leaves out type with effects, and follows edits, the custom dictionary and Ignore All. A right-click on an underlined word lists the words its dictionary suggests (each replaces it in one undo step, `text.editRange`), or No Suggestions, then Ignore All and Add to Dictionary, and a right-click on type has Spelling › Auto Spell Check, checked while it is on. Edit › Edit Custom Dictionary… lists the custom dictionary's words, with an Entry field and Add, Delete and Change, applied on Done (Cancel leaves the dictionary as it was). The modal Check Spelling dialog is done: Edit › Spelling › Check Spelling… (`Cmd+I`, `ui.checkSpelling`) opens a modal dialog displaying the unrecognized word in sentence context ("Not in Dictionary"), a list of suggestions with double-click or selection to replace ("Change to" field), and action buttons: Ignore, Ignore All, Change (one-step Undo/Redo via `text.editRange`), Change All (batched across occurrences in a single undo step), Add to Dictionary (`text.spelling.addWord`), Done and Cancel, with keyboard navigation (Tab between controls, Enter to Change or Done, Escape to close). Evidence: `crates/engine/src/tests/spelling.rs`, `crates/ui-egui/src/canvas/tests.rs` (`auto_spell_check_*`), `crates/ui-egui/src/tests/contextmenu.rs` (the right-click), `crates/ui-egui/src/dialogs/custom_dictionary.rs` (the dialog), `crates/ui-egui/src/dialogs/check_spelling.rs` (the Check Spelling dialog). |
|
||||
| Smart Punctuation, Change Case, Find & Replace | done | Type › Smart Punctuation… opens a dialog with the ff, fi, ffi and ff, fl, ffl ligatures, Smart Quotes, Smart Spaces, En, Em Dashes, Ellipses and Expert Fractions, Replace In and Report Results, which lists the count of each replacement; ligatures and fractions are written only where the font has a glyph for them. Evidence: `tests::menucmds::smart_punctuation_ligatures_spaces_and_fractions_are_counted`, `smart_punctuation_skips_ligatures_and_fractions_the_font_lacks`, `smart_spaces_keeps_one_space_after_a_period`, `dialogs::smart_punctuation::tests::menu_item_opens_the_dialog_and_ok_reports_the_counts` |
|
||||
| Alt + numeric-keypad codes while typing (Windows: `Alt+0176` → °) | partial | #5108: on Windows the character Windows posts when Alt comes up after keypad digits is typed at the caret like any other, in the typing's undo step, and the keypad digits typed with Alt run no shortcut. With NumLock off the keypad keys (Insert, End, arrows, Clear, Home, Page Up/Down without the extended-key flag) count as digits too and don't move the caret (`windows_alt_codes` unit tests; neither NumLock on nor off has been tried on a Windows machine yet). `type.insert {code}` (Windows Alt+0 code, Windows-1252 for 128–159) and `{unicode}` (hex code point) insert a character by its code (`menucmds::insert_a_character_by_its_code`). macOS and Linux have no such system convention and egui reports a keypad digit as the top-row digit, so there it does nothing; a floating panel window doesn't receive the character |
|
||||
@@ -77,7 +77,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| CJK: warichu | done | Character panel menu › Warichu and Warichu Settings… (`text.setFormat` / `text.setRangeStyle {warichu, warichuLines, warichuGap, warichuScale, warichuAlign}`, `ui.warichuSettings`), with Show East Asian Options ([Format East Asian characters](https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html)): marked characters set at a percentage of their size and stacked on 1 to 6 lines inside their line, one above the other in horizontal type and side by side in vertical type, with a line gap and eight alignments; a block stays whole on one line. Saved natively, carried by character styles, drawn on the canvas and in every export (SVG, PDF and `.ai` write such type as outlines). Type on a path sets the characters at their own size. Evidence: `tests::warichu`, `dialogs::warichu::tests`, `typecmd::area_tests::warichu_is_a_character_attribute_set_saved_and_exported` |
|
||||
| CJK: composite fonts | partial | Type › Composite Fonts… (`type.compositeFonts.set`), with Show East Asian Options: a font made of a font per class of character (Kanji, Kana, Punctuation, Symbols, Roman, Numerals), each with its own style, size and baseline in percent of the type's size, Kana, Roman and Numerals with horizontal and vertical scale, and Kana with Scale at Center; New, Delete Font, Import… and Export… (`.vccomposite`, `type.compositeFonts.import` and `.export`) ([Creating composite fonts](https://help.adobe.com/archive/en_US/illustrator/cs3/illustrator_cs3_help.pdf#page=347)); custom character sets (Custom: New, Delete Set, characters added by Direct Entry or Unicode code and deleted), each with its own font, style, size, baseline and scales, ahead of the classes, the later set winning a character two list (`custom` in `type.compositeFonts.set`) ([Customize characters in a composite font](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=348)). Composite fonts are listed first in the font menus, saved with the document, and their type is laid out per set and class; SVG and legacy `.ai` write it as outlines. Show Sample draws the font picked with lines for its ICF box, em box, baseline, cap height, highest ascent and lowest descent, highest ascender and x-height, each shown or hidden by its button, at the Zoom picked ([Creating composite fonts](https://help.adobe.com/archive/en_US/illustrator/cs4/illustrator_cs4_help.pdf#page=352)). Not yet: the Units menu. Evidence: `text::composite::tests::characters_fall_in_their_classes`, `text::composite::tests::custom_sets_take_their_characters_before_the_classes`, `tests::composite::composite_type_draws_each_class_in_its_font`, `tests::composite::custom_character_sets_take_their_characters_first`, `compositefonts::tests`, `dialogs::composite_fonts::tests` |
|
||||
| CJK: ruby | partial | ruby (ふりがな) for live text (`type.ruby`): a reading over a byte range, above (right of the column in vertical type) or below, start/centre/end alignment, size, overhang or squeeze; saved natively, laid out with its line growing, drawn on the canvas, in SVG and PDF (as outlines where ruby is present), in EPS, EMF/WMF and legacy `.ai` (legacy `.ai` writes type with ruby as outlines), and kept by Create Outlines, Expand Appearance and flattening, each glyph where the layout puts it (`typecmd::ruby_tests::create_outlines_keeps_the_ruby_where_it_is_laid_out`) | #633 |
|
||||
| Language per character (Character panel › Language, character styles), text shaped in it | done | `text.setFormat` / `text.setRangeStyle {language}` by name or BCP 47 tag, one of Document Setup's languages (Hindi, Marathi, Gujarati, Bengali, Punjabi, Tamil, Telugu, Kannada, Malayalam, Odia and Urdu added, #4943; Assamese and Sanskrit added, #4947; Nepali, Konkani and Sindhi added, #4943; Serbian: Cyrillic, Serbian: Latin and Croatian; Bulgarian, #5945); the shaper gets the tag, so the font's language forms apply (OpenType `locl`: Turkish keeps `fi` apart and the dot on its i, #4940); new type takes the document's language; saved as the tag only when set, carried by character styles (#4946). English and eleven Indian languages hyphenate by run language; Sanskrit automatic hyphenation awaits allowlisted patterns (#4947). Not yet: `.ai`/PDF import of a text's language, paragraph styles. Evidence: `features::tests::language_picks_the_fonts_forms`, `features::tests::serbian_gets_the_fonts_serbian_forms`, `typecmd::area_tests::language_is_a_character_attribute_saved_only_when_set`, `tests::typo::indic_language_runs_hyphenate_with_both_composers`, `hyphen::tests::sanskrit_without_allowlisted_patterns_uses_only_exceptions`, `tests::docsetup::the_further_indian_languages_are_document_and_text_languages`; spelling is checked in each run's Language (`text.spelling.check`, #4936) |
|
||||
| Language per character (Character panel › Language, character styles), text shaped in it | done | `text.setFormat` / `text.setRangeStyle {language}` by name or BCP 47 tag, one of Document Setup's languages (Hindi, Marathi, Gujarati, Bengali, Punjabi, Tamil, Telugu, Kannada, Malayalam, Odia and Urdu added, #4943; Assamese and Sanskrit added, #4947; Nepali, Konkani and Sindhi added, #4943; Serbian: Cyrillic, Serbian: Latin and Croatian; Bulgarian, #5945); the shaper gets the tag, so the font's language forms apply (OpenType `locl`: Turkish keeps `fi` apart and the dot on its i, #4940); new type takes the document's language; saved as the tag only when set, carried by character styles (#4946). English, eleven Indian languages, Bulgarian, Turkish and Russian hyphenate by run language, and German, Polish, Portuguese and Italian do in builds that embed their patterns; a word outside its language's script stays whole; Sanskrit automatic hyphenation awaits allowlisted patterns (#4947). Not yet: `.ai`/PDF import of a text's language, paragraph styles. Evidence: `features::tests::language_picks_the_fonts_forms`, `features::tests::serbian_gets_the_fonts_serbian_forms`, `typecmd::area_tests::language_is_a_character_attribute_saved_only_when_set`, `tests::typo::indic_language_runs_hyphenate_with_both_composers`, `hyphen::tests::sanskrit_without_allowlisted_patterns_uses_only_exceptions`, `hyphen::tests::rule_languages_break_by_their_own_rules`, `hyphen::tests::pattern_languages_break_at_their_own_patterns`, `tests::typo::a_russian_run_hyphenates_at_russian_break_points`, `tests::docsetup::the_further_indian_languages_are_document_and_text_languages`; spelling is checked in each run's Language (`text.spelling.check`, #4936) |
|
||||
| No Break | done | Character panel menu (`text.setFormat` / `text.setRangeStyle {noBreak}`): the marked characters stay on one line, including across a space; a run that does not fit after earlier text moves together, and a run longer than the line stays together. Evidence: `layout::wrapping_tests::no_break_keeps_marked_characters_on_one_line`, `tests::no_break_keeps_marked_words_on_one_line`, `typecmd::no_break_is_a_character_attribute_saved_only_when_on` |
|
||||
| Inline symbols in text | beyond Illustrator | not scored |
|
||||
| Align Stroke (inside, outside) on live type's character stroke | beyond Illustrator | not scored; `stroke.set {align}` and `text.setRangeStyle {strokeOptions: {align}}`; saved natively, drawn around the glyphs on the canvas and in PDF, EPS and SVG (live text, stroke on the glyph outlines); visual bounds grow with it (#2294) |
|
||||
|
||||
+12
-6
@@ -31,8 +31,10 @@ Window → Help Bar toggles the bottom tool-help strip independently of the stat
|
||||
|
||||
**Feature evidence last updated:** 2026-11-03.
|
||||
|
||||
Enclosing Lasso is an add-on under Object › Plug-ins with its own heading in All Tools. It has
|
||||
no default shortcut or Basic toolbar slot. It selects whole objects only
|
||||
Enclosing Lasso is an add-on under Object › Plug-ins. Its tool is also in the Lasso tool's group
|
||||
in both shipped toolbars, after the Lasso, and All Tools lists it there, under Select. A toolbar
|
||||
edited before it joined keeps its saved layout until Reset Toolbar. It has no default shortcut;
|
||||
one can be set in Edit › Keyboard Shortcuts › Tools. It selects whole objects only
|
||||
when their geometry is fully enclosed by the freehand loop. Shift adds, Alt subtracts, and
|
||||
Escape cancels. Ordinary group members can be selected separately; compound paths stay whole.
|
||||
Path checks follow curves, excluding stroke width and effects; other objects use their geometric
|
||||
@@ -165,6 +167,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| Cmd/Ctrl lends the last-used selection tool | done | the path being drawn continues afterwards; with Direct Selection (the default until a selection tool is chosen) a Cmd drag moves an anchor of the path being drawn, moves a straight segment or bends a curved one, one undo step each, and a Cmd-click away from art ends the path; with Selection the hidden bounding box of the path being drawn takes no press, so the drag moves the path (#4980); anchors or segments the lent Direct Selection picks are what Copy and Cut take, as with Direct Selection chosen, while Copy with the Pen's own last anchor selected takes the whole path (#6123) |
|
||||
| Click an open path's end to continue it; click another path's end to join | done | #776 |
|
||||
| Rubber Band preview | done | Preferences option |
|
||||
| P while the Pen draws a path ends the path, as Escape does | done | the [help page](https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/draw-shapes/preview-paths-drawn.html) describes P with the preview off; VectorCraft's own rules: it does the same with Rubber Band on, a click on the active Pen's button and `tool.select` do the same, and the Pen stays chosen |
|
||||
| Auto Add/Delete on a selected path; Shift or the preference disables it | done | |
|
||||
| Pen cursors (new path ×, continue /, close o, add +, delete −, convert ^) | done | the nib is a fountain-pen nib, tip on the hotspot, with the slit widening into the breather hole and the heel clipped square to its axis; bitmap tests at 1× and 2× pin the nib and the new-path asterisk, and in-app screenshots compare the Pen with Direct Selection |
|
||||
| Node-editing cursors: Direct Selection's white arrow with a hollow or filled square over an anchor (path unselected or selected); the Reshape Segment cursor over a curved segment (Direct Selection, Anchor Point, the Pen with Alt); the Anchor Point caret for the Pen with Alt; Group Selection's plus (also Direct Selection with Alt); a filled arrow while dragging that turns hollow on a snap; a double arrowhead for an Alt-drag copy | partial | as the public manual describes them, drawn in code; no cue over handles (none documented) |
|
||||
@@ -237,7 +240,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| Live Corners widgets (radius readout, Alt-click cycles kind, double-click the Corners dialog) | done | a Direct Selection click on a widget selects its corner (#1239), and with every corner selected a Shift-click on a widget picks that corner alone instead of deselecting it (#5188); a press-and-drag on a widget of a path selected whole still rounds every corner (#908), and adding widgets to the selection by Shift-click (#1232) is missing; the bounding box hides while a widget is dragged with the Selection tool (#1229); a round corner next to a curved side curves smoothly instead of sticking out of the shape (#1512); a corner rounds until its cut reaches its neighbours' cuts, so one corner of a square alone reaches the whole side (#2332) |
|
||||
| Corners between curved sides (#1144), Relative rounding | done | #1144 closed; Relative rounding in the Corners dialog (Relative / Absolute, radius as a percentage of each corner's maximum, kept as the shape is resized; `object.setLiveShape` `relativeRadii`, #3091, `tests_livecorners::relative_corner_rounding_keeps_fraction_on_resize`) |
|
||||
| Pie widgets on a live ellipse: drag one to set Pie Start or End Angle, double-click one to make the ellipse whole | done | Selection tool, with the bounding box showing |
|
||||
| A shape just drawn shows its bounding box and Live Shape widgets with the shape tool still active, and the selection can be moved and turned without switching tools | done | #5477: Rectangle, Rounded Rectangle, Ellipse, Polygon and Star keep the selection's bounding box, corner widgets and pie widgets on show while they draw nothing; a drag on a corner or pie widget adjusts it (arrows step the corner kind, Escape cancels), a press on the selection's centre point (Attributes › Show Center) moves the selection — the Selection tool's move arrow, snapping and Alt copy — a press just outside a corner of the box turns it about the centre (the Selection tool's rotate zone and cursor), and a press anywhere else draws (so a second shape drawn from the first one's centre moves the first: press elsewhere or deselect first). Public descriptions: [Live Shapes](https://helpx.adobe.com/illustrator/using/live-shapes.html) (live shapes adjust without switching tools) and [CreativePro, Working with Live Shapes](https://creativepro.com/?p=23921) (a widget shows in every corner on release; drag one toward the centre to round). The bounding-box handles show but scale only with the Selection tool, so a press on a corner still starts a new shape there; double-clicking a widget opens nothing with a shape tool. Tests `a_shape_tool_drags_the_selected_shapes_widgets` and `a_shape_tool_moves_the_selection_by_its_centre_point_and_turns_it_from_a_corner` |
|
||||
| A shape just drawn shows its bounding box and Live Shape widgets with the shape tool still active, and the selection can be moved and turned without switching tools | done | #5477: Rectangle, Rounded Rectangle, Ellipse, Polygon and Star keep the selection's bounding box, corner widgets and pie widgets on show while they draw nothing; a drag on a corner or pie widget adjusts it (arrows step the corner kind, Escape cancels), a press on the selection's centre point (Attributes › Show Center) moves the selection — the Selection tool's move arrow, snapping and Alt copy — a press just outside a corner of the box turns it about the centre (the Selection tool's rotate zone and cursor), and a press anywhere else draws (so a second shape drawn from the first one's centre moves the first: press elsewhere or deselect first). Public descriptions: [Live Shapes](https://helpx.adobe.com/illustrator/using/live-shapes.html) (live shapes adjust without switching tools) and [CreativePro, Working with Live Shapes](https://creativepro.com/?p=23921) (a widget shows in every corner on release; drag one toward the centre to round). A drag on one of the box's handles scales the selection as the Selection tool's handles do. A double-click on a corner widget of a selected live rectangle or polygon shows and selects the Transform panel where it is (closed, docked, floating or in an icon column; a second double-click keeps it on show), and leaves the tool, the selection and the document as they were; a double-click on a pie widget, off the widgets, with Show Corner Widget off or with Line Segment does nothing, and the Selection tool's double-click on a corner widget still opens the Corners dialog. Public description: [Live shape properties](https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/modify-live-shapes/live-shape-properties.html) (a double-click on a corner widget of a selected live shape opens the Transform panel). Tests `a_shape_tool_drags_the_selected_shapes_widgets`, `a_shape_tool_moves_the_selection_by_its_centre_point_and_turns_it_from_a_corner`, `a_shape_tool_scales_the_selection_by_its_bounding_box_handles`, `a_double_click_on_a_corner_widget_shows_the_transform_panel`, `a_double_click_on_a_corner_widget_with_a_shape_tool_asks_for_the_transform_panel` (engine), `a_corner_widget_double_click_with_a_shape_tool_requests_the_transform_panel` (MCP: the `pointer_gesture` reply's `requests` carry `{"panel": "transform"}`) and `a_tools_panel_request_shows_the_panel_and_a_second_keeps_it_shown` (UI) |
|
||||
| Isolation mode by double-click (groups and single objects), breadcrumbs, Esc to exit | done | Single paths, compound paths, images, meshes and placed files isolate too ([helpx: Isolate objects](https://helpx.adobe.com/africa/illustrator/desktop/manage-objects/select-objects/isolate-objects.html)); locking or hiding the layer (or a group) around the isolated object afterwards keeps clicks and marquees off it, as outside isolation mode (#5309) |
|
||||
| "Magnetic" moves of selected anchors with a modifier (#955 request) | missing | not a feature of the reference app as documented; under discussion |
|
||||
| Coinciding anchors of overlapping objects: the selected object's anchor is taken, also under another object | done | #1508 |
|
||||
@@ -328,6 +331,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| Cmd/Ctrl: last-used selection tool; Cmd+Alt: Group Selection inside Direct Selection | done | Cmd+Alt lends Group Selection only while Direct Selection is active (Cmd borrow from the Pen keeps Direct Selection so Alt stays copy/subtract); Cmd alone lends Direct Selection the Selection tool: its bounding box shows while Cmd is held over objects selected whole and its handles scale and rotate them, and a Cmd drag moves the whole object while its direct-selected anchors stay selected (#3901; no box over a selection with anchors picked yet); engine pointer and canvas regressions |
|
||||
| Eyedropper copies effective character dimensions between transformed text objects | done | Point/area and grouped text, highlighted ranges, reverse/remembered sampling, opt-outs and atomic invalid-transform rejection; `scaled_type_pick_*` (#6404) |
|
||||
| Eyedropper styles highlighted characters only and preserves ranges across Type switches | done | Font/paint, Shift color-only, Unicode, Undo/Redo and stale-range regression tests; enabled non-neutral source or target object transparency is refused atomically; disable Transparency to sample supported attributes |
|
||||
| Gradient mesh: a solid color dropped from the Color or Swatches panel or a Fill proxy on a selected mesh recolors the mesh point under the pointer, else the patch's four points; with the mesh selected, an Eyedropper click applies the fill color the same way | done | [Edit mesh objects](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=312); `object.mesh.setPointColor`, one undo step, none when the color is unchanged. The 5-pixel reach for a point is VectorCraft's own. Tests `a_color_dropped_on_a_selected_mesh_recolors_the_point_or_patch_under_it`, `a_click_on_a_selected_mesh_gives_its_point_or_patch_the_fill_color`, `a_click_on_an_object_over_a_selected_mesh_copies_that_object` |
|
||||
| Eyedropper reads visible sources while their layer/object is locked or outside isolation | done | Ordinary/Shift/Shift+Alt and gradient-stop reads preserve the source and selection; Alt reverse remains editable-only; hidden art stays excluded (`eyedropper_sources.rs`, #1251) |
|
||||
| Add a visible stroke after drawing with inherited None/zero-width paint | done | Paint and Swap Fill/Stroke restore the existing 1 pt default; positive widths and painted zero widths stay as set; Undo/Redo and targeted appearance items tested (`stroke_visibility.rs`, #1253) |
|
||||
| Double-click a stroked segment to create a width point in Width Point Edit | done | Finite-arithmetic follow-up: engine regressions and full CI passed; [Validation evidence](target-app-parity.md#evidence-what-ships-today-by-area). Command and pointer regressions cover opening, sampled widths, adjoining adjustment on/off through checkbox/OK, compound paths, Cancel/Delete and Undo/Redo; dialog layout reviewed. [Validation evidence](target-app-parity.md#evidence-what-ships-today-by-area) |
|
||||
@@ -337,7 +341,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| Document Setup → Edit Artboards applies valid settings, closes the dialog and activates the Artboard tool | done | Pointer-click tests cover successful handoff, invalid settings, OK, Cancel and Undo in `dialogs/document_setup.rs`. |
|
||||
| Escape leaves Artboard editing for Selection; during a drag it first cancels the gesture | done | Headless egui key events cover idle Escape, active-drag cancellation and a subsequent Escape in `tests/distortkeys.rs`. |
|
||||
| Escape while typing ends the edit, keeps the type selected and switches back to the tool whose double-click on type chose the Type tool (kept until another tool is chosen or another document or window becomes active, so later edits with the Type tool return there too), or to the Selection tool when there is no such tool, as when the Type tool was chosen from the toolbar or after such a switch | done | #1802 (#1686, #1656) |
|
||||
| Selection tool: selected area type and type on a path show an in port and an out port (empty, an arrow where threaded, the red "+" of overflow); a click on either loads the text cursor; a click on a closed path, on empty canvas or a drag threads the text there, after the clicked frame from its out port, before it from its in port; Escape or another tool drops it; a double-click on a threaded port breaks the thread there | partial | #2572 (`text.thread.add`, `before` for the in port); the out port sits on the frame's right side above the bottom-right corner handle and the in port on its left side below the top-left one, so the handles can still be grabbed; a double-click on a threaded port breaks the thread (`text.thread.break`, [archived help](https://web.archive.org/web/20220127090642/https://helpx.adobe.com/illustrator/using/creating-text.html)); the loaded cursor borrows the I-beam |
|
||||
| Selection tool: selected area type and type on a path show an in port and an out port (empty, an arrow where threaded, the red "+" of overflow); a click on either loads the text cursor; a click on a closed path, on empty canvas or a drag threads the text there, after the clicked frame from its out port, before it from its in port; Escape or another tool drops it; a double-click on a threaded port breaks the thread there | partial | #2572 (`text.thread.add`, `before` for the in port); the out port sits on the frame's right side above the bottom-right corner handle and the in port on its left side below the top-left one, so the handles can still be grabbed; a double-click on a threaded port breaks the thread (`text.thread.break`, [archived help](https://web.archive.org/web/20220127090642/https://helpx.adobe.com/illustrator/using/creating-text.html)); the loaded text has a cursor of its own, with a link badge over a closed path, area type or type on a path that a click threads it into |
|
||||
| Shift-click selects several artboards (Artboard tool, Artboards panel); they move, Alt-copy and delete together | done | `artboard.move`/`artboard.delete` `indices` (#1139); in the panel, Shift- and Ctrl/Cmd-click work with any tool by switching to the Artboard tool (#5698); panel menu, trash and Properties share selected-set deletion; all-selected retains artboard 1 and a single board cannot be deleted, with pointer-event and Undo/Redo coverage |
|
||||
| Artboards panel: drag a row above or below another to reorder the artboards (as Move Up / Move Down do) | done | #4687; a line shows where the row lands, `artboard.reorder` in one undo step, the moved artboard becomes active; public forum answers describe the drag |
|
||||
| Artboards panel › Delete Empty Artboards | done | `artboard.deleteEmpty`; one undo step, guides go too, locked artboards stay, and artboard 1 when every artboard is empty and none is locked; an artboard is empty when no object (hidden, locked and template art included; guides not) has visual bounds that meet or touch it, a group counting by its members and a clip group or clipping layer by its members inside the clip (our reading of "no artwork"; the pages give no finer rule); [spec](https://helpx.adobe.com/illustrator/desktop/create-manage-artboards/add-edit-artboards/delete-artboards.html) |
|
||||
@@ -424,7 +428,8 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| Live trace result bounds and selection highlights exclude the retained bitmap; source-image views retain it | done | All TraceView modes and rotated result bounds regression-covered; ordinary hidden group behavior retained |
|
||||
| Image Trace panel: the Preview checkbox before Trace chooses whether a setting change traces the selected Image Trace object again at once | done | Per the public documentation, Preview shows the result of the current settings and Trace traces with them (<https://web.archive.org/web/20250831090623/https://helpx.adobe.com/illustrator/using/image-trace.html>). Preview is on by default and kept with the UI preferences; Reset to Default leaves it. Off, changes wait in the panel until Trace applies them as one undo step, or until Preview is turned on again. Changes stay with the object they were made for while another object is selected, and come back when it is selected again. `imageTrace.preview {on?}`, `ui.set {imageTracePreview}`; `panels/image_trace.rs` headless tests (`with_preview_off_a_slider_change_waits_for_trace`, `turning_preview_on_traces_the_changes_that_waited`, `preview_turned_on_with_nothing_selected_traces_when_the_object_is_selected_again`, `settings_that_wait_stay_with_their_object`, `settings_that_wait_come_back_when_their_object_is_selected_again`, `settings_that_wait_are_dropped_when_their_object_changed_since`, `preview_is_kept_with_the_preferences_and_reset_to_default_leaves_it`) |
|
||||
| Toolbar without group labels by default, one or two columns; All Tools drawer by flyout group with shortcuts, its menu (Reset, Basic, Advanced) and Show section | done | #1751; a preference brings the labels back; `toolbar.show` sets the Fill/Stroke, Coloring, Draw Mode and Screen Mode controls |
|
||||
| Actions panel: ≡ › Save Actions… saves the current set with all its actions to a file and ≡ › Load Actions… adds a saved set ([Manage a set of actions](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/manage-a-set-of-actions.html)) | partial | `ui.actionSet.save`, `ui.actionSet.load`; `panels/actions.rs` tests. The file is VectorCraft's own `.vcactions` JSON; Clear and Replace Actions remain |
|
||||
| Actions panel: ≡ › Save Actions… saves the current set with all its actions to a file and ≡ › Load Actions… adds a saved set ([Manage a set of actions](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/manage-a-set-of-actions.html)) | partial | `ui.actionSet.save`, `ui.actionSet.load`; `panels/actions.rs` tests. The file is VectorCraft's own `.vcactions` JSON; Clear Actions remains |
|
||||
| Actions panel: ≡ › Replace Actions… puts the set of a saved file in place of every set in the panel ([the help page](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/actions-panel-overview.html)) | done | `ui.actionSet.replace`; `panels/actions.rs` tests. The file is read as Load Actions… reads it; the item asks no question first |
|
||||
| Actions panel: ≡ › Reset Actions asks first; OK replaces the sets in the panel with the default set and Append adds the default set after them ([the help page](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/manage-a-set-of-actions.html)) | done | `ui.actionSet.reset`; `panels/actions.rs` and `dialogs/tests.rs` tests. The default set is VectorCraft's own Default Actions set |
|
||||
| Actions panel: ≡ › Load Actions… also reads action sets saved as `.aia` files ([Actions panel overview](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/actions-panel-overview.html)) | partial | `actionSet.read`, `ui.actionSet.load`; `tests/actionset.rs`, `panels/actions.rs` tests, `import_fuzz`. Steps with a label and no recorded values come in as menu commands that run with no values and open no dialog, matched by label, and Set Selection steps come in as Select Object steps; the other steps, recorded menu items included, are left out and counted |
|
||||
| Actions panel: ≡ › Action Options… renames the selected action and sets its function key and color ([Actions panel overview](https://helpx.adobe.com/illustrator/desktop/automate-visualize-data/automate-actions/actions-panel-overview.html)) | partial | `ui.action.options`; `panels/actions.rs` tests (part of #1629). Button Mode shows the color |
|
||||
@@ -447,6 +452,7 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| Make Compound Path on a group (such as outlined type) keeps its backmost path's paint; compound paths joined into one keep their holes | done | #1537 |
|
||||
| Symbol libraries: Window › Symbol Libraries (Basic Shapes, UI Frames, Map Markers, Inventory Icons, Skill Icons, User Defined, Other Library…, Save Symbols…) and the Symbols panel's Symbol Libraries Menu button and its menu's Open Symbol Library / Save Symbol Library…; a click on a library symbol adds it to the document's Symbols (one undo step, it becomes the current symbol), Shift/Cmd-clicks select for Add to Symbols, and a symbol dragged onto the canvas is added and placed where it is dropped | done | [public source](https://helpx.adobe.com/illustrator/desktop/manage-objects/traces-mockups-symbols/create-or-import-symbol-libraries.html), [Symbols panel options](https://helpx.adobe.com/illustrator/desktop/manage-objects/traces-mockups-symbols/symbols-panel-options.html), [placing from a library](https://helpx.adobe.com/illustrator/desktop/manage-objects/traces-mockups-symbols/create-and-place-symbols.html); `window.symbolLibrary`, `window.symbolLibrary.other`, `ui.saveSymbolLibrary` (dialog `saveSymbolLibrary`), `window.userSymbolLibrary1`…`10`; `panels::tests_symbol_libraries`; five built-in libraries (Basic Shapes, UI Frames with default 9-slice, Map Markers, Inventory Icons, Skill Icons; original, generated in code) |
|
||||
| Brush libraries: Window › Brush Libraries (Art Ribbons, Ink and Wash, Calligraphic Nibs, Bristle Brushes, Pattern Borders, Scatter Shapes, Game Trails, Energy Beams, Dry Media, Tech Circuit, User Defined, Other Library…, Save Brushes…) and the Brushes panel's Brush Libraries Menu button and its menu's Open Brush Library / Save Brush Library…; a click on a library brush adds it to the document's Brushes (one undo step, it becomes the current brush, and selected paths take it in the same step), Shift/Cmd-clicks select for Add to Brushes, a brush dragged onto a path is added and applied to it and one dragged onto the Brushes panel is added; thumbnails render with the library's patterns and symbols | done | [public source](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/create-new-brush-libraries.html), [import brushes](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/import-brushes-from-brush-libraries-or-other-files.html), [Brushes panel overview](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/brushes-panel-overview.html); `window.brushLibrary`, `window.brushLibrary.other`, `ui.saveBrushLibrary` (dialog `saveBrushLibrary`), `window.userBrushLibrary1`…`10`; `panels::tests_brush_libraries`; ten built-in libraries (original, generated in code) |
|
||||
| Brushes panel menu › Options of Selected Object…: changes the selected brushed paths' brush settings on those paths only, leaving the brush and its other strokes as they are; the brush type's options dialog opens without the Name row (and without an art brush's scale and direction options or a pattern brush's tiles), and OK sends only the values changed in it | done | [Modify brushes](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/modify-brushes.html), [Brushes panel overview](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/brushes-panel-overview.html); `brush.objectOptions`, `ui.brushObjectOptions`; which fields a path can set is VectorCraft's own choice (calligraphic, scatter, art and pattern brushes; not bristle); `options_of_selected_object_*` tests in `crates/engine/src/tests/brushsym.rs` and `crates/ui-egui/src/dialogs/brush_options/tests.rs`, brush tests in `crates/brush/src/tests.rs` |
|
||||
| Symbols panel: New Symbol opens Symbol Options (Name) before making the symbol; Alt-click skips it | partial | #1560 (#1566); Registration 9-point grid in Symbol Options (`symbol.new` / `symbol.place`); Export Type (Graphic / Movie Clip) and Enable Guides for 9-Slice Scaling (scaled instances keep their corners; in symbol editing mode the guides are drawn over the art and the Selection tool drags them); Symbol Type (Dynamic Symbol / Static Symbol, new symbols dynamic; #4938); Align to Pixel Grid (`alignToPixelGrid` on `symbol.new` / `symbol.options`: the art snaps at the symbol's natural size and instances at that size stay on whole points; [Aligning symbols to pixel grid](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=28)) |
|
||||
| Dynamic symbols: an instance changes the fill, stroke, opacity and blend of objects in its symbol's art and stays linked; Reset in the Properties panel's Quick Actions and the Symbols panel menu (Reset Symbol Instance) | partial | #4938; `symbol.instance.setAppearance` (by child-index path) and `symbol.instance.reset`; redefining keeps the changes, Break Link bakes them; Direct Selection of a path, compound path or type object inside an instance, with the Fill/Stroke controls setting its solid fill or stroke, is on canvas; on-canvas editing beyond a solid fill and stroke, and `.ai` read and write, remain |
|
||||
| Pathfinder Trim, Merge and Crop remove strokes; Merge joins same-fill objects whatever their strokes | done | #1570 (#1572) |
|
||||
@@ -475,7 +481,7 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| DXF export/import preserves intended curve closure | done | #1299; R13–2018 closed SPLINE bit set/read; an open curve ending at its start stays open; knots and control points unchanged; circular cubic paths export as native CIRCLE/ARC where stroke semantics permit; DXF Options' Preset menu and `document.exportDxf`'s `dxfPreset: "cnc"` set the CNC / CAM options (#5500) |
|
||||
| macOS save sheet: choose the format from a menu | done | #866; the save panel is VectorCraft's own `NSSavePanel` with its Format menu set before the sheet opens (`apps/vectorcraft/src/mac_save_format.rs`); #1855 had withdrawn the menu that was added after the sheet began, which made Save As, Save a Copy and the first Save show no sheet |
|
||||
| Preferences: every option acts | partial | 2 stored but unused (#394, audited 2026-10-30): Scratch Disks, Legacy vector clipboard; the rest act (Units › East Asian Type since 2026-10-31; Open Documents As Tabs: cleared, new documents open in floating windows). General › Corner Radius drives the Rounded Rectangle tool and follows its ↑/↓ (2026-10-24) |
|
||||
| Preferences › General › Constrain Angle | done | arrow keys and Shift drags along the turned axes; the Rectangle, Rounded Rectangle, Ellipse and grid tools, point and area type and the shape size dialogs draw along them with the bounding box turned; Shift-drawn polygons and stars keep the turned base orientation; the Line Segment tool's Shift steps count from it (#394, <https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>); spirals, flares and Pen paths are not turned |
|
||||
| Preferences › General › Constrain Angle | done | arrow keys and Shift drags along the turned axes; the Rectangle, Rounded Rectangle, Ellipse and grid tools, point and area type and the shape size dialogs draw along them with the bounding box turned; Shift-drawn polygons and stars keep the turned base orientation; the Line Segment tool's Shift steps count from it (#394, <https://helpx.adobe.com/illustrator/desktop/manage-objects/arrange-objects/rotate-objects-by-specific-angles.html>); flares and Pen paths are not turned |
|
||||
| Tabs panel: a stop drags from where the press landed, a stop just added included | done | #1458 |
|
||||
| Outline view keeps template layers in Preview, dimmed | done | #1486; a picture placed to be traced stays visible under the outlines |
|
||||
| Outline view draws on a white canvas, the artboards as their edges | done | Outline shows only the paths ([Outline mode](https://helpx.adobe.com/illustrator/desktop/get-started/learn-the-basics/preview-artwork-as-outlines.html)). VectorCraft's own rule for the canvas: in every interface brightness and Canvas Color the whole canvas is white, pasteboard included; the artboards draw no paper (no Simulate Colored Paper or artboard color, and no paper with Hide Artboards); the artboard names and the ruler origin's crosshair are dark gray; split views and floating windows follow their own view. Tests `outline_draws_on_a_white_canvas_with_artboards_as_edges`, `outline_draws_no_colored_paper`, `a_pane_draws_its_own_views_outline`, `the_ruler_origin_crosshair_shows_on_the_outline_canvas` |
|
||||
|
||||
Reference in New Issue
Block a user