mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-17 13:08:32 +00:00
Merge main into fix/erase-region-params-refused
This commit is contained in:
@@ -867,8 +867,8 @@ writes the HTML page to a temporary folder and opens it in the default browser (
|
||||
PSD Options: Export As… with the PSD format (`file.exportAs {format: "psd"}`, then the save dialog) opens `psdOptions`:
|
||||
the raster rows of PNG Options (`ppi`, `background`, `antiAlias`), then `colorModel` (`rgb`, `cmyk`, `gray`; a CMYK
|
||||
document starts on `cmyk`), `layers` (true: Write Layers; false: Flat Image, whose background list starts at White),
|
||||
`maxEditability` and `hiddenLayers` (with layers) and `embedIcc`. `ui.dialog.set` the fields and `ui.dialog.confirm`
|
||||
writes the file(s) with `document.export`.
|
||||
`preserveText`, `maxEditability` and `hiddenLayers` (with layers) and `embedIcc`. `ui.dialog.set` the fields and
|
||||
`ui.dialog.confirm` writes the file(s) with `document.export`; with Flat Image it leaves `preserveText` out.
|
||||
|
||||
Print: File → Print… (`file.print` with no params, Ctrl/Cmd+P) opens the `print` dialog on the document's print
|
||||
settings. Its fields are the `print.setup` settings (`copies`, `artboards`, `range`, `media`, `orientation`,
|
||||
|
||||
@@ -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: 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 |
|
||||
| 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)) |
|
||||
|
||||
|
||||
@@ -249,7 +249,9 @@ private editing data. VectorCraft:
|
||||
paint; Graph Data then edits it. Other graphs (pie and scatter graphs, graphs with designs or
|
||||
customizations, records of later versions) come in as plain groups, paths and type, with a note. Saving a graph to
|
||||
`.ai`, in either form, writes these records around its art when the reader above reads them back as the same graph,
|
||||
so the file opens again with its data and settings; any other graph is written as its art, with a warning.
|
||||
so the file opens again with its data and settings; any other graph is written as its art, with a warning. A
|
||||
legend swatch the graph tools draw has the stroke of its series' marks, so a drawn stacked column or area graph
|
||||
is written with its records.
|
||||
Legacy `.ai` patterns in the version 7 form (a list of `@` and `&` layers, `_ &` for the tile's background)
|
||||
open as pattern swatches, with a fill's offset, scale, rotation, reflection and shear applied before its
|
||||
matrix. Legacy `.ai` linked images in
|
||||
@@ -294,7 +296,7 @@ Names in the editing data that aren't UTF-8 (layers, objects, artboards, colors,
|
||||
| HP-GL/2 `.plt`, `.hpgl`, `.hgl`, `.hpg` | — | yes (pen moves, pens and widths, line types and attributes, circles, arcs, wedges and Bézier curves, filled and edged rectangles, wedges and polygons, encoded polylines, scaling and rotation; labels, symbol mode, raster images and hatching aren't drawn) | yes (`.plt`: each visible path once along its line, a pen per color or a pen table, type as outlines, clipping applied, HP-GL or HP-GL/2 with pen colors and encoded polylines) | recognized by its first instructions after any printer escapes, under its own extensions or one no other format reads; `crates/cad/src/hpgl/tests.rs`, `crates/cad/src/hpgl/write/tests.rs` (plots read back by the reader), `tests_hpgl.rs`, `import_fuzz.rs` |
|
||||
| DWG | open, export | no | no | no open spec; DXF instead |
|
||||
| EMF / WMF | open, export | yes | yes | an oversized embedded PNG or JPEG is refused from its header, before any pixels are decoded (#1776) |
|
||||
| PSD | open, place, export | yes (open: layers as layers, or the merged image with `layers: false`; place: merged image, or the layers embedded as a group of objects with `layers: true`; the merged image comes in clipped by the file's clipping path; every mode and depth; `.psd` and `.pdd`) | yes (layered, max editability) | PSD Import Options on File › Open and on File › Place without Link (Convert Layers to Objects, Flatten Layers to a Single Image, Import Hidden Layers, Import Slices; `tests_psdlayers.rs`, `dialogs/psd_import.rs`); slices (image resource 1050, version 6 and the version 7 and 8 descriptor) open and embed as user slices with `importSlices` (`tests_psdslices.rs`); layer comps aren't read; the embedded ICC profile's tags are 4-byte aligned (#1584) |
|
||||
| PSD | open, place, export | yes (open: layers as layers, or the merged image with `layers: false`; place: merged image, or the layers embedded as a group of objects with `layers: true`; the merged image comes in clipped by the file's clipping path; every mode and depth; `.psd` and `.pdd`) | yes (layered, max editability, point type as editable type layers with `preserveText`; `tests_psd.rs`) | PSD Import Options on File › Open and on File › Place without Link (Convert Layers to Objects, Flatten Layers to a Single Image, Import Hidden Layers, Import Slices; `tests_psdlayers.rs`, `dialogs/psd_import.rs`); slices (image resource 1050, version 6 and the version 7 and 8 descriptor) open and embed as user slices with `importSlices` (`tests_psdslices.rs`); layer comps aren't read; the embedded ICC profile's tags are 4-byte aligned (#1584) |
|
||||
| PSB | open | yes (layers as layers, or the merged image; the merged image comes in clipped by the file's clipping path) | no | |
|
||||
| PNG / JPEG / GIF / BMP / TIFF / Targa | open, place, export | yes (PNG: `.png` and `.pns`; BMP: `.bmp`, `.dib` and `.rle`; Targa: `.tga`, `.vda`, `.icb` and `.vst`, raw or run-length encoded, with a 16-bit file's one-bit alpha) | yes; TIFF is also selectable in Export for Screens and Asset Export with its existing options | Targa: `tests_tiffbmp.rs`, `tests/links.rs`; TIFF: grayscale with an alpha channel or other extra channels reads (#1466 in part), and so do files that store each channel as its own plane (PlanarConfiguration 2), CMYK ones with their ink amounts, and 1-bit files compressed with CCITT Group 3 (Compression 2 and 3, one- and two-dimensional rows); the ICC profiles embedded in JPEG and TIFF have 4-byte aligned tags (#1584); PNG export marks its colours as sRGB (`embedIcc`, an `sRGB` chunk; no ICC profile is embedded, #2221) |
|
||||
| WebP | export (Export for Screens) | yes | yes (lossless only; lossy written lossless with a warning) | |
|
||||
|
||||
@@ -55,7 +55,7 @@ plus review. Native-speaker review is human work and isn't in the hours.
|
||||
| Traditional Chinese (Taiwan) | `zh-hant` | 8,820 rows, 3,438 of them `@msg` and 48 `@msgplural` (counted 2026-11-13): the untranslated report lists 40 missing messages for it; menus, `tl!` literals and messages were complete when counted on 2026-10-21 (80% overall) | partial |
|
||||
| Italian | `it` | 8,924 rows, 3,560 of them `@msg` and 48 `@msgplural` (counted 2026-11-13): the untranslated report lists 54 missing messages for it, which open #7116, #7211, #7378 and #7405 translate | full |
|
||||
| Dutch | `nl` | 3,447 `@msg` and 48 `@msgplural` rows (counted 2026-11-13): in `COMPLETE_MESSAGES`, and the untranslated report lists 41 missing messages for it; one/other plurals | full |
|
||||
| Danish | `da` | 7,422 rows, 1,636 of them `@msg` and 48 `@msgplural` (counted 2026-11-14 on `main` at `edb228ac3`): in `COMPLETE_MESSAGES`, and the untranslated report lists the same missing messages for it as for Greek, Spanish and Finnish; one/other plurals | full |
|
||||
| Danish | `da` | 9,616 rows, 3,702 of them `@msg` and 49 `@msgplural` (counted 2026-11-15): in `COMPLETE_MESSAGES`, and the untranslated report lists 81 missing messages for it, 46 of them missing in every language; one/other plurals | full |
|
||||
| Russian | `ru` | 9,259 rows, 3,444 of them `@msg` and 48 `@msgplural` (counted 2026-11-13): in `COMPLETE_MESSAGES`; the untranslated report lists 46 menu strings, 21 `tl!` literals and 11 undo labels as missing | full |
|
||||
| Ukrainian | `uk` | 8,802 rows, 3,439 of them `@msg` and 48 `@msgplural` (counted 2026-11-13); one/few/many plurals | full |
|
||||
| Hungarian | `hu` | 9,166 rows, 3,444 of them `@msg` and 48 `@msgplural` (counted 2026-11-13): the untranslated report lists 40 missing messages for it, and lists 47 menu strings, 25 `tl!` strings, 11 undo labels and 45 swatch names without a row; one plural form | full |
|
||||
|
||||
+210
-41
@@ -835,6 +835,20 @@ look was edited keep their look. Read as a source, by `graphicStyle.new`, `graph
|
||||
style link of its own gives the look and the style link of the topmost path directly in it, and a move with
|
||||
`appearance.transfer` clears each of those paths; a series group that has one of them is read itself.
|
||||
|
||||
The commands in the paragraph above read a graph's Axes group and Legend group, given by id or selected with Group
|
||||
Selection, as they read a series group: the Axes group stands for the axis lines, tick marks, radar rings and labels
|
||||
directly in it, and the Legend group for the legend labels directly in it. The graph stores what they set for every
|
||||
line and label of each kind, as described below for a line or label given itself, and the groups keep no rows of their
|
||||
own. An Axes or Legend group that has a fill or stroke row of its own, or holds no line or label, is edited itself,
|
||||
except by `graphicStyle.redefine`, which passes the style to the lines and labels of a linked group whatever the group
|
||||
holds. An `index`, `indices` or fill or stroke `item` given an Axes or Legend group whose lines and labels have
|
||||
different rows, as the lines and labels of a new graph do, is an error unless `aligned` is true, which makes it a row
|
||||
of the stack of the backmost line or label in the group, and `appearance.moveItem` does not move the rows of such a
|
||||
group. With `aligned`, the graph stores the rows of only the lines and labels that have that row; a kind of label none
|
||||
of whose labels has it keeps what it stored before. The graph keeps no graphic style link on its lines and
|
||||
labels: they keep the look of a style applied to them, and are unlinked when the graph is drawn again. The commands
|
||||
find these groups by their names, so a renamed Axes or Legend group is edited itself.
|
||||
|
||||
`transparency.set` and `object.setProps` with an opacity, blend mode, isolation, knockout or knockout shape for the
|
||||
object, given a series group's id or the selected series group, set them on the group itself, and the graph stores them
|
||||
for that series. The series group has them again when the graph is drawn again, and they apply to the group as a whole
|
||||
@@ -843,10 +857,12 @@ in addition to each path's own opacity and blend mode. `addon.arrange.randomizeO
|
||||
what they change on the group the same way. Each of the commands above that clears the group's own opacity, blend mode, isolation
|
||||
and knockout also removes what the graph stores for it.
|
||||
|
||||
The other commands given a series group's id edit the group itself, and the graph does not store what they set on it:
|
||||
the `effect.*` commands and `appearance.addEffect`, and the paint, stroke and gradient commands with a fill or stroke
|
||||
`item`, which is a row of the group's own stack. The Appearance panel and `appearance.setActiveItem` read the selected
|
||||
group's own rows.
|
||||
The other commands given a series group's id, or a graph's Axes or Legend group, edit the group itself, and the graph
|
||||
does not store what they set on it: the `effect.*` commands and `appearance.addEffect`, and the paint, stroke and
|
||||
gradient commands with a fill or stroke `item`, which is a row of the group's own stack. `transparency.set` and
|
||||
`object.setProps` with an opacity or blend mode for the object, given an Axes or Legend group, edit the group itself the
|
||||
same way. `paint.setFill`, `paint.setStroke` and the recolor commands given the Axes group store the line rows, as
|
||||
described below. The Appearance panel and `appearance.setActiveItem` read the selected group's own rows.
|
||||
|
||||
When a graph is drawn again (a change to its data, its type, or its column or marker designs), it draws the art of a
|
||||
column or marker design in a series again from the design, and an edit made to that art is lost. The art is any object
|
||||
@@ -909,9 +925,11 @@ placement they set there. A stroke weight and dashes are stored as the label sho
|
||||
scaled. When the characters of labels of one kind change differently, the frontmost label sets what the kind keeps. On
|
||||
a pie with Legends in Wedges, a fill a command sets on the legend labels is drawn on every wedge, black included, until
|
||||
that command is undone; a size, font or stroke change does not set one. Before that, their fill is stored only when
|
||||
every legend label the command reaches ends up with the same fill. Otherwise they are drawn again in black, or white on
|
||||
a dark wedge. These commands do not store the colors they give a graph's axis lines, ticks and radar rings, which are
|
||||
drawn again with their default paint.
|
||||
every legend label the command reaches ends up with the same fill. The recolor commands also need to be given the legend
|
||||
labels themselves: a recolor given the graph or a group that holds it does not store their fill. When their fill is not
|
||||
stored, they are drawn again in black, or white on a dark wedge. `paint.default` stores the black fill and no stroke for
|
||||
the kind of each label it reaches, also when the label already showed them. What these commands change on a graph's
|
||||
axis lines, tick marks and radar rings is stored as described below.
|
||||
|
||||
`text.setFormat` without `start` and `end`, on a graph or on its labels, stores the character and paragraph attributes
|
||||
it sets for each kind of label it reaches (value axis numbers, category labels, legend labels), and every label of that
|
||||
@@ -935,11 +953,14 @@ The `appearance.*` commands, `graphicStyle.apply` and `graphicStyle.redefine`, a
|
||||
transparency commands given an `item` (or the Appearance panel's active row) store a graph label's object rows for its
|
||||
kind of label: the paint, weight, opacity and blend mode of its topmost visible fill and stroke row, their order and
|
||||
their place relative to the Characters row, and the label's object opacity and blend mode. They store them even when the
|
||||
label already showed them. `transparency.set` without an `item`, `object.setProps` with an opacity or blend mode, and
|
||||
label already showed them, but an edit of a hidden row that leaves the topmost visible rows as they were, and an
|
||||
`appearance.moveItem` of the Contents row that leaves them in place, store nothing. `transparency.set` without an `item`, `object.setProps` with an opacity or blend mode, and
|
||||
an `appearance.copyFrom` (Eyedropper) pick of transparency store only the label's object opacity and blend mode;
|
||||
`appearance.copyFrom` with `append` stores the rows. When the graph is drawn again, every label of that kind gets what
|
||||
is stored, with a placed gradient fitted to each label, and the graph saves it as `valuesRows`, `categoriesRows` and
|
||||
`legendRows` in its label styles. Rows below the topmost one of each kind, a row's effects, other stroke options (caps,
|
||||
`appearance.copyFrom` with `append` stores the rows of the kinds it adds (fill, stroke or both), and the object opacity
|
||||
and blend mode only when it also applies the object's transparency. `graphicStyle.apply` with `add` stores the rows of
|
||||
the kinds the style shows. Both leave a row of the other kind as the kind keeps it, and `graphicStyle.apply` with `add`
|
||||
also leaves the object opacity and blend mode the kind keeps. When the graph is drawn again, every label of that kind gets what is stored, with a placed
|
||||
gradient fitted to each label, and the graph saves it as `valuesRows`, `categoriesRows` and `legendRows` in its label styles. Rows below the topmost one of each kind, a row's effects, other stroke options (caps,
|
||||
joins, dashes) and effects applied with `effect.*` are not stored. When labels of one kind are edited together, the
|
||||
last one in the order of the targets (`ids` as given, otherwise paint order) sets what the kind keeps.
|
||||
`appearance.copyFrom` onto the whole text of a label also stores the character attributes it applies and, from type,
|
||||
@@ -947,6 +968,38 @@ the paragraph attributes. `paint.setFill` and `paint.setStroke` store a characte
|
||||
the label's characters (the whole label, or all of its text highlighted with the Type tool), and the row when it goes to
|
||||
a row. A stored character gradient also fits each label.
|
||||
|
||||
On a graph's axis lines and tick marks, and separately on a radar graph's rings, `paint.setFill`, `paint.setStroke`,
|
||||
`addon.color.fillToStroke`, `addon.color.strokeToFill`, the stroke, gradient and recolor commands above, `paint.swap`,
|
||||
`paint.default`, the `appearance.*` commands (`appearance.copyFrom`, the Eyedropper, included), `graphicStyle.apply`,
|
||||
`graphicStyle.redefine`, `transparency.set` and `object.setProps` store what a line shows for every line of its kind:
|
||||
the paint, weight, opacity and blend mode of its topmost visible fill and stroke row, their order, and the line's object
|
||||
opacity and blend mode. `paint.setFill`, `paint.setStroke` and the recolor commands also store them when given the
|
||||
graph, its Axes group or a group that holds the graph, so the lines keep the paint those commands give a whole graph.
|
||||
The other commands store them when given the line itself, and the `appearance.*` and graphic style commands and
|
||||
`transparency.set` with an `item` also when given the Axes group, as described above. `transparency.set` without an
|
||||
`item` and `object.setProps` store only the object opacity and blend mode. `appearance.clear`, `appearance.transfer`,
|
||||
`graphicStyle.apply`, `graphicStyle.redefine`, and `appearance.copyFrom` with every attribute picked up and applied or
|
||||
with `append`, store a line's rows even when the line already showed them; `graphicStyle.apply` with `add` and
|
||||
`appearance.copyFrom` with `append` store only the kinds of row they add. `appearance.addFill` and
|
||||
`appearance.addStroke` store the row they add when it becomes the line's topmost visible row of its kind, also when the
|
||||
line already showed its paint, weight and opacity. The other commands, an `appearance.copyFrom`
|
||||
of some attributes included, store only what they change on a line's rows; the kind keeps its other attributes, also
|
||||
when the line still shows different ones until the graph is drawn again. `paint.setFill`, `paint.setStroke`,
|
||||
`addon.color.fillToStroke` and `addon.color.strokeToFill` also store the paint they write on a line's topmost visible
|
||||
fill or stroke row when the line already showed it. `appearance.setItem` and an `appearance.copyFrom` of some
|
||||
attributes store the paint, stroke weight, and row opacity and blend mode they write to that row in the same way, and
|
||||
`stroke.set` stores the weight it writes there. An `appearance.copyFrom` that does not apply
|
||||
the object's transparency, and `graphicStyle.apply` with `add`, leave the object opacity and blend mode a kind keeps as
|
||||
they are, also when the line still shows other ones. `paint.default` stores the default fill and stroke rows for a
|
||||
line's kind even when the line already showed them, and leaves the object opacity and blend mode the kind keeps. Rows
|
||||
equal to a kind's default stroke (0.5 pt black for axis lines and tick marks, 0.25 pt gray for rings) are not saved, and
|
||||
an edit of a hidden row that leaves the topmost visible rows as they were stores nothing. When one command reaches
|
||||
several lines of one kind, the frontmost line in
|
||||
paint order sets what the kind keeps, whatever order the `ids` are in. A gradient is stored without its placement, and
|
||||
each line fits it when the graph is drawn again. The graph saves the rows as `axisRows` and `ringRows` in its label
|
||||
styles. Other stroke options (caps, joins, miter limit, alignment, dashes and arrowheads), rows below the topmost one of
|
||||
each kind, and effects are not stored, so a dash set on a line is drawn solid again.
|
||||
|
||||
`effect.apply {"effect": "path.outlineObject"}` (Effect › Path › Outline Object) takes no parameters. Type that carries
|
||||
it is drawn, exported and expanded as its glyph outlines and stays editable type, and the effects after it reshape
|
||||
those outlines. On paths, compound paths and images it does not change what is drawn. On an image's own fill or stroke
|
||||
@@ -3459,7 +3512,7 @@ already walks Image Trace. Short agent entry points:
|
||||
`[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.
|
||||
`tiltX` and `tiltY` are degrees −90..90 in document axes, positive leaning right and leaning down the page (one
|
||||
without the other is 0); `rotation` is the barrel's rotation in degrees clockwise. The stroke keeps how far the pen
|
||||
without the other is 0); `rotation` is the barrel's rotation in degrees clockwise, 0..360. The stroke keeps how far the pen
|
||||
leaned (`tilt`, 0 upright to 1 lying flat), which way (`bearing`, degrees counter-clockwise from leaning right; a
|
||||
pen within 1° of upright takes the bearing before it, or at the start of the stroke its first one) and how far the
|
||||
barrel turned (`rotation`, degrees counter-clockwise). A point without a tilt that other points have counts as
|
||||
@@ -3879,16 +3932,20 @@ already walks Image Trace. Short agent entry points:
|
||||
black ring around a white disc around a black dot, black gets two groups. `layer.releaseToLayers` on the expanded group then
|
||||
gives each group a sublayer. A trace made with `autoGrouping` is refused. Expanding by color also refuses a trace
|
||||
with a live Pathfinder effect.
|
||||
An Abutting trace with Fills (not Flat Logo) also holds a group named `Seam Fills` under its paths: for each color, a
|
||||
stroke 1.5 image pixels wide (at the image's larger scale, when it is stretched more one way) with butt caps and round joins along the edges where a filled path of that color meets a
|
||||
filled path drawn after it, in that color (a gradient path's stroke takes its gradient). Without it, a renderer that
|
||||
anti-aliases each path on its own shows a light hairline along every shared edge. The traced paths and their shared
|
||||
edges are the same with or without it, and edges against the image's border, a transparent area or a color left out
|
||||
get no stroke. A trace whose paths have more than half of the trace's anchor limit (8,000,000, 2,000,000 on the web)
|
||||
has no seam fills, so that paths and seam fills together stay within the limit. Both Expand commands keep the group, and `byColor` leaves it under every color's group. The strokes
|
||||
are separate objects: after Expand, recoloring, moving or deleting a traced path leaves them as they are, and deleting
|
||||
the group removes them. The reply's
|
||||
`paths` and `anchors` count the traced paths only.
|
||||
An Abutting trace with Fills (not Flat Logo) also holds a clip group named `Seam Fills` under its paths. For each
|
||||
color it holds one stroke along the edges where a filled path of that color meets a filled path drawn after it, in
|
||||
that color (a gradient path's stroke takes its gradient), with butt caps and round joins. The stroke is 1.5 image
|
||||
pixels wide, VectorCraft's own width. On an image stretched more one way than another, the group holds each
|
||||
stroke's outline in image pixels as a filled path instead; the outline covers 0.75 image pixels on each side of its
|
||||
edge. The group clips the strokes or outlines to the image's box within the box of the traced paths, and its
|
||||
bounds lie within that box. Where a shared edge ends at, or runs within 0.75 image pixels of, a
|
||||
transparent area or a color left out, its stroke can reach up to 0.75 image pixels into that area. Paths that
|
||||
became live shapes (`shapes`) take no part. The traced paths and their shared edges are the same with or without
|
||||
the group. A trace whose paths have more than about half of the trace's anchor limit (8,000,000,
|
||||
2,000,000 on the web) has no seam fills. Both Expand commands keep the group, and `byColor` leaves it under every
|
||||
color's group; `byColor` refuses a trace whose seam fills' group was moved above a path. The strokes are separate
|
||||
objects, in a trace and after Expand: recoloring, moving or deleting a traced path leaves them as they are, and
|
||||
deleting the group removes them. The reply's `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
|
||||
@@ -4417,16 +4474,24 @@ is tall), `bevelInside` (false adds the bevel around the shape, true carves it i
|
||||
`softness` are not used). `ambient` (0..100%, default 50) lights every face.
|
||||
- `highlightIntensity` (0..100%, default 60) and `highlightSize` (0..100%, default 90; 100 is broad) shape the Plastic
|
||||
highlight. `blendSteps` (whole number, 1..256, default 25) is how many levels the shading is rounded to.
|
||||
- `shadingColor`: `black` (the default), `custom` (darkens toward `shadingCustom`, a `#rrggbb` color) or `none` (the
|
||||
paint is kept and only the highlight lightens it). `drawHiddenFaces` also draws the faces turned away from the
|
||||
viewer, behind the others.
|
||||
- `shadingColor`: `black` (the default), `custom` (darkens toward `shadingCustom`, a `#rrggbb` color), `none` (the
|
||||
paint is kept and only the highlight lightens it) or `blackOverprint`. With `blackOverprint` every face keeps the
|
||||
paint unchanged, and each face that darkens gets overprinting black over it, as strong as `black` would darken it.
|
||||
The paint's own inks print as they are and the shading prints on the black plate. On screen the black is multiplied
|
||||
over the paint, Separations Preview shows it on the Black plate, and `document.exportPdf` writes it as overprinting
|
||||
fills
|
||||
([Shading Color options](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=188)).
|
||||
The highlight is not drawn with `blackOverprint`; that rule is VectorCraft's own. On a pattern face the black covers
|
||||
the whole face, transparent pattern cells included, as the shading of the other shading colors does.
|
||||
`drawHiddenFaces` also draws the faces turned away from the viewer, behind the others.
|
||||
- `preserveSpotColors` (default false) is the Lighting tab's Preserve Spot Colors checkbox. When it is on, a fill or
|
||||
stroke linked to a spot or global swatch stays linked on every face, so a spot color prints on its own plate in
|
||||
separations and PDF. The highlight lowers the swatch's tint, and a face that darkens gets black at the shade's
|
||||
strength over the swatch, multiplied and overprinting. These rules for drawing the shading are VectorCraft's own. The
|
||||
option does nothing while `shadingColor` is `custom`, since a custom shading color cannot keep a spot color
|
||||
([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)).
|
||||
Unlinked colors, gradients, patterns and the Wireframe surface draw as they do with it off.
|
||||
Unlinked colors, gradients, patterns and the Wireframe surface draw as they do with it off. With `blackOverprint`
|
||||
every face keeps its paint, swatch link included, whether the option is on or off.
|
||||
|
||||
The defaults are VectorCraft's own. An unknown parameter, a number out of range, a flag that is not true or false, or
|
||||
an unknown surface or shading color is refused with an error and the document is not changed.
|
||||
@@ -4567,7 +4632,10 @@ the others turn by the same hue). `limitTo` snaps new colours to a swatch librar
|
||||
new color as it is and shuffles only the rows that hold current colors. A row without `from`, or with
|
||||
a current color that is not a color, is refused. With art selected, the Recolor Artwork dialog's New Row button (beside
|
||||
Merge) adds such a row above the first selected row, or at the top, with that row's new color, and selects it; Shift-click a row below it and Merge to move that row's colors into it (Merge keeps the topmost selected row's new color). An
|
||||
empty row does not count toward Colors. With `limitTo`, a row's `tint` (a percentage, default 100) gives the art
|
||||
empty row does not count toward Colors. While it is empty, the dialog's Edit tab does not show it (its sliders edit
|
||||
the base color when the empty row is selected), the harmony rules,
|
||||
linked moves and the Color Theme Picker leave its new color as it is, and Save All Colors and a new color group saved
|
||||
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
|
||||
@@ -4609,7 +4677,7 @@ objects are read. As VectorCraft's own rule, each object read weighs the same, s
|
||||
among its pixels; the vector art a symbol instance places counts as one object, and each image it places counts on
|
||||
its own), and similar colors merge (k-means in Lab) into at most `colors` (1 to 64, default 5), each shown by its
|
||||
most used color in its own model. Picks that touch no art return no colors. In the Recolor Artwork dialog the picks are the `themePicks` field: the rows that aren't
|
||||
excluded take the palette as their new colors in row order, the colors repeating when the rows outnumber them.
|
||||
excluded and hold current colors take the palette as their new colors in row order, the colors repeating when the rows outnumber them.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"recolor.pickTheme","params":{"picks":[{"at":[120,80]},{"rect":[200,40,320,140]}],"colors":4}}}
|
||||
@@ -4635,7 +4703,7 @@ bar sits under the Edit tab's wheel: each row with a share is a part as wide as
|
||||
the largest first. Dragging the edge between two parts moves width between them, and when the drag ends the widths
|
||||
become the `weights` field, which moves the rows' current colors and previews the result. The New Color Group menu
|
||||
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, in row order, and Save Prominent Colors saves the bar's colors in the bar's order.
|
||||
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.
|
||||
|
||||
```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]}}}
|
||||
@@ -5788,11 +5856,24 @@ moves that point alone as the focal point, with or without Shift (Shift keeps th
|
||||
focal points stay highlighted where it left them; Escape during a drag puts the path back and keeps them, and
|
||||
switching to another tool clears them.
|
||||
|
||||
`path.freehand`, `brush.freehand`, `path.knife`, `path.eraseRegion`, `path.eraseSegments`, `path.smoothRegion`,
|
||||
`path.joinScrub` and `path.blob` refuse a pen `pressure` outside 0 to 1, a `tiltX` or `tiltY` outside -90 to 90 and a
|
||||
`rotation` outside 0 to 360 with an error such as `` `tiltX` must be from -90 to 90 ``, naming the key, and a point
|
||||
given as an array of more than six numbers with `` `points[3]` must be an array of at most 6 entries ``, naming the
|
||||
point. `path.blob` and `path.eraseRegion` refuse a `size` outside 0.1 to 1000 pt with
|
||||
`` `size` must be from 0.1 to 1000 `` and a `sizeVariation` over 1000 pt with
|
||||
`` `sizeVariation` must be from 0 to 1000 ``, in every `sizeMode` and when it is left out. `path.blob` refuses a
|
||||
negative `sizeVariation` with the same message, and `path.eraseRegion` with "sizeVariation must be 0 or more". The
|
||||
document and the selection do not change and no undo step is recorded. A null is read as a key left out, and a point given as `[x, y]`
|
||||
has no pen values. The pressure and tilt ranges are those of
|
||||
[Pointer Events](https://www.w3.org/TR/pointerevents3/); the rotation, size and size variation ranges are
|
||||
VectorCraft's own values.
|
||||
|
||||
`path.eraseRegion` (the Eraser) takes a variation mode for each of its tip's values, as the variation menus of
|
||||
Eraser Tool Options set them ([Erase paths using the Eraser
|
||||
tool](https://helpx.adobe.com/illustrator/desktop/draw-shapes-and-paths/modify-paths/erase-paths-using-eraser-tool.html)):
|
||||
`angleMode` with `angleVariation` (degrees, 0 to 180), `roundnessMode` with `roundnessVariation` (percent, 0 to 100)
|
||||
and `sizeMode` with `sizeVariation` (points, 0 or more), each `"fixed"` (the default), `"random"`, `"pressure"`,
|
||||
and `sizeMode` with `sizeVariation` (points, 0 to 1000), each `"fixed"` (the default), `"random"`, `"pressure"`,
|
||||
`"tilt"`, `"bearing"` or `"rotation"`. A value that varies takes up to its variation either way. Random draws one
|
||||
value for the drag. Pressure goes from the value less the variation where the pen presses lightest to the value plus
|
||||
it where the pen presses hardest. Tilt goes from less with the pen lying flat to more with it upright. Bearing and
|
||||
@@ -5998,12 +6079,21 @@ 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. 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
|
||||
there.
|
||||
`preserveNumbers` (and PDF/X-1a, which converts the same way) keeps the numbers of untagged content only: an RGB image
|
||||
that carries an ICC profile is converted from that profile to sRGB with the same intent, and then to a CMYK or other
|
||||
RGB destination, the document's own RGB profile included (written as sRGB when colours are ICC-tagged), while an untagged RGB image keeps its numbers in an RGB
|
||||
destination and converts from sRGB to a CMYK one. A gray image that carries one is converted to sRGB grays in an
|
||||
sRGB destination and keeps its profile in the others, and a profile the color engine can't
|
||||
read leaves the image as it is in an RGB destination, with a warning, and its numbers read as sRGB in a CMYK one.
|
||||
In both modes, any other image whose colors are converted (a CMYK image, an RGB image going to a CMYK destination, or
|
||||
with `destination` an RGB image going 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. A tagged RGB image
|
||||
that `preserveNumbers` converts in an RGB destination but whose pixels can't be decoded keeps its profile, with a
|
||||
warning, as with `destination` and an sRGB destination.
|
||||
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
|
||||
the document's CMYK profile, RGB as sRGB, grey with the sRGB tone curve (PDF/A, PDF/X-3 and PDF/X-4 files are
|
||||
@@ -7984,7 +8074,8 @@ Besides SVG, Copy offers other apps PNG and PDF of the copied objects, and their
|
||||
preferences: `text/plain` (the text of a type-only copy, else the SVG markup with `copyAsSvg` when the images it
|
||||
embeds total at most 1 MiB, so a paste never reads a photo back as text, #2213), `image/svg+xml`
|
||||
(`copyAsSvg`), `application/pdf` (`copyAsPdf`) and `image/png` (always; PDF and PNG need objects with an
|
||||
area). Each one has a query command:
|
||||
area). For a caller with read roots, the list leaves out `image/svg+xml`, and the SVG markup as `text/plain`, when
|
||||
`clipboard.exportSvg` would refuse the SVG. Each one has a query command:
|
||||
`clipboard.exportSvg`, `clipboard.exportText` (null unless every copied object is type), `clipboard.exportPdf`
|
||||
(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`
|
||||
@@ -8716,10 +8807,13 @@ becomes an asset (or one asset with `multiple: false`).
|
||||
### 3D assets
|
||||
|
||||
Asset Export's menu item Export 3D Object and the 3D and Materials panel's Export 3D Object button
|
||||
(`assets.add3D {ids?, format?}`; the button passes the ids of the selected objects that have a 3D effect and then shows
|
||||
the Asset Export panel, [three-d.md](three-d.md#3d-and-materials-panel)) collect each selected object (or `ids`)
|
||||
(`assets.add3D {ids?, format?}`; the button then shows the Asset Export panel,
|
||||
[three-d.md](three-d.md#3d-and-materials-panel)) collect each selected object (or `ids`)
|
||||
that carries Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, named after the object; an object already
|
||||
collected as a 3D asset keeps it, and an object without such an effect is refused. A 3D asset's Format is `usda` (the
|
||||
collected as a 3D asset keeps it. An object in `ids` without such an effect is refused. Without `ids`, the selected
|
||||
objects without one are left out, and so are a group or layer whose 3D effect is on a fill or stroke (it draws nothing
|
||||
to export) and a selected object inside another selected 3D object; the command is refused when no selected object is
|
||||
left. A 3D asset's Format is `usda` (the
|
||||
default), `usdz`, `gltf` or `obj`; the panel shows a Format row for the 3D assets it would export, and
|
||||
`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).
|
||||
@@ -8785,6 +8879,28 @@ appearance of their own or knockout stay one pixel layer. Hidden layers and obje
|
||||
`hiddenLayers: true` writes them as hidden layers. `layers: false` writes one flat image, on white where nothing is
|
||||
drawn. Files are at most 30000 pixels a side.
|
||||
|
||||
`preserveText: true` (with layers; refused with `layers: false`) writes horizontal and vertical point type as type
|
||||
layers that a reader can edit: each holds the text, its fonts (by PostScript name), sizes, leading, tracking, scaling,
|
||||
baseline shift, caps, underline, strikethrough, fill color, Fractional Widths, paragraph alignment, orientation and
|
||||
anti-aliasing method (None with `antiAlias: none`), at the export's resolution, and keeps its pixels for readers that
|
||||
show them. The font is the installed version the character style names, if any. VectorCraft writes only point type in
|
||||
solid colors with whole-number tracking whose characters are all in their own font (none drawn with a fallback font),
|
||||
that sets no other character attribute (no stroke, kerning, rotation, OpenType feature, small caps, position, East
|
||||
Asian setting or language other than the default English: USA), whose paragraphs set nothing but their alignment
|
||||
and line breaking (no indents, spacing, tabs, bullets or numbers, Auto Leading, word or letter spacing, Standard
|
||||
composer, and no Mojikumi other than the default in type with Chinese, Japanese or Korean characters) and run left to right (set, or from their first strong
|
||||
character), and that has no inline graphics, ruby, System Layout, Optical Margin Alignment, effects, appearance of its
|
||||
own or opacity mask as a type layer; other type, area type and type on a path stay pixels. Without `maxEditability`, a
|
||||
layer or sublayer that holds such type becomes a group of its type layers and one pixel layer for each stretch of art
|
||||
between them, unless other art in it blends in a mode other than Normal: then the layer stays one pixel layer. Hidden
|
||||
type counts only with `hiddenLayers`. With `maxEditability`, every object is a layer as above. The PSD Options dialog
|
||||
has the option as Preserve Text Editability
|
||||
(<https://helpx.adobe.com/illustrator/desktop/save-and-export/export-files-to-different-formats/export-file-format-options-in-illustrator.html>).
|
||||
|
||||
```json
|
||||
{"name":"export","arguments":{"path":"/tmp/poster.psd","options":{"ppi":300,"preserveText":true}}}
|
||||
```
|
||||
|
||||
PSD files (`.psd`, and `.psb`, the large document format) place as their merged image, the
|
||||
flattened picture every PSD file carries: Bitmap, Grayscale, Duotone, Indexed, RGB, CMYK
|
||||
(converted with the colour settings' CMYK) and Lab, at 1, 8, 16 and 32 bits per channel, sized by their resolution.
|
||||
@@ -9628,6 +9744,32 @@ https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"bunriKinshi":true}}}
|
||||
```
|
||||
|
||||
## Kurikaeshi Moji Shori
|
||||
|
||||
`text.setFormat {kurikaeshiMojiShori: bool}` (Paragraph panel menu › Kurikaeshi Moji Shori, shown with the East Asian
|
||||
options) turns it on or off for the paragraphs of the selected type (or `ids`, or the paragraphs a `start` / `end`
|
||||
range touches). On, a repeat mark that starts a line of point or area type, horizontal or vertical, or starts a frame
|
||||
of type on a path (which holds one line), is drawn as the character it repeats, so both characters show when a line break separates them. The text keeps the mark: copying,
|
||||
searching, the caret and the line breaks stay as they were, and the drawn character takes the mark's place and width.
|
||||
SVG export with live type writes the drawn character, and embeds its glyph when fonts are embedded; it writes type on a
|
||||
path that starts with such a mark as outlines, with a warning.
|
||||
VectorCraft's set of marks and its rules: 々 repeats a Han ideograph, ゝ and ゞ a hiragana, and ヽ and ヾ a katakana; the
|
||||
repeated character is the last one before the mark in the paragraph that is not a repeat mark, a soft return or a
|
||||
combining voicing mark (U+3099, U+309A), looking back into the frames before when threaded type continues a paragraph
|
||||
from one frame into the next; ゝ and ヽ draw it without its voicing marks, and ゞ and ヾ draw its voiced form, or the
|
||||
plain kana when it has none; ゝ or ヽ followed by a combining voicing mark (U+3099) counts as ゞ or ヾ when the font draws the
|
||||
pair as one glyph, and is drawn as it is when the font draws two. A mark is drawn as it is when nothing before it in the paragraph fits, when the font has no glyph for the character, at the start of a
|
||||
paragraph, and inside tate-chu-yoko or warichu. Off by default. It is saved with the paragraph
|
||||
(`kurikaeshi_moji_shori` in `para`) only when on, paragraph styles carry it (`kurikaeshi_moji_shori` in a paragraph
|
||||
style's attributes), and Reset Panel turns it off. A value that is not true, false or null is refused, `null` leaves the
|
||||
setting as it is, and a call that gives the value the paragraphs already have records no undo step. One undo step. `.ai` editing data does not hold it, and a
|
||||
save reports a paragraph with it on as left out. The help page:
|
||||
https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"text.setFormat","params":{"kurikaeshiMojiShori":true}}}
|
||||
```
|
||||
|
||||
## Korean Line Break Anywhere
|
||||
|
||||
`text.setFormat {koreanLineBreakAnywhere: bool}` (Paragraph panel menu › Korean Line Break Anywhere, shown with the
|
||||
@@ -12013,7 +12155,14 @@ Tools:
|
||||
screen pixels of the pointer. A drag draws a rectangle and runs it with `rect` on release; once the pointer has
|
||||
gone 3 screen pixels from the press, the gesture stays a drag even when it ends near the press. An Alt-drag draws a
|
||||
freehand line and runs it with `points` on release; a line of more than 65,536 points is dropped. Nothing changes
|
||||
while dragging, and Escape during a drag removes nothing. The tool has no options.
|
||||
while dragging, and Escape during a drag removes nothing. Hovering draws in red the stretch a click there would
|
||||
remove. It draws nothing when a click would remove nothing, or when finding the path's crossings takes more than a
|
||||
twentieth of the work a click may do. A drag draws in red every stretch its release would remove while it reaches at
|
||||
most 32 paths, the paths it reaches times the paths that can be edited come to at most 10,000,000, and a freehand
|
||||
line has at most 4,096 points; past those limits it draws none. Once finding the crossings takes more than a
|
||||
twentieth of the work a release may do, or checking the line against the paths' segments takes more than 1,000,000
|
||||
box tests, the drag draws none until the next press. A click or a release still removes what it reaches. The tool
|
||||
has no options.
|
||||
|
||||
Commands:
|
||||
|
||||
@@ -12069,6 +12218,26 @@ Commands:
|
||||
drawn, and the path's fills stay on it, below its dashes (a path without fills goes). A compound path's dashes are
|
||||
plain paths with its appearance. Paths without a dashed stroke stay as they are, and it is an error if none has one.
|
||||
The dashes are selected; more than 100,000 (or a pattern too fine to draw) is refused. → `{ids, dashes}`.
|
||||
- `addon.pathtools.tangentCircle {ids?, radius?, circle?}` draws the circles that touch two paths or compound paths
|
||||
and have `radius` (0.01 to 1,000,000 pt, needed with two), or that touch three (which set the radius themselves, so
|
||||
`radius` is then an error), as one undo step (Object › Plug-ins › Path Precision Tools › Tangent Circle…). `ids`
|
||||
defaults to the selection. A circle touches a shape when it meets the shape's outline without crossing it, the whole
|
||||
outline lying outside the circle or inside it: at a smooth point it is tangent to the outline, and at a corner or an
|
||||
open end it passes through that point. A compound path's members count as one outline. For shapes that are all
|
||||
circles of four curved segments (as the Ellipse tool draws them) the answers come from the true circles and are then
|
||||
moved onto the drawn Bézier outlines, which differ by up to 0.0273% of the radius; within that much of a tangency
|
||||
threshold the true circles decide. Every circle that touches all the shapes is found (three circles have up to
|
||||
eight); with three shapes, circles up to 64 times the diagonal of the box around the shapes' anchors and handles.
|
||||
They are listed by radius, then top to bottom, then left to right, and `circle` (0 to 64; 0 by default) picks the
|
||||
nth of them, or 0 draws them all. Each circle is a new ellipse with the current paint on top of the current layer,
|
||||
or of the isolated group, and the circles are selected; inside an isolated compound path they join it. Locked and
|
||||
hidden shapes given by `ids` are read and left as they are. It is an error, with the document unchanged, when no
|
||||
circle touches the shapes, when more than 64 do (shapes touched along a whole curve, such as two concentric
|
||||
circles), when `circle` is past the last one, when `ids` names an object twice, when the shapes lie at one point or
|
||||
are too small for the radius, above 2,000 segments in all, and when the search for other shapes goes past its
|
||||
limits. → `{ids, found}` (`found`: how many circles touch the shapes). Tangent Circle… opens a dialog
|
||||
(`ui.menuDialog {command}`, kind `tangentCircle`) with the radius (used with two shapes selected; 36 pt to start), a
|
||||
Circle menu (All, or one circle by number, as many as the last preview found) and Preview, which starts on.
|
||||
- `addon.pathtools.cornerSet {ids?, anchors?, items?, radius, kind?, every?, minAngle?, maxAngle?}` cuts live corners, the ones Direct Selection's
|
||||
corner widgets and the Corners dialog edit, as one undo step. `ids` (default: the selection) are the paths and
|
||||
`anchors` the anchor indices of each path's outline with no corners cut; without `anchors`, a path's direct-selected
|
||||
|
||||
File diff suppressed because one or more lines are too long
+19
-5
@@ -83,11 +83,12 @@ pages describe it.
|
||||
[Export 3D vector artwork](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)
|
||||
page describes; VectorCraft places it at the bottom of the panel. It adds each selected object that has a visible
|
||||
3D effect to Asset Export as a 3D asset, the same as
|
||||
Asset Export's own Export 3D Object (`assets.add3D` with those objects' ids), selects their assets in the Asset
|
||||
Asset Export's own Export 3D Object (`assets.add3D` on the selection), selects their assets in the Asset
|
||||
Export panel and shows that panel, where the Format row and Export write the mesh files
|
||||
([3D assets in mcp.md](mcp.md#3d-assets)). Selected objects without a visible 3D effect are left out, and so is
|
||||
a 3D object inside another selected 3D object, whose asset holds it. The button is unavailable while no selected
|
||||
object has a visible 3D effect. Adding the assets is one undo step; when every one of the objects is an asset already, nothing is
|
||||
([3D assets in mcp.md](mcp.md#3d-assets)). Selected objects without a visible 3D effect are left out, and so are
|
||||
a group whose 3D effect is on a fill or stroke, which draws nothing to export, and a 3D object inside another
|
||||
selected 3D object, whose asset holds it. The button is unavailable while no selected object has a 3D effect that
|
||||
can be exported. Adding the assets is one undo step; when every one of the objects is an asset already, nothing is
|
||||
recorded and their assets are selected again.
|
||||
- The Lighting tab also holds the Shadows switch and its settings ([Shadows](#shadows)). The Materials tab holds
|
||||
the Graphics ([Graphics](#graphics)); base materials and ray-traced rendering are not built (see below). The
|
||||
@@ -156,12 +157,23 @@ How a facet carries its seam depends on the lights and the paint:
|
||||
and from places where the light changes sharply, a pixel drawn at 1:1 is opaque where the 3x art is opaque, and
|
||||
otherwise its alpha is within 3 levels. Inflate seen straight on with an opaque fill also has each color channel
|
||||
within 3 levels (VectorCraft's own measure).
|
||||
In the composite, a facet that is one closed polygon whose edges do not cross is drawn over the underlay as one
|
||||
filled path, the facet and the outline of its round seam together, so a pixel at its edge is covered once and not
|
||||
by a fill and then by a stroke of the same color. Other facets keep a fill and a seam stroke. Turned to X 50°,
|
||||
Y 35° in an opaque fill, at most one color channel sample is more than 3 levels off the 3x art, and by at most 4
|
||||
(VectorCraft's own measure).
|
||||
- Extrude & Bevel (Classic), Rotate (Classic) and Revolve (Classic): a path and a seam for every face; gradient and
|
||||
pattern faces seam only the base paint, and the shading and highlight layers cover the face alone. The Wireframe
|
||||
surface draws edges only, with no seam.
|
||||
- Revolve, with shading on: when a `lights` list is given (even one of white lights), a solid-color or gradient face fills its light
|
||||
ramps through a clip of the face and its 0.75 pt seam, outlined with round joins. With the single legacy light,
|
||||
a face is a path and a seam; with a colored `lightColor` a gradient face fills through the same kind of clip.
|
||||
Under a colored `lightColor` or a `lights` list, the faces of a solid-color or gradient surface lie over an underlay
|
||||
of themselves under one clip, as colored Inflate's facets do; in a group, each run of one member's faces in the
|
||||
shared depth order takes its own underlay, and a face with a part of a mapped graphic keeps that part right after
|
||||
it. Faces in a gradient with transparent stops carry its opacity mask and are drawn without an underlay. At 1:1,
|
||||
away from the surface's outline, a pixel is opaque where the same art drawn at 3x and averaged down is opaque
|
||||
(VectorCraft's own measure).
|
||||
|
||||
A facet seen almost edge-on is a sliver, and a seam with mitered joins would reach past the solid as a thorn; a round
|
||||
one reaches no more than half its width past its facet. So where a facet has no neighbor (Rotate's plane, every
|
||||
@@ -598,7 +610,9 @@ out, perspective). No Adobe software, assets, presets or bevel shapes were used.
|
||||
face that darkens gets black over it, multiplied and overprinting, so a spot color stays on its own plate. The
|
||||
checkbox is unavailable while Shading Color is Custom
|
||||
([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); how
|
||||
the faces are shaded with it is VectorCraft's own. Their Rotation tab has the track cube
|
||||
the faces are shaded with it is VectorCraft's own. The Black Overprint shading color keeps each face's paint and
|
||||
draws the shading over it as overprinting black, without the highlight. The shading is on the black plate in
|
||||
Separations Preview and PDF output. Their Rotation tab has the track cube
|
||||
([Track cube](#track-cube)). Map art, Turntable and 3D export are separate, unbuilt items.
|
||||
|
||||
Release measurements and a repeatable CLI scene are in [3D lighting performance](3d-lighting-performance.md).
|
||||
|
||||
+2
-1
@@ -32,7 +32,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| 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) |
|
||||
| Character size and horizontal scale after object/group scaling | done | #1034: fields and setters compensate the stored affine; point size follows the transformed em-height axis, not the glyph ink bounds. Range edits, keyboard increments, leading and baseline shift use document points; rotation, reflection and shear remain editable. |
|
||||
| Preserve font sizes while scaling a group | missing | Separate enhancement; scaling still scales text with the other artwork. |
|
||||
| OpenType panel, Glyphs panel, alternates | done | Highlight Alternate Glyphs preference (#394, off by default) paints pink behind OpenType substitutions on screen when on (required shaping such as Arabic joining forms and the lam-alef ligature, including a lam-alef older fonts file under `liga`, is not highlighted; an optional feature that changes the ligature is); stylistic sets ss01–ss20, stylistic and titling alternates, proportional and lining figures, superscript and subscript are character-style features (`text.setStyle {features}`, #1607); the OpenType panel's Position menu sets superscript, subscript, numerator or denominator glyphs (`sups`, `subs`, `numr`, `dnom`). The OpenType panel's Stylistic Sets menu lists the selected font's `ss01`–`ss20` features, using a font-supplied name where available and `Set N` otherwise; several sets can be active, and selecting an active one removes it. For a mixed-font selection it uses the first selected character's font, a VectorCraft design choice ([public help](https://helpx.adobe.com/illustrator/desktop/design-with-text/special-characters-glyphs/add-stylistic-sets-to-selected-text.html), [OpenType feature specification](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt)). The Glyphs panel highlights the character selected with the Type tool (a range's first character, else the one before the caret) and scrolls it into view as the selection moves (#4908; `panels::glyphs` tests); its Show menu lists Unicode ranges and Alternates for Current Selection, the selected character's alternate glyphs from the font's `GSUB` table. A double-click applies the OpenType feature that draws a variant to that character alone, or uses a glyph choice when no supported feature draws it; see the Glyphs panel row below for Entire Font and the joining limits. The glyph-cell pop-up of alternates is not there yet |
|
||||
| OpenType panel, Glyphs panel, alternates | done | Highlight Alternate Glyphs preference (#394, off by default) paints pink behind OpenType substitutions on screen when on (required shaping such as Arabic joining forms and the lam-alef ligature, including a lam-alef older fonts file under `liga`, is not highlighted; an optional feature that changes the ligature is); stylistic sets ss01–ss20, stylistic and titling alternates, proportional and lining figures, superscript and subscript are character-style features (`text.setStyle {features}`, #1607); the OpenType panel's Position menu sets superscript, subscript, numerator or denominator glyphs (`sups`, `subs`, `numr`, `dnom`). The OpenType panel's Stylistic Sets menu lists the selected font's `ss01`–`ss20` features, using a font-supplied name where available and `Set N` otherwise; several sets can be active, and selecting an active one removes it. For a mixed-font selection it uses the first selected character's font, a VectorCraft design choice ([public help](https://helpx.adobe.com/illustrator/desktop/design-with-text/special-characters-glyphs/add-stylistic-sets-to-selected-text.html), [OpenType feature specification](https://learn.microsoft.com/en-us/typography/opentype/spec/features_pt)). The Glyphs panel highlights the character selected with the Type tool (a range's first character, else the one before the caret) and scrolls it into view as the selection moves (#4908; `panels::glyphs` tests); its Show menu lists Unicode ranges and Alternates for Current Selection, the selected character's alternate glyphs from the font's `GSUB` table. A double-click applies the OpenType feature that draws a variant to that character alone, or uses a glyph choice when no supported feature draws it; see the Glyphs panel row below for Entire Font and the joining limits. A grid cell whose glyph has alternates shows a triangle in its lower right corner; a click on it opens a pop-up of that glyph and its alternates in the font's order, and a pick inserts the character at the caret drawn with that glyph, or draws the selected character with it, in one undo step; in Entire Font a glyph no character maps has the triangle too, and a pick goes on the selected character as a double-click on that glyph's cell does ([CS6 reference, Glyphs panel overview](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=373)); the triangle's size and the pop-up's eight columns and six rows are VectorCraft's own (`panels::glyphs` tests `a_cells_corner_triangle_opens_its_alternates_and_a_pick_inserts_one`, `a_pick_replaces_the_selected_character_and_says_why_when_it_cannot`, `a_pick_that_cannot_be_drawn_leaves_the_text_as_it_was`, `an_unencoded_glyphs_corner_triangle_applies_its_alternates_to_the_selection`; `has_alternates_follows_the_listed_substitutions` in the text crate) |
|
||||
| Glyphs panel: alternates as OpenType feature values, unencoded glyphs | done | #5514, as [Replace characters with alternate glyphs](https://helpx.adobe.com/illustrator/desktop/design-with-text/special-characters-glyphs/replace-characters-with-alternate-glyphs.html) describes (Show › Alternates For Current Selection; replace the selected character by double-clicking the glyph). A character-style feature takes a value (`"salt=2"`, the font's alternate number; `ss01`–`ss20`, `swsh`, `titl` and `aalt` too) in `features` and `featureChanges`, in SVG `font-feature-settings` (`"salt" 2`) and in native files as the plain string. Show › Entire Font applies an unencoded glyph the same way when it is an alternate of the selected character in its word, applies one no feature reaches (`A.salt` in a font with no `salt`) to the selected character as a glyph choice (it may not join), and dims the others with the reason in the tooltip (e.g. `yehfarsi.fina.alt2 belongs to ی (U+06CC) at the end of a word; your selection is ي (U+064A)`); an Arabic presentation form picked there inserts its letter so the word joins. Runs that differ only in their features shape as one piece of text, each run's features over its own characters, so a variant on one letter of an Arabic word keeps its neighbours' initial, medial and final forms and the letters still touch. The panel lists the alternates of the glyph the shaper makes for the selected character in its word (a medial letter shows medial variants), and a double-click applies the OpenType feature that draws the variant (`salt=N` or `ssNN`) to that character alone, in one undo step (`text.setRangeStyle`); a variant no feature reaches falls back to a replacement glyph (`text.setGlyphAlternate`), which its tooltip says may not join. Show › Entire Font also lists the glyphs no character maps, with their name or `gid N` and the feature that gives them. The text crate reads each face's `GSUB` once (alternate sets, single substitutions, the feature that reaches a glyph). Not done: alternates reached through contextual or ligature lookups, and features of the font that the style has no tag for (`cv01`–`cv99`, `hist`). Evidence: `tests::glyph_alternates` in the text crate (a fixture font with a medial teh at `salt=1` to `3`, the neighbours' forms, no gap; Kufi Murabba PIIIX when it is installed), `features::tests::feature_values_are_parsed_validated_and_shaped`, `tests::textedit::feature_values_are_set_replaced_and_saved`, the `panels::glyphs` tests. |
|
||||
| OpenType panel menu: H or V Style, Roman Italics | done | With Show East Asian Options, as [Format East Asian characters](https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html) describes: H or V Style is the character feature `hkna` (kana in the font's horizontal forms, shaped as `vkna` in vertical type) and Roman Italics is `ital` (the font's italic half-width alphanumerics), set with `text.setStyle` / `text.setRangeStyle {features, featureChanges}`, on or off only, and in Character Style Options › OpenType Features ([OpenType feature list](https://learn.microsoft.com/en-us/typography/opentype/spec/featurelist)). |
|
||||
| Font menu: samples, live preview, filters, favourites, recent families; font matching by any name; Find Font | done | #3515: recently applied families appear first, once each; missing families are omitted and the existing Number of Recent Fonts setting applies; #339; script filter: Japanese, Latin, Thai; the font scan on Linux also reads the folders fontconfig's configuration lists, such as TeX fonts under `/usr/share/texmf/fonts` (#1548, fixes #1529; not verified on Linux); Select Text by Font takes a scope: the document, chosen artboards or chosen layers; Find Font's Find In offers Document, Artboard (the active one) and Layers (the selected ones, else the current one) (#5529, a VectorCraft addition); Replace With Font lists family and style rows, one click setting both, with a search over them; its list scrolls on its own, apart from the document's font list (#4972); wherever the font menu opens, its filters keep the same four rows, and it opens at least wide enough for them and for a family name up to 220 points wide with its sample (up to 60% of the window), each sample filling its row's height (a VectorCraft layout); a filter chosen in the font menu of the Character panel, the Control bar or the Properties panel is on in the others, and the filters are cleared when the app quits ([Font browser overview](https://helpx.adobe.com/illustrator/desktop/design-with-text/fonts-and-scripts/font-options-overview.html)); the font menus of the Glyphs panel and of the dialogs that pick a font share the same filters (a VectorCraft choice). |
|
||||
@@ -68,6 +68,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| CJK: input methods (marked text, candidate window) | done | |
|
||||
| CJK: kinsoku (Hard, Soft, None), the predefined mojikumi sets (None, YakumonoHankaku, GyomatsuYakumonoHankaku, GyomatsuYakumonoZenkaku, YakumonoZenkaku, with VectorCraft's own spacing for each) and Line-end Punctuation Half Width, tate-chu-yoko (auto) | done / partial | custom kinsoku sets, custom mojikumi sets and the Mojikumi Settings dialog missing |
|
||||
| CJK: Kinsoku Shori Type (Push In First, Push Out First, Push Out Only) | done | Paragraph panel menu › Kinsoku Shori Type (`text.setFormat {kinsokuType}`), with the East Asian options ([Formatting Asian characters](https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html)); Push Out Only is the default, and a push-in closes the line's gaps next to CJK characters by at most a tenth of an em each (VectorCraft's own limit). Evidence: `layout::wrapping_tests::kinsoku_shori_type_pushes_a_closing_bracket_in_or_out`, `tests::vertical::kinsoku_shori_type_pushes_a_closing_bracket_in_or_out`, `typecmd::area_tests::kinsoku_shori_type_is_set_per_paragraph_and_saved_only_when_not_push_out_only` |
|
||||
| CJK: Kurikaeshi Moji Shori | done | Paragraph panel menu › Kurikaeshi Moji Shori (`text.setFormat {kurikaeshiMojiShori}`), with the East Asian options ([Format East Asian characters](https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html)): a repeat mark (々, ゝ, ゞ, ヽ, ヾ) that starts a line of point or area type is drawn as the character it repeats, and the text keeps the mark; SVG export with live type writes the drawn character. The set of marks and the voicing rules are VectorCraft's own. Off by default, saved natively only when on, carried by paragraph styles. Evidence: `tests::repeat_marks_stand_for_the_character_before_them`, `tests::kurikaeshi_moji_shori_draws_the_repeated_character_at_a_line_start`, `typecmd::area_tests::kurikaeshi_moji_shori_is_set_per_paragraph_and_saved_only_when_on`, `threads::tests::a_continued_frame_carries_the_character_a_repeat_mark_stands_for`, `panels::paragraph::tests::kurikaeshi_moji_shori_toggle_follows_the_selected_paragraphs`, `text_layout::a_repeat_mark_at_a_line_start_is_written_as_the_character_it_draws` |
|
||||
| CJK: Proportional Metrics (`palt` in horizontal type, `vpal` in vertical type) | done | #966 |
|
||||
| CJK: East Asian Type units (Q, Ha) | done | Preferences › Units › East Asian Type (`unitsAsianType`, Points by default) offers every unit and Q and Ha, a quarter of a millimetre each ([Scripting Guide](https://ai-scripting.docsforadobe.dev/scripting/measurementUnits/): 0.709 pt per Q; [InDesign's unit notation](https://helpx.adobe.com/in/indesign/desktop/layout-and-grid-tools/rulers-and-measure-tools/change-ruler-measurement-units.html): `q`, `h`). The public pages do not say which fields follow it, so no field uses it yet and that waits for a source. Evidence: `q_and_ha_are_a_quarter_millimetre`, `east_asian_type_unit_*` |
|
||||
| CJK: manual tate-chu-yoko | done | Character panel menu › Tate-chu-yoko (`text.setFormat` / `text.setRangeStyle {tateChuYoko}`), with Show East Asian Options: marked characters stand side by side across one em of a vertical column, squeezed to the em when wider; two or three half-width digits still do so without the mark; horizontal type keeps the mark and does not move them. Tate-chu-yoko Settings… (`ui.tateChuYokoSettings`, `{tcyUpDown, tcyLeftRight}` in points) moves a marked block up or down and right or left as one piece. Evidence: `tests_vertical::manual_tate_chu_yoko_sets_marked_characters_across_one_em`, `tests_vertical::tate_chu_yoko_settings_move_a_marked_block_up_down_left_and_right`, `typecmd::tate_chu_yoko_is_a_character_attribute_saved_only_when_on`, `typecmd::tate_chu_yoko_settings_are_character_attributes_saved_only_when_set`, `dialogs::tate_chu_yoko::tests` |
|
||||
|
||||
+3
-1
@@ -345,6 +345,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| View › Hide Artboards (Ctrl/Cmd+Shift+H) hides the artboards' edges, bleeds, marks and names and shows the whole canvas as paper (white, or Simulate Colored Paper's colour); the Artboard tool still shows them | done | #4038, `canvas::tests::hidden_artboards_leave_a_paper_canvas_without_edges` |
|
||||
| Artboard Options › Display: Show Video Safe Areas and Video Ruler Pixel Aspect Ratio ([public source](https://helpx.adobe.com/illustrator/desktop/create-manage-artboards/organize-manage-artboards/set-video-display-options-for-artboards.html)) | done | #2849; per artboard (`artboard.setProps`/`artboard.new` `showVideoSafeAreas`, `videoRulerPixelAspectRatio` 0.1–10, default 1; one undo step; native format). The page gives no safe-area numbers: our choice is [EBU R 95](https://tech.ebu.ch/docs/r/r095.pdf)'s, the action-safe area 3.5% and the title-safe area 5% in from each edge, outlined 1 point wide on the canvas and turned with the view; exports and print leave them out. Tests `an_artboard_shows_its_video_safe_areas`, `artboard_options_show_video_display_options`, `artboard_video_display_options_*` |
|
||||
| Shape tools: Shift constrains, Alt from centre, Space moves while dragging, arrows change sides/points/rows | done | |
|
||||
| Eraser: Shift-drag erases along a horizontal, vertical or diagonal line ([public source](https://help.adobe.com/archive/en_US/illustrator/cs3/illustrator_cs3_help.pdf#page=82)) | done | the line runs from the press point at the 45° step from the Constrain Angle nearest the pointer, taken once the pointer is 3 screen pixels from the press and kept until Shift is released; the tip outline follows the line; released, the drag goes on freehand from the last point on the line, and Shift again takes a new step from the press point (VectorCraft's own rules); `eraser_shift_keeps_the_stroke_on_a_45_degree_line` in `crates/tools/src/draw2/gesture/tests.rs` |
|
||||
| Polygon/Star exact-size placement remembers the chosen sides/points for later drags and dialog openings; Cancel preserves the previous count | done | Session tool options; existing dialog-opening gestures retained; regression in `toolbar.rs` |
|
||||
| Tool double-click opens its options | done | |
|
||||
| Per-platform mapping (Cmd ↔ Ctrl, Option ↔ Alt) | done | |
|
||||
@@ -484,8 +485,9 @@ next unit in the order a right-click on a ruler lists them, from Feet back to Po
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools selects its eight tools (Anchor Eraser Brush, Extend Path, Measure & Inspect, Parametric Shape, Corner Tool, Slide Anchor Along Path, Shared Edge Merge Tool, Trim at Crossings Tool), which the All Tools drawer lists under their own heading but neither toolbar shows as shipped, opens the Anchor Inspector panel (the selected anchor's X/Y and handle lengths and angles as fields; Make Smooth, Make Corner, Equalize Handles, Remove Points Keep Shape, Add Points, the three ways to close) and the Parametric Shape panel (kind, count, W/H, rotation, the kind's own values and corner radius of the selected parametric shape, or of the tool's next one), and runs Add Points at / Split at Crossings and Convert to Parametric Shape; the Parametric Shape Tool draws ten re-editable kinds from the centre (↑/↓ and ←/→ change their numbers while dragging) and edits a selected one with handles; the Corner Tool cuts editable corners on any path (hover shows the anchor, a click uses its radius and kind, a drag sizes the corner, Shift whole values; a corner's marker selects it and loads its values, drags to resize, to 0 or double-clicked removes it; never past what fits; Alt-marquee cuts every anchor inside) with a Corners section in the Anchor Inspector (radius, kind, selected count, Apply to Selected Anchors); Slide Anchor Along Path drags an anchor along its curve with the segments beside it refitted, Shift snapping where the tangent is a multiple of 45°; the Shared Edge Merge Tool shows, over two paths touching at two coincident anchors, the two stretches and the edge merging them, a click merges them (half way; Shift the upper path, Alt the lower), and near anchors meet or an anchor one path lacks is added to match (Shift+Alt asks for this inside a stretch), with a Shared Edges section in the Anchor Inspector (brush diameter, coincidence 0 to 3 pt, Keep Shared Points Together, which takes coincident anchors along with the add-on's own anchor moves); a double-click on the brush or Extend Path tool opens its options | done | `addon.pathtools.*`, `crates/tools/src/addons/`, `crates/ui-egui/src/addons/pathtools.rs`, `crates/ui-egui/src/addons/pathtools/` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Divide into Dashes… (Dash and Gap in any unit, Fit to Corners and Ends, Remove Gaps; Preview) cuts the selected paths, or only their direct-selected segments, into open pieces along the curve, keeping their appearance, one undo step | done | #4950; `addon.pathtools.divideDashes`, `crates/pathops/src/addons/pathtools/dashes.rs`, `crates/ui-egui/src/addons/pathtools/dashes.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Set Corners… (also a button in the Anchor Inspector's Corners section: Radius in any unit, Corner kind, Anchors: All, Odd-Numbered or Even-Numbered, counted from each path's first anchor; Angle: from … to …°, only the corners whose sides meet at an angle in that range; Preview) cuts corners on the chosen anchors of every selected path, one undo step | done | #5546, #5545; `addon.pathtools.cornerSet` (`every`, `minAngle`, `maxAngle`), `crates/ui-egui/src/addons/pathtools/set_corners.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Trim at Crossings Tool (in the All Tools drawer under the add-on's heading, in neither toolbar as shipped, no shortcut) removes stretches of paths between the places where they are crossed, on any editable path, selected or not: a click removes the stretch under the pointer, a drag every stretch its rectangle touches, an Alt-drag every stretch its freehand line crosses; one undo step each; Escape during a drag removes nothing | done | `addon.pathtools.trim` (in `crates/engine/src/cmd/addons/pathtools/trim.rs`), `crates/tools/src/addons/trim.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Trim at Crossings Tool (in the All Tools drawer under the add-on's heading, in neither toolbar as shipped, no shortcut) removes stretches of paths between the places where they are crossed, on any editable path, selected or not: a click removes the stretch under the pointer, a drag every stretch its rectangle touches, an Alt-drag every stretch its freehand line crosses; one undo step each; Escape during a drag removes nothing; hovering shows in red the stretch a click would remove, and a drag that reaches few paths shows what its release would remove | done | `addon.pathtools.trim` (in `crates/engine/src/cmd/addons/pathtools/trim.rs`), `crates/tools/src/addons/trim.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Expand Dashes into Paths turns each selected path's dashed stroke into separate open paths, one per dash, laid out as the stroke draws them (pattern, offset, Align Dashes to Corners and Path Ends), each keeping the stroke with the dashes off; one undo step | done | #4922; `addon.pathtools.expandDashes` (in `crates/engine/src/cmd/addons/pathtools.rs`, using the renderer's dash layout) and its tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools › Tangent Circle… draws the circles that touch two selected paths or compound paths at a radius, or three of them, each touching the outlines without crossing them; Radius (two shapes), a Circle menu (All or one by number) and Preview; one undo step | done | `addon.pathtools.tangentCircle` (in `crates/engine/src/cmd/addons/pathtools/tangent_circle.rs`, geometry in `crates/pathops/src/addons/pathtools/tangent_circle.rs`) and its tests; a VectorCraft addition, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Effect › Path Effects lists its live effects (Dashes to Geometry, Add Anchors, Extend Path, Close Path, Smooth Anchors, Retract Handles, Reverse Direction, Simplify Anchors, Split at Anchors), each with the effect dialog's live Preview except Reverse Direction, which has no options, and listed in the Appearance panel like any effect | done | `addon.path.*`, `crates/effects/src/addons/path.rs`, `crates/ui-egui/src/addons/pathtools.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools selects its four tools (Anchor Eraser Brush, Extend Path, Measure & Inspect, Parametric Shape), which the All Tools drawer lists under their own heading but neither toolbar shows as shipped, opens the Anchor Inspector panel (the selected anchor's X/Y and handle lengths and angles as fields; Make Smooth, Make Corner, Equalize Handles, Remove Points Keep Shape, Add Points, the three ways to close) and the Parametric Shape panel (kind, count, W/H, rotation, the kind's own values and corner radius of the selected parametric shape, or of the tool's next one), and runs Add Points at / Split at Crossings and Convert to Parametric Shape; the Parametric Shape Tool draws ten re-editable kinds from the centre (↑/↓ and ←/→ change their numbers while dragging) and edits a selected one with handles; a double-click on the brush or Extend Path tool opens its options | done | `addon.pathtools.*`, `crates/tools/src/addons/`, `crates/ui-egui/src/addons/pathtools.rs`, `crates/ui-egui/src/addons/pathtools/shape.rs` and their tests; not a feature of the reference app, so it is not scored |
|
||||
| Path Precision Tools add-on (VectorCraft addition): Object › Plug-ins › Path Precision Tools selects its six tools (Anchor Eraser Brush, Extend Path, Measure & Inspect, Parametric Shape, Corner Tool, Slide Anchor Along Path), which the All Tools drawer lists under their own heading but neither toolbar shows as shipped, opens the Anchor Inspector panel (the selected anchor's X/Y and handle lengths and angles as fields; Make Smooth, Make Corner, Equalize Handles, Remove Points Keep Shape, Add Points, the three ways to close) and the Parametric Shape panel (kind, count, W/H, rotation, the kind's own values and corner radius of the selected parametric shape, or of the tool's next one), and runs Add Points at / Split at Crossings and Convert to Parametric Shape; the Parametric Shape Tool draws ten re-editable kinds from the centre (↑/↓ and ←/→ change their numbers while dragging) and edits a selected one with handles; the Corner Tool cuts editable corners on any path (hover shows the anchor, a click uses its radius and kind, a drag sizes the corner, Shift whole values; a corner's marker selects it and loads its values, drags to resize, to 0 or double-clicked removes it; never past what fits; Alt-marquee cuts every anchor inside) with a Corners section in the Anchor Inspector (radius, kind, selected count, Apply to Selected Anchors); Slide Anchor Along Path drags an anchor along its curve with the segments beside it refitted, Shift snapping where the tangent is a multiple of 45°; a double-click on the brush or Extend Path tool opens its options | done | `addon.pathtools.*`, `crates/tools/src/addons/`, `crates/ui-egui/src/addons/pathtools.rs`, `crates/ui-egui/src/addons/pathtools/` and their tests; not a feature of the reference app, so it is not scored |
|
||||
|
||||
Reference in New Issue
Block a user