🇬🇧 🇫🇷 🇪🇸 🇩🇪

# AMSpiriT Lite — Referencia rápida

AMSpiriT Lite es un emulador Amstrad CPC para Linux basado en el núcleo AMSpiriT de David MANUEL.

## Teclas de control

Tecla | Acción
--- | ---
`F1` | Abrir esta ayuda en el navegador
`F2` | Guardar una captura de pantalla PNG en el directorio actual
`Shift`+`F4` | Guardar snapshot (.sna) en la ranura actual
`Ctrl`+`F4` | Cargar snapshot desde la ranura actual
`Ctrl`+`0` a `Ctrl`+`9` | Cambiar a la ranura de snapshot 0–9 (guardados persistentes)
`Ctrl`+`E` | Exportar (detokenizar) programa BASIC desde RAM
`F7` | Bajar el volumen (-10 %)
`F8` | Subir el volumen (+10 %)
`F9` | Activar / desactivar el modo turbo (velocidad máxima, audio silenciado)
`F10` | Reinicio total (arranque en frío)
`Shift`+`F10` | Reinicio suave (arranque en caliente)
`F11` | Cambiar tipo de pantalla (color, monitor verde, variantes ASIC)
`Shift`+`F11` | Mostrar / ocultar el indicador FPS
`Ctrl`+`F11` | Cambiar los modos de visualización CRTC (depuración)
`F12` | Alternar pantalla completa / modo ventana
`Shift`+`F12` | Alternar vista: pantalla CPC visible ↔ trama CRTC completa
`Pause` | Pausar / Reanudar la emulación
`Ctrl`+`O` | Abrir un diálogo de selección de archivo
`Alt`+`F4` | Cerrar la ventana (gestionado por el gestor de ventanas)
`Esc` | Salir (solo cuando la emulación está en pausa)
`Ctrl`+`1` a `Ctrl`+`0` | Teclado numérico CPC 1–0 (para portátiles sin teclado numérico)

## Carga de archivos

Arrastre y suelte un archivo sobre la ventana del emulador para cargarlo, o use `Ctrl`+`O` para abrir un diálogo de archivo (requiere zenity o kdialog).

Consejo: mantenga `Ctrl` mientras arrastra un archivo para realizar un reinicio total antes de cargarlo — útil para iniciar una imagen de disco en un estado limpio.

Formato | Descripción
--- | ---
`.dsk` | Imagen de disco estándar
`.hfe` / `.ipf` | Imagen de disco de alta fidelidad (CAPS)
`.cdt` / `.wav` | Cinta (CDT o audio WAV)
`.sna` | Snapshot (estado guardado)
`.cpr` | Cartucho CPC Plus / GX4000 — cambia automáticamente al modelo CPC 6128+ y tipo CRTC 3

## Modo turbo

El modo turbo desactiva la cadencia de 50 Hz y silencia el audio, permitiendo al emulador funcionar a la velocidad máxima de la CPU. Útil para omitir cargas largas de cinta o intros.

- Pulse `F9` para activar o desactivar el modo turbo en cualquier momento.
- Al lanzar con `--turbo` junto con `--autotype` o `-A`, el turbo se detiene automáticamente cuando finaliza la secuencia de escritura automática.

## Joystick

Los joysticks USB se detectan automáticamente al inicio y al conectarlos. El primer joystick encontrado se asigna al puerto 1 del CPC.

Botón | Acción CPC
--- | ---
Botón 0 | Disparo 1
Botón 1 | Disparo 2
Botón 2 | Disparo 3
Botón 3 / Start | Pausar / Reanudar emulación
LB (botón izquierdo) | Guardado rápido del snapshot en la ranura actual
RB (botón derecho) | Carga rápida del snapshot desde la ranura actual
Eje X / Y o sombrero | Direcciones (arriba, abajo, izquierda, derecha)

## Servidor web de depuración

Al lanzar con `--web-ui`, el emulador inicia un servidor HTTP local que expone una interfaz de depuración en el navegador: registros Z80, Gate Array, PSG, FDC, FPS y controles (pausa, reinicio, cambio de modelo).

    amspirit-lite-sdl --web-ui [--web-addr 0.0.0.0] [--web-port 8765] [--web-html ruta/a/ui.html]

Opción | Descripción
--- | ---
`--web-ui` | Activar el servidor (desactivado por defecto)
`--web-addr <dirección>` | Dirección de escucha (por defecto: `127.0.0.1` — solo local; use `0.0.0.0` para todas las interfaces)
`--web-port <puerto>` | Puerto de escucha (por defecto: `8765`)
`--web-html <archivo>` | Ruta al archivo HTML de la interfaz (por defecto: `amspirit-lite.html` junto al binario)

