Files
craft-libs/crates/layers/README.md
T
aiongg 6eef0ae74c craft-layers: the nine filter types and Find Layers
The filter bar offers Photoshop's types: Kind, Name, Effect, Mode, Attribute,
Color, Smart Object, Artboard and Group. LayerInfo carries what the generic rule
reads (effect kinds, Advanced Blending, smart object source); LayerTree::listed
lets the app answer what only it knows (missing linked files, empty layers) and
defaults to LayerFilter::lists, which walks the tree for Group and Artboard.
Artboard and Group keep each group open or closed; the Mode list leaves out
Pass Through. LayersPanel::focus_filter_name switches the bar to Name and puts
the caret in its field with the text selected.
2026-11-12 14:32:51 +00:00

2.0 KiB

craft-layers

The Layers panel for Craft apps. The app implements LayerTree, a read-only view of its layers; LayersPanel shows it and reports what the user did as events in the order they happened. The app applies them with its own commands and undo.

Module (craft_layers::ui::…) What it gives the app
tree LayerTree, the one trait an app implements: children and parent, one LayerInfo per row (name, kind, visibility, label colour, locks, clipping, link, blend label, masks, effects, smart object source, warning), the selection and target, sub-rows, the active layer's properties, the blend modes (Entry<String> lists), the footer's state and the drop rules.
panel LayersPanel: the filter bar, the blend and opacity row, the lock and fill row, the rows, the footer; one focus stop, keyboard, rename in place (double-click on the name, F2 or start_rename), drag and drop, AccessKit. LayersEvents out; panel_menu and run_command for the panel menu; LayersPanel::style(&UiTokens) gives the look.
rows BlendRows: Blend mode, Opacity, Lock and Fill as one block, usable alone (a Properties panel).
filter LayerFilter and LayerFilterBar: filter by kind, name, effect, blend mode, attribute, label colour, smart object, artboard or group; the matching rule is plain code, and LayerTree::listed lets the app answer what only it knows (missing linked files, empty layers).
options LayersSettings (the persisted section), LayersOptions and LayersOptionsDialog (Layers Panel Options: thumbnail size and contents, the five switches).
thumbs LayerThumb, LayerThumbKind, ThumbContents: the key the panel gives craft_ui::primitives::textures::Thumbnails for each thumbnail of a row; the app implements ThumbSource for it.

Its words are the words! structs of the parts: LayersPanelWords, BlendRowsWords, LayerFilterWords and LayersOptionsWords.

The crate is UI-only: egui and craft-ui are plain dependencies, and screen-testing is its only feature.