🇬🇧 🇫🇷 🇪🇸 🇩🇪

# AMSpiriT Lite — Kurzreferenz

AMSpiriT Lite ist ein Linux-Amstrad-CPC-Emulator, der auf dem AMSpiriT-Kern von David MANUEL basiert.

## Steuertasten

Taste | Aktion
--- | ---
`F1` | Diese Hilfe im Browser öffnen
`F2` | PNG-Screenshot im aktuellen Verzeichnis speichern
`Shift`+`F4` | Snapshot (.sna) im aktuellen Slot speichern
`Ctrl`+`F4` | Snapshot aus dem aktuellen Slot laden
`Ctrl`+`0` bis `Ctrl`+`9` | Zum Snapshot-Slot 0–9 wechseln (persistente Speicherung)
`Ctrl`+`E` | BASIC-Programm aus RAM exportieren (detokenisieren)
`F7` | Lautstärke verringern (-10 %)
`F8` | Lautstärke erhöhen (+10 %)
`F9` | Turbo-Modus ein-/ausschalten (volle Geschwindigkeit, Audio stumm)
`F10` | Kalt-Reset (Cold Boot)
`Shift`+`F10` | Warm-Reset (Warm Restart)
`F11` | Bildschirmtypen durchschalten (Farbe, Grünmonitor, ASIC-Varianten)
`Shift`+`F11` | FPS-Anzeige ein-/ausblenden
`Ctrl`+`F11` | CRTC-Debug-Visualisierungsmodi durchschalten
`F12` | Vollbild / Fenstermodus umschalten
`Shift`+`F12` | Ansicht umschalten: sichtbarer CPC-Bildschirm ↔ vollständiger CRTC-Rahmen
`Pause` | Emulation pausieren / fortsetzen
`Ctrl`+`O` | Dateiauswahldialog öffnen
`Alt`+`F4` | Fenster schließen (vom Fenstermanager verwaltet)
`Esc` | Beenden (nur wenn die Emulation pausiert ist)
`Ctrl`+`1` bis `Ctrl`+`0` | CPC-Ziffernblock 1–0 (für Laptops ohne Nummernblock)

## Dateien laden

Ziehen Sie eine Datei auf das Emulatorfenster, um sie zu laden, oder verwenden Sie `Ctrl`+`O` für einen Dateidialog (erfordert zenity oder kdialog).

Tipp: Halten Sie `Ctrl` gedrückt, während Sie eine Datei ablegen, um vor dem Laden einen Kalt-Reset durchzuführen — nützlich, um ein Disk-Image in einem sauberen Maschinenzustand zu starten.

Format | Beschreibung
--- | ---
`.dsk` | Standard-Disk-Image
`.hfe` / `.ipf` | High-Fidelity-Disk-Image (CAPS)
`.cdt` / `.wav` | Kassette (CDT oder WAV-Audio)
`.sna` | Snapshot (gespeicherter Zustand)
`.cpr` | CPC Plus / GX4000 Cartridge — wechselt automatisch zum CPC 6128+-Modell und CRTC-Typ 3

## Turbo-Modus

Der Turbo-Modus deaktiviert den 50-Hz-Takt und schaltet das Audio stumm, sodass der Emulator mit voller CPU-Geschwindigkeit läuft. Nützlich, um lange Kassettenladezeiten oder Intros zu überspringen.

- Drücken Sie `F9`, um den Turbo-Modus jederzeit ein- oder auszuschalten.
- Bei Start mit `--turbo` zusammen mit `--autotype` oder `-A` stoppt der Turbo automatisch, wenn die automatische Tippsequenz abgeschlossen ist.

## Joystick

USB-Joysticks werden beim Start und beim Anschließen automatisch erkannt. Der erste gefundene Joystick wird dem CPC-Joystick-Port 1 zugeordnet.

Taste | CPC-Aktion
--- | ---
Taste 0 | Feuer 1
Taste 1 | Feuer 2
Taste 2 | Feuer 3
Taste 3 / Start | Emulation pausieren / fortsetzen
LB (linke Schultertaste) | Snapshot schnell speichern im aktuellen Slot
RB (rechte Schultertaste) | Snapshot schnell laden aus dem aktuellen Slot
Achse X / Y oder Hat | Richtungen (oben, unten, links, rechts)

## Web-Debug-Server

Beim Start mit `--web-ui` startet der Emulator einen lokalen HTTP-Server, der eine Debug-Schnittstelle im Browser bereitstellt: Z80-Register, Gate Array, PSG, FDC, FPS und Steuerungen (Pause, Reset, Modellwechsel).

    amspirit-lite-sdl --web-ui [--web-addr 0.0.0.0] [--web-port 8765] [--web-html Pfad/zur/ui.html]

Option | Beschreibung
--- | ---
`--web-ui` | Server aktivieren (standardmäßig deaktiviert)
`--web-addr <Adresse>` | Bind-Adresse (Standard: `127.0.0.1` — nur lokal; `0.0.0.0` für alle Schnittstellen)
`--web-port <Port>` | Listening-Port (Standard: `8765`)
`--web-html <Datei>` | Pfad zur HTML-UI-Datei (Standard: `amspirit-lite.html` neben der Binärdatei)

