Files
craft-libs/crates/draw
aiongg 2b5de84828 Design lint: layer the env values, route egui access through the adapter, derive setters, token and relation checks in tests
The gate's design-lint test finds nothing. Env value types (pane edge, column align, row pressed, in-bar), band fill and span live in the layer that uses them; the cursor image and inside label are read back by the higher layer. Hand setters become derived props, tests assert relations, and the remaining sites are listed exceptions with reasons. The shortcut chord chip's sample is built only for screen tests.
2026-11-14 05:05:04 +00:00
..

craft-draw

Vector and shape tools for Craft apps. With the ui feature, craft_draw::ui has the pen, crop and free transform overlays (below), the gradient tools (GradientEditor, GradientPalette, GradientSwatch, GradientRamp, the stop rules in gradient::stops, the on-canvas GradientOverlay with its gradient_line geometry, and the GradientMapEditor) and these tools and panels, each in its own module with its labels:

  • stroke: StrokeEditor, StrokeButton and StrokePreview over StrokeStyle; corner: CornerWidgets for corner radii;
  • shape and shape_drag: ShapePanel, ShapeBar, ShapeDragTool and CreateShapeDialog; slice: SliceTool, SliceOverlay, SliceBar and the Slice Options and Divide Slices dialogs; artboard and add_beside: ArtboardTool, ArtboardBar, ArtboardProperties and the add-beside buttons; connector: ConnectorTool, ConnectorOverlay and ConnectorBar;
  • pattern and picture_fill: PatternFillEditor, PatternFillDialog and PictureFillEditor;
  • transform: TransformSession with TransformOverlay, TransformBar and the Transform menu words; crop: CropTool, CropSession and CropBar beside the CropFrame; measure: RulerTool, RulerBar and box_distances; symmetry: Symmetry with SymmetryOverlay, SymmetryMenu and SymmetryTransform;
  • brush_presets and brush_settings: BrushPresetPicker, BrushPresetChip and BrushSettingsPanel (its answer is BrushSettingsPanelOutput).

The main types of every module are re-exported at craft_draw::ui.

The gradient editor uses the colour picker and wells of craft-color.

ui::pen, ui::crop and ui::transform hold the canvas overlays of the Pen, Crop and Free Transform tools. They sense through craft_ui::canvas (CanvasView, Claim, PartFocus, quad):

TransformBox draws Free Transform's box over the guides (a bare 1 pt line, 8 square handles, the reference point) and runs its gestures through quad::drag (PhotoCraft's rules by default; BoxRules, RotateZone and inside_moves set DesignCraft's, VectorCraft's or a Move tool's): the nearest handle within 12 pt, drags reported as edit gestures, a click outside or a double-click inside or Enter applies, Esc undoes a drag and then discards the box, the arrows move the picked part, an optional readout shows the angle, scale or move; one Tab stop whose Page keys pick the whole box, a corner, an edge or the reference point, each an AccessKit object named by the host's TransformNames. A host that runs its own input calls hit, press, track and release (canvas points, modifiers, the view; BoxPress is the state it keeps between press and release) and gets the box show would give; paint_pivot draws the reference point for a host that shows one outside the box. BezierOverlay draws paths (EditPath: subpaths of Knots, each an anchor with in and out handles; PathSelection is the host's) with their anchors and direction handles and edits them as Direct Selection (select, ⇧ toggle, ⌥ subpath, drag anchors, handles and segments, a marquee on empty canvas) or Convert Point does, reporting PathEdits for the host to apply; one Tab stop whose Page keys pick anchors and their handles, arrows move them, Insert and Delete report anchors to add and remove; above MAX_ANCHORS anchors it draws outlines only. PenDraft draws the path being drawn with the Pen and runs its gestures (click for a corner anchor, drag for symmetric handles, ⇧ at 45°, ⌥ breaks the pair, a press on the last anchor retracts its handle, a press on the first closes the path, a press on an open path's end resumes it) and keys (Enter and Esc end the path and keep it, Backspace and PenDraft::remove_last take back the last anchor), reporting the whole draft as an EditSubpath edit gesture; it is not a Tab stop and its anchors are AccessKit objects named by the host's PenNames.