With Smart Guides and Snap to Tangent on, an Alt+Shift drag with the
Ellipse tool snaps the circle's radius so that the circle touches a
nearby path, when the radius comes within the snapping tolerance of that
size. The touch point is where the line from the center meets a straight
segment or a curve square, inside a segment or at an anchor where the
path runs smoothly, including an anchor where a curve's handle lies on
the anchor. A circle can touch another circle from outside or from
inside. Corners, open path ends and curves around the same center are
not offered.
The touch point shows the "tangent" label, the radius is measured along
the Constrain Angle's axes, and Space moves the circle at the size it
snapped to, which it keeps when Space is let go. When an anchor, center or crossing is near the pointer, or
the dragged corner snapped onto one, the circle is not resized. An
ellipse without Shift is not snapped. Snap to Grid and pixel snapping
place the point instead, also when turned on during the drag, and
turning Snap to Tangent off during the drag stops the snap. A press
with a small jitter is still a click rather than a drag. Each pointer move
measures at most 256 segments near that radius.
object.cropImage with ppi draws a turned or skewed image at that ppi
even when it is the image's own, instead of at the lower density of the
box around it, and a ppi over that whole box makes the new image too.
The raster size limit applies only when the crop is drawn or resampled,
so a straight cut at the image's own ppi is not refused.
The Crop Image tool's Apply sends a turned image's own resolution when
no other is set and it is within 1 to 2400 ppi, and crops over the
whole box when a resolution is chosen.
Each piece of a long drag's line also held the first segment of the next
piece, so that segment was drawn twice, once by each piece. Where the
line is thin or partly covered at its edges, the doubled coverage drew a
darker stretch every 64 segments. A piece now ends halfway along the
segment after its last point, and the next piece starts there, so a wide
line still turns at the piece's last point as one line does.
With Smart Guides and Snap to Tangent on, a Line Segment drag pressed
anywhere on a convex closed path with curves and dragged to within the
snapping tolerance of another such path lands on a common tangent of the
two. Both ends move to where the line touches the paths, the start sliding
along the first path. The line is the tangent whose touch point on the
second path is nearest the pointer, so moving the pointer around that path
switches between the outer tangent and the one crossing between the paths.
Each end shows the "tangent" label when Anchor/Path Labels is on, and the
line is drawn as a guide when Alignment Guides is on.
Before this change the start of a Line Segment drag always stayed where it
was pressed. It still does when Shift, Alt or Space is held, when an
anchor, center or crossing lies nearer the pointer than the second path,
when the press snapped to an anchor, center or crossing off the first path,
when Snap to Tangent is off, when Snap to Grid or pixel snapping places
drawn points, or when either path bends inward somewhere or has more than
512 segments.
The tangents come from the Common Tangents geometry. Each pointer move
looks at the 16 nearest closed subpaths within the snapping tolerance and
keeps the tangents of up to 64 pairs for the rest of the drag.
The line that a round Eraser, the Knife, the Path Eraser, the Pencil with
Live preview off or a smoothing drag shows was one path of every point,
copied, flattened and tessellated again each frame, and with the
Eraser's Size following the pen each step was a new path each frame.
- A drag of more than 64 segments now shows in pieces of 64 segments,
each also holding the next piece's first segment so wide lines join
as one. Pieces the drag has passed come back as the same shared path,
and the canvas reuses their triangles while the view stays the same;
only the last piece is built again, and only when it changed.
- With Size following the pen, each step is kept as its own shared path
and only a new or moved step is built.
- The Knife's pieces carry where the dash pattern starts, so the dashes
run on across pieces (Overlay::SharedPath gains `dash`).
- The smoothing band is shared until it changes.
The canvas still copies the kept triangles into each frame. Release
commands (path.eraseRegion, path.knife, path.eraseSegments,
path.freehand) are unchanged.
- Resampling at a resolution asked for weights colors by alpha in 16 bits a
channel, so a pixel with alpha 1 keeps its color instead of turning black.
- A box between pixels is drawn with the image stretched so the box fills
the whole pixels drawn; nothing past the box is squeezed into it.
- A linked W or H below a point raises both sides together, keeping the
box's proportions.
- Apply no longer clears the box and the resolution; leaving the tool does,
so a crop that fails keeps them for another try.
A click with the Ellipse tool opens a dialog with a new Anchors field
under Height, 4 by default. With 4, OK draws the same live ellipse as
before. Any other count from 2 to 1000 draws a closed plain path with
that many smooth anchors spaced evenly by angle, from the left one and
clockwise, with handles of 4/3*tan(theta/4) scaled along each axis and
the path fitted to the typed width and height. The dialog sends the
nearest whole number from 2 to 1000 (4 for an empty field or text that
is not a number). The count confirmed last is kept as the Ellipse
tool's anchors option, and the next Ellipse dialog opens on it.
shape.ellipse takes an optional anchors param (default 4). A number
that is not a whole number from 2 to 1000 gets one error naming that
range, a value that is not a number gets the usual type error, and
nothing is drawn. The MCP draw_shape tool lists anchors for ellipses.
Docs: params text, docs/mcp.md, docs/target-app-parity.md (Shapes).
With Alt held at the press, an Eraser drag draws a marquee from the press
point to the pointer instead of a stroke, and the release erases everything
inside it. Alt+Shift keeps the marquee square on its larger side, Escape
cancels it, and a click or a drag along one axis erases nothing.
path.eraseRegion takes {rect: [x, y, width, height]} in place of points.
Closed paths lose the rectangle's area; open paths are cut where they cross
its edges, found from the exact crossings, so a narrow rectangle across a
long segment still cuts it. A width or height of 0 or less, a non-finite
value, or points and rect together is an error, and nothing erased adds no
undo step.
Docs: docs/mcp.md, docs/ui-parity.md.
A step took the tip halfway between the tips at its ends, turned the
shorter way round. The release reads the pen's pressure and tilt halfway
along the step, and its bearing and rotation halfway the shorter way
round, so a step from no pressure to full pressure with the angle on
Pressure by 90° erases with a level tip there while the outline showed
it upright. Each step now takes the tip of the pen's readings halfway
along it.
A plain drag of the annotator's end handle now slides the end along the
bar's line, at least 10 px from the start, and snaps only to targets on
that line. Alt-drag moves the end freely, changing the length and angle
together, with Shift at Constrain Angle steps. A vector of no length
still moves freely.
Docs: docs/mcp.md, docs/ui-parity.md.
Hovering with the Trim at Crossings Tool draws in red the stretch a click
there would remove, on the same paths and by the same rules as the click,
and nothing over empty canvas or hidden and locked paths. A drag draws
every stretch its rectangle or freehand line would remove while it
reaches at most 32 paths. In isolation mode only paths inside the
isolated object are highlighted.
What a pick removes moves from the command into
vectorcraft_tools::addons::trim::plan, which the command and the tool
both use. A preview spends at most a twentieth of the crossing work a
click may (Work::share); past that it shows nothing, and the click or
release still removes what it reaches. The tool keeps the crossings it
found for the document as it is, so moving along one path does not
search again, and kept crossings still count against a pick's work
budget. Work::spent_since and Work::draw in vectorcraft-pathops measure
and charge that work.
Docs: docs/mcp.md, docs/ui-parity.md, docs/target-app-parity.md.
The release reads the bearing of the first point the pen leaned 1° or
more at for the points before it, while the outline kept the set value
there. The outline now takes that bearing too, and starts again when the
first lean arrives, also when a pen tilted in place at the last point
gives it.
With Shift held, an Eraser drag stays on the line from the press point at
the 45 degree step from the Constrain Angle that the pointer lies nearest
to. The step is taken once the pointer is 3 screen pixels from the press
and holds 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.
Once the pen pressed less than fully, the steps of the outline already
built kept the tip of a stroke without pressure, while the release reads
full pressure at those points. The outline now starts again when the
pressure first counts.
A Tilt, Bearing or Rotation mode set during the drag gave the early
points the pose of later ones. The release reads no poses for such a
stroke, so the outline now keeps the set values for them too, and the
same for a Pressure mode set during the drag.
The outline of the area an Eraser drag covers used the set Angle and
Roundness and varied the Size only with Pressure, while the release
(since #7726) erases with the tip the pen gives at each point on the
Pressure, Tilt, Bearing and Rotation modes.
Each step now takes the tip halfway between those at its ends, read as
the release reads the stroke. A step whose angle or roundness varies is
outlined where its own tip is round, and the parts inside other steps'
areas are removed as before. A pen turned in place gives the last step
the new tip, and a changed mode or Variation starts the outline again.
A round tip whose Size follows the pen shows each step that wide.
Random shows the value itself until the release draws it.
`through` now takes only the ids of the group's edges, each once: a face's
id, an unknown id, another group's edge or an edge given twice is an error
and changes nothing. A hidden edge in it is still skipped by the join. For
a double-click the Bucket passes only edges of the group, each once, so an
earlier click that filled a face whose fill was the edge's stroke paint
(Paint Fills and Paint Strokes both on) no longer sends that face.
The Bucket finds the faces a fill drag crossed among those whose bounds
meet the drag's bounds only.
A canvas test covers the middle-button press and the Space-held press
between two Bucket clicks. The progress-doc line lists the new tests, and
docs/mcp.md says which edges the tool passes in `through`.
Follows #7875.
While Crop Image shows its box, the Control bar has a PPI list (72, 96,
150, 200 and 300 ppi, with the ones above the image's own disabled) and a
PPI field, a reference point that X and Y name and that W and H resize
about, and a link icon that keeps W and H in proportion. A linked size
that would not fit the image is reduced with the other side in proportion.
object.cropImage takes ppi: the cut pixels are resampled to it, with colors
weighted by their alpha, and the image keeps the box's size. A box over
the whole image with a new ppi only resamples it, and an image scaled
differently across and down comes out with square pixels. ppi is refused
outside 1 to 2400, above the image's own resolution (300 ppi for a linked
image), and with trim. tool.setOption sets ppi, reference and linked for
the Crop Image tool and refuses values it can't use.
Docs: docs/mcp.md, docs/target-app-parity.md.
When a click's press lands in one face and its release in the next, the
drag fills both. The bucket now notes the fill every face the drag
crosses had before the press, the release included, so a double-click
or triple-click that follows on such a face compares that fill instead
of the one the first click gave it. This also holds when the release of
the last click crosses into the clicked face.
When the first click makes the Live Paint group, or merges the selection
into a selected group, the crossed face counts with the fill it was made
with: a kept face's paint from the merged group (an unplaced gradient
fixed to its fit), else the fill Make gives it, the topmost fill that
draws of the front-most source path over it that has one. A selected
group's edges no longer count as source paths.
A double-click whose two clicks land on two joined edges now paints the
edges joined through the other edge its clicks painted:
livePaint.strokeEdge takes `through`, edge ids that the join counts as
drawing with `match`, and the tool passes that edge. When the second
press lands on the next edge and is released back on the first, the
double-click matches the first edge's stroke paint from before the
first click.
A press that the view tools take (held Space, the middle button), or
that holds Cmd/Ctrl and goes to the lent selection tool, now counts as
a press that paints nothing, so the clicks around it are not taken for
one triple-click's: the session tells the tool through the new
Tool::press_elsewhere.
The tool doc, docs/mcp.md and the progress-doc line now say that a click
records an undo step only when it changes a paint, and that a
triple-click paints the faces that have the clicked face's fill (and the
edges that draw with the clicked edge's stroke paint) with the bucket's
paint.
Follows #7291.
A Shift-triple-click on a face whose double-click already reached a
joined face of the same fill selects every face with that fill. The new
test pins that the joined face the double-click toggled on is not
toggled off again by the triple-click.
While the Smooth tool is in use with a path it can smooth selected, the
bar shows the tool's Fidelity field and Tool Options..., which opens the
Smooth tool's options. The field sets Fidelity through tool.setOption
with the same range, unit and steps as the field in the options dialog.
With nothing smoothable selected, the tool shows no bar. The bar leaves
out the selection tools' actions and the Fill, Stroke, Recolor Artwork
and Lock controls. On a canvas too narrow for the field, More Options
lists Fidelity, which opens the tool's options.
The Smooth tool's cursor and the bar share one check of the selection,
which the bar keeps for the document's revision.
While the center is dragged out, Ctrl (Command on macOS) keeps the
center's diameter as the last drag showed it, and the drag sizes the
halo through shape.flare's growth: the halo's radius keeps the ratio to
the pointer's distance that it had when the key went down, within the
Flare Tool Options' 0 to 300 %. Letting the key go sizes the center with
the drag again, and the flare keeps the new growth.
While the rings' end point is placed, Up and Down Arrow add and remove
rings within 0 to 50, and leave the rays as the center drag left them.
Before, they changed the rays in both drags. Each press of ~ (backquote)
sends a new ringSeed. shape.flare takes ringSeed, a whole number below
2^53, and places the rings along the path from a sequence of its own,
keeping their count and sizes and the other parts. seed and ringSeed
given as a fraction, a negative number or a boolean are refused. The
canvas re-hovers the tool when backquote goes down or up, so ~ works with
the pointer held still.
With Rings off, the arrows and ~ do not change the flare in the second
step. Each new flare starts from the options' counts and growth, without
a ringSeed.
While the Selection, Direct Selection or Group Selection tool moves the
selection, or the Gradient tool draws a vector, W and H show the change
in x and y, with the distance and the angle under them. A Scale tool
drag shows its percentages; a Rotate, Reflect or Shear tool drag shows
the center of the selection's box and its angles. The Zoom tool adds the
magnification and the Paintbrush the name of its brush.
W and H follow Use Preview Bounds. With several objects selected, the
panel shows only the fill, stroke and type values they share, and Show
Options adds a tint's swatch and percentage and a gradient's swatch name.
- Tool::readout and Readout (crates/tools/src/readout.rs).
- info.readout returns the selection's size and the tool's readout.
- Docs: docs/mcp.md, docs/ui-parity.md.
- perspective.grid.set rejects an offset that puts a plane behind the
viewer even while Automatic Plane Positioning holds that plane, so the
plane does not vanish when positioning ends.
- The gridline intersection nearest the pointer is found on strongly
skewed planes: each drawn line is searched at the point nearest the
pointer on the page, instead of a few cells around the pointer's
inverse.
- Moves while an artboard name is pressed no longer reach the tool as
hover, so Shift does not position the plane while the button is down.
A subpath's anchors are now an `Anchors` list held in chunks of up to
256 anchors behind `Arc`s. Copying a path copies the chunk table and
shares the chunks, and editing one anchor copies only the chunk that
holds it, so the undo step of a one-anchor edit no longer keeps a copy
of every anchor of the path. Inserting or removing an anchor copies the
chunk it is in and rebuilds the table. Reads and edits follow the Vec
and slice methods the code used; files write and read each subpath's
anchors as one list, as before, within the same anchor read budget.
The undo memory estimate counts only the chunks the other version of
the path does not hold, and the renderer's kept paths compare only the
chunks an edit copied when they look for moved anchors.
Moving one anchor of an open path of 10,000 or 200,000 anchors
(path.moveAnchor, path.setHandle, path.moveAnchors, a nudge) keeps at
most 48 KiB in its undo and redo steps, where it kept 56 bytes per
anchor.
A triple-click with the Live Paint Selection tool on a face now selects
every face of its group with that face's fill, and on an edge every edge
of its group that draws with that edge's stroke paint. Hidden faces and
edges are left out. Before, a triple-click selected only what its third
click selected.
With Shift held, the parts are toggled from the selection there was
before the clicks: the tool keeps what the double-click and the Shift
clicks of the series toggled, and the triple-click toggles those back.
docs/target-app-parity.md's Live Paint Selection line says so.