poster: Werbegrafik / Poster
Abgrenzung (zuerst lesen)
| Anforderung | Verwenden |
|---|
| Einzelne Datengrafik (Balken/Linien/Kreis/Fluss/Zeitachse) | diagram, dieses Skill nicht verwenden |
| Einzelne visuelle Grafik: Poster/Langbild/Cover/Banner/Karte/Ausstellungstafel | Dieses Skill |
| Mehrseitige Präsentation | make-ppt |
| Dokument mit Formeln | md2docx |
Lokale Grenzen: Keine Diffusionsmodellgewichte, keine lokale Inferenzrechenleistung, keine Erzeugung von Fotos oder fotorealistischen Illustrationen.
Dieses Skill kann nur Vektor-/geometrischen Stil (detailliert, aber nicht fotorealistisch).
Eiserne Regeln
- Keine manuellen Punktlisten. Formen verwenden parametrische Primitive aus
engine.geometry (circle/leaf/cloud/wave/heart…), diese passen sich intern adaptiv an; manuelle Koordinaten sind die Wurzel von „offensichtlich mit Polygonen geflickten“ Formen.
- Text ebenfalls als Pfad. Kein separates Textzeichnungssystem;
engine.typography übernimmt Zeilenumbruch/vertikalen Text/Zeichenvermeidung an Zeilenanfang/-ende.
- Nach Code-Änderungen Modul-Cache leeren. Der Interpreter des
python-Tools teilt sich Anfragen: for m in [k for k in sys.modules if k.startswith("engine")]: del sys.modules[m]
- Keine Abnahme von 1–2 px Fehlern per Bildbetrachtung.
read_image skaliert die Vorschau und erzeugt scheinbare Lücken; verwenden Sie engine.check.check_canvas()-Asserts oder pixelgenaue Statistiken.
- Leistung: Große pixelweise Operationen an die C-Ebene delegieren, zuerst analysieren, dann ändern.
- Halbtransparente Überlagerungen mit einfarbig (Schwarz/Weiß/Grau): Drei Kanäle gleiche Abbildung → 256-Eintrag LUT +
bytes.translate.
Gemessen: Pixelweise Alpha-Mischung verbrauchte 71 % (6,6 s), geändert auf 0,05 s, mathematisch völlig äquivalent.
- Ganze Zeilen mit durchgehender Farbe per Slice zuweisen, nicht pixelweise 3 Byte schreiben.
- Zlib mit Level 6, nicht 9 (doppelt so schnell, Datei nur 15 % größer).
- Vor dem Eingriff
cProfile: Die größte Falle dieses Projekts ist die Alpha-Mischung, nicht die Geometrie-Algorithmen.
Drei Zugriffsmodi
| Modus | Eingabe | Anwendung |
|---|
| A Vorlage nutzen | templates/*/ kopieren, nur content.json ändern | Standard-Werbegrafiken (80 % der Fälle) |
| B Zusammenbauen | layout.json schreiben (Grundgerüst + Blockliste + Parameter) | Struktur ändern, Elemente standardisiert |
| C Eigenzeichnung | engine.canvas.Canvas direkt für Grafikelemente | Referenzbild nachahmen, einzigartiges Layout |
Verzeichnis
engine/
canvas.py Display-Liste (Canvas.fill/stroke/clip, Layer static/dynamic)
path.py Path (M/L/C/Q/Z) + adaptive Unterteilung
geometry.py 23 parametrische Primitive
fonts.py Schriftregistrierung + Glyph→Path + Fehlende-Zeichen-Erkennung
typography.py Zeilenumbruch/Vermeidung Zeilenanfang/-ende/Zeichensetzung-Kernung/vertikaler Text/Laufweite
theme.py Thema (6 Skin-Sets + Stilparameter) + 9 Leinwand-Voreinstellungen
blocks.py 21 deklarative Blöcke
layouts.py 9 Grundgerüste (inkl. Links-Rechts-Spalte)
render.py Zusammenbau + CLI
check.py Überlauf/Kontrast/Schriftgröße/Farbanzahl/Fehlende Glyphen/Slot-Asserts
cache.py Cache statischer Layer-Bitmaps (standardmäßig aus, gemessen siehe refs/workflow.md)
backends/ raster.py (PNG), pdf.py (Vektor-PDF), svg.py
packs/ Materialpakete (guofeng 国风, tea 茶器), bei Bedarf laden
templates/ Fertige Rezepte (content + layout)
Voraussetzungen
- Abhängigkeiten installieren:
pip install -r requirements.txt (nur ein Abhängigkeit: fontTools).
- Schriftarten: Dieses Repository enthält keine Schriftdateien; die Engine liest systemweit installierte Schriftarten – standardmäßig scannt sie
/system/fonts, /usr/share/fonts, ~/.fonts usw.; bei anderem Speicherort mit Umgebungsvariable
POSTER_FONT_DIR auf das Schriftverzeichnis verweisen.
- Kein Internet, kein Office/GUI nötig: Rasterung, PDF und SVG sind alles reine Python-Implementierungen.
Schnellstart
python -m engine.render templates/minimal-poster/layout.json -o out.png
python -m engine.render templates/minimal-poster/layout.json -o out.pdf \
--preset a4-portrait --for print
python -m engine.render ... --theme guofeng --preset xhs-3x4
python -m engine.render --list
Aufruf in Python:
from engine.render import render, load_json
render(layout, content, theme="minimal", preset_name="xhs-3x4",
out="out.png", for_="publish")
Nur vier Stellschrauben
| Stellschraube | Werte | Beschreibung |
|---|
preset | xhs-3x4 / sq-1x1 / story-9x16 / wechat-cover / video-16x9 / info-long / a4-portrait / a3-portrait / rollup-85x200 | Größe & Sicherheitszone |
--for | draft / preview / publish / print | Auflösung & Ausgabe (siehe refs/workflow.md) |
--format | png / pdf / svg | Standard: print→pdf, sonst png |
--deco | 0/1/2 (innerhalb des Themas) | Dekorationsdichte; beeinflusst nur Optik & Dateigröße, kaum Geschwindigkeit |
Kein quality-Parameter: Untere Qualitätsgrenze garantiert durch adaptive Unterteilung der Primitive + Subpixel-Abdeckung + check.py.
Einschränkungen (transparent mitgeteilt)
- Keine Fotos, fotorealistische Illustrationen, 3D; halbrealistische Gegenstände möglich (jeweils ca. 100–200 Zeilen, sechs Schichten), Personen nicht empfohlen.
- PDF erste Version Text in Pfade umgewandelt: visuell korrekt, aber nicht auswählbar, nicht durchsuchbar.
- PDF nur RGB, kein CMYK/Sonderfarben; vor Druck selbst konvertieren.
- Große Überschriften/dünne Linien bei ss=2 besser mit
--for publish (ss=3) verwenden.
- Seltene Zeichen können fehlen;
check.py meldet fehlende Zeichen, Schriftart über POSTER_FONT_DIR angebbar.
- Erstmaliges Rendern ca. +6 s (Schriftdatei-Parsing), Wiederverwendung im gleichen Prozess; iterativ aufrufen, nicht häufig neustarten.
- Warmlauf-Zeitreferenz: preview ≈1,6 s, publish ≈2,7 s (1080×1440 Ausgabe mit 3240×4320).
- Vertikale Zeichensetzung nur verschoben, nicht gedreht; Zahlen/Englisch vertikal nicht gedreht; keine Schriftsatzanpassung für mehrere Endgeräte.
Hinweise (bekannte Fallstricke)
Leistung
- Halbtransparente Überlagerungen: Beliebige Farben über kanalweise LUT (gemessen 13 s→2,5 s). Vor neuem „großflächiger pixelweiser“ Feature überlegen, ob Lookup-Tabelle möglich.
- Große PNG-Dekodierung: 5760×3240 voll dekodiert 10 s+. Hintergrundmaterial ≤1500px oder JPEG (nur DC-Koeffizienten dekodieren, eine Größenordnung schneller).
- Print-Modus erzwingt ss=1: A4@ss3 gemessen 52 s.
- Cache statischer Layer gemessen nicht lohnend (40 MB Bitmap-IO ≈ Rendering-Kosten),
--cache standardmäßig aus.
Schriftarten
- Alle FZ-Schriftarten fehlen
∂ ħ ∇ und hochgestellte Zahlen ⁻³⁵; Fehlende Zeichen werden stillschweigend übersprungen, kein Fehler (Formeln werden zu ψ/ t = i Hψ).
- Vor Formeln/Einheiten
fonts.missing(text, family) prüfen; gemessen nur verfügbare Symbole: ψ ∫ ≈ ∝ λ ∞ → ·.
Layout
hero mehrzeilig benötigt Bereichshöhe ≥ Zeilen × Zeilenhöhe, sonst Druck auf nächsten Block.
banner / card-grid / cover Proportionen sind Erfahrungswerte, bei Inhaltswechsel ggf. Feinjustierung nötig.
- CTA in Breitbild muss
max_width gesetzt haben, sonst füllt es die ganze Zeile wie eine Fortschrittsleiste.
- Eigener Text im Hintergrundbild kollidiert mit Vordergrund – textloses Material wählen (Fotos/Texturen/Illustrationen).
Bildmaterial
- JPEG mit PNG-Ausgabe nur DC-Version (8× verkleinert, pixelig); für Klarheit PDF ausgeben oder PNG-Material verwenden.
- PDF direktes Einbetten von JPEG ohne Neucodierung, beste Qualität.
- Material ohne Dateiendung wird erkannt (anhand Dateisignatur).
Entwicklungspraktiken
- Modul-Cache des
python-Tools wird anfragenübergreifend geteilt, daher zu Testbeginn sys.modules von engine* / packs* leeren.
- Entwicklungsverzeichnis und Installationsverzeichnis trennen, nach Änderungen mit
copytree synchronisieren (__pycache__ ignorieren).
- Fehler beim Import von
objects_pack in scene führen zu stillem Rückfall auf vereinfachte Version, kein Fehler.
Detaildokumentation (bei Bedarf lesen)
| Datei | Inhalt |
|---|
refs/workflow.md | Referenzbild-Zerlegung → Graumodell → Färbung → Beschriftung → Abnahme; Auflösungsstufen und Leistungsmessungen |
refs/canvas-api.md | Canvas / Path / geometry Kurzreferenz, Methoden für fehlende Fähigkeiten |
refs/presets.md | Alle Größen, Sicherheitszonen, Druckbeschneidung und pt-Umrechnung |
refs/packs.md | Materialpaket-Protokoll und Workflow für „bedarfsgerechtes Verpacken“ |
refs/styles.md | Stilparameter, 6 integrierte Stil-Fingerabdrücke, theme_overrides, Workflow zur Nachahmung eines Stils |
refs/analyze.md | Referenzbildanalyse: Farbnahme/Helligkeit/Satzspiegel/Dichte → Theme-Entwurf |