poster : Affiche / Visuel promotionnel
Limites (à lire en premier)
| Besoin | Utiliser |
|---|
| Un seul graphique de données (barres/lignes/camembert/processus/frise) | diagram, ne pas utiliser ce skill |
| Une seule image visuelle : affiche / infographie longue / couverture / bannière / carte / panneau | Ce skill |
| Présentation multi-diapos | make-ppt |
| Document avec formules | md2docx |
Limites de la machine : pas de poids de modèle de diffusion, pas de capacité de calcul local pour l'inférence, ne peut pas générer de photos ni d'illustrations réalistes.
Ce skill ne peut produire que des styles géométriques/vectoriels (peut être très détaillé, mais pas réaliste).
Règles absolues
- Ne pas écrire de points à la main. Utilisez toujours les primitives paramétriques de
engine.geometry (cercle/feuille/nuage/vague/cœur…). Elles s'adaptent en interne ; écrire des coordonnées à la main est la source des « polygones approximatifs ».
- Le texte passe aussi par Path. N'écrivez pas un autre système de dessin de texte ;
engine.typography gère le retour à la ligne, l'écriture verticale, les césures.
- Videz le cache du module après avoir modifié le code. L'interpréteur de l'outil
python est partagé entre les requêtes :
for m in [k for k in sys.modules if k.startswith("engine")]: del sys.modules[m]
- Ne validez pas les défauts de 1–2px en regardant l'image. L'aperçu
read_image réduit la taille et produit de faux défauts ; utilisez les assertions de engine.check.check_canvas() ou faites des statistiques au pixel.
- Performance : les opérations sur de grandes surfaces de pixels doivent être confiées au C, analysez avant de modifier.
- Si la superposition semi-transparente est monochrome (noir/blanc/gris), la cartographie est la même pour les trois canaux → LUT à 256 entrées +
bytes.translate.
Mesures : le mélange pixel par pixel représentait 71 % (6,6 s), après modification 0,05 s, et mathématiquement équivalent.
- Pour remplir une ligne entière d'une couleur unie, utilisez une affectation par tranche, n'écrivez pas 3 octets pixel par pixel.
- Utilisez le niveau 6 pour zlib, pas le 9 (deux fois plus rapide, fichier seulement 15 % plus gros).
- Avant d'agir, faites un
cProfile : le plus gros goulot d'étranglement de ce projet est le mélange alpha, pas les algorithmes géométriques.
Trois modes d'accès
| Mode | Entrée | Utilisation |
|---|
| A. Modèle | Copier templates/*/, ne modifier que content.json | Affiches classiques (80 % des cas) |
| B. Assemblage | Écrire layout.json (squelette + liste de blocs + paramètres) | Structure à modifier, éléments standard |
| C. Dessin libre | engine.canvas.Canvas pour dessiner directement | Imiter une image de référence, mise en page unique |
Arborescence
engine/
canvas.py Liste d'affichage (Canvas.fill/stroke/clip, calques static/dynamic)
path.py Path (M/L/C/Q/Z) + subdivision adaptative
geometry.py 23 primitives paramétriques
fonts.py Registre des polices + glyphe→Path + détection de glyphes manquants
typography.py Retour à la ligne, césure, espacement, écriture verticale, crénage
theme.py Thème (6 ensembles de peau + paramètres de style) + 9 préréglages de toile
blocks.py 21 blocs déclaratifs
layouts.py 9 squelettes (dont colonnes gauche/droite)
render.py Assemblage + CLI
check.py Assertions : débordement, contraste, taille de police, nombre de couleurs, glyphes manquants, emplacements
cache.py Cache de bitmap de calque statique (désactivé par défaut, voir refs/workflow.md)
backends/ raster.py (PNG), pdf.py (PDF vectoriel), svg.py
packs/ Packs de ressources (guofeng, tea), chargés à la demande
templates/ Recettes prêtes (content + layout)
Prérequis
- Installer les dépendances :
pip install -r requirements.txt (une seule dépendance : fontTools).
- Polices : ce dépôt ne contient pas de fichiers de polices ; le moteur lit les polices système installées – par défaut, il analyse
/system/fonts, /usr/share/fonts, ~/.fonts et autres répertoires courants ; si les polices sont ailleurs, utilisez la variable d'environnement
POSTER_FONT_DIR pour pointer vers le dossier.
- Pas besoin de connexion réseau, ni d'Office/GUI : les trois backends (rasterisation, PDF, SVG) sont implémentés en pur Python.
Démarrage rapide
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
Appel en Python :
from engine.render import render, load_json
render(layout, content, theme="minimal", preset_name="xhs-3x4",
out="out.png", for_="publish")
Quatre boutons seulement
| Bouton | Valeur | Description |
|---|
preset | xhs-3x4 / sq-1x1 / story-9x16 / wechat-cover / video-16x9 / info-long / a4-portrait / a3-portrait / rollup-85x200 | Dimensions et zones de sécurité |
--for | draft / preview / publish / print | Netteté et sortie (voir refs/workflow.md) |
--format | png / pdf / svg | Défaut : print→pdf, sinon png |
--deco | 0/1/2 (dans le thème) | Densité de décoration ; n'affecte que l'aspect visuel et la taille du fichier, presque pas la vitesse |
Pas de paramètre quality : la qualité minimale est garantie par la subdivision adaptative des primitives + la couverture sous-pixel + check.py.
Limites (honnêtement)
- Pas de photos, d'illustrations réalistes, de 3D ; les objets semi-réalistes sont possibles (environ 100–200 lignes, six couches de dessin), les personnages ne sont pas recommandés.
- La première version du PDF vectorise le texte : visuellement correct mais non sélectionnable, non recherchable.
- Le PDF est uniquement RVB, ne supporte pas CMJN/couleurs d'accompagnement ; la conversion avant impression est à faire.
- Pour les grands titres/traits fins en ss=2, il est recommandé d'utiliser
--for publish (ss=3).
- Les caractères rares peuvent être absents ;
check.py signalera les glyphes manquants, la police peut être spécifiée avec POSTER_FONT_DIR.
- Premier rendu : environ 6s supplémentaires (analyse des fichiers de polices), les rendus suivants dans le même processus sont réutilisés ; lors des itérations, appelez en continu plutôt que de redémarrer fréquemment.
- Temps à chaud (estimation) : preview ≈1,6s, publish ≈2,7s (pour 1080×1440 avec sortie 3240×4320).
- La ponctuation verticale n'est que translatée, pas tournée ; les chiffres/anglais en vertical ne sont pas tournés ; l'adaptation multi-polices n'est pas faite.
Points d'attention (pièges rencontrés)
Performance
- Superposition semi-transparente : toutes les couleurs passent par une LUT par canal (mesuré : 13s→2.5s). Avant d'ajouter une nouvelle fonction « pixel par pixel sur une grande surface », demandez-vous si une table de correspondance ne suffit pas.
- Décodage de gros PNG : 5760×3240 complet : 10s+. Les images d'arrière-plan doivent faire ≤1500px, ou utiliser du JPEG (ne décoder que les coefficients DC, dix fois plus rapide).
- Le mode print force ss=1 : A4@ss3 mesuré à 52s.
- La mise en cache des calques statiques n'est pas rentable en pratique (IO de 40 Mo de bitmap ≈ coût de rendu),
--cache désactivé par défaut.
Polices
- Toutes les polices FZ manquent de
∂ ħ ∇ et des exposants numériques ⁻³⁵ ; les glyphes manquants sont ignorés silencieusement, pas d'erreur (les formules deviendront ψ/ t = i Hψ).
- Avant d'écrire des formules/unités, faites
fonts.missing(text, family) ; les symboles disponibles sont : ψ ∫ ≈ ∝ λ ∞ → ·.
Mise en page
hero multi-lignes nécessite une hauteur de zone ≥ nombre de lignes × hauteur de ligne, sinon cela se comprime sur le bloc suivant.
- Les proportions de
banner / card-grid / cover sont empiriques, un changement de contenu peut nécessiter un ajustement.
- Le CTA en écran large doit définir
max_width, sinon il occupe toute la ligne comme une barre de progression.
- Le texte présent dans l'image d'arrière-plan entre en conflit avec le premier plan – choisissez des images sans texte (photos, textures, illustrations).
Images
- La sortie PNG d'une image JPEG est une version DC (vignette 8×, pixelisée) ; pour une image nette, utilisez du PDF ou des images PNG.
- Le PDF intègre le JPEG sans réencodage, meilleure qualité.
- Les images sans extension sont reconnues (par signature de fichier).
Habitudes de travail
- Le cache des modules de l'outil
python est partagé entre les requêtes ; au début de chaque test, videz sys.modules de engine* / packs*.
- Séparez le répertoire de développement du répertoire d'installation ; après modification, synchronisez avec
copytree (ignorez __pycache__).
- L'échec de l'import de
objects_pack d'scene se replie silencieusement sur une version simplifiée, sans erreur.
Documentation détaillée (à lire selon les besoins)
| Fichier | Contenu |
|---|
refs/workflow.md | Dissection d'une image de référence → maquette grise → mise en couleur → texte → validation ; palettes de netteté et mesures de performance |
refs/canvas-api.md | Référence rapide Canvas / Path / geometry, solutions pour les fonctionnalités manquantes |
refs/presets.md | Toutes les dimensions, zones de sécurité, fond perdu d'impression et conversion pt |
refs/packs.md | Protocole de pack de ressources et processus de « conditionnement à la demande » |
refs/styles.md | Paramètres de style, empreintes des 6 thèmes intégrés, theme_overrides, processus pour imiter un style |
refs/analyze.md | Analyse d'une image de référence : extraction des couleurs, luminosité/obscurité, mise en page, densité → ébauche de theme |