mirror of
https://github.com/storytold/vectorcraft.git
synced 2026-11-18 13:33:51 +00:00
Merge main into feat/save-for-web-delete-color
This commit is contained in:
@@ -183,7 +183,7 @@ VectorCraft choices; an original approximation, never compared with another appl
|
||||
| Materials panel, lighting, ray-traced render | Window › 3D and Materials panel with the object types (Plane, Extrude, Revolve, Inflate) and the Object, Rotation and Lighting settings of the applied effect, Render Settings › Wireframe, which draws the live effect as the edges of its faces, and Quick Actions › Expand as Wireframes ([three-d.md](three-d.md#3d-and-materials-panel)); one to ten directional lights with per-light Color (opaque RGB, white by default), Intensity, Rotation, Height, Softness and neutral Ambient Light, Revolve and colored Inflate use smooth vector shading; Extrude & Bevel and Rotate retain planar shading; original Standard, Diffuse, Top Left and Right lighting rigs; shadows behind or below the object from the first light, blurred by its Softness ([three-d.md](three-d.md#shadows)); the Materials tab's Graphics, document symbols mapped onto Extrude & Bevel's caps and onto a plane, moved with an artboard handle, and wrapped around Revolve's side ([three-d.md](three-d.md#graphics)); no base materials, graphics on Inflate or on Extrude & Bevel's walls and bevels, or ray tracing |
|
||||
| 3D (Classic): Extrude & Bevel, Revolve, Rotate | Extrude & Bevel (Classic) initial: live, round seam joins, Extrude Depth, Cap, five original bevel shapes with Height and Bevel Extent In or Out, Position presets and rotation gizmo, Perspective, Wireframe, No Shading, Diffuse and Plastic surfaces with one to ten lights, Light Intensity, Ambient Light, Highlight Intensity and Size, Blend Steps, Black, Custom, Black Overprint or no Shading Color ([Black Overprint](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=188)), Draw Hidden Faces ([create 3D objects](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/create-3d-objects.html)); Revolve (Classic) initial: live, round seam joins, Angle, Cap, Offset from the left or right edge, Position presets and rotation gizmo, Perspective, the same four surfaces, lights, highlight, Blend Steps and Shading Color, groups and layers revolved about one shared axis (same page); Rotate (Classic) initial: live, round seam joins, every fill and stroke turned as one plane, Position presets and rotation gizmo, Perspective, No Shading and Diffuse surfaces with lights, Ambient Light, Blend Steps and Shading Color ([rotate objects in 3D](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/rotate-objects-in-3d.html)); Preserve Spot Colors in all three, unavailable with a Custom Shading Color ([Preserve Spot Color](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=260)); all three: a lighting sphere on the Lighting tab whose lights drag, move to the back or front, and are added at the front center or deleted down to one ([lighting options](https://help.adobe.com/archive/en_US/illustrator/cs5/illustrator_cs5_help.pdf#page=272)); all three: the track cube (face, edge, Shift and ring drags, keyboard steps; [three-d.md](three-d.md#track-cube)); Map Art: none |
|
||||
| Turntable (30.0 beta) | none |
|
||||
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object, and the 3D and Materials panel's Export 3D Object button (which then shows Asset Export with the new assets selected, [three-d.md](three-d.md#3d-and-materials-panel)), collect an object with Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, and Export writes its solids as a USDA (the default), USDZ, glTF or OBJ mesh with a material in each solid's paint color (`assets.add3D`, `assets.set3DFormat`, `assets.export3D`); no textures, map art or shading ([3D export help](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)) |
|
||||
| Export 3D objects (OBJ, USDA, glTF) | initial: Asset Export's Export 3D Object, and the 3D and Materials panel's Export 3D Object button (which then shows Asset Export with the new assets selected, [three-d.md](three-d.md#3d-and-materials-panel)), collect an object with Extrude & Bevel, Revolve, Inflate or Rotate as a 3D asset, and Export writes its solids as a USDA (the default), USDZ, glTF or OBJ mesh with a material in each solid's paint color (`assets.add3D`, `assets.set3DFormat`, `assets.export3D`); graphics mapped onto a plane or Extrude & Bevel's caps are exported as PNG textures of those faces, flat and unlit; no graphics on Revolve's side, no materials and no shading ([3D export help](https://helpx.adobe.com/illustrator/desktop/special-effects-styles/create-3d-graphics/export-3d-vector-artwork.html)) |
|
||||
|
||||
The `three-d` crate (depends on `geom` and `pathops`, with no UI or GPU dependencies) builds, rotates, projects, shades and depth-sorts the surfaces;
|
||||
the effects crate turns them into art. What's left (materials and shadows, ray-traced rendering,
|
||||
|
||||
@@ -323,7 +323,7 @@ Gradient meshes in the editing data keep each point's own color where a patch's
|
||||
| DXF | open, export | yes | yes (R12–2018) | R13–2018 closed SPLINE flags and control-point closure on import verified (#1299); circular cubic paths export as native CIRCLE/ARC where stroke semantics permit; R12 weighted strokes remain POLYLINE while non-circular curves keep the existing fallback (`crates/cad/src/tests.rs`); [Autodesk group 70](https://help.autodesk.com/cloudhelp/2024/ENU/AutoCAD-DXF/files/GUID-E1F884F8-AA90-4864-A215-3182D47A9C74.htm). DXF 2000–2018 LAYOUT objects write the paper image origin as 148/149 (was a stray 158), the shade plot codes (2004+) and the model type flag, and the plot style placeholder carries no subclass marker (#3085; structure test `r2000_and_later_files_have_the_structure_cad_apps_require`, checked with ezdxf's audit; not yet confirmed in Autodesk Fusion). DXF Options' Preset menu and `document.exportDxf`'s `dxfPreset: "cnc"` set the CNC / CAM options (#5500); VCarve QA remains open |
|
||||
| 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) |
|
||||
| EMF / WMF | open, export | yes | yes | an oversized embedded PNG or JPEG is refused from its header, before any pixels are decoded (#1776); a picture cut short by a reader limit, images and pattern brushes that are not read, clips that are not applied and raster operations other than a plain copy come back as warnings; tests in `crates/metafile/src/tests/import.rs` |
|
||||
| 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) |
|
||||
@@ -345,6 +345,15 @@ Gradient meshes in the editing data keep each point's own color where a patch's
|
||||
| Affinity `.af`, `.afdesign`, `.afpub` | no | yes (beyond Illustrator) | no (#665) | 51 pinned files, [affinity-validation.md](affinity-validation.md) |
|
||||
| Clipboard: PDF, SVG, PNG, EMF, text | yes | yes | yes | copied files paste as art; cells copied from a spreadsheet (tab-separated text) paste as a table of point type over gridlines, at most 1000 rows, 256 columns and 20,000 cells (#5296) |
|
||||
|
||||
Opaque CMYK PSD/PSB merged images preserve their 8-bit or 16-bit ink samples, CMYK ICC profile, resolution,
|
||||
and clipping path through placement, relinking, updating, and embedding (#8316). VectorCraft stores these images
|
||||
as CMYK TIFFs up to its native limit of 67,108,864 pixels and within its allocation allowance. Other CMYK composites
|
||||
use the RGB import path, subject to its allocation limit; importing individual layers keeps its existing behavior.
|
||||
Synthetic regressions in
|
||||
`tests_psdread.rs` cover native samples, compression, metadata, and linked-image operations. The
|
||||
[public PSD specification](https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/index.html) defines
|
||||
the CMYK planes and profile and resolution resources.
|
||||
|
||||
## PDF form gradients
|
||||
|
||||
PDF export's linear and radial gradients stay aligned inside transparency groups, opacity masks,
|
||||
|
||||
+5
-3
@@ -517,8 +517,9 @@ macOS cursor delivery (#2292) is narrowed to a native host adapter using the exi
|
||||
afterwards opens in a floating window of its own (G7's Float in Window); documents already open stay where they
|
||||
are. Estimate unchanged.
|
||||
- **Done:** Hyphenation › Default Language is the language of new type, unless Document Setup chose one, and each
|
||||
run hyphenates in its own language (Character panel). English and eleven Indian languages have break
|
||||
points; other languages stay whole apart from the Exceptions list (#394, #4947).
|
||||
run hyphenates in its own language (Character panel). English, eleven Indian languages, Bulgarian, Turkish
|
||||
and Russian have break points, and German, Polish, Portuguese and Italian have them in builds that embed
|
||||
their patterns; other languages stay whole apart from the Exceptions list (#394, #4947).
|
||||
- **Done (2026-11-14):** Layers panel row context menu: right-clicking a layer, group, or object row shows a context menu (Options…, Duplicate, Delete, Lock Others / Unlock All, Hide Others / Show All, Locate Object, Collect for Export) with proper selection behavior and Undo/Redo tracking. Tests in `crates/ui-egui/src/panels/layers/tests.rs`.
|
||||
- **Missing:** 2 Preferences options stored but not acted on (#394), each waiting on a subsystem of its own:
|
||||
Plug-ins & Scratch Disks › Primary and Secondary (documents are kept in memory; nothing pages to
|
||||
@@ -703,7 +704,8 @@ macOS cursor delivery (#2292) is narrowed to a native host adapter using the exi
|
||||
Extrude & Bevel, Inflate and Rotate with Position presets ([three-d.md](three-d.md), #1407). Colored Inflate has automatic smooth vector lighting from shared membrane normals. White-light Inflate keeps its polygon shading. Every 3D facet's seam has round joins ([three-d.md](three-d.md#seams)). All four take one to ten colored directional lights, with neutral ambient applied once, a light list and independent previewing controls. Standard, Diffuse, Top Left and Right select original rigs, shared with commands; manual settings show Custom.
|
||||
- **Missing:** materials (base, Substance, graphics), shadows,
|
||||
ray-traced rendering, angular cut caps, exact visibility for intersecting and concave surfaces, the rest of 3D
|
||||
Classic (Map Art), Turntable, textures, map art and shading in 3D export.
|
||||
Classic (Map Art), Turntable, and in 3D export the graphics on Revolve's side, materials and shading (graphics on
|
||||
planes and Extrude & Bevel's caps are exported as textures).
|
||||
- **Impact:** specialist; Materials is the one menu stub left.
|
||||
- **Estimate:** 25–45 h; plan in `plan/` before coding.
|
||||
|
||||
|
||||
@@ -23,7 +23,10 @@ versions. Among those presets, Corners is 100 in Technical Drawing, 75 in Defaul
|
||||
Logo, Line Art and Outline, and 50 in the other eight. Noise is 1 px in Technical Drawing, 5 in High Fidelity Photo and Black and White Logo, 8 in 6 Colors
|
||||
and 16 Colors, 10 in Low Fidelity Photo, 15 in 3 Colors and Shades of Gray, 20 in Sketched Art, Line
|
||||
Art and Outline, 25 in Default, and 90 in Silhouettes (see
|
||||
[image-trace-quality.md](image-trace-quality.md#preset-paths-corners-and-noise)).
|
||||
[image-trace-quality.md](image-trace-quality.md#preset-paths-corners-and-noise)). High Fidelity Photo
|
||||
traces with Palette › Full Tone at Color detail 85 and Method › Abutting (VectorCraft's own values; see
|
||||
[image-trace-quality.md](image-trace-quality.md#high-fidelity-photo-in-full-tone)); Low Fidelity Photo
|
||||
traces with a Limited palette of 20 colors, Overlapping.
|
||||
|
||||
Sliders apply on release, and their numeric fields can be edited directly. Each committed
|
||||
adjustment re-traces the selected object as one undo step and changes the preset to Custom.
|
||||
@@ -83,9 +86,9 @@ leaves out every white area whatever `ignoreBackground` is.
|
||||
color nearest to it in lightness and hue, with a difference in hue or chroma counted three times
|
||||
as much as one in lightness, so a gray or a muted brown takes a black, white or other neutral
|
||||
library color rather than a saturated color of the same lightness.
|
||||
**Abutting and Overlapping.** Abutting is the default Method, and the Default, Auto Color, 3 Colors,
|
||||
6 Colors and 16 Colors presets use it. With Abutting, two neighboring colors share one exact edge. The
|
||||
canvas smooths the edges of each path on its own, so each of the two paths covers only part of the
|
||||
**Abutting and Overlapping.** Abutting is the default Method, and the Default, Auto Color, High Fidelity
|
||||
Photo, 3 Colors, 6 Colors and 16 Colors presets use it. With Abutting, two neighboring colors share one
|
||||
exact edge. The canvas smooths the edges of each path on its own, so each of the two paths covers only part of the
|
||||
pixels along that edge, and a thin line of the background can show between the colors. Web browsers
|
||||
and PDF viewers usually draw an exported SVG or PDF file the same way and show the same line. Raster
|
||||
exports (PNG, JPEG, TIFF and the other bitmap formats) with None anti-aliasing do not show it at any
|
||||
|
||||
@@ -83,8 +83,9 @@ gradient, texture, sensor noise):
|
||||
Photo trace was 86,000 anchors under the old limit; a noisier scan of the same size would have been
|
||||
refused. At 8,000,000 anchors a trace keeps about 0.7 GB, with a peak of about 0.9 GB while tracing.
|
||||
The preset rows were measured with the earlier preset values: High Fidelity Photo at Paths 90, Corners 25
|
||||
and Noise 4, Low Fidelity Photo at Paths 60, Noise 12 and 16 Colors at Paths 70, Corners 55 and Noise 10
|
||||
(see [Preset Paths, Corners and Noise](#preset-paths-corners-and-noise)).
|
||||
and Noise 4 with a Limited palette of 64 colors and Overlapping, Low Fidelity Photo at Paths 60, Noise 12
|
||||
and 16 Colors at Paths 70, Corners 55 and Noise 10 (see [Preset Paths, Corners and
|
||||
Noise](#preset-paths-corners-and-noise) and [High Fidelity Photo in Full Tone](#high-fidelity-photo-in-full-tone)).
|
||||
## Collapsed loops keep few segments
|
||||
A small closed loop (or a piece that returns to its own junction) whose fit collapsed to a single
|
||||
cubic cannot stay as one, so it kept every positioned point as a straight segment. A looser Paths
|
||||
@@ -250,7 +251,8 @@ Every built-in preset other than Auto Color and Flat Logo traces at Paths 50. Co
|
||||
The palettes, color counts, thresholds and other options of the presets did not change. The enhanced
|
||||
versions of these presets use the same Paths, Corners and Noise. 6 Colors and 16 Colors were at Noise 15
|
||||
and Black and White Logo at 25 until [Noise joins the nearest color](#noise-joins-the-nearest-color);
|
||||
the measurements below were made at those values.
|
||||
the measurements below were made at those values. High Fidelity Photo's palette and Method changed
|
||||
later (see [High Fidelity Photo in Full Tone](#high-fidelity-photo-in-full-tone)).
|
||||
|
||||
Measured with the harness below (section 1, each preset on the inputs it is meant for), before and after:
|
||||
anchors fall in 10 of the 12 changed presets, for example 5,494 to 3,136 (High Fidelity Photo), 33 to 27
|
||||
@@ -271,6 +273,47 @@ the other sections of this file, and in the Image Trace entries of
|
||||
[target-app-parity.md](target-app-parity.md), were measured at the earlier values.
|
||||
Test: `presets_have_their_paths_corners_and_noise` in `crates/trace/src/tests.rs`.
|
||||
|
||||
## High Fidelity Photo in Full Tone
|
||||
High Fidelity Photo traces with Palette › Full Tone at Color detail 85 and Method › Abutting. It traced
|
||||
with a Limited palette of 64 colors, Overlapping, before. Paths, Corners and Noise stay 50, 50 and 5.
|
||||
These are VectorCraft's own values. Low Fidelity Photo keeps its Limited palette of 20 colors.
|
||||
|
||||
Palette › Full Tone splits its colors until none spans more than its width limit. Then, while it has
|
||||
fewer colors than Color detail's value (85 at 85), it splits the narrower ones too, where the image has
|
||||
that many colors. The colors that look alike merge after that, and a merged color can merge again, so a
|
||||
trace can end with far fewer colors than that count: a gray-to-green ramp 256 px wide with up to 8 levels
|
||||
of grain a channel ends with 6 colors at Color detail 85, where the RGB test leaves 4. Full Tone's colors
|
||||
merge when they are thoroughly mixed and less than 5 apart in Oklab × 100, or mixed in patches
|
||||
(compression blocks) and less than 1.5 apart. The other palettes, Automatic included, keep the RGB test
|
||||
(under 30 levels and thoroughly mixed, or under 12 and mixed in patches), and Automatic's continuous-tone
|
||||
colors do not take the least count. These rules apply to every trace with Palette › Full Tone, so an
|
||||
existing Full Tone trace or saved preset traces differently when it is traced again.
|
||||
|
||||
On 19 photos, cartoons and synthetic shapes of 400 to 4,000 px, the mean pixel difference summed over the
|
||||
inputs fell from 80.5 to 65.6 levels. It fell by more than 1% on 14 inputs (2.88 to 2.19 and 2.59 to 2.48
|
||||
on two photos, the second a JPEG at quality 40; 1.88 to 1.45 on a 4000 × 3000 photo; 12.40 to 7.44 on an
|
||||
upscaled cartoon) and changed by less than 1% on the other 5. Anchors rose 1.66 times (1.98 million to
|
||||
3.29 million) and the SVG size 1.31 times. The trace time rose 1.7 times (18.9 to 31.5 s for all 19, with
|
||||
both builds tracing 3 images at a time in the same run). Flat synthetic art costs the most: 12 to 400
|
||||
anchors on a 4000 × 3000 image of two flat colors, and about 3 times the anchors on two images of
|
||||
synthetic shapes (400 × 300 and 1600 × 1200), with the same pixel difference. A flat gray 192 × 128 with
|
||||
up to 3 levels of grain a channel traces as 25 colors and 244 anchors, where the Limited palette of 64
|
||||
traced 1 color and 4 anchors; with up to 5 or 8 levels both trace it as 25 to 37 colors, on each of the
|
||||
grays tested (28, 60, 128 and 200).
|
||||
|
||||
In the same run, peak memory fell on 16 of the 19 inputs, for example 906 to 625 MiB on a 1536 × 2048
|
||||
cartoon, and rose on 3 small ones (by 5 to 11 MiB). Abutting accounts for the fall: the earlier preset
|
||||
with Method › Abutting peaked at 523 MiB on the same cartoon, against 924 MiB with Overlapping, in another
|
||||
run. Low Fidelity Photo, 16 Colors, 6 Colors, Black and White Logo and Auto Color give byte-identical
|
||||
SVGs. On three flat colors stored in 8 × 8 blocks, each block off by up to 8 levels a channel, High
|
||||
Fidelity Photo traces 3 colors as 3 paths; without the patch rule it traced 7 colors as 74 paths.
|
||||
|
||||
Tests: `high_fidelity_photo_traces_in_full_tone`, `full_tone_keeps_more_of_a_noisy_ramps_tones`,
|
||||
`full_tone_traces_a_noisy_dark_ground_like_a_light_one` and
|
||||
`full_tone_merges_a_flat_colors_compression_blocks` in `crates/trace/src/tests.rs`,
|
||||
`full_tone_merges_only_mixed_colors_that_look_alike` in `crates/trace/src/quantize.rs`, and
|
||||
`full_tone_makes_one_color_per_step_of_color_detail` in `crates/trace/src/quantize/palette.rs`.
|
||||
|
||||
## A simpler contour walk
|
||||
`contour::trace_mask` follows each region's outline along the pixel cracks with the inside on the
|
||||
right. It used to build a table of outgoing directions for every pixel corner in a raster pass and
|
||||
|
||||
+60
-3
@@ -5441,7 +5441,11 @@ and `layerRows`, the rows highlighted in the panel.
|
||||
runs Hide or Lock Others for the row's layer, or Show or Unlock All when the others already are), `layer.pasteRemembersLayers`,
|
||||
`object.isolate {id?}` (a group, a layer or a single object, by default the first selected object; not type, not a
|
||||
hidden or locked object or one in a hidden or locked group or layer, not a guide path while Lock Guides is on, and
|
||||
while a symbol is edited only the editing layer or art on it) / `object.exitIsolation`.
|
||||
while a symbol is edited only the editing layer or art on it) / `object.exitIsolation`. Leaving an isolated Live
|
||||
Paint group (`object.exitIsolation`, or `object.isolate` on a level outside it) adds the paths, compound paths and
|
||||
groups of them drawn in it, shown and unlocked with everything in them, to the group as `livePaint.merge` does, in
|
||||
one undo step; type, images and other objects stay in it as they are, and with nothing drawn no undo step is
|
||||
recorded.
|
||||
- **Dialogs and panel state** (control channel and the app's MCP): `ui.layerOptions {ids?}` and `ui.newLayer
|
||||
{sublayer?}` open Layer Options (dialog `layerOptions`: name, color, template, locked, visible, printable, preview,
|
||||
dimImages, dimPercent; OK is one undo step; `ui.dialog.set` of `template` also sets `locked` and `dimImages`, as the
|
||||
@@ -7598,6 +7602,12 @@ they can't be read, as with a PNG cut short by a download or a sync still runnin
|
||||
can't be read" and places nothing; `clipboard.importImage` fails the same way. A JPEG cut short is placed when its
|
||||
pixels still decode. Both keep the decoded pixels (except a CMYK JPEG's) in the image store the renderers share, so the first render
|
||||
that draws the image does not decode the file again.
|
||||
Opaque CMYK PSD/PSB merged images retain their 8-bit or 16-bit ink samples, CMYK ICC profile, resolution, and
|
||||
clipping path when placed, linked, relinked, updated, or embedded. `file.place.info`, `image.info`, and `links.info`
|
||||
report CMYK for these images. VectorCraft's native CMYK limit is 67,108,864 pixels. Composites with transparency,
|
||||
images beyond that limit, and native samples beyond the allocation allowance use the RGB import path, subject to
|
||||
its allocation limit. Importing individual layers with `layers: true` retains its existing behavior.
|
||||
|
||||
`file.place.info` describes a file without placing it and `image.info` reports a placed image's link, colour mode and
|
||||
effective ppi. `file.place.queue` loads the place cursor (the `place` tool) with several files: headless, drive it
|
||||
with `pointer_gesture` (a click places at 100% with the top-left corner there, a drag at the dragged size) and
|
||||
@@ -8848,6 +8858,9 @@ starts a new point type object at the position the advance gives, and an underli
|
||||
of the last character's advance. Type on more than one line is placed a line at a time: each line is aligned by its own advances and
|
||||
split as a single line is. An EMF that
|
||||
draws with EMF+ records is read from them. Hatched and pattern brushes fill with their average color. Records VectorCraft doesn't read are skipped with one warning.
|
||||
Each of these adds one warning, with a count: a file, or a metafile image inside it, cut short by one of the reader's
|
||||
limits; images and pattern brushes whose bitmap can't be read, which are left out; clips that can't be applied as the
|
||||
file sets them; and raster operations other than a plain copy, drawn as a plain copy or left out.
|
||||
`clipboard.importEmf {dataBase64, center?}` loads an EMF or WMF picture into the clipboard for `edit.paste`; the app
|
||||
pastes `image/emf` from the system clipboard ahead of text and bitmaps when the platform's clipboard service offers it
|
||||
(the Windows desktop service doesn't read metafiles yet).
|
||||
@@ -9121,13 +9134,28 @@ default), `usdz`, `gltf` or `obj`; the panel shows a Format row for the 3D asset
|
||||
`assets.set3DFormat {assets, format}` sets it (an undo step only when the format changes). `assets.list` gives each
|
||||
asset's `format3D` (null for a picture asset).
|
||||
|
||||
`assets.export3D {assets?, folder?, zip?}` writes each 3D asset (default: all of them) as a mesh file named after it:
|
||||
`assets.export3D {assets?, folder?, zip?, textureSize?}` writes each 3D asset (default: all of them) as a mesh file named after it:
|
||||
`.usda`, `.usdz`, `.gltf` (glTF 2.0, its buffer embedded) or `.obj` with its `.mtl` (whitespace and `#` in an OBJ's
|
||||
name become `_`). Every solid of the object (the
|
||||
fill's, each stroke's, a group's members') is its own mesh, with a two-sided material in the color it is painted
|
||||
(a gradient's stops averaged, a pattern gray). The mesh holds the solid's faces before they are projected onto the
|
||||
page, those turned away from the viewer included, at the object's 3D rotation, y up, about the point the object turns
|
||||
about: in points (USD's layer gives `metersPerUnit`), in meters in glTF. Files that would share a name get `-2`, `-3` and so on.
|
||||
Graphics mapped onto a plane or onto Extrude & Bevel's front or back cap (`threeD.mapGraphic`) are exported as a PNG
|
||||
texture of that face: the face's color with its graphics drawn over it, flat and unlit, on a mesh of the face's own
|
||||
triangles with texture coordinates and a material that shows the texture. A face that is not opaque keeps its opacity
|
||||
in the texture's alpha: as on the canvas, the graphics take the opacity of the face's fill or stroke, and the object's
|
||||
opacity applies to the face and its graphics together. glTF embeds the PNG as a data URI
|
||||
(`TEXCOORD_0`, `baseColorTexture`), USDZ stores it after the layer, USDA reads it through `primvars:st`, a
|
||||
`UsdPrimvarReader_float2` and a `UsdUVTexture` connected to the surface's `diffuseColor`, and OBJ gives `vt` coordinates
|
||||
and an MTL `map_Kd`; OBJ and USDA write the PNG beside them as `<name>-texture-1.png`, `-texture-2.png` and so on
|
||||
(whitespace, `#` and `@` become `_`). USD reads a face's opacity from the texture's alpha (`outputs:a`), and an OBJ
|
||||
whose face is not opaque also gets `<name>-texture-1-opacity.png`, the alpha as gray levels, for the MTL's `map_d`.
|
||||
Faces with the same color, graphics and bounds share one texture. `textureSize` (128 to
|
||||
4096, default 1024, VectorCraft's own values) is the number of pixels along the longer side of each texture; one export
|
||||
draws at most 67,108,864 texture pixels in all, and past that it is refused. Graphics on Revolve's side are not
|
||||
exported yet. The layouts follow glTF 2.0, UsdPreviewSurface (<https://openusd.org/release/spec_usdpreviewsurface.html>)
|
||||
and OBJ/MTL (<https://www.loc.gov/preservation/digital/formats/fdd/fdd000508.shtml>).
|
||||
With `zip`, the files go into one ZIP named after the document with `-3D` added (`Untitled-1-3D.zip`), or
|
||||
`3D Assets.zip` when the document's title gives no file name.
|
||||
An object whose face has a hole that crosses the face's outline or another hole is refused, by `assets.add3D` and
|
||||
@@ -9815,6 +9843,20 @@ on again.
|
||||
{"name":"run_command","arguments":{"command":"type.convertToAreaType","params":{"ids":[42]}}}
|
||||
```
|
||||
|
||||
## Insert Special, Whitespace and Break Characters
|
||||
|
||||
`type.insert {char?, text?, code?, unicode?, ids?|id?}` inserts one character (`char` names it, `code` and `unicode` give
|
||||
its code) or the string `text`. While the Type tool edits text and neither `ids` nor `id` is given, it replaces the
|
||||
tool's selection, or inserts at its caret, and the caret goes after the insertion; otherwise it appends to the end of each
|
||||
selected text object. Each call is one undo step; an empty `text` at the Type tool's caret changes nothing and records no undo step.
|
||||
`char: "forcedLineBreak"` (Type › Insert Break Character › Forced Line Break) inserts U+2028, which starts a new line in
|
||||
the same paragraph, as Shift+Enter does; `char: "paragraphReturn"` inserts a line feed, which starts a new paragraph. A
|
||||
`text` that holds U+2028 inserts the same break.
|
||||
|
||||
```json
|
||||
{"name":"run_command","arguments":{"command":"type.insert","params":{"char":"forcedLineBreak"}}}
|
||||
```
|
||||
|
||||
## Smart Punctuation
|
||||
|
||||
`type.smartPunctuation` replaces keyboard characters in the selected type, or in every text object with `scope:
|
||||
@@ -12247,7 +12289,12 @@ away); its click on a gradient mesh's line picks the line's two
|
||||
ends, and a click inside a patch picks the four points around it. The picked points show filled. Dragging one of them
|
||||
moves them all as one undo step (`object.mesh.movePoints`), a click on one of several picked points picks it alone,
|
||||
and the arrow keys nudge them by the keyboard increment. The active tool lists them in its options
|
||||
(`tool.setOption {}` returns them as `meshPoints: [{id, index}…]`). On gradient meshes a solid fill colour (`paint.setFill`, from the
|
||||
(`tool.setOption {}` returns them as `meshPoints: [{id, index}…]`). Switching to the Eyedropper keeps them picked, its
|
||||
options list them too, and the Mesh tool, Direct Selection or a Lasso chosen next picks them again. While a selected, editable mesh has
|
||||
points picked, an Eyedropper click or Shift-click on an image or other art samples the color under the pointer into
|
||||
those points alone as `paint.sampleColor {color, stroke: false, ids}` with the meshes that have points picked: one undo
|
||||
step, none when the color is unchanged. Other selected objects keep their paint. A click on one of those meshes, and
|
||||
Alt-click and Shift+Alt-click anywhere, are unchanged. On gradient meshes a solid fill colour (`paint.setFill`, from the
|
||||
Color panel, Swatches or the Eyedropper) recolours just the picked points, and when every target of
|
||||
`transparency.set` is a gradient mesh with points picked, its `opacity` fades those points instead of the objects
|
||||
(`transparency.info` then shows their opacity, `null` when it differs). Both are one undo step, and neither goes to the
|
||||
@@ -12257,6 +12304,16 @@ picked point's color, and `fillMixed` compares the picked points' colors with ea
|
||||
selected objects. The Transparency panel shows the picked points' opacity (blank when it differs), and the Control
|
||||
bar shows the first picked point's opacity.
|
||||
|
||||
A solid color dragged from the Color or Swatches panel or a Fill proxy and dropped on a selected gradient mesh, while the
|
||||
Fill proxy is active, recolors the mesh point under the pointer (within 5 screen pixels), else the four points around the
|
||||
patch there, as `object.mesh.setPointColor {id, points, color, keepModel: true}`. With a gradient mesh selected and a
|
||||
solid fill color set, a plain Eyedropper click does the same with the fill color: on a point of any selected mesh, or
|
||||
inside a patch of the selected mesh the click hits. A gradient, a pattern, a fill of None, a stroke proxy or a mesh that
|
||||
is not selected keeps the earlier behavior (the whole object takes the paint, and the Eyedropper copies the appearance),
|
||||
and so does an unselected object on top of the mesh at that place.
|
||||
See [Edit mesh objects](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=312);
|
||||
the 5-pixel reach is VectorCraft's own.
|
||||
|
||||
`object.mesh.movePoints {id, points: [index…], dx, dy}` (or `{items: [{id, points}…], dx, dy}` over several meshes)
|
||||
moves points by (dx, dy), their handles with them; `object.mesh.setPointColor` takes `points` or `items` the same
|
||||
way to colour or fade several points at once. An index out of range, an index that is not a whole number ≥ 0, or a
|
||||
|
||||
+3
-2
@@ -37,8 +37,9 @@ Window → Help Bar toggles the bottom tool-help strip independently of the stat
|
||||
**Feature evidence last updated:** 2026-11-03.
|
||||
|
||||
M1 selection: Enclosing Lasso selects whole objects enclosed by a freehand loop. It is an add-on
|
||||
under Object › Plug-ins and has its own heading in All Tools. It has no default shortcut or Basic
|
||||
toolbar slot. Shift adds and Alt subtracts enclosed objects; Escape cancels the loop.
|
||||
under Object › Plug-ins, and its tool is also in the Lasso tool's group in both shipped toolbars,
|
||||
after the Lasso. It has no default shortcut. Shift adds and Alt subtracts enclosed objects; Escape
|
||||
cancels the loop.
|
||||
This is a VectorCraft addition; milestone estimates and parity scores are unchanged.
|
||||
|
||||
The shared assessment status line and revision history are current upstream; this dated section records the submission's feature evidence and revisions without rescoring upstream or claiming a new combined build or runtime measurement.
|
||||
|
||||
File diff suppressed because one or more lines are too long
+1
-1
@@ -77,7 +77,7 @@ against Illustrator's public documentation; **estimated** unless noted.
|
||||
| CJK: warichu | done | Character panel menu › Warichu and Warichu Settings… (`text.setFormat` / `text.setRangeStyle {warichu, warichuLines, warichuGap, warichuScale, warichuAlign}`, `ui.warichuSettings`), with Show East Asian Options ([Format East Asian characters](https://helpx.adobe.com/illustrator/using/formatting-asian-characters.html)): marked characters set at a percentage of their size and stacked on 1 to 6 lines inside their line, one above the other in horizontal type and side by side in vertical type, with a line gap and eight alignments; a block stays whole on one line. Saved natively, carried by character styles, drawn on the canvas and in every export (SVG, PDF and `.ai` write such type as outlines). Type on a path sets the characters at their own size. Evidence: `tests::warichu`, `dialogs::warichu::tests`, `typecmd::area_tests::warichu_is_a_character_attribute_set_saved_and_exported` |
|
||||
| CJK: composite fonts | partial | Type › Composite Fonts… (`type.compositeFonts.set`), with Show East Asian Options: a font made of a font per class of character (Kanji, Kana, Punctuation, Symbols, Roman, Numerals), each with its own style, size and baseline in percent of the type's size, Kana, Roman and Numerals with horizontal and vertical scale, and Kana with Scale at Center; New, Delete Font, Import… and Export… (`.vccomposite`, `type.compositeFonts.import` and `.export`) ([Creating composite fonts](https://help.adobe.com/archive/en_US/illustrator/cs3/illustrator_cs3_help.pdf#page=347)); custom character sets (Custom: New, Delete Set, characters added by Direct Entry or Unicode code and deleted), each with its own font, style, size, baseline and scales, ahead of the classes, the later set winning a character two list (`custom` in `type.compositeFonts.set`) ([Customize characters in a composite font](https://web.archive.org/web/20220911143322/https://helpx.adobe.com/pdf/cs6/illustrator_reference.pdf#page=348)). Composite fonts are listed first in the font menus, saved with the document, and their type is laid out per set and class; SVG and legacy `.ai` write it as outlines. Show Sample draws the font picked with lines for its ICF box, em box, baseline, cap height, highest ascent and lowest descent, highest ascender and x-height, each shown or hidden by its button, at the Zoom picked ([Creating composite fonts](https://help.adobe.com/archive/en_US/illustrator/cs4/illustrator_cs4_help.pdf#page=352)). Not yet: the Units menu. Evidence: `text::composite::tests::characters_fall_in_their_classes`, `text::composite::tests::custom_sets_take_their_characters_before_the_classes`, `tests::composite::composite_type_draws_each_class_in_its_font`, `tests::composite::custom_character_sets_take_their_characters_first`, `compositefonts::tests`, `dialogs::composite_fonts::tests` |
|
||||
| CJK: ruby | partial | ruby (ふりがな) for live text (`type.ruby`): a reading over a byte range, above (right of the column in vertical type) or below, start/centre/end alignment, size, overhang or squeeze; saved natively, laid out with its line growing, drawn on the canvas, in SVG and PDF (as outlines where ruby is present), in EPS, EMF/WMF and legacy `.ai` (legacy `.ai` writes type with ruby as outlines), and kept by Create Outlines, Expand Appearance and flattening, each glyph where the layout puts it (`typecmd::ruby_tests::create_outlines_keeps_the_ruby_where_it_is_laid_out`) | #633 |
|
||||
| Language per character (Character panel › Language, character styles), text shaped in it | done | `text.setFormat` / `text.setRangeStyle {language}` by name or BCP 47 tag, one of Document Setup's languages (Hindi, Marathi, Gujarati, Bengali, Punjabi, Tamil, Telugu, Kannada, Malayalam, Odia and Urdu added, #4943; Assamese and Sanskrit added, #4947; Nepali, Konkani and Sindhi added, #4943; Serbian: Cyrillic, Serbian: Latin and Croatian; Bulgarian, #5945); the shaper gets the tag, so the font's language forms apply (OpenType `locl`: Turkish keeps `fi` apart and the dot on its i, #4940); new type takes the document's language; saved as the tag only when set, carried by character styles (#4946). English and eleven Indian languages hyphenate by run language; Sanskrit automatic hyphenation awaits allowlisted patterns (#4947). Not yet: `.ai`/PDF import of a text's language, paragraph styles. Evidence: `features::tests::language_picks_the_fonts_forms`, `features::tests::serbian_gets_the_fonts_serbian_forms`, `typecmd::area_tests::language_is_a_character_attribute_saved_only_when_set`, `tests::typo::indic_language_runs_hyphenate_with_both_composers`, `hyphen::tests::sanskrit_without_allowlisted_patterns_uses_only_exceptions`, `tests::docsetup::the_further_indian_languages_are_document_and_text_languages`; spelling is checked in each run's Language (`text.spelling.check`, #4936) |
|
||||
| Language per character (Character panel › Language, character styles), text shaped in it | done | `text.setFormat` / `text.setRangeStyle {language}` by name or BCP 47 tag, one of Document Setup's languages (Hindi, Marathi, Gujarati, Bengali, Punjabi, Tamil, Telugu, Kannada, Malayalam, Odia and Urdu added, #4943; Assamese and Sanskrit added, #4947; Nepali, Konkani and Sindhi added, #4943; Serbian: Cyrillic, Serbian: Latin and Croatian; Bulgarian, #5945); the shaper gets the tag, so the font's language forms apply (OpenType `locl`: Turkish keeps `fi` apart and the dot on its i, #4940); new type takes the document's language; saved as the tag only when set, carried by character styles (#4946). English, eleven Indian languages, Bulgarian, Turkish and Russian hyphenate by run language, and German, Polish, Portuguese and Italian do in builds that embed their patterns; a word outside its language's script stays whole; Sanskrit automatic hyphenation awaits allowlisted patterns (#4947). Not yet: `.ai`/PDF import of a text's language, paragraph styles. Evidence: `features::tests::language_picks_the_fonts_forms`, `features::tests::serbian_gets_the_fonts_serbian_forms`, `typecmd::area_tests::language_is_a_character_attribute_saved_only_when_set`, `tests::typo::indic_language_runs_hyphenate_with_both_composers`, `hyphen::tests::sanskrit_without_allowlisted_patterns_uses_only_exceptions`, `hyphen::tests::rule_languages_break_by_their_own_rules`, `hyphen::tests::pattern_languages_break_at_their_own_patterns`, `tests::typo::a_russian_run_hyphenates_at_russian_break_points`, `tests::docsetup::the_further_indian_languages_are_document_and_text_languages`; spelling is checked in each run's Language (`text.spelling.check`, #4936) |
|
||||
| No Break | done | Character panel menu (`text.setFormat` / `text.setRangeStyle {noBreak}`): the marked characters stay on one line, including across a space; a run that does not fit after earlier text moves together, and a run longer than the line stays together. Evidence: `layout::wrapping_tests::no_break_keeps_marked_characters_on_one_line`, `tests::no_break_keeps_marked_words_on_one_line`, `typecmd::no_break_is_a_character_attribute_saved_only_when_on` |
|
||||
| Inline symbols in text | beyond Illustrator | not scored |
|
||||
| Align Stroke (inside, outside) on live type's character stroke | beyond Illustrator | not scored; `stroke.set {align}` and `text.setRangeStyle {strokeOptions: {align}}`; saved natively, drawn around the glyphs on the canvas and in PDF, EPS and SVG (live text, stroke on the glyph outlines); visual bounds grow with it (#2294) |
|
||||
|
||||
+5
-2
@@ -31,8 +31,10 @@ Window → Help Bar toggles the bottom tool-help strip independently of the stat
|
||||
|
||||
**Feature evidence last updated:** 2026-11-03.
|
||||
|
||||
Enclosing Lasso is an add-on under Object › Plug-ins with its own heading in All Tools. It has
|
||||
no default shortcut or Basic toolbar slot. It selects whole objects only
|
||||
Enclosing Lasso is an add-on under Object › Plug-ins. Its tool is also in the Lasso tool's group
|
||||
in both shipped toolbars, after the Lasso, and All Tools lists it there, under Select. A toolbar
|
||||
edited before it joined keeps its saved layout until Reset Toolbar. It has no default shortcut;
|
||||
one can be set in Edit › Keyboard Shortcuts › Tools. It selects whole objects only
|
||||
when their geometry is fully enclosed by the freehand loop. Shift adds, Alt subtracts, and
|
||||
Escape cancels. Ordinary group members can be selected separately; compound paths stay whole.
|
||||
Path checks follow curves, excluding stroke width and effects; other objects use their geometric
|
||||
@@ -328,6 +330,7 @@ tools, never checked side by side) isn't captured row by row.
|
||||
| Cmd/Ctrl: last-used selection tool; Cmd+Alt: Group Selection inside Direct Selection | done | Cmd+Alt lends Group Selection only while Direct Selection is active (Cmd borrow from the Pen keeps Direct Selection so Alt stays copy/subtract); Cmd alone lends Direct Selection the Selection tool: its bounding box shows while Cmd is held over objects selected whole and its handles scale and rotate them, and a Cmd drag moves the whole object while its direct-selected anchors stay selected (#3901; no box over a selection with anchors picked yet); engine pointer and canvas regressions |
|
||||
| Eyedropper copies effective character dimensions between transformed text objects | done | Point/area and grouped text, highlighted ranges, reverse/remembered sampling, opt-outs and atomic invalid-transform rejection; `scaled_type_pick_*` (#6404) |
|
||||
| Eyedropper styles highlighted characters only and preserves ranges across Type switches | done | Font/paint, Shift color-only, Unicode, Undo/Redo and stale-range regression tests; enabled non-neutral source or target object transparency is refused atomically; disable Transparency to sample supported attributes |
|
||||
| Gradient mesh: a solid color dropped from the Color or Swatches panel or a Fill proxy on a selected mesh recolors the mesh point under the pointer, else the patch's four points; with the mesh selected, an Eyedropper click applies the fill color the same way | done | [Edit mesh objects](https://web.archive.org/web/20210601162814/https://helpx.adobe.com/pdf/illustrator_reference.pdf#page=312); `object.mesh.setPointColor`, one undo step, none when the color is unchanged. The 5-pixel reach for a point is VectorCraft's own. Tests `a_color_dropped_on_a_selected_mesh_recolors_the_point_or_patch_under_it`, `a_click_on_a_selected_mesh_gives_its_point_or_patch_the_fill_color`, `a_click_on_an_object_over_a_selected_mesh_copies_that_object` |
|
||||
| Eyedropper reads visible sources while their layer/object is locked or outside isolation | done | Ordinary/Shift/Shift+Alt and gradient-stop reads preserve the source and selection; Alt reverse remains editable-only; hidden art stays excluded (`eyedropper_sources.rs`, #1251) |
|
||||
| Add a visible stroke after drawing with inherited None/zero-width paint | done | Paint and Swap Fill/Stroke restore the existing 1 pt default; positive widths and painted zero widths stay as set; Undo/Redo and targeted appearance items tested (`stroke_visibility.rs`, #1253) |
|
||||
| Double-click a stroked segment to create a width point in Width Point Edit | done | Finite-arithmetic follow-up: engine regressions and full CI passed; [Validation evidence](target-app-parity.md#evidence-what-ships-today-by-area). Command and pointer regressions cover opening, sampled widths, adjoining adjustment on/off through checkbox/OK, compound paths, Cancel/Delete and Undo/Redo; dialog layout reviewed. [Validation evidence](target-app-parity.md#evidence-what-ships-today-by-area) |
|
||||
|
||||
Reference in New Issue
Block a user