Files
craft-libs/crates/draw
aiongg 613b6a82c1 Story canvas: stories draw their old content through StoryPicture
StoryPicture is a story picture whose pixels are a function of the document point, and StoryShape
fills and outlines shapes on it; show_quad takes any picture. The stories show what the old gallery
drew under their control again:
- CropOverlay: the crop tool's landscape under ratio_held, straighten_armed (horizon at 6 degrees)
  and image_mode.
- GradientOverlay: the gradient itself in 64 x 40 cells, on the old line with the old four stops.
- HoverOutline: the light picture with the hovered object in the accent.
- ConnectorHandles, CornerWidgets, RulerOverlay, TransformOverlay: the boxes, rounded shapes,
  measured object and transformed layer in the accent.
- TransformBox and PerspectiveCropQuad: the layer and page with their dark grey edge.
- ColorSamplerMarks: the hue and brightness picture the samplers sit on.
- WideAngleWorkspace and ConstraintLines: the generated picture in place of flat grey.
SmartGuides, RasterDisplay and PixelGrid stories draw their pictures through StoryPicture;
FlatPicture is gone.
2026-11-12 14:32:39 +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.