sergio
fb3091d995
Un escritorio sin forma de abrir una terminal no es usable. Ahora el keymap puede lanzar programas: - `mirada-protocol`: nuevo `BrainCommand::Spawn(String)`. - `mirada-brain`: `DesktopAction::Spawn(String)` con forma textual `spawn:<comando>` (`Display`/`FromStr`); `Desktop::apply` la traduce a `BrainCommand::Spawn`. El keymap por defecto trae `Super+Shift+Return` → `spawn:foot`. `DesktopAction` deja de ser `Copy` (lleva el comando) — `Keymap::lookup` clona en vez de copiar. - `mirada-body`: `BodyOp::Spawn(String)`. - `mirada-compositor`: `exec_op` ejecuta el spawn con un helper `spawn_command` (`sh -c`, hereda `WAYLAND_DISPLAY`), que también recoge el lanzamiento de `MIRADA_STARTUP` — antes duplicado. `spawn:foot --title x` también funciona desde `mirada-ctl`. Tests nuevos del round-trip textual y del flujo atajo→comando. Nota: un keymap.ron ya existente no recibe el atajo nuevo; hay que añadir la línea a mano o borrar el archivo para regenerarlo. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
139 lines
4.8 KiB
Markdown
139 lines
4.8 KiB
Markdown
# 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.
|
|
|
|
Tiene **dos backends gráficos**:
|
|
|
|
- **`winit`** — corre **anidado**, como una ventana dentro de tu sesión
|
|
gráfica actual (X11 o Wayland). Para desarrollar y probar sin dejar el
|
|
escritorio.
|
|
- **`drm`** — corre **nativo** sobre una TTY, sin sesión anfitriona:
|
|
toma la GPU (DRM/KMS/GBM/EGL), el teclado (`libinput`) y la pantalla
|
|
entera. Es carmen como tu escritorio de verdad.
|
|
|
|
Sin argumentos elige solo: con `DISPLAY`/`WAYLAND_DISPLAY` → `winit`;
|
|
sin ellos → `drm`. O fuérzalo: `mirada-compositor --winit` / `--drm`.
|
|
|
|
## Backends
|
|
|
|
### winit — anidado
|
|
|
|
```sh
|
|
cargo run -p mirada-compositor -- --winit
|
|
```
|
|
|
|
Necesita una sesión gráfica anfitriona (X11 o Wayland) donde dibujar su
|
|
ventana; sin ella aborta con un mensaje que lo explica.
|
|
|
|
### drm — nativo sobre TTY
|
|
|
|
```sh
|
|
cargo run -p mirada-compositor -- --drm
|
|
```
|
|
|
|
Corre directo sobre el hardware. Requiere una **TTY** (`Ctrl+Alt+F3`),
|
|
una GPU con `/dev/dri`, y `seatd` o `logind` para la sesión. Toma la
|
|
pantalla completa; sal con `Super+Shift+e` o `Ctrl+C`.
|
|
|
|
Lleva teclado y ratón por `libinput`: el ratón mueve un cursor de
|
|
software, el foco sigue al puntero y los clics y la rueda llegan a la
|
|
ventana que tienes debajo. **`Super`+arrastre** con el botón izquierdo
|
|
mueve una ventana, con el derecho la redimensiona — al arrastrarla, la
|
|
ventana pasa a flotar.
|
|
|
|
- `MIRADA_STARTUP=<cmd>` — lanza una app al arrancar (`MIRADA_STARTUP=foot`).
|
|
- `MIRADA_DRM_TIMEOUT=<s>` — cierra el compositor solo tras N segundos
|
|
(0 o sin definir = sin tope).
|
|
|
|
## Dos modos
|
|
|
|
- **Autónomo** (por defecto) — lleva un `Desktop` (de `mirada-brain`)
|
|
embebido. Es un compositor teselante completo en un solo proceso.
|
|
|
|
```sh
|
|
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.
|
|
|
|
```sh
|
|
# 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:
|
|
|
|
```sh
|
|
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+…`: lanzar una terminal
|
|
`Super+Shift+Return`, 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`).
|
|
|
|
```sh
|
|
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`:
|
|
|
|
```sh
|
|
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 ratón en el backend DRM), `wl_output`, `wl_data_device`
|
|
(selección) y `xdg-decoration` — fuerza decoración del servidor y no
|
|
dibuja ninguna, así las ventanas van sin barra de título. Composición
|
|
con `GlesRenderer` — en `winit` sobre la ventana, en `drm` con un
|
|
`DrmCompositor` por salida.
|
|
|
|
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
|
|
|
|
Del backend DRM: conmutación de VT, hotplug de monitores, multi-GPU.
|
|
Puntero en el backend `winit`. Aislamiento de clientes. Ver el SDD.
|
|
|
|
[`smithay`]: https://github.com/Smithay/smithay
|