Die Datei `amspirit-lite.html` kann ohne Neukompilierung bearbeitet werden. Falls sie fehlt, wird die in der Binärdatei eingebettete UI als Fallback verwendet.

## Tastaturbelegung

Die CPC-Tastaturbelegung wird beim Start über die Option `--lang` ausgewählt. Verfügbare Belegungen:

Wert | CPC-Tastaturbelegung
--- | ---
`FR` | Französisch (AZERTY)
`EN` / `UK` | Englisch (QWERTY, Großbritannien)
`US` | Englisch (QWERTY, USA)
`ES` | Spanisch
`GE` | Deutsch (QWERTZ)
`IT` | Italienisch
`DA` | Dänisch

AltGr: Die AltGr-Taste wird abgefangen und nie an den CPC weitergeleitet. AltGr-Zeichen (|, {, }, ~, @, …) erreichen den Emulator direkt über ihr SDL-Sym.

## Befehlszeilenoptionen

    amspirit-lite-sdl [OPTIONEN] [DATEI]

### Emulation

Option | Beschreibung
--- | ---
`-m <Modell>` | CPC-Modell: `464`, `664`, `6128` (Standard), `6128+`, `464+`, `GX4000`
`-c <Typ>` | CRTC-Typ (0 bis 4)
`-R <Pfad>` | ROMs-Verzeichnis (Standard: `./ROMs`)
`-C <Pfad>` | Konfigurationsverzeichnis (Standard: `./config`)
`-k <Layout>` / `--keyboard <Layout>` | Tastaturbelegung wählen: FR, EN, US, ES, DA, DE, IT, PT, BE, SW, CA (Standard: FR)
`-F` | Im Vollbildmodus starten
`-Z` / `--turbo` | Im Turbo-Modus starten (volle Geschwindigkeit)

### Automatisches Laden

Option | Beschreibung
--- | ---
`-A` / `--autorun` | Tippt automatisch `RUN"` nach dem Start, um das erste Programm zu starten
`-T <Name>` / `--run <Name>` | Tippt automatisch `RUN"<Name>` beim Start
`-t <Datei>` / `--autotype <Datei>` | Tippt den Inhalt einer Textdatei nach dem Start in den CPC
`--basic <Datei>` / `-b <Datei>` | Ein Locomotive-BASIC-Programm tokenisieren und in RAM injizieren (~3s nach dem Start)

### Audio und Anzeige

Option | Beschreibung
--- | ---
`-L <ms>` / `--audio-latency <ms>` | Audio-Puffer-Latenz in Millisekunden (Standard: 80 — erhöhen bei Audioknistern)
`--show-overlay` | FPS-Anzeige in der oberen linken Ecke einblenden (rot = zu langsam, blau = zu schnell)

### Web-Debug-Server

Option | Beschreibung
--- | ---
`--web-ui` / `--web-server` | HTTP-Debug-Server aktivieren (standardmäßig deaktiviert)
`--web-addr <Adresse>` | Bind-Adresse (Standard: `127.0.0.1`)
`--web-port <Port>` | Listening-Port (Standard: `8765`)
`--web-html <Datei>` | Pfad zur Debug-UI-HTML-Datei

### Verschiedenes

Option | Beschreibung
--- | ---
`-K` | Ausführliche Tastatur-Debug-Ausgabe aktivieren
`--dump-keymap` | Eine Referenz-`keymap.cfg`-Datei basierend auf dem aktuellen Layout generieren und auf stdout ausgeben
`-X <Sekunden>` | Nach N Sekunden automatisch beenden (automatisierte Tests)

## Tastenbelegung konfigurieren (keymap.cfg)

Generieren Sie eine `keymap.cfg`-Datei mit der Option `--dump-keymap`, bearbeiten Sie sie nach Ihren Wünschen und starten Sie den Emulator neu:

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

Platzieren Sie die generierte `keymap.cfg`-Datei in Ihrem Verzeichnis `ROMs/` oder `config/`. Die Datei verwendet INI-Format mit zwei Abschnitten: `[keyboard layout]` und `[emulator hotkeys]`.

Unterstützte Tastenkombinationsaktionen: PAUSE, HELP, SCREENSHOT, SNAPSHOT_SAVE, SNAPSHOT_LOAD, BASIC_EXPORT, VOLUME_UP, VOLUME_DOWN, FULLSCREEN, MONITOR_TYPE, CRTC_SELECT, VISIBLE_FRAME

Tastaturformat: Einzelne Taste (F1, A, Escape, Return, Space) oder Modifizierer (Ctrl+X, Shift+F1, Alt+Shift+P). Groß-/Kleinschreibung wird ignoriert.

Änderungen werden beim Neustart wirksam. Um den Code einer Taste zu finden, starten Sie den Emulator mit `-K` und suchen Sie nach `DOWN`-Meldungen in der Konsole. Hinweis: SDL- und Qt-Anwendungen verwenden unterschiedliche Tastencodes; verwenden Sie separate Keymap-Dateien für jede, wenn Sie beide ausführen.

AMSpiriT-Kern von David MANUEL — Linux-Port von Siko — amspirit.fr