diff --git a/PLAN-AKTE.md b/PLAN-AKTE.md index a35002c..e99af2d 100644 --- a/PLAN-AKTE.md +++ b/PLAN-AKTE.md @@ -1,6 +1,6 @@ # Plan: Modul „Akte" -Stand: 10. September 2026 · Stufe 0 bis 2 umgesetzt, Release 4.0 nach dem Update-Test von 3.4 +Stand: 11. September 2026 · Stufe 0 bis 3 umgesetzt, Release 4.0 nach dem Update-Test von 3.4 Eine Personalakte für den eigenen Squad-Charakter: Name, Callsign, Rang, Porträt, Nation, Teilstreitkraft, Einheit, Werdegang. Reines Rollenspiel — @@ -84,6 +84,7 @@ theme.py Farben, Schriften, apply_tactical_theme(), LevelMeter akte.py Oberfläche der Akte akte_modell.py Datenmodell und Speicherung, ohne tkinter akte_vorlagen.py Fraktionen, Dienstgrade, Verwendungen +akte_karte.py Akte als PNG-Karte zum Teilen ``` Flach bleibt es, weil Installer, Update-Paket und `start.pyw` heute flache @@ -151,7 +152,7 @@ Eine Akte ist ein Ordner mit JSON-Datei und Porträt: | **0** | Fehlende Pakete werden beim Start nachinstalliert — **erledigt in 3.3** | klein | | **1** | `theme.py` auslagern, Hauptreiter *Funk* / *Akte*, Akte noch leer — **erledigt in 3.4** | mittel | | **2** | Akte vollständig: Liste, Formular, Dokumentansicht, Porträt, Vorbelegungen — **umgesetzt**, Release 4.0 folgt | groß | -| **3** | Teilen: Akte als PNG-Karte für Discord, Export/Import als `.akte`-Datei | mittel | +| **3** | Teilen: Akte als PNG-Karte für Discord — **umgesetzt**, kommt mit 4.0 (Export/Import als `.akte`-Datei entfällt, siehe Abschnitt 7) | mittel | Jede Stufe endet mit einem Release über den Updater. Stufe 1 ist bewusst ohne neue Funktion: Wenn dabei etwas bricht, liegt es am Umbau und nicht an diff --git a/PROJEKT-UEBERGABE.md b/PROJEKT-UEBERGABE.md index 3b2f577..c1b46f1 100644 --- a/PROJEKT-UEBERGABE.md +++ b/PROJEKT-UEBERGABE.md @@ -49,6 +49,7 @@ theme.py Farben, Schriften, ttk-Stil, Pegelanzeige akte.py Akte: Oberfläche (Liste, Formular, Dokumentansicht) akte_modell.py Akte: Datenmodell und Speicherung, ohne tkinter akte_vorlagen.py Akte: Fraktionen, Dienstgrade, Verwendungen +akte_karte.py Akte: PNG-Karte zum Teilen, Zwischenablage update_helfer.py spielt Updates ein, bei Bedarf mit Adminrechten start.pyw Startskript ohne Konsolenfenster make_icon.py erzeugt icon.ico aus icon.png @@ -114,7 +115,8 @@ frisch. Funk-Modul und Updater (Hauptklasse `VoiceActivationApp`), `theme.py` mit dem Stil, und das Modul Akte in drei Teilen — `akte.py` (Oberfläche), `akte_modell.py` (Datenmodell und Speicherung, bewusst ohne tkinter und -damit ohne Fenster testbar) und `akte_vorlagen.py` (Vorschlagslisten). `theme.py` gibt es, damit +damit ohne Fenster testbar), `akte_vorlagen.py` (Vorschlagslisten) und +`akte_karte.py` (Karte zum Teilen). `theme.py` gibt es, damit `akte.py` die Farben nicht aus `squad_manager.py` holen muss — das wäre ein zirkulärer Import, weil `squad_manager.py` die Akte einbindet. Weitere Module gehören ebenfalls flach daneben: Installer, Update-Paket @@ -165,6 +167,19 @@ doppelt vergeben wird. Das Feld `schema` erlaubt spätere Formatänderungen; Änderungen werden 800 ms nach der letzten Eingabe gespeichert, außerdem beim Schließen und vor einem Update. +**Teilen:** Knopf „Teilen …" in der Leiste der Akte. `akte_karte.karte()` +zeichnet mit Pillow eine Karte 1200 × 675 (Discord zeigt das groß) — +bewusst kein Bildschirmfoto, damit sie überall gleich aussieht. Inhalt: +Porträt (bei *gefallen* grau), Callsign in der größten passenden Schrift, +Dienstzeilen bis der Platz endet, unten Auszeichnungen als ganze Einträge +mit „+ n weitere", sonst eine Zeile Beschreibung; Fußzeile wirbt mit +`sva.tyrveil.com`. „Kopieren" legt die Karte zweimal in die +Zwischenablage, als `CF_DIB` und als registriertes Format `PNG` — Discord +nimmt dann das verlustfreie PNG. Schriften kommen aus `C:\Windows\Fonts` +(Segoe UI, Consolas), mit Pillows Standardschrift als Ausweg. Prüfen: +Karten für Grenzfälle erzeugen und ansehen — volle Akte, leere, gefallen, +überlange Namen ohne Porträt; der Test überschreibt die Zwischenablage. + --- ## 4. Release bauen, Installer und Updater diff --git a/README.md b/README.md index b0327ee..46f24a8 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ Technische Dokumentation und alle bekannten Fallstricke: | `akte.py` | Modul Akte: Oberfläche | | `akte_modell.py` | Modul Akte: Datenmodell und Speicherung | | `akte_vorlagen.py` | Modul Akte: Fraktionen, Dienstgrade, Verwendungen | +| `akte_karte.py` | Modul Akte: PNG-Karte zum Teilen | | `update_helfer.py` | spielt Updates ein, bei Bedarf mit Adminrechten | | `start.pyw` | Startskript ohne Konsolenfenster | | `make_icon.py` | erzeugt `icon.ico` aus `icon.png` | diff --git a/akte.py b/akte.py index 7ffa6fa..e1ed7b5 100644 --- a/akte.py +++ b/akte.py @@ -12,6 +12,7 @@ from tkinter import ttk, filedialog, messagebox from PIL import Image, ImageOps, ImageTk +import akte_karte import akte_modell as modell import akte_vorlagen as vorlagen from theme import (BG, PANEL, LINE, FG, FG_DIM, OLIVE, OLIVE_HI, AMBER, RED, @@ -213,6 +214,12 @@ class AkteSeite(ttk.Frame): self.knopf_ansicht = ttk.Button(leiste, text="Ansicht", command=lambda: self.modus_setzen("ansicht")) self.knopf_ansicht.pack(side="right", padx=(0, 6)) + self.knopf_teilen = ttk.Button(leiste, text="Teilen …", command=self.teilen_menue) + self.knopf_teilen.pack(side="right", padx=(0, 18)) + self.rueckmeldung_var = tk.StringVar() + ttk.Label(leiste, textvariable=self.rueckmeldung_var, style="Dim.TLabel").pack( + side="left", padx=(16, 0)) + self._rueckmeldung_job = None self.leiste = leiste # Dokumentansicht @@ -415,6 +422,55 @@ class AkteSeite(ttk.Frame): self.aktuell = None self.akten_laden() + # -- Teilen -------------------------------------------------------------- + def teilen_menue(self): + if self.aktuell is None: + return + menue = tk.Menu(self, tearoff=False, bg=PANEL, fg=FG, activebackground=OLIVE, + activeforeground="#12150f", font=FONT_UI) + menue.add_command(label="Karte kopieren – in Discord mit Strg+V einfügen", + command=self.karte_kopieren) + menue.add_command(label="Karte als PNG speichern …", command=self.karte_speichern) + knopf = self.knopf_teilen + menue.tk_popup(knopf.winfo_rootx(), knopf.winfo_rooty() + knopf.winfo_height()) + + def _karte(self): + self.speichern_sofort() + return akte_karte.karte(self.aktuell) + + def karte_kopieren(self): + try: + akte_karte.in_zwischenablage(self._karte()) + except Exception as fehler: + messagebox.showerror("Akte teilen", + f"Die Karte konnte nicht kopiert werden:\n{fehler}") + return + # Kurz: Neben Nummer und drei Knoepfen bleiben in der Leiste nur + # rund 150 Pixel. Den Tipp mit Strg+V nennt schon der Menueeintrag. + self._rueckmeldung("✓ Kopiert") + + def karte_speichern(self): + ziel = filedialog.asksaveasfilename( + parent=self, title="Karte speichern", defaultextension=".png", + filetypes=[("PNG-Bild", "*.png")], + initialfile=akte_karte.dateiname(self.aktuell)) + if not ziel: + return + try: + self._karte().save(ziel, "PNG", optimize=True) + except Exception as fehler: + messagebox.showerror("Akte teilen", + f"Die Karte konnte nicht gespeichert werden:\n{fehler}") + return + self._rueckmeldung("✓ Gespeichert") + + def _rueckmeldung(self, text): + self.rueckmeldung_var.set(text) + if self._rueckmeldung_job is not None: + self.after_cancel(self._rueckmeldung_job) + self._rueckmeldung_job = self.after( + 5000, lambda: self.rueckmeldung_var.set("")) + # -- Umschalten ---------------------------------------------------------- def _zeigen(self, rahmen): for r in (self.ansicht, self.formular, self.leer): diff --git a/akte_karte.py b/akte_karte.py new file mode 100644 index 0000000..4efba11 --- /dev/null +++ b/akte_karte.py @@ -0,0 +1,291 @@ +""" +Akte als Bild zum Teilen, etwa in Discord. + +Gezeichnet mit Pillow statt vom Bildschirm abfotografiert: Die Karte sieht +so auf jedem Rechner gleich aus, unabhaengig von Fenstergroesse und +Bildschirmskalierung, und laesst sich ohne Fenster erzeugen und pruefen. +Das Format 1200 x 675 zeigt Discord gross und scharf an. +""" + +import io +import re +from pathlib import Path + +from PIL import Image, ImageDraw, ImageFont, ImageOps + +import akte_modell as modell +from theme import BG, PANEL, LINE, FG, FG_DIM, OLIVE_HI, AMBER, RED + +BREITE, HOEHE = 1200, 675 +FUSSZEILE = "ERSTELLT MIT SQUAD MANAGER · SVA.TYRVEIL.COM" + +MONO, MONO_FETT = "consola.ttf", "consolab.ttf" +UI, UI_HALBFETT = "segoeui.ttf", "seguisb.ttf" + + +def _schrift(datei, groesse): + try: + return ImageFont.truetype(datei, groesse) + except OSError: + return ImageFont.load_default(groesse) + + +def _kuerzen(zeichnen, text, schrift, breite): + """Schneidet mit Auslassungszeichen ab, bis der Text in die Breite passt.""" + if zeichnen.textlength(text, font=schrift) <= breite: + return text + while text and zeichnen.textlength(text + " …", font=schrift) > breite: + text = text[:-1] + return text.rstrip() + " …" + + +def _umbrechen(zeichnen, text, schrift, breite, zeilen_max): + zeilen, aktuell = [], "" + for wort in text.split(): + probe = f"{aktuell} {wort}".strip() + if zeichnen.textlength(probe, font=schrift) <= breite or not aktuell: + aktuell = probe + else: + zeilen.append(aktuell) + aktuell = wort + if aktuell: + zeilen.append(aktuell) + if len(zeilen) > zeilen_max: + zeilen = zeilen[:zeilen_max] + zeilen[-1] += " …" + return [_kuerzen(zeichnen, z, schrift, breite) for z in zeilen] + + +def _groesste_schrift(zeichnen, text, datei, breite, groessen): + for groesse in groessen: + schrift = _schrift(datei, groesse) + if zeichnen.textlength(text, font=schrift) <= breite: + return schrift + return _schrift(datei, groessen[-1]) + + +def _portraet(akte, groesse, gedaempft): + pfad = modell.portraet_pfad(akte.get("id", "")) + if not pfad or not Path(pfad).is_file(): + return None + try: + with Image.open(pfad) as quelle: + bild = ImageOps.fit(ImageOps.exif_transpose(quelle).convert("RGB"), groesse, + Image.LANCZOS) + except OSError: + return None + if gedaempft: + grau = ImageOps.grayscale(bild).convert("RGB") + bild = Image.blend(grau, Image.new("RGB", groesse, BG), 0.35) + return bild + + +def _stempel(bild, mitte, text, farbe, winkel=18): + """Schraeger Stempel wie in der Dokumentansicht, hier als gedrehte Ebene.""" + schrift = _schrift(MONO_FETT, 42) + probe = ImageDraw.Draw(bild) + links, oben, rechts, unten = probe.textbbox((0, 0), text, font=schrift) + breite, hoehe = rechts - links + 60, unten - oben + 40 + ebene = Image.new("RGBA", (breite, hoehe), (0, 0, 0, 0)) + zeichnen = ImageDraw.Draw(ebene) + zeichnen.rectangle((3, 3, breite - 4, hoehe - 4), outline=farbe, width=6) + zeichnen.text((breite / 2, hoehe / 2), text, font=schrift, fill=farbe, anchor="mm") + ebene = ebene.rotate(winkel, expand=True, resample=Image.BICUBIC) + ebene.putalpha(ebene.getchannel("A").point(lambda wert: int(wert * 0.92))) + x, y = int(mitte[0] - ebene.width / 2), int(mitte[1] - ebene.height / 2) + bild.paste(ebene, (x, y), ebene) + + +def _datum(iso): + teile = str(iso)[:10].split("-") + return ".".join(reversed(teile)) if len(teile) == 3 else "" + + +def karte(akte): + """Gibt die Karte als Pillow-Bild zurueck.""" + pers, dienst = akte.get("personalien", {}), akte.get("dienst", {}) + status = dienst.get("status", "aktiv") or "aktiv" + gefallen = status == "gefallen" + schrift_farbe = FG_DIM if gefallen else FG + akzent = FG_DIM if gefallen else OLIVE_HI + + bild = Image.new("RGB", (BREITE, HOEHE), BG) + z = ImageDraw.Draw(bild) + z.rectangle((24, 24, BREITE - 25, HOEHE - 25), fill=PANEL, outline=LINE, width=2) + + klein = _schrift(MONO, 17) + z.text((60, 46), f"AKTE NR. {akte.get('aktennummer', '')}", font=klein, fill=FG_DIM) + z.text((BREITE - 60, 46), "SQUAD MANAGER · PERSONALWESEN", font=klein, fill=FG_DIM, + anchor="ra") + z.line((60, 80, BREITE - 60, 80), fill=LINE, width=2) + + # Portraet links + px0, py0, pb, ph = 60, 108, 312, 390 + z.rectangle((px0 - 7, py0 - 7, px0 + pb + 6, py0 + ph + 6), outline=LINE, width=2) + foto = _portraet(akte, (pb, ph), gefallen) + if foto: + bild.paste(foto, (px0, py0)) + else: + z.rectangle((px0, py0, px0 + pb - 1, py0 + ph - 1), fill=BG) + # Unter einem Stempel wuerde der Text nur durchscheinen + if status not in ("gefallen", "vermisst"): + z.multiline_text((px0 + pb / 2, py0 + ph / 2), "KEIN\nPORTRÄT", + font=_schrift(MONO, 22), fill=FG_DIM, anchor="mm", + align="center", spacing=8) + + # Kopfdaten rechts + x, rechts = 420, BREITE - 60 + breite = rechts - x + stempel_schrift = _schrift(MONO_FETT, 24) + links, oben, r, unten = z.textbbox((x + 16, 112), "PERSONALAKTE", font=stempel_schrift) + z.rectangle((links - 16, oben - 10, r + 16, unten + 10), outline=AMBER, width=3) + z.text((x + 16, 112), "PERSONALAKTE", font=stempel_schrift, fill=AMBER) + + name = " ".join(t for t in (pers.get("vorname", ""), pers.get("nachname", "")) if t) + callsign = pers.get("callsign", "") + titel = callsign.upper() if callsign else (name or "NEUE AKTE") + titel_schrift = _groesste_schrift(z, titel, UI_HALBFETT, breite, range(72, 38, -4)) + y = 160 + z.text((x, y), _kuerzen(z, titel, titel_schrift, breite), font=titel_schrift, fill=akzent) + y += titel_schrift.size + 10 + zweite = " ".join(t for t in (dienst.get("rang", ""), name if callsign else "") if t) + if zweite: + name_schrift = _schrift(UI, 30) + z.text((x, y), _kuerzen(z, zweite, name_schrift, breite), font=name_schrift, + fill=schrift_farbe) + y += 44 + y += 8 + + einheit = " · ".join(v for v in (dienst.get("einheit", {}).get(k, "") for k in + ("verband", "bataillon", "kompanie", "zug", "gruppe")) if v) + einsaetze = akte.get("einsaetze", []) + letzter = next((e.get("ort", "") for e in reversed(einsaetze) if e.get("ort")), "") + zeilen = [ + ("FRAKTION", " · ".join(v for v in (dienst.get("fraktion", ""), + dienst.get("teilstreitkraft", "")) if v)), + ("VERWENDUNG", dienst.get("verwendung", "")), + ("EINHEIT", einheit), + ("STATUS", status.upper()), + ("DIENSTBEGINN", dienst.get("dienstbeginn", "")), + ("EINSÄTZE", f"{len(einsaetze)}" + (f" · zuletzt {letzter}" if letzter else "") + if einsaetze else ""), + ] + beschriftung, inhalt = _schrift(MONO, 17), _schrift(MONO, 21) + wert_x = x + 190 + for titel_zeile, wert in zeilen: + if not wert: + continue + umbruch = _umbrechen(z, wert, inhalt, rechts - wert_x, 2) + if y + 31 * len(umbruch) > 512: + break + z.text((x, y + 3), titel_zeile, font=beschriftung, fill=FG_DIM) + farbe = (RED if gefallen else AMBER) if titel_zeile == "STATUS" and \ + status in ("gefallen", "vermisst") else schrift_farbe + for teil in umbruch: + z.text((wert_x, y), teil, font=inhalt, fill=farbe) + y += 31 + + if status in ("gefallen", "vermisst"): + _stempel(bild, (px0 + pb / 2, py0 + ph / 2), status.upper(), RED if gefallen else AMBER) + + # Leiste unten: Auszeichnungen, sonst ein Stueck Beschreibung + z.line((60, 526, BREITE - 60, 526), fill=LINE, width=2) + auszeichnungen = [e.get("bezeichnung", "") for e in akte.get("auszeichnungen", []) + if e.get("bezeichnung")] + unten_schrift = _schrift(UI, 21) + unten_breite = BREITE - 120 + abstand = " " + if auszeichnungen: + z.text((60, 542), "AUSZEICHNUNGEN", font=_schrift(MONO_FETT, 17), fill=akzent) + # Nur ganze Eintraege, der Rest als Zahl - ein halber Orden liest sich schlecht + gezeigt, rest = [], len(auszeichnungen) + for name_a in auszeichnungen: + probe = gezeigt + ["■ " + name_a] + anhang = f"{abstand}+ {rest - 1} weitere" if rest > 1 else "" + if gezeigt and z.textlength(abstand.join(probe) + anhang, + font=unten_schrift) > unten_breite: + break + gezeigt, rest = probe, rest - 1 + text = abstand.join(gezeigt) + (f"{abstand}+ {rest} weitere" if rest else "") + z.text((60, 568), _kuerzen(z, text, unten_schrift, unten_breite), font=unten_schrift, + fill=schrift_farbe) + elif akte.get("beschreibung", "").strip(): + z.text((60, 542), "BESCHREIBUNG", font=_schrift(MONO_FETT, 17), fill=akzent) + zeile = _umbrechen(z, akte["beschreibung"].replace("\n", " "), unten_schrift, + unten_breite, 1)[0] + z.text((60, 568), zeile, font=unten_schrift, fill=schrift_farbe) + + fuss = _schrift(MONO, 14) + z.text((60, HOEHE - 52), FUSSZEILE, font=fuss, fill=FG_DIM) + stand = _datum(akte.get("geaendert", "")) + if stand: + z.text((BREITE - 60, HOEHE - 52), f"STAND {stand}", font=fuss, fill=FG_DIM, anchor="ra") + return bild + + +def dateiname(akte): + pers = akte.get("personalien", {}) + name = pers.get("callsign") or pers.get("nachname") or "Akte" + name = re.sub(r"[^\w\-]+", "_", f"{name}_{akte.get('aktennummer', '')}").strip("_") + return f"{name}.png" + + +def in_zwischenablage(bild): + """ + Legt die Karte in die Windows-Zwischenablage. + + Zweimal: als DIB, das jedes Programm versteht, und als PNG, das Discord + und Browser bevorzugen und das verlustfrei ankommt. + """ + import ctypes + import ctypes.wintypes as wintypes + import time + + user32 = ctypes.WinDLL("user32", use_last_error=True) + kernel32 = ctypes.WinDLL("kernel32", use_last_error=True) + user32.OpenClipboard.argtypes = (wintypes.HWND,) + user32.OpenClipboard.restype = wintypes.BOOL + user32.EmptyClipboard.restype = wintypes.BOOL + user32.CloseClipboard.restype = wintypes.BOOL + user32.SetClipboardData.argtypes = (wintypes.UINT, wintypes.HANDLE) + user32.SetClipboardData.restype = wintypes.HANDLE + user32.RegisterClipboardFormatW.argtypes = (wintypes.LPCWSTR,) + user32.RegisterClipboardFormatW.restype = wintypes.UINT + kernel32.GlobalAlloc.argtypes = (wintypes.UINT, ctypes.c_size_t) + kernel32.GlobalAlloc.restype = wintypes.HGLOBAL + kernel32.GlobalLock.argtypes = (wintypes.HGLOBAL,) + kernel32.GlobalLock.restype = wintypes.LPVOID + kernel32.GlobalUnlock.argtypes = (wintypes.HGLOBAL,) + kernel32.GlobalFree.argtypes = (wintypes.HGLOBAL,) + + bmp = io.BytesIO() + bild.convert("RGB").save(bmp, "BMP") + dib = bmp.getvalue()[14:] # ohne BITMAPFILEHEADER + png = io.BytesIO() + bild.save(png, "PNG") + + def speicherblock(daten): + block = kernel32.GlobalAlloc(0x0002, len(daten)) # GMEM_MOVEABLE + if not block: + raise MemoryError("Kein Speicher für die Zwischenablage") + ctypes.memmove(kernel32.GlobalLock(block), daten, len(daten)) + kernel32.GlobalUnlock(block) + return block + + # Ein anderes Programm kann die Zwischenablage kurz belegt halten + for _ in range(20): + if user32.OpenClipboard(None): + break + time.sleep(0.05) + else: + raise OSError("Die Zwischenablage ist gerade von einem anderen Programm belegt.") + try: + user32.EmptyClipboard() + for format_nr, daten in ((8, dib), # CF_DIB + (user32.RegisterClipboardFormatW("PNG"), png.getvalue())): + block = speicherblock(daten) + if not user32.SetClipboardData(format_nr, block): + kernel32.GlobalFree(block) + raise OSError("Die Karte konnte nicht in die Zwischenablage gelegt werden.") + finally: + user32.CloseClipboard() diff --git a/start.pyw b/start.pyw index 4070bfc..cbac97a 100644 --- a/start.pyw +++ b/start.pyw @@ -27,7 +27,7 @@ ORDNER = Path(__file__).resolve().parent VENV_PYTHON = ORDNER / ".venv" / "Scripts" / "python.exe" ANFORDERUNGEN = ORDNER / "requirements.txt" EIGENE_MODULE = {"squad_manager", "theme", "akte", "akte_modell", "akte_vorlagen", - "update_helfer"} + "akte_karte", "update_helfer"} for pfad in (ORDNER / ".venv" / "Lib" / "site-packages", ORDNER): if pfad.is_dir(): diff --git a/werkzeuge/baue_release.py b/werkzeuge/baue_release.py index 9c98e68..e72b547 100644 --- a/werkzeuge/baue_release.py +++ b/werkzeuge/baue_release.py @@ -29,7 +29,8 @@ DIST = WURZEL / "dist" BASIS_URL = "https://sva.tyrveil.com" PYTHON_DATEIEN = ("squad_manager.py", "theme.py", "akte.py", "akte_modell.py", - "akte_vorlagen.py", "update_helfer.py", "start.pyw", "make_icon.py") + "akte_vorlagen.py", "akte_karte.py", "update_helfer.py", "start.pyw", + "make_icon.py") MITKOPIEREN = ("requirements.txt", "icon.png", "icon.ico") ISCC_KANDIDATEN = (