El archivo `amspirit-lite.html` puede editarse sin recompilar. Si falta, se usa la interfaz integrada en el binario como alternativa.

## Distribución del teclado

La distribución del teclado del CPC se selecciona mediante la opción `--lang` al iniciar el emulador. Las distribuciones disponibles son:

Valor | Distribución del CPC
--- | ---
`FR` | Francés (AZERTY)
`EN` / `UK` | Inglés (QWERTY Reino Unido)
`US` | Inglés (QWERTY EE.UU.)
`ES` | Español
`GE` | Alemán (QWERTZ)
`IT` | Italiano
`DA` | Danés

AltGr: la tecla AltGr es absorbida y nunca se reenvía al CPC. Los caracteres AltGr (|, {, }, ~, @, …) llegan al emulador directamente a través de su sym SDL.

## Opciones de línea de comandos

    amspirit-lite-sdl [OPCIONES] [ARCHIVO]

### Emulación

Opción | Descripción
--- | ---
`-m <modelo>` | Modelo CPC: `464`, `664`, `6128` (por defecto), `6128+`, `464+`, `GX4000`
`-c <tipo>` | Tipo CRTC (0 a 4)
`-R <ruta>` | Directorio de ROMs (por defecto: `./ROMs`)
`-C <ruta>` | Directorio de configuración (por defecto: `./config`)
`-F` | Iniciar en pantalla completa
`-Z` / `--turbo` | Iniciar en modo turbo (velocidad máxima)

### Carga automática

Opción | Descripción
--- | ---
`-A` / `--autorun` | Escribe automáticamente `RUN"` tras el arranque para lanzar el primer programa
`-T <nombre>` / `--run <nombre>` | Escribe automáticamente `RUN"<nombre>` al inicio
`-t <archivo>` / `--autotype <archivo>` | Escribe el contenido de un archivo de texto en el CPC tras el arranque

### Audio y pantalla

Opción | Descripción
--- | ---
`-L <ms>` / `--audio-latency <ms>` | Latencia del búfer de audio en milisegundos (por defecto: 80 — aumentar si hay crepitaciones)
`--show-overlay` | Mostrar el indicador FPS en la esquina superior izquierda (rojo = demasiado lento, azul = demasiado rápido)

### Servidor web de depuración

Opción | Descripción
--- | ---
`--web-ui` | Activar el servidor HTTP de depuración (desactivado por defecto)
`--web-addr <dirección>` | Dirección de escucha (por defecto: `127.0.0.1`)
`--web-port <puerto>` | Puerto de escucha (por defecto: `8765`)
`--web-html <archivo>` | Ruta al archivo HTML de la interfaz de depuración

### Varios

Opción | Descripción
--- | ---
`-K` | Activar la salida de depuración detallada del teclado
`--dump-keymap` | Generar un archivo `keymap.cfg` de referencia basado en la disposición actual y mostrar en stdout
`-X <segundos>` | Salir automáticamente después de N segundos (pruebas automatizadas)

## Configuración del teclado (keymap.cfg)

Genere un archivo `keymap.cfg` usando la opción `--dump-keymap`, luego edítelo a su conveniencia y reinicie el emulador:

    amspirit-lite-sdl --dump-keymap > keymap.cfg

Coloque el archivo `keymap.cfg` generado en su carpeta `ROMs/` o `config/`. El archivo utiliza formato INI con dos secciones: `[keyboard layout]` y `[emulator hotkeys]`.

Acciones de atajo admitidas: PAUSE, HELP, SCREENSHOT, SNAPSHOT_SAVE, SNAPSHOT_LOAD, BASIC_EXPORT, VOLUME_UP, VOLUME_DOWN, FULLSCREEN, MONITOR_TYPE, CRTC_SELECT, VISIBLE_FRAME

Formato de teclas: Tecla única (F1, A, Escape, Return, Space) o modificadores (Ctrl+X, Shift+F1, Alt+Shift+P). Sin distinción de mayúsculas.

Los cambios toman efecto al reiniciar. Para encontrar el código de una tecla, ejecute con la opción `-K` y busque mensajes `DOWN` en la consola. Nota: Las aplicaciones SDL y Qt utilizan códigos de tecla diferentes; use archivos keymap separados para cada una si ejecuta ambas.

Núcleo AMSpiriT por David MANUEL — port Linux por Siko — amspirit.fr