alvici/png-to-svg

PNG vers SVG

Convertissez les PNG en véritables SVG vectoriels (chemins), et non en PNG encapsulés dans du SVG. Tous les scripts se trouvent dans le dossier scripts/ à côté de ce fichier ; exécutez-les avec le chemin complet.

Windows : utilisez python ou py -3, pas python3 (qui ouvre souvent le Microsoft Store). Préparation, rendu et problèmes courants sous Windows : references/windows.md.

Étapes de travail

1. Vérifiez le fichier source. Assurez-vous que le fichier PNG peut être ouvert. Ne convertissez pas les logos ou caractères d'autres marques, sauf si l'utilisateur en a clairement le droit.

2. Demandez la variante avant conversion. N'exécutez pas le processus de création du SVG tant que l'utilisateur n'a pas choisi la variante. Exécutez : python scripts/png2svg.py input.png --list-options

   • source_type: color → demandez s'ils souhaitent Couleur d'origine, Blanc, Noir, ou une combinaison de ces options.
   • source_type: mono → demandez s'ils souhaitent Noir, Blanc, ou les deux.

   Si l'utilisateur demande une conversion sans préciser la variante, arrêtez-vous après avoir vérifié les options et posez la question ; ne choisissez pas default simplement parce qu'aucune option n'a été donnée. Continuez après la réponse de l'utilisateur. Si l'utilisateur demande explicitement de passer directement sans question, utilisez default. Détails de chaque variante : references/variants.md.

3. Convertissez après avoir reçu le choix de l'utilisateur. Utilisez uniquement les variantes sélectionnées par l'utilisateur dans --variants, par exemple : python scripts/png2svg.py input.png out_dir --variants original,white --compare Ajoutez --icons si l'utilisateur demande des favicons ou des icônes d'application. Pour un dossier, remplacez input.png par le nom du dossier.

4. Lisez le rapport JSON. Pour chaque variante, il y a similarity_pct et audit.

   • similarity_pct ≥ 97 et audit.verdict = ok → terminé.
   • Sinon, ajustez --colors ou --speckle selon references/tuning.md, avec un maximum de 3 tentatives.
   • similarity_pct: null signifie qu'aucun rendu n'est disponible : le résultat est quand même produit, mentionnez que la vérification visuelle est ignorée.
   • Si vous pouvez voir l'image, ouvrez *_compare.png (gauche = cible, droite = résultat).

5. Remettez le résultat. Fournissez les fichiers SVG par variante (et le dossier icons/ si demandé) avec un résumé court : méthode, similarité, taille, et notes issues de notes ou audit.issues.

Règles

• Ne modifiez jamais le fichier original ; écrivez toujours dans le dossier de sortie.
• Les variantes blanc/noir sont des silhouettes monochromes. Les détails de couleur à l'intérieur des formes se fondent ; mentionnez-le à l'utilisateur si le logo a de tels détails.
• Scripts supplémentaires : scripts/svg_audit.py (audit de n'importe quel SVG), scripts/render.py --which (vérifier les rendus disponibles), scripts/variants.py (variantes à partir d'un SVG existant).
• Intégration des cases à cocher dans le tableau de bord AION : references/aion-integration.md.