mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-19 09:13:34 +00:00
Merge main (36b5a5920) into fix/ai-dashes-aligned-to-corners
Conflicts in docs (the status lines, the changelog rows, the M4 Files row and the File formats rows): main's entries and this branch's are both kept, each once. In crates/eps/src/import/ai.rs main's brush re-export (now with `turn_over as turn_brush_art_over`) and this branch's test-only `DASH_CHECKS_MADE` re-export are both kept. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+5
-1
@@ -297,7 +297,11 @@ other `sv-*` locale resolve to it), Georgian (`ka`, complete; `ka-GE` and `ka_GE
|
||||
control channel, MCP and tests read them) and are translated only where the status bar draws them
|
||||
(`i18n::msg`). `@msg` catalog rows hold a whole message or a template such as
|
||||
`Couldn't open {name}: {e}`; `{_1}`, `{_2}` … stand for the format string's `{}`, and the values in the
|
||||
placeholders are translated in turn (the reason after `: {e}` is often a message too). A value that starts with
|
||||
placeholders are translated in turn (the reason after `: {e}` is often a message too). A template needs text
|
||||
between any two placeholders, since the catalog cannot tell where `{a}{b}` splits: make the message with the
|
||||
side-by-side values joined into one (`unknown parameter `{key}``, where `key` is `marks.ofset`). The catalog
|
||||
leaves out a row whose template has two placeholders in a row or no text; `i18n::tests` fails on such a row
|
||||
and on such a message, and the untranslated report counts it as missing. A value that starts with
|
||||
`{` is translated only when it has an exact row, so a JSON object stays as it is; a value that starts with `[` is
|
||||
also matched against a template that starts with `[` and an index of digits, such as an effect's refusal
|
||||
``[{j}] `{_1}`: {why}``, so its reason is translated while a JSON array stays as it is. A literal brace in a
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Effects parity
|
||||
|
||||
> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-11-12 · **Change:** minor (Extrude & Bevel, Inflate and Rotate seams have round joins under a white light and in the 3D (Classic) effects too, no longer reaching past the solid as thorns; previously: Effect Gallery: a thumbnail for each filter and an in-dialog preview on an original drawing; the 1–2 h for those is done; Extrude & Bevel, Inflate and Rotate merge contours that cross, touch or overlap, as type often draws a glyph, before building a solid; previously: Extrude & Bevel, Inflate and Rotate apply to groups and layers, their objects turning about one shared axis (#4506); the Transform effect's copies of a path with a fill and a stroke (or several fills and strokes, an even-odd fill, or a partly transparent one) are drawn each above the one before, as Expand Appearance makes them (#5920); Expand Appearance makes each copy of a path's Transform effect an object of its own (#5612); previously: Pixelate › Color Halftone: Max Radius in pixels of the Document Raster Effects resolution, 4–127 px, with older documents converted on opening and radii written back in points for older app versions (#3260); Effect dialogs clamp bounded length inputs immediately on commit and flash rejection on invalid input (#4638); previously: Drop Shadow Darkness uses fixed RGB subtraction and CMYK black addition; scores unchanged; Pathfinder › Trap: the Pathfinder panel's Trap… and Effect › Pathfinder › Trap… add an overprinting strip of the lighter colour where two solid colours meet; recounted with Hard Mix (#3061) and Soft Mix already in the catalogue: Pathfinder 13/13, Illustrator effects 49/50) · **Target:** Adobe Illustrator 2026 (30.x)
|
||||
> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-11-17 · **Change:** minor (Twist: a strongly twisted path joins its pieces without kinks, #7069; scores and estimates unchanged; previously: Extrude & Bevel, Inflate and Rotate seams have round joins under a white light and in the 3D (Classic) effects too, no longer reaching past the solid as thorns; previously: Effect Gallery: a thumbnail for each filter and an in-dialog preview on an original drawing; the 1–2 h for those is done; Extrude & Bevel, Inflate and Rotate merge contours that cross, touch or overlap, as type often draws a glyph, before building a solid; previously: Extrude & Bevel, Inflate and Rotate apply to groups and layers, their objects turning about one shared axis (#4506); the Transform effect's copies of a path with a fill and a stroke (or several fills and strokes, an even-odd fill, or a partly transparent one) are drawn each above the one before, as Expand Appearance makes them (#5920); Expand Appearance makes each copy of a path's Transform effect an object of its own (#5612); previously: Pixelate › Color Halftone: Max Radius in pixels of the Document Raster Effects resolution, 4–127 px, with older documents converted on opening and radii written back in points for older app versions (#3260); Effect dialogs clamp bounded length inputs immediately on commit and flash rejection on invalid input (#4638); previously: Drop Shadow Darkness uses fixed RGB subtraction and CMYK black addition; scores unchanged; Pathfinder › Trap: the Pathfinder panel's Trap… and Effect › Pathfinder › Trap… add an overprinting strip of the lighter colour where two solid colours meet; recounted with Hard Mix (#3061) and Soft Mix already in the catalogue: Pathfinder 13/13, Illustrator effects 49/50) · **Target:** Adobe Illustrator 2026 (30.x)
|
||||
|
||||
Every entry of Illustrator's Effect menu, by its public feature name, against VectorCraft's effects catalogue
|
||||
(`effect_catalog()` in `crates/effects/src/lib.rs`) and the Effect menu built from it
|
||||
@@ -22,7 +22,7 @@ Part of [target-app-parity.md](target-app-parity.md); open work is in [gaps.md](
|
||||
|---|---|---:|---|
|
||||
| Convert to Shape | Rectangle, Rounded Rectangle, Ellipse | 3/3 | — |
|
||||
| Crop Marks | Crop Marks | 1/1 | — |
|
||||
| Distort & Transform | Free Distort, Pucker & Bloat, Roughen, Transform, Tweak, Twist, Zig Zag | 7/7 | Free Distort's dialog has a handle on each corner of the object's bounds, moved by dragging or with the arrow keys; Zig Zag's ridges are evenly spaced along each segment (#1558), and Smooth points make a continuous wave whose peaks and valleys have handles along the path (#2343); Roughen with Smooth keeps turn-backs smooth instead of cusps that draw as spikes (#1646); Expand Appearance of a path whose Transform effect makes copies gives a group of one object per copy, each painted as the path, and a second Transform effect's copies nest in a group per copy of the first (#5612); drawn, each copy of a path with a fill and a stroke (or several, an even-odd fill or a partly transparent one) paints below the one before, the fills above covering the strokes of the copies below, instead of one path of every copy (#5920), and a group's copies each hold all its members except guides, the original group on top (#6316); a clipping group, a group with a fill or stroke of its own, a group whose type is kept as type, and a group with a member that carries a geometry, Pathfinder or 3D effect copy each member in its place |
|
||||
| Distort & Transform | Free Distort, Pucker & Bloat, Roughen, Transform, Tweak, Twist, Zig Zag | 7/7 | Free Distort's dialog has a handle on each corner of the object's bounds, moved by dragging or with the arrow keys; Zig Zag's ridges are evenly spaced along each segment (#1558), and Smooth points make a continuous wave whose peaks and valleys have handles along the path (#2343); Roughen with Smooth keeps turn-backs smooth instead of cusps that draw as spikes (#1646); Expand Appearance of a path whose Transform effect makes copies gives a group of one object per copy, each painted as the path, and a second Transform effect's copies nest in a group per copy of the first (#5612); drawn, each copy of a path with a fill and a stroke (or several, an even-odd fill or a partly transparent one) paints below the one before, the fills above covering the strokes of the copies below, instead of one path of every copy (#5920), and a group's copies each hold all its members except guides, the original group on top (#6316); a clipping group, a group with a fill or stroke of its own, a group whose type is kept as type, and a group with a member that carries a geometry, Pathfinder or 3D effect copy each member in its place; Twist's handles follow the rotation's derivative, so a strongly twisted path is a smooth spiral without kinks where its pieces join (#7069, `twist_joins_its_pieces_smoothly`). |
|
||||
| Path | Offset Path, Outline Object, Outline Stroke | 3/3 | With Use Preview Bounds on, Align, Distribute and the Transform panel still measure type that carries Outline Object by its layout box (preview bounds leave out effects) |
|
||||
| Pathfinder | Add, Intersect, Exclude, Subtract, Minus Back, Divide, Trim, Merge, Crop, Outline, Hard Mix, Soft Mix, Trap | 13/13 | Trap traps only solid fills (gradients and patterns hide what is below them but don't trap) and spreads each colour's visible area as a whole; the public page gives no default values, so Trap's 0.25 pt, 100% and 40% are VectorCraft's own |
|
||||
| Rasterize | Rasterize… (as a live effect) | 1/1 | — |
|
||||
@@ -193,6 +193,7 @@ angular cut caps, exact visibility, the rest of 3D Classic (Map Art), Turntable)
|
||||
|
||||
| Date | Change | Summary |
|
||||
|---|---|---|
|
||||
| 2026-11-17 | minor | Distort & Transform › Twist: handles follow the rotation's derivative, so a strongly twisted path is a smooth spiral instead of pieces meeting at kinks (#7069; `twist_joins_its_pieces_smoothly` in `crates/effects/src/tests.rs`). Scores and estimates unchanged. |
|
||||
| 2026-11-12 | minor | The seams of Extrude & Bevel, Inflate and Rotate under a white light, and of the faces of Extrude & Bevel (Classic), Revolve (Classic) and Rotate (Classic), went from miter to round joins (the seams of Revolve and of colored lights, and 3D (Classic) Wireframe edges, were already round): no thorns on edge-on facets, and facets with no neighbor now have rounded convex corners ([three-d.md](three-d.md#seams)); scores and estimates unchanged |
|
||||
| 2026-11-10 | minor | Effect Gallery: each filter has a thumbnail, and the dialog has a preview of the visible stack (or the browsed filter when the stack is empty). Both are an original landscape drawing passed through the filter ([Filter Gallery overview](https://helpx.adobe.com/photoshop/desktop/effects-filters/get-started-with-filters/filter-gallery.html)). The canvas preview and one-undo OK are unchanged. Remaining hours for the gallery's thumbnails and in-dialog preview: 1–2 → none. Counts unchanged (57/57). |
|
||||
| 2026-11-08 | minor | Extrude & Bevel, Inflate and Rotate merge contours that cross, touch or overlap (a glyph's arm across its stem) before building a solid, so the solid follows the shape as it is filled; others are built as drawn ([three-d.md](three-d.md)); scores and estimates unchanged |
|
||||
|
||||
File diff suppressed because one or more lines are too long
+49
-8
@@ -3618,7 +3618,10 @@ already walks Image Trace. Short agent entry points:
|
||||
a straight Pencil line too, or with Alt held at the release. The stroke's end then joins the other end when it is
|
||||
within four times the Fidelity of it (at least 6 pt and at most 400 pt), and a straight segment closes the path from
|
||||
farther away. Without `closed`, the stroke closes the path when it ends within that four-times-Fidelity distance. The
|
||||
Blob Brush's `path.blob` Fidelity stays in points, 0.01 to 100 pt.
|
||||
Blob Brush's `path.blob` Fidelity stays in points, 0.01 to 100 pt, and is
|
||||
not used when left out or null. `path.blob` rejects a `fidelity` outside 0.01 to 100 pt, an `angle` outside -180° to
|
||||
180° and a `roundness` outside 0% to 100% with an error such as `` `angle` must be from -180 to 180 degrees ``; the
|
||||
document does not change and no undo step is recorded. These ranges are VectorCraft's own values.
|
||||
- Variables: `variable.list`, `variable.define {name, kind: text|visibility|image|graph}`, `variable.bind {variable, ids?}`,
|
||||
`variable.makeTextDynamic`, `variable.makeVisibilityDynamic`, `variable.makeImageDynamic`, `variable.makeGraphDynamic`
|
||||
(`variable.bind` and `variable.makeTextDynamic` refuse type that already has another text variable and name it),
|
||||
@@ -6057,6 +6060,11 @@ These commands refuse a string, a number or another value that is not true or fa
|
||||
in `path.curvatureEdit`; `perpendicular` in `path.reshapeSegment`; and `keepSelected`, `mergeOnlySelection` and
|
||||
`merge` in `path.blob`. A null is read as a key left out.
|
||||
|
||||
`path.freehand` (and `brush.freehand`, which runs it) refuses a `style` other than "pencil" or "brush" with
|
||||
`style must be "pencil" or "brush"`, and an `end` of `extend` other than "start" or "end" with
|
||||
`extend end must be "start" or "end"`; the document does not change and no undo step is recorded. Left out or null,
|
||||
`style` is "pencil" and the `end` of `extend` is "end".
|
||||
|
||||
A `pointer_gesture` with `mods: {cmd: true}` held at the press, with any tool but the selection tools (Command on
|
||||
macOS, Ctrl elsewhere), drags with the selection tool chosen last (`select_tool`), or Direct Selection with the Pen,
|
||||
Curvature and anchor tools until one is chosen; the release gives the tool back as it was, so the Pen goes on drawing
|
||||
@@ -7560,7 +7568,7 @@ nothing. Opening a document reads a DCS file and its plates again even with the
|
||||
keeps the saved preview of other linked EPS files. These rules are VectorCraft's own: the screen, composite print and exports show the image as its plates
|
||||
mixed into CMYK (each ink amount times the ink's CMYK values, plates combined as `1 − (1 − a)(1 − b)`); Separations
|
||||
Preview and `file.print` separations show each plate on its own ink, and a spot plate prints as the document's swatch
|
||||
of its ink (else its CMYK values) with `spotsToProcess`. Separations Preview shows a reduced image's plates as the
|
||||
of its ink (else its CMYK values) with `spotsToProcess` or that ink's own `convertToProcess`. Separations Preview shows a reduced image's plates as the
|
||||
mean of the plate pixels each shown pixel covers. A file may name 64 plates, a plate file may be 1 GB, and the plates together may hold 512 MB of
|
||||
ink amounts; a plate that can't be read is an error naming the plate, and nothing is placed. The plates go on the first
|
||||
plate's pixel grid, grown to hold every plate where it prints; a plate of another size or position is resampled onto
|
||||
@@ -8646,7 +8654,9 @@ picked as the printer, File → Print saves the PDF instead (see Printing). Head
|
||||
`{pages, path | dataBase64, bytes, warnings}`; `print.preview {settings?}`
|
||||
answers what it would print without writing it: `{pages (copies included), sheets: [{artboard, tile?, ink?, width,
|
||||
height, orientation, scale}] (one copy, in order), tiles: [{artboard, columns, rows, printed, tiles}] (document
|
||||
space), inks: [{name, spot, print, frequency, angle}], warnings, settings}`. `print.setup {settings?}` saves the
|
||||
space), inks: [{name, spot, print, frequency, angle}] (the plates), documentInks: [{name, spot, print, frequency,
|
||||
angle, convertToProcess?}] (every ink of the document, the spot inks printing as process included), warnings,
|
||||
settings}`. `print.setup {settings?}` saves the
|
||||
settings with the document (one undo step, kept in the native file as `print_setup`); both other commands start from
|
||||
the saved settings, or from a print preset's with `preset` (see Print presets), with `settings` over them (`null` keeps
|
||||
a value). `list_commands` with filter `print.setup`
|
||||
@@ -8676,9 +8686,19 @@ documents every field:
|
||||
- `marks` and `bleed` as `document.exportPdf` takes them (the bleed is the document's unless `useDocument: false`),
|
||||
drawn around the artboard at the paper's scale; the page information adds the tile and the ink with its screen.
|
||||
- `output: {mode: composite|separations, emulsion: up|down, image: positive|negative, spotsToProcess, overprintBlack,
|
||||
inks: [{name, print, frequency, angle}]}`: separations print one page per ink in the gray of its coverage (images
|
||||
too; overprinting fills, strokes and characters don't knock out), Registration on every plate; emulsion down mirrors
|
||||
the page and a negative inverts it.
|
||||
inks: [{name, print, frequency, angle, convertToProcess}]}`: separations print one page per ink in the gray of its
|
||||
coverage (images too; overprinting fills, strokes and characters don't knock out), Registration on every plate;
|
||||
emulsion down mirrors the page and a negative inverts it.
|
||||
- `output.inks[].convertToProcess` (default false) prints one spot ink as process inks: it gets no plate of its own,
|
||||
and its color prints on the Cyan, Magenta, Yellow and Black plates, while other spot inks keep their plates. The
|
||||
Print dialog's Document Ink Options list shows an icon before each spot ink's name, and a click on it switches that
|
||||
ink between spot and process output, as
|
||||
[the help page](https://helpx.adobe.com/illustrator/using/printing-color-separations.html) describes for single
|
||||
spot colors. The rest is VectorCraft's own rule. `spotsToProcess` converts every spot ink whatever each one's
|
||||
own setting says, and the dialog then dims the icons; turning it off again applies each ink's own setting. A
|
||||
converted ink's `print`, `frequency` and `angle` are kept for when it prints as a spot ink again, and its Print
|
||||
checkbox and fields are dimmed: `print: false` does not leave its color out of the process plates. Process inks and
|
||||
Registration have no icon, and `convertToProcess` on a process ink is ignored with a setting note.
|
||||
- `output.overprintBlack` (default false) makes black ink overprint in separations, as the Output step of
|
||||
[Print color separations](https://helpx.adobe.com/illustrator/using/printing-color-separations.html) describes:
|
||||
black art leaves the inks under it on the other plates. Which paints count as black is VectorCraft's own rule: a
|
||||
@@ -8977,6 +8997,25 @@ file size), `seconds` to download at `kbps` (default 56.6), the size, and for pa
|
||||
`source` (the colour the reduction made), so a colour keeps its edits when it is web-shifted or snapped. `slice: n`
|
||||
previews one slice; `image: true` adds the file; `warnings` holds the export's warnings.
|
||||
|
||||
Optimize to File Size (the dialog's button under Preset) is `webExport.optimizeToFileSize {desiredK, startWith?,
|
||||
use?, slice?, …settings}`. It searches for settings whose files fit in `desiredK` K (1 K is 1024 bytes; above 0, at
|
||||
most 1048576) and returns them without writing a file or changing the remembered settings: `{targetBytes, achieved,
|
||||
bytes, format, settings, trials, images, warnings}`. `startWith: current` (the default) keeps the format and takes the
|
||||
highest JPEG quality (1 to the current quality) or the most GIF/PNG-8 colors (2 to the current count) that fit,
|
||||
measured by encoding. A lower value can give a larger file, so the search measures up to 6 values spread over the
|
||||
range, from the top down, and then narrows the step above the first one that fits. When no value measured fits, GIF
|
||||
tries lossy 100 with the most colors that fit. PNG-24 has no
|
||||
setting to lower. `startWith: auto` takes GIF for art with transparent pixels or at most 256 colors and JPEG
|
||||
otherwise. With `transparency: false` it counts the colors the pixels have once blended over the matte, as the file
|
||||
is written. For opaque art it tries the other format when the first one cannot reach the size. `use: allSlices` (the
|
||||
default) measures the image, or the image slices' files together; `eachSlice` measures the largest slice file;
|
||||
`currentSlice` measures `slice` (a number from `slice.list`), else the selected image slice, else the first. The
|
||||
slices share one setting, so every `use` changes the setting of all of them. The search encodes at most 32 trial
|
||||
settings. When none fits, `achieved` is false and `settings` are the smallest trial. A `desiredK` that is missing,
|
||||
not a number, 0 or less or above 1048576 is an error, as are an unknown `startWith` or `use` and a `slice` that is
|
||||
not a slice number or comes with another `use`. In the dialog, the desired size starts at the size of what Total of All
|
||||
Slices measures with the current settings, rounded up to 0.001 K.
|
||||
|
||||
Presets: `webExport.presets.list` (built-in ones, then saved ones), `webExport.presets.save {name, newName?, …settings}`,
|
||||
`webExport.presets.delete {name}`; any name works as `preset` in the other commands (its settings, then the keys
|
||||
given). `webExport.settings {…}` remembers the settings the dialog opens on (`{}` reads them, `reset: true` restores the
|
||||
@@ -9362,7 +9401,7 @@ layers are refused.
|
||||
destination or output intent is refused. Transparency is flattened before writing.
|
||||
- **pdfX3** (PDF/X-3:2002, written as PDF 1.3): colours are tagged with ICC profiles; transparency is flattened.
|
||||
- **pdfX4** (PDF/X-4:2010, PDF 1.6 at most): transparency and layers are kept, colours are tagged, and the XMP metadata
|
||||
names the standard.
|
||||
names the standard and has an `xmp:MetadataDate` equal to its `xmp:ModifyDate`.
|
||||
|
||||
Flattening uses `flattenerPreset` (default High Resolution, see PDF 1.3 above) on a copy (the document is untouched; a
|
||||
warning says so), and images with see-through pixels count as transparency. The written file is checked against
|
||||
@@ -11469,7 +11508,9 @@ it while the drag sizes the halo: the halo's radius keeps the ratio to the point
|
||||
went down, through `growth` within 0 to 300 %. Letting the key go sizes the center with the drag again, and the flare
|
||||
keeps the new `growth`. While the rings' end point is placed, Up and Down Arrow add and remove rings (0 to 50; with
|
||||
Rings off they do nothing), and each press of backquote (the ~ key; a pointer event's `backquote` turning true) sends a
|
||||
new `ringSeed`, which moves the rings along the path and keeps their count and sizes. Each new flare starts from the
|
||||
new `ringSeed`, which moves the rings along the path and keeps their count and sizes. In VectorCraft, small seed
|
||||
values, including 0, distribute the first ring along the path; the same seed and parameters reproduce the same
|
||||
positions. Each new flare starts from the
|
||||
options' counts and growth, without a `ringSeed`. The Artboard tool's are the active artboard's Artboard Options
|
||||
(dialog `artboardOptions`; the Artboard tool's active artboard while it is in use, else the window's; its `x` and `y`
|
||||
are the artboard's top-left corner in document points, while the dialog shows X and Y at the reference point the
|
||||
|
||||
+5
-2
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user