mirror of
https://github.com/storytold/craft-libs.git
synced 2026-11-15 06:52:23 +00:00
6026ad570f
* Share shape gallery choices and procedural previews * Clip shape previews to their supplied rectangles * Discard texture updates explicitly in headless rendering tests * Honor fill colors across complete star and heart contours * Make heart contour collection type explicit * Use fixed-size triangle chunks in fill regression --------- Co-authored-by: Fluorine <joseph.anglada92@gmail.com> Co-authored-by: Joseph Anglada Muñiz <janglada@nd-soft.com>
36 lines
2.2 KiB
Markdown
36 lines
2.2 KiB
Markdown
# Shared Insert Shapes choices and previews
|
|
|
|
`craft_ui::shapes` shares the shape/connector menu and original procedural previews contributed in
|
|
[WordCraft #2142](https://github.com/storytold/wordcraft/pull/2142). It provides semantic preset
|
|
identities, default ordering, connector/arrow classification, capability filtering and a menu built
|
|
on the existing accessible `IconButton`. This is reusable menu logic as well as painting.
|
|
|
|
The overlap is concrete: GridCraft's [Insert ribbon](https://github.com/storytold/gridcraft/blob/b8771d51fb4da60bd48c13cf313d6d6014dc5e66/crates/ui-egui/src/ribbon.rs#L1534)
|
|
offers rectangle, rounded rectangle, ellipse, triangle, line, arrow and text box. WordCraft also
|
|
offers diamond, star, heart and connectors. Each host must filter by what its engine supports;
|
|
a preview does not imply import/export or rendering support in that app.
|
|
|
|
```rust
|
|
let chosen = craft_ui::shapes::menu(ui, 220.0, font, &button_style,
|
|
|preset| supported_by_this_app(preset),
|
|
|preset| localize(preset.source_label()),
|
|
);
|
|
if let Some(preset) = chosen {
|
|
// Adapt the semantic choice to this app's insertion operation.
|
|
}
|
|
```
|
|
|
|
`ShapePreset::key()` is a stable choice key, not a universal command payload.
|
|
The enum is non-exhaustive: capability adapters should reject unknown future presets by default.
|
|
WordCraft maps `StraightArrowConnector` to `kind: "straightConnector", arrow: "end"`; GridCraft
|
|
must hide it until its own engine supports attachment/routing. An ordinary `Arrow` remains a
|
|
different semantic choice. The library does not silently substitute unsupported objects.
|
|
|
|
Apps own localization, theme, popup lifetime, current document, insertion coordinates, undo and
|
|
selection. Additional actions such as New Drawing Canvas remain app-specific menu entries.
|
|
`paint_preset` is also available for app-owned gallery layouts. The previews use original path
|
|
geometry and no external assets. They are UI icons, not editable document geometry or a shape
|
|
rendering engine. Star and heart contours honor `fill` across their full area, including with no
|
|
outline; their fixed concave paths use triangle fans around verified interior centers.
|
|
Consumer adoption and command adapters are separate work.
|