Add opt-in native Modern UI foundation and first desktop flow (by Codex)

This commit is contained in:
Codex committed 2026-10-23 18:51:02 +02:00
1 parent a4a37f1cb2
commit 11a6356c1e
42 files changed
+5333 -9

No files matched your search

+99
View File
@@ -0,0 +1,99 @@
# Native Modern UI · erster Umsetzungsstand
Stand: 23. Oktober 2026. **Experimenteller RmlUI-Unterbau und erster
bedienbarer Durchlauf. Noch keine vollständige Umsetzung des HTML-Mockups.**
Die normale Classic-Konfiguration bleibt unverändert; die neue Oberfläche
wird ausdrücklich mit `OPENBMH_BUILD_MODERN_UI=ON` gebaut.
## Vorhanden
- Gemeinsamer SDL2-/RmlUI-Unterbau mit den vorhandenen OpenGL-/Direct3D-
Renderern, den drei Farbpaletten und dem 2720 × 2040 großen 4:3-Fenster.
- Schreibgeschützter OBW-Katalog für Diamond Modern: Vereine, Ligen, Spieler,
Wappen und Fotos. SVG-Wappen werden gegenüber kleinen Legacy-Bildern bevorzugt.
- Eigene GUI-Ressourcen für Hintergründe, Desktop-Icons, Managerporträts,
Karten und Trainingslagerbilder. Der Vorbereitungsbefehl verändert weder
das Mockup noch die Weltdatei.
- Hauptmenü und Mod-Auswahl; Grundeinstellungen mit vier großen Auswahlfeldern;
Manager-/Vereinswahl mit Foto- und Illustrationsporträts. Ausländische
Vereine bleiben sichtbar und sind für Manager gesperrt.
- Drei Teilnehmerseiten, automatische Demo-Auslosung mit Pause/Überspringen
und Übersicht; in dieser Folge gibt es keinen Schließen-Knopf.
- Desktop mit Statusleiste, Buttons, fixierter Standardanordnung, Raster und
freiem Verschieben, Rechtsklickmenü, gemeinsamer Fixierung, Rückgängig,
Widgetauswahl und den vorgesehenen Widgetgrößen. Kurven-/Statistikinhalte
und die Widgetvorschauen benötigen noch den detaillierten Mockup-Abgleich.
- Eintrittspreis-Popover: 330 × 196 Punkte, Entwurf, gesonderte Bestätigung,
Abbrechen, Fehler-/Revisionsschutz und Tastaturbedienung.
- Trainingslager: drei Karten, 18 Angebote, eigene GUI-Bilder und lokale
Vormerkung. Tabellen/Stärken sowie Speichern/Laden sind als erste native
Ansichten vorhanden; ihr vollständiger Bedienungsabgleich bleibt offen.
- Separate UI-Demostände und Desktopansichten. Ansichten speichern zusätzlich
einen Screenshot; die Standardansicht kann nicht gelöscht werden.
**Anstoß führt keine Aktion aus**, weder per Maus noch per Tastatur. Das gilt
auch für die direkte Aktionsschnittstelle des Demoanbieters.
## Noch offen
Die übrigen Desktop-Untermenüs werden anschließend einzeln vom HTML-Mockup
übertragen. Für sie erscheinen derzeit keine vereinfachten Ersatzlayouts.
Der Einstellungsdialog, die vollständigen Widgetinhalte, Sortierung/Details,
Mod-Importkomfort und dauerhafte globale Voreinstellungen sind noch nicht
vollständig. Übersetzungen, echte Engine-Anbindung und Plattform-Abnahme
unter Windows/macOS folgen später. Dies ist kein freigegebenes Test-Release.
## Architekturgrenze für die Engine
Die Oberfläche liegt unter `src/modern/ui`, verwendet aber den Namespace
`bmh::modern_ui`. Damit verdeckt sie nicht `bmh::ui`, auf das die Modern-
Session des Engine-Forks derzeit zugreift.
`DataSource` liefert besitzende, unveränderliche `Snapshot`-Werte mit Revision
und nimmt `Action`-Anfragen entgegen. Aktuell implementiert ausschließlich
`DemoSource` diese Grenze. Keine Ansicht greift auf `GameState` zu; die Demo
ruft keine Modern-Session, Zufallsquelle oder Matchfunktion auf. Ihr `.json`-
Speicherformat ist ausdrücklich kein `.obs`-Spielstand und keine neue
Spielregel. Ein späterer Session-Adapter ersetzt den Demoanbieter.
Die bisher nur für den Editor verwendeten Archiv-/Bild-Hilfen sind als
`bmh_asset_io` geteilt. Editor-Oberfläche, MCP-Server und HTTP-Server werden
nicht in die Modern UI eingebunden.
## Lokal bauen und ansehen
```sh
python3 tools/modern_ui/prepare_gui_assets.py \
--mockup /path/to/bmh_4k_ui --output /path/to/gui-resources
cmake -S . -B build-modern -DOPENBMH_BUILD_MODERN_UI=ON \
-DBMH_MODERN_GUI_ASSETS=/path/to/gui-resources
cmake --build build-modern --target openbmh_play modern_ui_core_tests modern_ticket_document_tests
ctest --test-dir build-modern -R '^modern_(ui_core|ticket_)' --output-on-failure
./build-modern/OpenBMH --modern-ui-demo --mod /path/to/Diamond_Modern.obw
```
Bei Mehrkonfigurations-Generatoren liegt das Programm im Konfigurationsordner;
`--config Release` beziehungsweise `ctest -C Release` ergänzen. Die
Spieler-/Vereinsdaten und die privaten Referenzmotive werden nicht mit diesem
Quellcode verteilt. Ohne externe GUI-Ressourcen kann das Hauptmenü den bereits
mitgelieferten Launcher-Hintergrund verwenden.
Entwicklungsoptionen: `--gui-assets`, `--ui-scene`, `--ui-theme`, `--ui-size`,
`--ui-state`, `--ui-screenshot` und `--ui-script`. Das zeilenweise JSON-
Eingabeskript führt Maus-/Tastaturaktionen durch RmlUI aus; es ersetzt keine
Sessionaktionen durch direkte Zustandsmanipulation. `checkpoint` schreibt einen
wiederherstellbaren Demostand passend zu den Bildschirmaufnahmen.
## Prüfung
Synthetische Tests prüfen Katalog, HQ-Bildauswahl, ausländische Übernahmesperre,
Revisionsschutz, Desktop-Grenzen/Fixierung/Größen und atomare Demostand-
Wiederherstellung. Drei fensterlose RmlUI-Tests prüfen den Eintrittspreis in
allen Themes, einschließlich doppelter Pixeldichte und abgewiesener Übernahme.
Ein nativer Linux-/OpenGL-Durchlauf mit externem Diamond-Datensatz führt über
das Hauptmenü, die Managerwahl und Auslosung zum Desktop, verändert den
Eintrittspreis nach Bestätigung, öffnet das Nahost-Lager und prüft Verschieben
und Rückgängig. Bildschirmaufnahmen, Eingabeskripte und Demostände bleiben im
privaten Mockup-Repository. Windows-/macOS-Laufzeitverhalten wird damit nicht
als geprüft ausgegeben.
+3 -1
View File
@@ -1,6 +1,8 @@
# Native Modern UI bis zum Anstoß
Stand: 23. Oktober 2026. **Abgestimmter Umfang; native Umsetzung noch offen.**
Stand: 23. Oktober 2026. **Abgestimmter Gesamtumfang; native Umsetzung begonnen.**
Der [native Umsetzungsstand](NATIVE_STATUS.md) unterscheidet den bereits
bedienbaren Unterbau von den noch ausstehenden Menüübertragungen.
Diese Seite hält die Entscheidungen aus dem UI-Plan fest. Sie ersetzt keine
Implementierungs- oder Abnahmebelege. Die Engine entsteht parallel bei Claude.
+1
View File
@@ -8,6 +8,7 @@ Implementierung in der Spiel-Engine.
| Bereich | Dokument |
|---|---|
| Umsetzung | [Abgestimmter Umfang der nativen UI bis zum Anstoß](PLAN.md) |
| Nativer Stand | [Unterbau, erster Durchlauf und noch offene Übertragungen](NATIVE_STATUS.md) |
| Ressourcen | [GUI-Assets, Weltbilder und spätere Paketbereinigung](assets.md) |
| Desktop | [Statusleiste, Gestaltung und Fenster](desktop/README.md) |
| Eintrittspreis | [Kompakter Schieberegler im Konto-Widget](desktop/entry-price/README.md) |
+2 -2
View File
@@ -1,7 +1,7 @@
# Eintrittspreis · Konto-/Eintritts-Widget
Stand: 23. Oktober 2026. Im HTML-Mockup umgesetzt; die native Modern UI
übernimmt diese Bedienung bei ihrer Umsetzung.
Stand: 23. Oktober 2026. Im HTML-Mockup und im experimentellen nativen
RmlUI-Desktop umgesetzt. Siehe [nativer Umsetzungsstand](../../NATIVE_STATUS.md).
## Bedienung und Größe