CommunityImagegithub.com

poster

Dessinez des affiches et des visuels promotionnels en Python pur : affiche simple page, infographie longue, couverture, bannière, carte de connaissances, page de comparaison, certificat, roll-up. Déclaratif « squelette + blocs + thème » ou dessin libre avec Canvas ; sortie PNG / SVG / PDF, aucune dépendance externe (sauf fontTools) pour le rendu local.

Qu'est-ce que poster ?

Ce skill permet de générer des affiches et des visuels promotionnels en pur Python, sans aucune dépendance externe lourde (seulement fontTools). Il offre trois modes d'utilisation : A) modèle prêt à l'emploi (modifier un fichier content.json), B) assemblage déclaratif (squelette + blocs + paramètres), C) dessin libre avec l'API Canvas. Le rendu produit du PNG, du SVG ou du PDF vectoriel (texte vectorisé). Le skill est conçu pour un style géométrique et vectoriel, ne génère pas de photographies ni d'illustrations réalistes. Il intègre des vérifications automatiques (débordement, contraste, tailles de police, polices manquantes) et des thèmes prédéfinis. Il est optimisé pour les performances (LUT pour la transparence, niveau zlib 6, etc.). Il est recommandé de vider le cache des modules entre les appels pour éviter les problèmes de partage de modules entre requêtes.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KongBai-lab/dsh-skill-poster/tree/main

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

poster : Affiche / Visuel promotionnel

Limites (à lire en premier)

BesoinUtiliser
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 / panneauCe skill
Présentation multi-diaposmake-ppt
Document avec formulesmd2docx

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

  1. 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 ».
  2. 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.
  3. 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]
  4. 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.
  5. 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

ModeEntréeUtilisation
A. ModèleCopier templates/*/, ne modifier que content.jsonAffiches classiques (80 % des cas)
B. AssemblageÉcrire layout.json (squelette + liste de blocs + paramètres)Structure à modifier, éléments standard
C. Dessin libreengine.canvas.Canvas pour dessiner directementImiter 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

# Générer une image (mode aperçu par défaut)
python -m engine.render templates/minimal-poster/layout.json -o out.png

# Version imprimable : PDF vectoriel A4 (texte non sélectionnable)
python -m engine.render templates/minimal-poster/layout.json -o out.pdf \
       --preset a4-portrait --for print

# Changer de thème / de taille
python -m engine.render ... --theme guofeng --preset xhs-3x4

# Lister les préréglages / squelettes / blocs disponibles
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

BoutonValeurDescription
presetxhs-3x4 / sq-1x1 / story-9x16 / wechat-cover / video-16x9 / info-long / a4-portrait / a3-portrait / rollup-85x200Dimensions et zones de sécurité
--fordraft / preview / publish / printNetteté et sortie (voir refs/workflow.md)
--formatpng / pdf / svgDéfaut : print→pdf, sinon png
--deco0/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)

FichierContenu
refs/workflow.mdDissection d'une image de référence → maquette grise → mise en couleur → texte → validation ; palettes de netteté et mesures de performance
refs/canvas-api.mdRéférence rapide Canvas / Path / geometry, solutions pour les fonctionnalités manquantes
refs/presets.mdToutes les dimensions, zones de sécurité, fond perdu d'impression et conversion pt
refs/packs.mdProtocole de pack de ressources et processus de « conditionnement à la demande »
refs/styles.mdParamètres de style, empreintes des 6 thèmes intégrés, theme_overrides, processus pour imiter un style
refs/analyze.mdAnalyse d'une image de référence : extraction des couleurs, luminosité/obscurité, mise en page, densité → ébauche de theme

Skills associés