mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-16 14:17:14 +00:00
Merge main into fix/graph-stacked-column-legend-stroke
This commit is contained in:
@@ -1061,6 +1061,7 @@ Commands (`panel` and every panel parameter take a panel id in any case or its d
|
||||
| `window.panel.activate`, `.close`, `.closeGroup`, `.closeOthers` | `{panel}` | shows and selects, or hides |
|
||||
| `window.panel.minimize` | `{panel, minimized?}` | minimizes a dock group to its tabs, or a floating window to its title bar; omitted toggles |
|
||||
| `window.panel.collapse` | `{panel, collapsed?}` | `window.panel.minimize`; returns `{panel, collapsed, layout}` |
|
||||
| `window.panel.cycleOptions` | `{panel}` | shows the panel at its next display size (its Show/Hide Options states, largest first), as the double triangle on its tab strip does; a panel without sizes is an error; returns `{panel, size, sizes}` |
|
||||
| `window.panel.iconic` | `{panel, iconic?}` | collapses the panel's dock column to icons, or expands it |
|
||||
| `window.panel.layout`, `ui.dock` | `{action}` | one craft-ui `Action`, externally tagged, e.g. `{"MoveFloating":{"panel":"swatches","rect":[44,66,360,450]}}` or `{"ResizeSplit":{"path":[],"size":{"Ratio":0.35}}}`; `ui.dock` also takes craft-ui's `{operation, …}` |
|
||||
|
||||
|
||||
@@ -83,6 +83,7 @@ The canvas is rasterized on the CPU (`vectorcraft-render`, vello_cpu); the GPU (
|
||||
- `WGPU_VALIDATION_INDIRECT_CALL=1`: turns wgpu's check of indirect draw arguments back on. VectorCraft draws nothing indirectly and turns it off, since the compute shader it needs fails to compile on some drivers (#651).
|
||||
- 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`.
|
||||
|
||||
## Logs
|
||||
|
||||
@@ -98,6 +99,8 @@ When the interface thread stays in one part of a frame for 3 s (VectorCraft's ow
|
||||
|---|---|
|
||||
| `VECTORCRAFT_CONTROL_PORT` | Same as `--control <port>`, which overrides it; a value that isn't a port from 1 to 65535 stops the app |
|
||||
| `VECTORCRAFT_IN_WINDOW_MENUS` | Any value but empty or `0`: same as `--in-window-menus` (see [macOS: the menu bar](#macos-the-menu-bar)) |
|
||||
| `VECTORCRAFT_PRESENT_MODE` | Same as `--present-mode`, which overrides it: `fifo`, `autovsync` or `novsync`; any other value stops the app (see [Desktop graphics processor](#desktop-graphics-processor)) |
|
||||
| `VECTORCRAFT_FRAME_LATENCY` | Same as `--frame-latency`, which overrides it: `1` to `3` frames; any other value stops the app (see [Desktop graphics processor](#desktop-graphics-processor)) |
|
||||
| `VECTORCRAFT_NO_PREFS` | No preferences read or written, no default Data Recovery folder and no log file, and no saved PDF presets or loaded ICC profiles kept (agents' test runs; also for `vectorcraft-cli`) |
|
||||
| `VECTORCRAFT_CONFIG_DIR` | The folder for the preferences and the folders next to them (`PDF Presets`, `Color Profiles`, …), for the app and `vectorcraft-cli` (see `docs/control-protocol.md`) |
|
||||
| `WGPU_POWER_PREF` | Graphics adapter: `low`, `high` or `none` (see [Desktop graphics processor](#desktop-graphics-processor)) |
|
||||
|
||||
@@ -181,7 +181,7 @@ VectorCraft choices; an original approximation, never compared with another appl
|
||||
| Revolve | initial: live, editable profile, rotation and light gizmos, default-on Cap with continuous curved rims, smooth vector shading and round seam joins, overlapping faces drawn in the order of their depths where they overlap, SVG/PDF output, Expand Appearance ([revolve.md](revolve.md), #846) |
|
||||
| Extrude & Bevel, Inflate, Rotate | initial: live, round seam joins, depth, twist, taper, solid or hollow caps, five original bevel shapes, Inflate volume, both sides, twist, taper and cap, Rotate of every fill and stroke, groups and layers turned about one shared axis (#4506), contours that cross, touch or overlap merged first ([three-d.md](three-d.md)), Position presets, rotation and light gizmos, SVG/PDF output, Expand Appearance ([three-d.md](three-d.md)) |
|
||||
| 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; hard-edged shadows behind or below the object from the first light ([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, soft shadows 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 or no Shading Color, 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: the track cube (face, edge, Shift and ring drags, keyboard steps; [three-d.md](three-d.md#track-cube)); Map Art: none |
|
||||
| 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 or no Shading Color, 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)) |
|
||||
|
||||
|
||||
@@ -20,9 +20,9 @@ its current location. Opening the controls does not add a document undo step.
|
||||
|
||||
The built-in presets other than Auto Color and Flat Logo all use Paths 50, and so do their enhanced
|
||||
versions. Among those presets, Corners is 100 in Technical Drawing, 75 in Default, Black and White
|
||||
Logo, Line Art and Outline, and 50 in the other eight. Noise is 1 px in Technical Drawing, 5 in High Fidelity Photo, 10 in Low Fidelity Photo, 15 in 3 Colors,
|
||||
6 Colors, 16 Colors and Shades of Gray, 20 in Sketched Art, Line Art and Outline, 25 in Default and
|
||||
Black and White Logo, and 90 in Silhouettes (see
|
||||
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)).
|
||||
|
||||
Sliders apply on release, and their numeric fields can be edited directly. Each committed
|
||||
|
||||
@@ -237,10 +237,10 @@ Every built-in preset other than Auto Color and Flat Logo traces at Paths 50. Co
|
||||
| High Fidelity Photo | 50 | 50 | 5 | 90, 25, 4 |
|
||||
| Low Fidelity Photo | 50 | 50 | 10 | 60, 50, 12 |
|
||||
| 3 Colors | 50 | 50 | 15 | 60, 60, 20 |
|
||||
| 6 Colors | 50 | 50 | 15 | 65, 60, 16 |
|
||||
| 16 Colors | 50 | 50 | 15 | 70, 55, 10 |
|
||||
| 6 Colors | 50 | 50 | 8 | 65, 60, 16 |
|
||||
| 16 Colors | 50 | 50 | 8 | 70, 55, 10 |
|
||||
| Shades of Gray | 50 | 50 | 15 | 60, 50, 10 |
|
||||
| Black and White Logo | 50 | 75 | 25 | 95, 80, 8 |
|
||||
| Black and White Logo | 50 | 75 | 5 | 95, 80, 8 |
|
||||
| Sketched Art | 50 | 50 | 20 | 50, 50, 100 |
|
||||
| Silhouettes | 50 | 50 | 90 | 40, 60, 30 |
|
||||
| Line Art | 50 | 75 | 20 | 80, 70, 10 |
|
||||
@@ -248,7 +248,9 @@ Every built-in preset other than Auto Color and Flat Logo traces at Paths 50. Co
|
||||
| Outline | 50 | 75 | 20 | 80, 70, 10 |
|
||||
|
||||
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.
|
||||
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.
|
||||
|
||||
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
|
||||
@@ -309,6 +311,47 @@ identical settings on unchanged current source and the candidate, including sepa
|
||||
crops and white-composited PNG comparisons. These local fixtures are not repository assets.
|
||||
The parity score is unchanged.
|
||||
|
||||
## Noise joins the nearest color
|
||||
|
||||
A region below Noise used to join the color it shares the longest border with. Along a thin dark
|
||||
line on a light ground, a dark speck of the line touches the ground on more sides than the line, so
|
||||
it joined the ground and the line broke into dashes. Now, when the color of the longest border is
|
||||
10 or more apart from the region's own color (Oklab × 100), the region joins the neighboring color
|
||||
nearest the average of its pixels, among the colors that share at least a tenth of the longest
|
||||
border. The average is taken in the image as prepared for tracing (deblocked, and smoothed for a
|
||||
photo) and leaves out the semi-transparent pixels along a cut-out image's edge that are the color
|
||||
beside them blended with the transparent background. A single pixel whose longest border is tied
|
||||
between colors keeps the previous rule. The rule changes only which
|
||||
color a region joins, and higher Noise still continues the same merge sequence. It applies in Color
|
||||
and Grayscale: in Black and White a region has only one neighboring color. The values are
|
||||
VectorCraft's own. 6 Colors and 16 Colors move from Noise 15 to 8, and Black and White Logo from 25 to 5.
|
||||
The new Noise values were chosen with the rule in place, and the measurements below include both
|
||||
changes.
|
||||
|
||||
Measured on 17 local images (synthetic shapes and photos at several sizes, a geometric drawing and
|
||||
eight illustrations; not repository assets), against `main` at `ea3f81d9c3`, with the mean absolute
|
||||
difference per channel (0 to 255) against the image on white:
|
||||
|
||||
| preset | three illustrations with fine dark lines | four other illustrations | synthetic shapes and photos |
|
||||
|:--|:--|:--|:--|
|
||||
| 16 Colors | 8.15 / 10.80 / 8.69 → 5.82 / 6.25 / 6.01; anchors +72% to +99% | −1.8% to −11.9%; anchors +20% to +39% | within 0.08 of a level; anchors 0% to +37% |
|
||||
| 6 Colors | 7.24 / 9.14 / 9.21 → 5.87 / 6.66 / 7.87; anchors +55% to +73% | −0.6% to −3.5%; anchors +13% to +20% | within 0.03; anchors 0% to +22% |
|
||||
| High Fidelity Photo | 8.42 / 10.11 / 7.46 → 6.85 / 7.54 / 6.00; anchors +31% to +51% | −1.4% to −5.8%; anchors −9% to +4% | within 0.08; anchors −6% to +5% |
|
||||
|
||||
With Black and White Logo, where only the Noise value changes, the pixels that differ from the image
|
||||
thresholded at 128 fall from 2.00 / 2.42 / 1.96% to 1.49 / 1.58 / 1.23% on the three illustrations,
|
||||
with 37% to 64% more anchors, and from 1.19 to 2.37% to 1.14 to 1.94% on the other four, with 5% to
|
||||
41% more anchors; the synthetic inputs change by 0.01% or less. On a simple flat illustration the
|
||||
difference changes by 1.0% or less in every preset, with up to 21% more anchors, and the geometric
|
||||
drawing keeps its anchor count and difference in every preset. Tests:
|
||||
`a_dark_speck_beside_a_dark_line_joins_the_line`, `a_speck_close_to_its_longest_border_color_joins_it`,
|
||||
`a_color_with_a_short_border_is_not_chosen`, `a_lone_pixel_tied_between_colors_merges_by_border`,
|
||||
`a_speck_of_settled_cut_edge_pixels_merges_by_border`, `noise_still_removes_every_region_below_it` and
|
||||
`a_source_that_does_not_cover_the_labels_is_not_read` in `crates/trace/src/quantize/denoise.rs`.
|
||||
`the_borders_of_a_gradients_bands_follow_its_contours` now traces at Noise 15: at 16 Colors' new
|
||||
Noise 8 the borders of its noisy gradient stray 0.92 px from the contours, above the test's 0.9 px
|
||||
limit.
|
||||
|
||||
## Pieces returning to a junction
|
||||
An outline piece can return to its starting junction while being fitted as an open chain. At loose
|
||||
Corners/Paths settings, a nonzero positioned boundary could collapse to one cubic and lose a small
|
||||
|
||||
+77
-27
@@ -255,9 +255,12 @@ the suite) keep the agent to the folders you give it:
|
||||
paths kept of them and each data set's image, in every symbol, pattern, graph design and brush, used or not,
|
||||
colorized or not, and a stored brush entry that does not read as a brush is refused too, since its links
|
||||
cannot be checked. Otherwise the images of the art the file writes,
|
||||
in opacity masks and in the symbols, patterns and brushes that art uses, are checked: hidden layers and
|
||||
objects only with `hiddenLayers` (a save keeps them unless it is `false`), and template layers and the
|
||||
layer of opacity-mask or symbol editing mode never. `selectedOnly` and `document.exportSelection` check the
|
||||
in opacity masks, in the art drawn for placed documents and in the symbols, patterns and brushes that art
|
||||
uses, are checked: hidden layers and objects only with `hiddenLayers` (a save keeps them unless it is
|
||||
`false`), also inside symbols, patterns and graph designs, and template layers and the layer of
|
||||
opacity-mask or symbol editing mode never. With `profile: "tiny12"` the file leaves out opacity masks, and
|
||||
their images are not checked. An object whose effect SVG has no filter for is checked as the image the file
|
||||
draws of it. `selectedOnly` and `document.exportSelection` check the
|
||||
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.
|
||||
@@ -628,7 +631,9 @@ For `draw_shape` and `draw_path`, omitted paint fields inherit the current [new-
|
||||
For a filled shape or path without an outline, pass an explicit `fill` and `stroke: "none"`.
|
||||
Lines start with no fill and a visible stroke.
|
||||
The Fill/Stroke proxy commands run through `run_command`: `paint.invert` and `paint.complement` recolor the active
|
||||
proxy, including a grayscale image's colorized fill, while keeping each color's model. `paint.lastColor` /
|
||||
proxy, including a grayscale image's colorized fill, while keeping each color's model. Given a group without an
|
||||
Appearance item, they recolor the active proxy's fills or strokes of the objects inside it and of the group itself;
|
||||
`target: "contents"` leaves the group's own fills or strokes as they are. `paint.lastColor` /
|
||||
`paint.lastGradient` re-apply the last solid color or gradient, and `paint.recent` returns the recent colors that every
|
||||
paint command (and the eyedropper) feeds: up to 30, newest first and each once, kept across documents for the session.
|
||||
`paint.proxies` returns what the proxies show: the fill and stroke, which one is active, and whether the selected
|
||||
@@ -849,15 +854,17 @@ inside a series group other than a path directly in it, a legend swatch's includ
|
||||
reached through `target: "contents"`. These commands leave that art out, edit the other objects they are given, and
|
||||
are an error when all their objects are design art: the `appearance.*` commands listed above, `effect.apply`,
|
||||
`appearance.addEffect` and the other `effect.*` commands that edit, move or remove an effect,
|
||||
`effect.expandAppearance` (which also leaves the art inside a selected graph or series group as it was, unless an
|
||||
effect of that group turns the whole group into other art, and is disabled when only design art is selected or
|
||||
given), `threeD.mapGraphic`,
|
||||
`effect.expandAppearance` (which also leaves the art inside a selected graph or series group as it was, except that
|
||||
an effect of that group which reshapes or replaces the whole group bakes into that art too, and is disabled when only
|
||||
design art is selected or given), `threeD.mapGraphic`,
|
||||
`graphicStyle.apply`, `graphicStyle.addFromLibrary` with `apply`, `graphicStyle.breakLink`, `transparency.set`, the
|
||||
`paint.freeform.*` commands that edit points and lines, and `appearance.copyFrom` as the target.
|
||||
`appearance.transfer` with design art as its `target`, or as its `source` without `copy`, is an error.
|
||||
`paint.setFill`, `paint.setStroke`, `paint.swap`, `paint.default`, `paint.invert` and `paint.complement` with an
|
||||
`item`, `stroke.set`, `stroke.weightUp`, `stroke.weightDown`, `stroke.setAdvanced`, `paint.editGradient`,
|
||||
`paint.setGradientGeom` and `object.setOverprint` leave the art out without an error. When the first selected object is design art, the commands
|
||||
`paint.setFill`, `paint.setStroke`, `paint.swap`, `paint.default`, `paint.invert`, `paint.complement`,
|
||||
`stroke.set`, `stroke.weightUp`, `stroke.weightDown`, `stroke.setAdvanced`, `paint.editGradient`,
|
||||
`paint.setGradientGeom` and `object.setOverprint` leave the art out without an error. When all their objects are design art,
|
||||
`paint.editGradient`, `paint.swap`, `paint.default`, `paint.invert`, `paint.complement` and `stroke.set` also leave
|
||||
the paint and stroke weight for new art and the remembered colors as they are. When the first selected object is design art, the commands
|
||||
do not use the Appearance panel's active row. When the first object given is design art, rows and effects given with
|
||||
`aligned: true` are rows of its stack in `appearance.setItem`, `appearance.removeItem`, `appearance.duplicateItem`,
|
||||
`transparency.set` with an `item`, `effect.apply`, `appearance.addEffect` and the other `effect.*` commands that edit,
|
||||
@@ -921,7 +928,8 @@ its own, can move or scale the plot at the next redraw. When all of a graph's ar
|
||||
the art measured has no width or no height, a redraw leaves the plot where it is and does not follow a move or scale of
|
||||
the graph. A graph opened from a `.ai` file
|
||||
saves `placedArt` too. A graph saved without `placedArt`, or with a `placedArt` that has no width or height, is
|
||||
measured on `placed`.
|
||||
measured on `placed`. `placed` includes the labels, so in such a graph moving an outermost label on its own can move or
|
||||
scale the plot at the next redraw.
|
||||
|
||||
The `appearance.*` commands, `graphicStyle.apply` and `graphicStyle.redefine`, and the paint, stroke, gradient and
|
||||
transparency commands given an `item` (or the Appearance panel's active row) store a graph label's object rows for its
|
||||
@@ -1313,7 +1321,7 @@ unknown label is refused. The `warnings` of the result name the first three such
|
||||
|
||||
Opening a PDF (or `.ai`) imports every page as an artboard and layer; `document.open` takes `pages` ("2-3, 5", 1-based),
|
||||
`cropTo` (`bounding` (the art's bounds), `art`, `crop` (default), `trim`, `bleed`, `media`: the box each artboard gets;
|
||||
with `trim` the bleed box round it becomes the document's bleed, and a PDF-compatible `.ai` or a PDF saved with its editing data opens on its trim boxes for
|
||||
with `trim` the bleed box round it becomes the document's bleed and the artboards are 36 pt apart plus that bleed on both sides, and a PDF-compatible `.ai` or a PDF saved with its editing data opens on its trim boxes for
|
||||
`crop`, its crop box taking the bleed in) and `password` for an encrypted file. `document.pdfInfo` reads a file without opening it: the page count, each page's
|
||||
size and boxes, `needsPassword`, and with `thumbnail: n` a PNG of page n. It reads a PostScript file (an EPS, a `.ps`
|
||||
file, a `.ai` in PostScript form) as one page the size of its bounding box (a US Letter page without one), with an
|
||||
@@ -1420,9 +1428,11 @@ Drive a tool like a mouse:
|
||||
|
||||
Edit a gradient with the Gradient tool's annotator (the bar runs along the vector; stop chips sit 10 px under
|
||||
it, midpoint diamonds 7 px above): a click on the bar adds a stop, dragging a chip moves it (drag it off the bar to
|
||||
delete it, hold Alt to copy it), dragging the end handle changes the vector. Both ends of a vector drawn on the art,
|
||||
the start of one a click applies, and the dragged start and end handles snap as drawn points do; with Shift, the end
|
||||
or the handle keeps to 45° steps and snaps along them. The selected stop
|
||||
delete it, hold Alt to copy it), dragging the end handle changes the length (the end stays on the bar's line, at
|
||||
least 10 px from the start), and Alt-dragging it changes the length and angle together. Both ends of a vector drawn
|
||||
on the art, the start of one a click applies, and the dragged start and end handles snap as drawn points do (the end
|
||||
handle without Alt only onto points on the bar's line); with Shift, the end of a drawn vector, the Alt-dragged end
|
||||
handle or the start handle keeps to 45° steps and snaps along them. The selected stop
|
||||
(`gradient.selectStop`) takes Delete and ←/→:
|
||||
|
||||
```json
|
||||
@@ -3374,6 +3384,14 @@ already walks Image Trace. Short agent entry points:
|
||||
`largeList`. Without `view` the command answers the current one. Each panel keeps its own view for the session, and
|
||||
the document does not change. An unknown panel or view is an error, and then nothing changes. It answers
|
||||
`{panel, view}`.
|
||||
- Panel display sizes: `window.panel.cycleOptions {panel}` shows the panel at its next display size, as the double
|
||||
triangle at the right end of its tab strip does, docked or floating. The sizes are the states its panel menu's Show
|
||||
Options and Hide Options items set, largest first, and the smallest is followed by the largest. Align, Attributes,
|
||||
Character, Color, Flattener Preview, Gradient, Info, Paragraph, Stroke and Transform have two sizes (options shown,
|
||||
options hidden). Transparency has three: thumbnails and options, thumbnails alone, and neither. A panel whose
|
||||
states match none of its sizes goes to its largest. An unknown panel or a panel without display sizes is an error,
|
||||
and then nothing changes. It answers `{panel, size, sizes}`, where `size` 0 is the largest. The order of the sizes
|
||||
and the panels that have them are VectorCraft's own.
|
||||
- The Brushes panel menu's Select All Unused: `brush.unused` (a query) lists the brushes no stroke paints with, in
|
||||
library order, and the panel selects them. Strokes in the art (opacity masks included), symbols, graph designs,
|
||||
pattern tiles (with the tiles that pattern editing's Cancel puts back) and graphic styles count, and so do the
|
||||
@@ -3547,6 +3565,11 @@ already walks Image Trace. Short agent entry points:
|
||||
image value that isn't a file's absolute path, and past `variable.loadLibrary`'s caps (256 variables, 1,000 data
|
||||
sets, 8 MiB). Without `path` the reply is `{xml, variables, datasets}`; with it, the file is written and the reply
|
||||
is `{path, variables, datasets}`.
|
||||
- Import a data source: `variable.import {path}` (the Variables panel menu's Import…) reads a data source file by its
|
||||
extension, in any case: a `.csv`, `.tsv` or `.txt` file as `dataset.import {path}` reads it, and an `.xml` file as
|
||||
`variable.loadLibrary {path}` reads it, with that command's refusals, undo step and reply, plus `format` (`csv` or
|
||||
`xml`). A path with any other extension, or none, is refused before the file is read. The panel menu's Import Data
|
||||
Sets… and Load Variable Library… stay.
|
||||
- Batch: `action.batch {commands, source?: folder|datasets, folder?, destination?: none|saveAndClose|folder,
|
||||
destinationFolder?, overrideOpen?, overrideSave?, overrideExport?, includeSubdirs?, stopOnError?}` plays an
|
||||
action on every file in a folder or every data set (the Actions panel menu's Batch…). Override Save and Override
|
||||
@@ -3847,6 +3870,15 @@ already walks Image Trace. Short agent entry points:
|
||||
`paths` and `anchors` count the traced paths only.
|
||||
With `keepColors` in `params`, the reply's `warnings` name each listed color that no traced color matches, and say
|
||||
when nothing was traced.
|
||||
`noise` (Color, Grayscale and Black and White, not Flat Logo) merges areas smaller than that many pixels into a
|
||||
neighboring color. Each one joins the color it shares the longest border with, unless that color is 10 or more apart from its own (Oklab
|
||||
× 100). Then it joins the neighboring color nearest the average of its pixels, among the colors that share at
|
||||
least a tenth of the longest border. The average is taken in the image as prepared for tracing (deblocked, and
|
||||
smoothed for a photo) and leaves out the semi-transparent pixels along a cut-out image's edge that are the color
|
||||
beside them blended with the transparent background. A single pixel whose
|
||||
longest border is tied between two or more colors always joins by border. In Black and White an area has only one
|
||||
neighboring color. These distances and fractions are VectorCraft's own values. The built-in presets 6 Colors and 16
|
||||
Colors use Noise 8, and Black and White Logo uses Noise 5.
|
||||
`imageTrace.presets.save {name?, newName?, preset?, enhanced?, params?}` saves tracing settings as a preset kept with
|
||||
the preferences: `params` over `preset`'s (default: the saved preset `name`, else Default), checked as `imageTrace.make`
|
||||
checks them; without `name` it is a new "Tracing Preset N", and `newName` renames a saved preset (the reply's
|
||||
@@ -5745,7 +5777,9 @@ the drag takes what the pen read there (the points' pressure, tilt and rotation,
|
||||
drag without that reading, such as a mouse drag, erases at the value itself. One Random value per drag, which way
|
||||
Tilt, Bearing and Rotation run, and the value itself without a reading are VectorCraft's own rules.
|
||||
The command refuses another mode, and a variation below 0 or past its range, and erases nothing. In the desktop app
|
||||
the Eraser's tip outline at the pointer takes the angle, roundness and size the pen gives while it erases.
|
||||
the Eraser's tip outline at the pointer takes the angle, roundness and size the pen gives while it erases, and the
|
||||
outline of the area a drag covers takes, at each step, the tip the pen's readings give halfway along it. A Random
|
||||
value shows as the value itself there, since the release draws it.
|
||||
`tool.setOption {tool: "eraser"}` takes the same keys.
|
||||
|
||||
These commands refuse a string or another value that is not a number with `` `dy` must be a number, not "10" ``,
|
||||
@@ -5852,7 +5886,7 @@ direction.
|
||||
|
||||
`path.smoothRegion` keeps an anchor as a corner where the path turns by more than 57.5° (an angle inside the corner
|
||||
under 122.5°) at the anchor and also over `radius` and over twice `radius` on either side of it (on a closed path that the drag reaches all the
|
||||
way round, no more than an eighth of its length), so a jag or a bump smaller than `radius` is still smoothed. The stretches on either side of a kept corner are smoothed and refitted on their
|
||||
way round, no more than an eighth of its length), measured along the path however many segments it is cut into, so a jag or a bump smaller than `radius` is still smoothed. The stretches on either side of a kept corner are smoothed and refitted on their
|
||||
own, and the corner keeps its place and the directions the path arrives and leaves along, on every call and at any
|
||||
`fidelity`. A call that changes no anchor returns `{ids: [], before: 0, after: 0}` and adds no undo step. The 57.5°
|
||||
threshold is VectorCraft's own value.
|
||||
@@ -5925,7 +5959,11 @@ are converted to, an RGB image that carries an ICC profile is converted from tha
|
||||
and then to the destination, instead of having its numbers read as sRGB (a profile the color engine can't read leaves
|
||||
them read as sRGB, with a warning); a gray image keeps its profile, as gray is not converted. An RGB destination other
|
||||
than sRGB that is the document's own RGB profile leaves RGB colors and RGB images as they are, so a tagged RGB image keeps its profile
|
||||
there.
|
||||
there. Any other image whose colors are converted (a CMYK image, or an RGB image going to a CMYK destination or to an
|
||||
RGB one other than sRGB) but whose pixels are more than VectorCraft decodes or can't be written that way is left out with
|
||||
the warning "an image couldn't be converted to the Output destination and is missing from the picture", rather than
|
||||
written in its own colors. One whose pixel data can't be read is left out with the warning "an image couldn't be decoded
|
||||
and is missing from the picture", as without a conversion.
|
||||
`preserveNumbers` still reads an image's numbers as sRGB. The destination is any profile `edit.colorSettings` lists (default: the document's
|
||||
for its colour mode). `profiles` (`all`, `destination`, or `taggedSource` for a document assigned profiles with
|
||||
`edit.assignProfile`) writes colours in ICC-based spaces with their profiles embedded: CMYK with the destination's or
|
||||
@@ -7202,7 +7240,10 @@ that draws the image does not decode the file again.
|
||||
`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
|
||||
`press_key` (Left/Right/Up/Down cycle, Escape discards the current file). `file.place`, `file.place.queue` and
|
||||
`press_key` (Left/Right/Up/Down cycle, Escape discards the current file). The cursor keeps an encrypted PDF, `.ai`
|
||||
or `.ait` file that it cannot read without the password, at 612 × 792 pt (VectorCraft's own size) with
|
||||
`needsPassword: true` and no thumbnail; in the app a click or drag on it asks for the password, and headless it places
|
||||
nothing. `file.place`, `file.place.queue` and
|
||||
`file.place.info` refuse, of the keys each one takes, a `link`, `replace` or `template` that is not true or false and a `thumbnail` that is not a
|
||||
number, naming the key, and place nothing; null is the same as leaving the key out.
|
||||
|
||||
@@ -7213,7 +7254,8 @@ slices (Place PSD). `showImportOptions: false` places such a file without asking
|
||||
its dialog: the text options, the DXF fit, lineweight, centering and layer choices with the drawing at 1:1 in its own
|
||||
unit, and the PSD conversion, hidden-layer and Import Slices choices. A PDF is placed on page 1 (or `page`) and its
|
||||
crop box, and an encrypted PDF given no
|
||||
`password` still asks for the password. A `showImportOptions` that is not true or false is refused, and nothing is placed. The
|
||||
`password` still asks for the password. An encrypted PDF given a `page` and no `password` asks for the password with
|
||||
Show Import Options on too, and places that page. A `showImportOptions` that is not true or false is refused, and nothing is placed. The
|
||||
Place dialog (File › Place, or `file.place {paths}`) has a Show Import Options checkbox after Link, Template and
|
||||
Replace ([Place multiple files in a document](https://helpx.adobe.com/illustrator/desktop/add-and-import-files/import-other-file-types/place-multiple-files-in-a-document.html)).
|
||||
It is on by default and saved with the preferences. On, each file that has import options asks for them before it is
|
||||
@@ -7253,8 +7295,10 @@ color first.
|
||||
|
||||
A global or spot swatch whose name the document gives another colour is a conflict: `clipboard.conflicts` lists
|
||||
them, and `swatchConflict` answers: `"merge"` (the default: the objects take the document's swatch), `"add"` (the
|
||||
pasted swatch comes in renamed) or one answer per name. Pasting back into the document the objects came from uses
|
||||
its resources as they are now and raises no conflict.
|
||||
pasted swatch comes in renamed) or one answer per name. When a merged swatch turns a pie's wedge from light to dark
|
||||
or back, the legend labels in that pie's wedges take the contrast a redraw gives them (white on a dark wedge, black on
|
||||
a light one), unless the legend labels have a fill of their own. Pasting back into the document the objects came from
|
||||
uses its resources as they are now and raises no conflict.
|
||||
|
||||
Placement: `edit.paste {center}` centres the objects on a point (the app passes the view centre), else offsets them
|
||||
by `dx`/`dy` (the Paste Offset preference). With nothing selected, `edit.pasteInFront` / `edit.pasteInBack` put them
|
||||
@@ -9606,9 +9650,15 @@ around them ([the help page](https://helpx.adobe.com/illustrator/using/formattin
|
||||
the default and how the space is measured are VectorCraft's own rules: the value is from 0 to 100, 0 by default and
|
||||
saved only when not 0, and it is the share of the blank space on each side of a character's ink, inside the
|
||||
character's own width, that is taken away. 50 halves that space, and 100 sets the ink against the characters before and
|
||||
after it; the glyph keeps its shape. A character without ink, such as a space, keeps its width. A ligature or a letter
|
||||
with its marks takes the value of its first character. Tracking, kerning and Insert Aki are added after it, and
|
||||
justification keeps it. Tsume applies to horizontal type; vertical type keeps its spacing. Character styles carry it
|
||||
after it; the glyph keeps its shape. The ink of a color glyph is the color art or bitmap drawn for it, not its outline.
|
||||
A character without ink, such as a space, keeps its width. A ligature or a letter with its marks takes the value of its
|
||||
first character. Tracking, kerning and Insert Aki are added after it, and justification keeps it. Vertical type takes
|
||||
it too ([the help page](https://helpx.adobe.com/illustrator/desktop/design-with-text/edit-format-text/format-east-asian-characters-in-vertical-text.html)):
|
||||
a character that stands upright loses the share of the space above and below its ink, inside its cell down the column
|
||||
(its vertical advance from the font's vertical metrics, else at least one em, with the Proportional Metrics change to
|
||||
it), and moves up with it; a character lying on its side is measured along its own width, as in horizontal type; the
|
||||
characters of a tate-chu-yoko block move closer across the column, and the block keeps its one em down the column. A
|
||||
mark in an upright character's cluster moves with it, and Tsume measures the character's own ink only. Character styles carry it
|
||||
(`charStyle.new`, `charStyle.setAttrs` and `charStyle.edit` refuse a value outside the range). A value that is not a
|
||||
number is refused with `` `tsume` must be a number ``, and one outside the range with `` `tsume` must be from 0 to
|
||||
100 ``. One undo step, and a call that gives the value the characters already have records none. With Show East Asian
|
||||
@@ -10101,8 +10151,8 @@ other marks take the values of their letter. Setting one value leaves the other
|
||||
saved only when not 0, and character styles carry them (`charStyle.new`, `charStyle.setAttrs` and `charStyle.edit`
|
||||
refuse a value outside the range). A value that is not a number is refused with `` `diacriticHorizontal` must be a
|
||||
number ``, and one outside the range with `` `diacriticHorizontal` must be from -1000 to 1000 ``, naming the key. One
|
||||
undo step, and a `text.setFormat` call that gives the values the characters already have records none. With Show Middle Eastern
|
||||
Options on, the Character panel shows both fields, blank where the selected characters differ, with -200, -100, -50,
|
||||
undo step, and a `text.setFormat` call that gives the values the characters already have records none. With Show Indic Options
|
||||
on, the Character panel shows both fields, blank where the selected characters differ, with -200, -100, -50,
|
||||
0, 50, 100 and 200 in their menus, and a value typed past either end sets that end; Reset Panel sets both to 0.
|
||||
Character Style Options shows both fields in Advanced Character Formats. The canvas, PDF export and outlines draw the
|
||||
moved marks; SVG export writes type with a moved mark as outlines.
|
||||
|
||||
File diff suppressed because one or more lines are too long
+12
-3
@@ -190,7 +190,9 @@ The rest is our reading:
|
||||
curved surfaces follow this only as closely as their flat facets do. A solid painted with a gradient that has
|
||||
transparent stops under a light that is not white is drawn with an opacity mask: its faces keep their places in
|
||||
this order, in runs that each carry the mask, and a graphic drawn after one of its faces carries the mask too
|
||||
([Graphics](#graphics)). A member of a 3D group with its own opacity
|
||||
([Graphics](#graphics)). Such a gradient, and a gradient with transparent stops under the classic effects'
|
||||
shading, is placed once on the whole solid when it has no placement of its own, so its colors and its
|
||||
transparency line up across the faces. A member of a 3D group with its own opacity
|
||||
mask or blending mode draws its fill's and strokes' faces in this order inside that mask or blending mode when
|
||||
they are opaque with Normal blending. Otherwise each solid is drawn on its own with its opacity and blending, the
|
||||
lower item's first. With a light that is not white, a puffed, shaded Inflate surface in a solid color takes its
|
||||
@@ -375,8 +377,15 @@ is drawn larger, above the others.
|
||||
|
||||
The widget sends the same settings as the Rotation, Height and Light behind the object controls
|
||||
(`effect.setParams`); there is no command of its own. The sphere's look, the 0.1° rounding and the arrow keys
|
||||
are VectorCraft's own. The options dialogs keep the light rings on the artboard instead, and the Lighting tab
|
||||
of Extrude & Bevel (Classic), Revolve (Classic) and Rotate (Classic) has no lighting widget.
|
||||
are VectorCraft's own. The options dialogs of Extrude & Bevel, Revolve, Inflate and Rotate keep the light rings
|
||||
on the artboard instead.
|
||||
|
||||
The Lighting tab of Extrude & Bevel (Classic), Revolve (Classic) and Rotate (Classic) has the same sphere, in
|
||||
the options dialog as well as in the panel, while the surface is Diffuse or Plastic, as the archived
|
||||
[lighting options](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=272) of
|
||||
the classic 3D dialogs describe. Their lights have no color, so every sun is white. The light rings on the
|
||||
artboard stay available in the dialog. **Add Light** adds a light at the front center of the sphere (Rotation
|
||||
0°, Height 90°), and **Delete Light** removes the selected light and is unavailable while one light is left.
|
||||
|
||||
### Light settings
|
||||
|
||||
|
||||
@@ -406,6 +406,7 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| Floating groups stack into sets; sets dock as extra dock columns (a multi-column dock); groups drop anywhere in a set or column, or onto its tabs; a column taller than the window scrolls | done | `window.panel.float {below, above}`, `window.panel.dock {column}` |
|
||||
| Panels dragged onto a dock group's tabs join it; onto its upper or lower half they make a new group above or below it (a top/bottom split, resizable); onto the icon column they become icons, the tabbed group's panels too; a dock tab's context menu closes it (Window menu reopens it) | done | `window.panel.dock {anchor, zone}`, `window.panel.dock {icon: true}`, `window.panel.close` |
|
||||
| A double-click on a dock group's tab collapses the group to its tabs (a group below it moves up into the room) and a second one expands it; a click on another of its tabs expands it showing that panel ([helpx: Workspace basics](https://helpx.adobe.com/illustrator/using/workspace-basics.html), panel groups) | done | `window.panel.collapse {panel, collapsed?}`; in dock groups and floating windows; a group beside another (a left/right split) doesn't collapse |
|
||||
| The double triangle at the right end of a panel's tab strip cycles the panel's display sizes, the states its Show/Hide Options (and Transparency's Show/Hide Thumbnails) panel-menu items set ([archived user guide](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=189), Transparency; [archived user guide](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=479), Character and Paragraph) | done | `window.panel.cycleOptions {panel}`; Align, Attributes, Character, Color, Flattener Preview, Gradient, Info, Paragraph, Stroke, Transform and Transparency; the order of the sizes, the glyph and where it sits are VectorCraft's own (#3041) |
|
||||
| Panels outside the app window (another monitor) | done | floating groups in OS windows of their own on the desktop (#4135) |
|
||||
| Edit Toolbar (•••): the All Tools drawer opens beside the toolbar by its button (Escape or a click outside closes it), dims the tools already in the toolbar; while it is open, tools drag from it onto the toolbar (between two tools, or onto one to join its group), from the toolbar into it, and within the toolbar; each toolbar keeps its edits | done | #1018; `window.editToolbar`, `toolbar.addTool`/`removeTool`/`reset`; the drawer's Reset (Illustrator has it in a drawer menu); dragging a toolbar button moves the tool it shows, not its whole group; tool flyouts are as wide as their longest translated name and shortcut need (#1616) |
|
||||
| Window › Toolbars › New Toolbar… (also in the All Tools drawer's menu): a name and OK make a blank floating toolbar, listed under Window › Toolbars (its item shows or hides it); its title bar moves it, its × hides it and its double arrow shows its tools in one column or two; its ••• button opens the All Tools drawer beside it to fill it; kept with the workspace it was made in | done | #1759 in part; `window.toolbar.new`, `window.toolbar.custom`, `window.toolbar.list`, the `toolbar` param of `window.toolbarColumns`, `window.editToolbar` and `toolbar.addTool`/`removeTool`/`reset` |
|
||||
@@ -455,6 +456,7 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| Gradient panel: Method, Classic or Perceptual (30.0) | done | Method menu under the Stroke buttons for linear and radial gradients (`paint.editGradient` `method`); [public source](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/create-and-edit-gradients/control-perceptual-interpolation-in-gradients.html); `panels::gradient` test |
|
||||
| Gradient panel: Presets (30.0) | done | Presets menu by library (theme) plus Saved: applies a preset to the gradient behind the active proxy, keeping its placement, one undo step; panel menu Save Gradient Preset…, Delete Gradient Preset, Hide/Show Presets (`gradient.presets.*`); `panels::gradient` tests |
|
||||
| Gradient panel: delete a stop | done | Delete Stop at the right end of the ramp deletes the selected stop, and a stop dragged down off the ramp is deleted on release, never below two stops, one undo step each; [Gradient panel options](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/create-and-edit-gradients/gradient-tool-and-panel.html); `panels::gradient` test |
|
||||
| Gradient tool: the annotator's end handle changes the length; Alt-drag changes the length and angle together | done | A plain drag keeps the end on the bar's line, at least 10 px from the start (VectorCraft's own minimum); Alt-drag moves it freely, Shift with Alt at 45° steps; [Default keyboard shortcuts](https://helpx.adobe.com/illustrator/using/default-keyboard-shortcuts.html); `xform::gradient` tests |
|
||||
| Workspaces (save, reset, switch); each remembers the layout changes made in it across switches and restarts until Reset <name> | done | `UiState::workspace_changes` |
|
||||
| Opening a file: after 0.4 s a progress window with the file name, a moving bar (reading counts no steps), how many more files wait, Cancel (Esc: the file doesn't open) and Continue in Background; never over another dialog or progress window | done | #5930; `opening::show`, `file.cancelOpen`, `file.openInBackground`. Save, Place and Close still show only the status bar's spinner (Place and Save run off the UI thread; Close is immediate) |
|
||||
| Window › Help Bar shows or hides the tool-help strip apart from the status bar; kept with the preferences and in saved workspaces; Presentation Mode hides both bars | done | `window.helpBar`; `help_bar_toggle_is_independent_and_saved_in_workspaces`, `help_bar_and_status_bar_render_independently`, `legacy_help_bar_visibility_follows_each_layouts_status_bar` |
|
||||
|
||||
Reference in New Issue
Block a user