Tanda de funciones de tiling WM, toda pura (mirada-layout/brain), sin tocar el protocolo: - nmaster: LayoutParams.master_count — cuántas ventanas van en el área maestra. MasterStack y CenteredMaster apilan N maestras; sin pila, las maestras llenan la pantalla. Acciones inc-master/dec-master (Super+, Super+.), acotadas 1..9. - Promover a maestra: Workspace::promote_focused lleva la ventana enfocada al puesto 0. Acción promote-to-master (Super+Return). - Smart gaps: una sola ventana se tesela a sangre, sin margen. combo_string del compositor canoniza ahora teclas con nombre (Return, Tab, F5, flechas…) vía xkb::keysym_get_name, no sólo caracteres imprimibles — sin eso Super+Return no sería un atajo expresable. Cableado en keymap por defecto, HUD de mirada y mirada-ctl. Verificado end-to-end con headless-ctl. mirada-layout 26->30, mirada-brain 39->41. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
4.0 KiB
mirada-compositor — el Cuerpo de carmen
Un compositor Wayland teselante real, sobre smithay. Es el Cuerpo
de la arquitectura Cerebro↔Cuerpo de mirada (ver
crates/modules/mirada/SDD.md): habla el protocolo Wayland con los
clientes, compone sus superficies y aplica la geometría que decide el
Cerebro.
Backend winit: corre anidado — una ventana dentro de tu sesión
gráfica actual, X11 o Wayland. No toca DRM/KMS, así que es seguro de
arrancar sin dejar la sesión.
Requisitos
Hace falta una sesión gráfica anfitriona (X11 o Wayland) donde
dibujar la ventana del compositor — es donde winit se anida. En un
servidor headless (SSH a una caja sin escritorio, XDG_SESSION_TYPE=tty,
sin /dev/dri) no hay dónde mostrar nada y el arranque aborta con un
mensaje que lo explica.
Para verlo en una caja headless: levanta un servidor X virtual y conéctate por VNC.
Xvfb :99 -screen 0 1280x800x24 &
x11vnc -display :99 -localhost -nopw & # luego túnel SSH al :5900
DISPLAY=:99 cargo run -p mirada-compositor
El backend nativo DRM/KMS —que pintaría directo en la pantalla sin
sesión anfitriona— está pendiente (ver el SDD), y de todos modos
necesitaría un /dev/dri.
Dos modos
-
Autónomo (por defecto) — lleva un
Desktop(demirada-brain) embebido. Es un compositor teselante completo en un solo proceso.cargo run -p mirada-compositor -
Enlazado — el Cuerpo escucha en un socket y la app
mirada(el Cerebro GPUI) se conecta y decide la geometría.# terminal 1 — el Cuerpo MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada-compositor # terminal 2 — el Cerebro MIRADA_SOCKET=/tmp/mirada.sock cargo run -p mirada
Probarlo
Al arrancar imprime el WAYLAND_DISPLAY que abrió. Lanza cualquier
cliente Wayland contra él:
WAYLAND_DISPLAY=wayland-1 foot # o weston-terminal, alacritty, …
Las ventanas se teselan solas. El teclado, con la ventana del compositor
enfocada, maneja el escritorio con atajos Super+…: foco Super+j/k,
los 7 layouts en Super+t/m/g/c/r/d/s (o ciclar con Super+space), área
maestra Super+h/l, nmaster Super+,/., promover a maestra
Super+Return, escritorios Super+1..9, cerrar Super+q. Cierra la
ventana del compositor para salir.
Atajos de teclado
Los atajos son configurables en RON: ~/.config/mirada/keymap.ron. En
modo autónomo, el Cuerpo lo carga al arrancar (si no existe, escribe uno
por defecto documentado) y lo recarga en caliente — edita el archivo,
guarda, y los atajos cambian sin reiniciar. En modo enlazado el keymap es
asunto del Cerebro (la app mirada).
cargo run -p mirada-brain --example keymap-default # ver el formato
El compositor en sí no interpreta atajos: sólo intercepta las
combinaciones que el Cerebro le pide (GrabKeys) y le devuelve la
pulsada. Qué significa cada una lo decide mirada-brain. Ver el SDD.
Control externo
En modo autónomo, el compositor abre un socket de control y mirada-ctl
lo maneja desde la terminal — al estilo de swaymsg/hyprctl:
mirada-ctl focus-next # cambia el foco
mirada-ctl focus-window 5 # enfoca una ventana concreta
mirada-ctl workspace 3 # va al escritorio 3
mirada-ctl windows # lista las ventanas
En modo enlazado el socket de control lo abre el Cerebro (la app
mirada), no el compositor.
Qué implementa
wl_compositor, xdg_shell (toplevels y popups), wl_shm, wl_seat
(teclado) y wl_data_device (selección). Composición con GlesRenderer.
Reusa mirada-body para la contabilidad de salidas y superficies, y
mirada-link para el cable hacia un Cerebro externo. Toda la lógica
espacial es agnóstica de Wayland y vive en los crates de
crates/modules/mirada/.
Pendiente
Backend nativo DRM/libinput (de ventana anidada a sesión real), puntero/ratón completo y aislamiento de clientes. Ver el SDD.