labwc/docs
stormshadow ba5a0b9829 feat: implement Openbox-style bottom window handle and grips
Add full handle/grip assembly to the bottom of SSD window frames,
following the Openbox themerc specification for geometry and theming.
Theme parsing:
- Parse window.handle.width (handle bar height, default 6)
- Parse window.grip.width (corner grip width, default 20)
- Parse window.[active|inactive].handle.bg with Solid/Gradient support
- Parse window.[active|inactive].grip.bg (inherits from handle if unset)
- Pre-render 1px-wide fill buffers and cairo patterns for handle/grip
Scene graph (new ssd-handle.c):
- Handle assembly replaces bottom border when active, with its own
  left/right/top borders and three-segment bottom border
- Grips at left/right corners for diagonal resize (sw/se-resize)
- Center handle for vertical resize (s-resize)
- Vertical separator lines between grips and handle using border color
- Per Openbox spec, handle_width is content-only height with borders
  drawn around it (total assembly height = 2*border_width + handle_width)
Interactive visual states (grips only):
- Hover: 20% black overlay on grip content area
- Pressed: 40% black overlay with 1px inset shadow (dark top/left,
  light bottom/right) for a pushed-in 3D effect
- Dragging: 20% overlay with inset shadow maintained
- Global hover tracking (server.hovered_handle_ssd/element) ensures
  proper cleanup when cursor moves across views or to desktop
Decoration toggle cycle (ToggleDecorations action):
- New LAB_SSD_MODE_BORDER_HANDLE between BORDER and FULL
- keepBorder=true: full -> border+handle -> border -> none -> full
- keepBorder=false: full -> none -> full (unchanged)
Node types and input:
- New LAB_NODE_HANDLE, LAB_NODE_GRIP_LEFT, LAB_NODE_GRIP_RIGHT
- Integrated into LAB_NODE_BORDER/BORDER_BOTTOM containment so
  existing Border context mousebinds (Resize) work automatically
- Handle/grip descriptors resolved directly in get_cursor_context()
  bypassing ssd_get_resizing_type() for precise cursor shapes
Visibility rules:
- Hidden when maximized, shaded, or handle_width is 0
- Hidden in LAB_SSD_MODE_BORDER and LAB_SSD_MODE_NONE states
- Bottom border in ssd-border.c disabled when handle is active
Documentation:
- labwc-theme.5.scd: document all handle/grip theme properties
- labwc-actions.5.scd: update ToggleDecorations to 4-state cycle
- docs/themerc: add handle/grip default values
2026-05-16 21:00:50 +05:30
..
autostart docs: document labwc-session.target integration 2026-04-27 20:57:36 +01:00
environment docs: add example for GTK4 composing 2025-12-23 20:11:33 +00:00
labnag.1.scd labnag: add details border color and margin options 2026-04-28 20:47:21 +01:00
labwc-actions.5.scd feat: implement Openbox-style bottom window handle and grips 2026-05-16 21:00:50 +05:30
labwc-config.5.scd Fix typo in labwc-config.5.scd 2026-05-09 13:09:29 +01:00
labwc-menu.5.scd menu: implement menu accelerators 2026-05-05 19:16:59 +01:00
labwc-theme.5.scd feat: implement Openbox-style bottom window handle and grips 2026-05-16 21:00:50 +05:30
labwc.1.scd window-title: rewording, renaming, lint fixes 2026-05-16 14:36:51 +01:00
menu.xml docs/: remove XML declarations in .xml files 2025-10-21 12:30:32 +09:00
meson.build Add labnag 2025-08-09 10:44:03 +01:00
rc.xml docs/rc.xml: populate <theme><name> to avoid empty string 2025-12-07 14:54:19 +09:00
rc.xml.all Document the new HDR option 2026-05-07 15:21:34 +02:00
README xwayland: support xinitrc scripts to configure server on launch (#1963) 2024-07-20 09:40:11 +01:00
shutdown docs: document labwc-session.target integration 2026-04-27 20:57:36 +01:00
themerc feat: implement Openbox-style bottom window handle and grips 2026-05-16 21:00:50 +05:30
xinitrc xwayland: support xinitrc scripts to configure server on launch (#1963) 2024-07-20 09:40:11 +01:00

Config layout for ~/.config/labwc/
- autostart
- environment
- menu.xml
- rc.xml
- shutdown
- themerc-override
- xinitrc

See `man labwc-config and `man labwc-theme` for further details.