Brushes: Options of Selected Object keeps the mode each path draws with when a value changes

A path without modes of its own takes them from its values, so a changed calligraphic variation or scatter range could change the mode the dialog showed (a Random size became Fixed when its two ends met). brush.objectOptions now keeps each path's drawn mode for every item params does not set, and still sets the modes params give.

The params text also says which way the calligraphic angle and the scatter rotation turn, as every_turn_param_says_which_way_it_turns requires.
This commit is contained in:
dotCooCoo
2026-11-15 13:18:05 -08:00
parent 9226a0bf74
commit 628bd5229c
5 changed files with 117 additions and 4 deletions
+6 -3
View File
@@ -3419,14 +3419,17 @@ already walks Image Trace. Short agent entry points:
`brush.objectOptions {ids?, params?, reset?}` (the Brushes panel menu's Options of Selected Object…, from the
[Modify brushes](https://helpx.adobe.com/illustrator/desktop/paint-and-fill/apply-and-edit-strokes/modify-brushes.html)
page) changes the brush settings of the selected brushed paths on those paths only; the brush and its other strokes
keep their settings. The fields a path can set are VectorCraft's own choice: calligraphic `angle`, `roundness`,
`size`, `variation` and `modes`; scatter `size`, `spacing`, `scatter`, `rotation`, `modes`,
keep their settings. The fields a path can set are VectorCraft's own choice: calligraphic `angle` (counter-clockwise from
level), `roundness`, `size`, `variation` and `modes`; scatter `size`, `spacing`, `scatter`, `rotation`
(counter-clockwise), `modes`,
`rotation_relative_to_path` and `colorization`; art `width`, `width_mode`, `width_max`, `flip_along`, `flip_across`,
`overlap` and `colorization`; pattern `scale`, `spacing`, `fit`, `flip_along`, `flip_across` and `colorization`.
Values outside their ranges are clamped as in `brush.options`, a `colorization` object changes only the fields it
gives, a `null` item of an array (`size: [40, null]`) keeps each path's own item, else the brush's, and a setting
equal to the brush's own value is dropped. The dialog sends only the items and fields changed in it, so editing one
end of a range leaves each selected path's other end as it was. `reset: true` clears a path's settings. The command
end of a range leaves each selected path's other end as it was. A mode that `params` does not set (no `modes`, or
a `null` item) stays the one each path draws with, so a changed calligraphic variation or scatter range does not
change it. `reset: true` clears a path's settings. The command
refuses `params` together with `reset`, a selection with no brushed path, paths whose brushes are of different
types, a bristle brush and a field the type does not take. It records one undo step, and none when nothing changes.
`brush.options` edits still reach the settings a path does not set, `brush.apply`, a brush change in