Files
vectorcraft/docs/image-trace-adjustments.md
T
andeecollardandClaude Opus 5.5 17a602d1dc Image Trace: large images trace with a warning; anchor limit 8,000,000
The public documentation says Image Trace warns about images larger
than 1500 pixels on a side but traces them, only more slowly. VectorCraft
traced them silently, and refused any trace of more than 2,000,000
anchors, which a 4000 x 3000 photo at High Fidelity Photo nearly reaches
(1.9 million on a code-drawn photo) and a noisier one passes.

- imageTrace.make and makeAndExpand return `warnings`: one for an image
  over 1500 px on a side (traced, but more slowly; a lower-fidelity
  preset or a smaller copy is quicker), one for an image over 64 MP
  that was traced from a scaled-down copy. The app shows the first in
  the status bar.
- MAX_TRACE_ANCHORS is 8,000,000 natively (2,000,000 on wasm, where a
  page has at most 4 GB). Measured through imageTrace.make on
  code-drawn photos: about 90 bytes an anchor kept in the document;
  7.9 million anchors kept 685 MB with an 876 MB peak (4000 x 3000,
  Full Tone at Colors 100, Paths 100, Noise 1, 37 s).
- The refusal keeps its translated advice: raise Noise, lower Paths or
  Colors, or pick a lower-fidelity preset.

Tests: a_large_image_traces_with_a_warning (1600 x 40 and 1500 x 8
code-drawn images, make and make-and-expand),
trace_warnings_name_a_large_or_scaled_down_image, a compile-time check
of the limit's range, and a UI test that the status bar shows the note.

Source:
https://helpx.adobe.com/illustrator/using/image-trace-results-optimization.html

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018tBcdwNhptqtmX32JCGFzB
2026-10-17 19:38:18 +07:00

3.3 KiB
Raw Blame History

Adjusting an Image Trace

Select a placed raster image, then choose Image Trace or a preset from its arrow in Properties or the Control bar. The original image stays inside the tracing object so that subsequent adjustments always use the original pixels.

To adjust the result, select the tracing object and click Image Trace in Properties or the image icon in the Control bar: the Image Trace panel opens with Advanced expanded. An existing floating or docked panel is activated in its current location. Opening the controls does not add a document undo step.

Control Range Effect
Threshold (Black and White) 0–255 Higher values include lighter pixels as black ink.
Paths 0–100% Higher values fit outlines more closely to the image.
Corners 0–100% Higher values preserve more sharp turns.
Noise 1–100 px Suppresses small connected regions; higher values remove more small details.
Method Abutting / Overlapping Chooses shared boundaries or stacked overlapping paths.
Create Fills / Strokes Creates filled areas, stroked lines, or both.
Ignore Color Color picker Leaves out the selected color (white by default).

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. While dragging, the preset and Enhanced row stay in place until release so the slider retains its active interaction. Committed settings are synchronized immediately, so Undo also restores the panel values before its next frame. View can show the source image, the result, outlines, or combinations without re-tracing. Use Expand when finished to turn the result into ordinary editable vector objects; after expanding, the tracing settings are no longer available. Release restores the source.

Large images. An image of more than 1500 pixels on a side is traced as any other, only more slowly, and the trace says so: imageTrace.make returns the note in warnings and the status bar shows it (the results optimization page describes the same warning for images over 1500 px). An image of more than 64 megapixels (up to 192) is traced from a copy scaled down to 64 megapixels, and the trace says that too. A trace that would make more than 8,000,000 anchor points (2,000,000 on the web) is refused to protect memory, with advice: raise Noise, lower Paths or Colors, or pick a lower-fidelity preset. A trace keeps about 90 bytes an anchor; a 4000 × 3000 photo at High Fidelity Photo makes about 1.9 million.

These controls use VectorCraft's existing tracing algorithm. Parameter effects follow its implementation; they do not claim pixel-identical results with another application. The terminology and general control behavior are described in the public Image Trace panel documentation.

Regression coverage: crates/ui-egui/src/panels/image_trace.rs tests opening the panel, a quick trace leaving it as it was, repeated opening, floating ownership, slider commits, visible threshold changes, undo, and the Properties entry point. Tracer tests live in crates/trace/src/tests.rs.