From 3a56f51cf3ff2e0437a157f4be06c1422547ee25 Mon Sep 17 00:00:00 2001 From: dotCooCoo Date: Sun, 8 Nov 2026 15:43:58 -0800 Subject: [PATCH] Docs: painted live effects state what hit tests and Pathfinder use --- docs/plugins.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/plugins.md b/docs/plugins.md index 0b84799e8..873ccd3cc 100644 --- a/docs/plugins.md +++ b/docs/plugins.md @@ -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.