Docs: painted live effects state what hit tests and Pathfinder use

This commit is contained in:
dotCooCoo
2026-11-08 15:43:58 -08:00
parent 870f633e62
commit 3a56f51cf3
+6 -3
View File
@@ -485,9 +485,12 @@ is a piece drawn by itself, in the order returned, with paints of its own:
- An effect on a fill (`_context.item` `{"fill": i}`) returns only `fills`, which replace that fill on each piece; an
effect on a stroke returns only `strokes`. The object's other fills and strokes stay where they are.
- The effects after it in the stack apply to the pieces together, the reference box being the bounds of all of them.
Bounds, hit tests, raster effects, Pathfinder effects, compound shapes and Envelope Options › Distort Appearance use
the pieces as they are drawn. For an effect on a fill or stroke, Pathfinder effects and compound shapes use the
object's path, as they do for every other effect on a fill or stroke. A 3D effect later in the stack uses the
Bounds, raster effects, Pathfinder effects, compound shapes and Envelope Options › Distort Appearance use the pieces
as they are drawn. Outside outline mode, an image is also hit where the pieces of its own fills and strokes paint; a
path or compound path is hit-tested on its source path and appearance. On an object with no geometry effect of its
own, Pathfinder effects and compound shapes use the object's path for an effect on a fill or stroke, as they do for
every other effect on a fill or stroke; on an object that has one, they also use the pieces of a painted effect on a
fill or stroke. A 3D effect later in the stack uses the
object's input path when the pieces name a swatch or pattern. Each piece counts against the budget of the
object's geometry effects as well as its anchors, so all the painted effects in a stack make at most 100,000 pieces
together; a run whose pieces would pass the budget draws its input as it was.