Add opt-in native Modern UI foundation and first desktop flow (by Codex)
This commit is contained in:
1 parent
a4a37f1cb2
commit
11a6356c1e
42 files changed
+5333
-9
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user