- Programm heisst jetzt Squad Manager, Hauptdatei squad_manager.py
- Einstellungen ziehen nach %APPDATA%\SquadManager um; alte werden beim
ersten Start kopiert, nicht verschoben
- Installer: Verknuepfung liegt in {userprograms}, der Deinstallierer
raeumte bisher im falschen Ordner ab; doppelte Verknuepfung entfernt
- Deinstallierer fragt per SuppressibleMsgBox mit Vorgabe Nein, damit
stille Deinstallationen keine Einstellungen loeschen
- HOCHLADEN.txt liegt jetzt in der Quelle und wird beim Bau kopiert
- Plan fuer das Modul Akte (PLAN-AKTE.md)
- Version 3.3
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
255 lines
9.4 KiB
Markdown
255 lines
9.4 KiB
Markdown
# Design-Briefing: Squad Manager
|
||
|
||
Zwei Aufgaben, in dieser Reihenfolge:
|
||
|
||
- **Teil A** — ein Design System (Farben, Schrift, Abstände, Bausteine)
|
||
- **Teil B** — die beiden Bildschirme des Programms, gebaut aus Teil A
|
||
|
||
---
|
||
|
||
## Ausgangslage
|
||
|
||
Ein Windows-Desktop-Werkzeug für den Taktik-Shooter **Squad**. Es misst
|
||
laufend den Mikrofonpegel und hält die Sprechtaste des Spiels automatisch
|
||
gedrückt, solange der Spieler redet — Voice Activation für ein Spiel, das
|
||
nur Push-to-Talk kennt.
|
||
|
||
Kein Overlay, kein Spielinhalt: ein eigenständiges Fenster neben dem Spiel.
|
||
Es wird zum Einrichten geöffnet und im Betrieb nur kurz angeschaut, um
|
||
einen Zustand abzulesen.
|
||
|
||
**Nutzer:** Squad-Spieler, überwiegend erwachsen, Mil-Sim-affin, technisch
|
||
interessiert. Vertraut mit Begriffen wie Local, Squad Radio, Command Radio,
|
||
WASAPI. Sie mögen nüchterne Werkzeuge und misstrauen verspielten
|
||
Oberflächen.
|
||
|
||
**Anmutung:** Militärisch-funktional, nüchtern, dunkel. Nähe zur
|
||
Bildsprache des Spiels — gedecktes Olivgrün, Sandtöne, dunkles Metall,
|
||
Beschriftungen wie auf Gerätefronten. Kein Neon, keine Verläufe, keine
|
||
Spielereien. Eher Feldfunkgerät als Consumer-App.
|
||
|
||
**Oberstes Ziel:** Ablesbarkeit. Der Nutzer kommt aus einem Vollbild-Spiel
|
||
und muss den Zustand in einer halben Sekunde erfassen.
|
||
|
||
---
|
||
|
||
# TEIL A — Design System
|
||
|
||
Gesucht ist ein kleines, konsequentes System für genau diese Art von
|
||
Werkzeug. Bitte als benannte Gestaltungsmerkmale anlegen, damit sie in
|
||
Teil B wiederverwendet werden können.
|
||
|
||
## A1 Farben
|
||
|
||
Als Rollen definieren, nicht nur als Werte. Benötigt werden mindestens:
|
||
|
||
- Fensterhintergrund (dunkelste Ebene)
|
||
- Flächenfarbe für Eingabefelder und Kästen
|
||
- gehobene Fläche für aktiven Reiter und Mauskontakt
|
||
- Rahmen- und Trennlinienfarbe
|
||
- Textfarbe, Nebentextfarbe
|
||
- Akzentfarbe (Olivgrün) in normal und hell
|
||
- Signalfarben: Bernstein (Hinweis, Schwelle), Grün (aktiv/sendet),
|
||
Rot (gesperrt), Grau (untätig)
|
||
|
||
Bisher verwendete Werte als Ausgangspunkt, gern verbessern:
|
||
|
||
| Rolle | Wert |
|
||
|---|---|
|
||
| Fensterhintergrund | `#151814` |
|
||
| Fläche | `#1e231b` |
|
||
| Fläche gehoben | `#2a3125` |
|
||
| Linie | `#3d4634` |
|
||
| Text | `#c9cec0` |
|
||
| Nebentext | `#7f8874` |
|
||
| Akzent | `#6e8b3d` |
|
||
| Akzent hell | `#8cb04d` |
|
||
| Bernstein | `#d9a441` |
|
||
| Rot | `#b4472f` |
|
||
| Grün aktiv | `#9ed23f` |
|
||
|
||
## A2 Schrift
|
||
|
||
Zwei Familien, klar getrennt in der Aufgabe:
|
||
|
||
- **Beschriftungen und Fließtext** — serifenlos, gut lesbar (bisher Segoe UI)
|
||
- **Messwerte, Diagnose, Zustandsanzeige** — dicktengleich (bisher Consolas)
|
||
|
||
Gesucht ist eine Skala mit etwa fünf Stufen: Fenstertitel, Kastenüberschrift,
|
||
Beschriftung, Nebentext, Zustandsanzeige. Versalien sparsam einsetzen —
|
||
bisher nur für Fenstertitel und die Knöpfe der Statusleiste.
|
||
|
||
## A3 Raster und Abstände
|
||
|
||
Formularzeilen: links Beschriftung, rechts Bedienelement, konsistent
|
||
ausgerichtet. Bitte eine Abstandsskala festlegen (Innenabstand von Kästen,
|
||
Zeilenabstand, Abstand zwischen Gruppen) und durchhalten.
|
||
|
||
## A4 Bausteine
|
||
|
||
Für jeden Baustein die Zustände *normal*, *Mauskontakt*, *Fokus* und
|
||
*deaktiviert* mitdenken:
|
||
|
||
1. **Knopf, primär** — nur einmal pro Fenster (STARTEN)
|
||
2. **Knopf, sekundär** — normale Aktionen, deaktivierbar
|
||
3. **Auswahlliste** — auch mit sehr langen Einträgen wie
|
||
`[WASAPI] Analogue 1 + 2 (Focusrite USB Audio)`; zusätzlich eine
|
||
schmale Variante für Tastenauswahl
|
||
4. **Textfeld** — einzeilig
|
||
5. **Zahlenfeld** mit Schrittpfeilen
|
||
6. **Schieberegler** mit Zahlenanzeige daneben
|
||
7. **Kontrollkästchen** mit ein- und zweizeiliger Beschriftung
|
||
8. **Reiter** — genau zwei, aktiver deutlich abgesetzt
|
||
9. **Gerahmter Kasten** mit Überschrift in der Rahmenlinie
|
||
10. **Diagnosefeld** — mehrzeilig, dicktengleich, gerahmt
|
||
11. **Pegelanzeige** — siehe A5
|
||
12. **Zustandsanzeige** — siehe A6
|
||
13. **Statuszeile** — dezente, mitlaufende Textzeile unter einem Element
|
||
14. **Hinweistext** — mehrzeilig, gedämpft
|
||
|
||
## A5 Pegelanzeige — Kernstück
|
||
|
||
Kein gewöhnlicher Fortschrittsbalken. Etwa 40 schmale senkrechte Segmente
|
||
in einem Rahmen. Gefüllte Segmente zeigen den aktuellen Pegel, leere
|
||
bleiben dunkel. Eine **senkrechte bernsteinfarbene Marke** steht an der
|
||
Position der Auslöseschwelle.
|
||
|
||
Der Nutzen: Man sieht sofort, ob die eigene Stimme über die Schwelle kommt.
|
||
Bleiben die gefüllten Segmente links der Marke, löst nichts aus. Genau
|
||
daran scheitern Nutzer beim Einrichten — deshalb ist das der wichtigste
|
||
Blickfang des Fensters.
|
||
|
||
Bitte auch entwerfen, wie die Anzeige im aktiven Zustand (es wird gerade
|
||
gesendet) anders aussieht als im horchenden.
|
||
|
||
## A6 Zustandsanzeige
|
||
|
||
Vier sich ausschließende Zustände, jeweils Punkt plus Text:
|
||
|
||
| Zustand | Text | Farbe | Bedeutung |
|
||
|---|---|---|---|
|
||
| gestoppt | ● BEREITSCHAFT | grau | läuft nicht |
|
||
| bereit | ● HORCHT | bernstein | läuft, wartet auf Stimme |
|
||
| aktiv | ● SENDET | grün | Taste wird gerade gehalten |
|
||
| blockiert | ● GESPERRT | rot | pausiert, Grund steht daneben |
|
||
|
||
Muss aus zwei Metern Abstand erkennbar sein. Farbe allein darf nicht das
|
||
einzige Unterscheidungsmerkmal sein.
|
||
|
||
---
|
||
|
||
# TEIL B — Die Bildschirme
|
||
|
||
Ein Fenster, Standardgröße **700 × 780 px**, verkleinerbar bis etwa
|
||
660 × 480. Aufbau von oben nach unten: Kopfbereich, zwei Reiter,
|
||
Statusleiste am unteren Rand (immer sichtbar, auch bei kleinem Fenster).
|
||
|
||
## Kopfbereich
|
||
|
||
- Titel **SQUAD MANAGER**
|
||
- Untertitel „Hält die Sprechtaste, solange du redest."
|
||
- Trennlinie darunter
|
||
|
||
## Bildschirm 1 — Reiter „Mikrofon"
|
||
|
||
Formularzeilen:
|
||
|
||
| Beschriftung | Bedienelement | Anmerkung |
|
||
|---|---|---|
|
||
| Mikrofon | Auswahlliste + Knopf „Neu laden" | lange Einträge, Präfix `[WASAPI]` / `[MME]` |
|
||
| Schwelle | Schieberegler + Zahlenwert | 0.002 bis 0.100, dreistellig angezeigt |
|
||
| Pegel | **Pegelanzeige** + Zahlenwert | das Kernstück aus A5 |
|
||
| Nachlaufzeit | Zahlenfeld + „ms nach dem letzten Wort" | 100 bis 2000 |
|
||
|
||
Darunter zwei gerahmte Kästen:
|
||
|
||
**„Warum sendet es (nicht)?"** — Diagnosefeld, zwei bis vier Zeilen.
|
||
Beispielinhalt:
|
||
|
||
```
|
||
Pegel 0.0413 / Schwelle 0.0250 -> über Schwelle
|
||
Blockiert: Squad nicht im Vordergrund
|
||
-> Squad anklicken, oder den Haken im
|
||
Reiter 'Tasten und Verhalten' entfernen.
|
||
```
|
||
|
||
**„Eingabetest"** — Knopf „PTT-Taste testen (1 Sekunde halten)" plus
|
||
Ergebnistext daneben.
|
||
|
||
Abschließend ein vierzeiliger Hinweistext in gedämpfter Farbe.
|
||
|
||
## Bildschirm 2 — Reiter „Tasten und Verhalten"
|
||
|
||
- Zeile **Sprechtaste**: schmale Auswahlliste (Zusatztaste), ein „+",
|
||
schmale Auswahlliste (Taste), dahinter grauer Hinweis
|
||
- Gerahmter Kasten **„Andere Sprechtasten — Automatik pausiert, solange
|
||
eine gehalten wird"** mit drei gleich aufgebauten Zeilen:
|
||
|
||
| Beschriftung | Zusatztaste | | Taste | Hinweis |
|
||
|---|---|---|---|---|
|
||
| Squad Radio | (kein) | + | B | meist B |
|
||
| Command Radio | (kein) | + | G | meist G |
|
||
| Weitere Taste | (kein) | + | (keine) | optional |
|
||
|
||
- Dreizeiliger Erklärtext
|
||
- Gerahmter Kasten **„Verhalten"**:
|
||
- Kontrollkästchen „Alles nur aktiv, solange dieses Programm im
|
||
Vordergrund ist:" — darunter eingerückt ein Textfeld mit dem
|
||
Prozessnamen und eine mitlaufende Statuszeile
|
||
(„gerade im Vordergrund: SquadGame-Win64-Shipping.exe")
|
||
- Kontrollkästchen „Pausieren, solange ein Mauszeiger sichtbar ist
|
||
(Deploy-Screen, Menü, Karte)" — darunter mitlaufende Statuszeile
|
||
(„Mauszeiger gerade ausgeblendet")
|
||
- Zeile „Stummschalt-Hotkey (nur im Spiel)" + schmale Auswahlliste
|
||
- Kontrollkästchen „Signalton beim Umschalten (hoch = aktiv, tief = stumm)"
|
||
- Zum Abschluss eine dezente Zeile „Alle Änderungen werden sofort
|
||
gespeichert." mit Zeitstempel der letzten Speicherung
|
||
|
||
## Statusleiste
|
||
|
||
Über die volle Breite, oben abgetrennt durch eine Linie.
|
||
|
||
- Links: **STARTEN** (der einzige primäre Knopf im ganzen Fenster) und
|
||
**STOPPEN** (sekundär, im Ruhezustand deaktiviert)
|
||
- Rechts: Detailtext (etwa „Funk aktiv (B)" oder „WASAPI @ 48000 Hz") und
|
||
daneben die Zustandsanzeige aus A6
|
||
|
||
## Bitte zusätzlich zeigen
|
||
|
||
Die Zustandsanzeige und die Pegelanzeige sind die einzigen Elemente, die im
|
||
laufenden Betrieb wirklich abgelesen werden. Deshalb wären hilfreich:
|
||
|
||
1. Bildschirm 1 im Zustand **SENDET** — Pegel über der Schwelle
|
||
2. Bildschirm 1 im Zustand **GESPERRT** — Pegel über der Schwelle, aber
|
||
blockiert, mit Grund im Diagnosefeld
|
||
3. Die vier Zustände der Zustandsanzeige nebeneinander
|
||
|
||
---
|
||
|
||
## Technische Rahmenbedingungen
|
||
|
||
Die Oberfläche ist mit **Python und Tkinter/ttk** gebaut. Das begrenzt, was
|
||
sich unmittelbar umsetzen lässt:
|
||
|
||
**Gut machbar:** freie Farben für Flächen, Text und Rahmen; eigene
|
||
Schriftarten und -größen; Rahmen und Trennlinien; beliebige Grafik auf
|
||
einer Zeichenfläche (die Pegelanzeige ist bereits so gebaut — dort ist
|
||
gestalterisch fast alles möglich); Bilder als Symbole.
|
||
|
||
**Nicht oder nur mit erheblichem Aufwand:** abgerundete Ecken an
|
||
Standardelementen, Schlagschatten, Verläufe hinter Bedienelementen,
|
||
Transparenz, weiche Animationen, Platzhaltertexte in Eingabefeldern.
|
||
|
||
Ein Entwurf darf gern darüber hinausgehen. Dann bitte kenntlich machen,
|
||
welche Teile über den Standardumfang hinausgehen — sie müssten dann als
|
||
selbstgezeichnete Flächen entstehen oder ein anderes Oberflächen-Werkzeug
|
||
erfordern.
|
||
|
||
## Woran der Entwurf gemessen wird
|
||
|
||
1. Der Zustand ist auf einen Blick erfassbar, auch aus zwei Metern.
|
||
2. Die Beziehung zwischen Pegel und Schwelle wird sofort verständlich —
|
||
das ist die häufigste Hürde beim Einrichten.
|
||
3. Der zweite Reiter mit seinen vielen Auswahlfeldern wirkt geordnet,
|
||
nicht überladen.
|
||
4. Es sieht nach Werkzeug aus, nicht nach Spielerei.
|