StarVector : un modèle de base pour générer des graphiques vectoriels SVG à partir d'images et de textes

Introduction générale

StarVector est un projet open source créé par des développeurs tels que Juan A. Rodriguez pour convertir des images et du texte en Scalable Vector Graphics (SVG). Cet outil utilise un modèle de langage visuel qui comprend le contenu des images et les instructions textuelles pour générer un code SVG de haute qualité. StarVector est entraîné sur l'ensemble de données SVG-Stack, qui contient plus de 2 millions d'échantillons SVG réels, ce qui garantit des résultats précis et variés. Le projet est actuellement soutenu par ServiceNow Research et Mila, entre autres, et a été mis à jour pour la dernière fois en mars 2025.

Liste des fonctions

• Génération de SVG à partir d'une image : saisie d'une image pixellisée et génération du code graphique vectoriel correspondant.
• Générer des SVG à partir d'un texte : créer de nouveaux graphiques SVG à partir de descriptions textuelles.
• Prise en charge d'un large éventail d'éléments graphiques : les éléments de base du SVG tels que les chemins, les ellipses, les polygones et le texte.
• Vectorisation de haute précision : les SVG résultants conservent les détails et sont adaptés à une utilisation en zoom avant.
• Open source et gratuité : le code est ouvert au public, les utilisateurs peuvent le télécharger et le modifier librement.

Utiliser l'aide

L'utilisation de StarVector nécessite quelques connaissances techniques car il s'agit d'un projet basé sur le code. Vous trouverez ci-dessous les étapes détaillées de l'installation et de l'utilisation pour aider les utilisateurs à démarrer rapidement.

Processus d'installation

1. Préparation de l'environnement
   • Assurez-vous que Python 3.11.3 est installé sur votre ordinateur. Vous pouvez vérifier la version avec la commande :

     python --version
     

   • Si ce n'est pas le cas, téléchargez et installez le logiciel à partir de https://www.python.org.
   • Installez Git pour télécharger le code de GitHub. Télécharger à l'adresse https://git-scm.com.
2. Créer un environnement virtuel
   • Ouvrez un terminal et tapez la commande suivante pour créer un nouvel environnement Python :

     conda create -n starvector python=3.11.3 -y
     

   • Activer l'environnement :

     conda activate starvector
     

3. Télécharger StarVector Code
   • Saisissez-le dans le terminal :

     git clone https://github.com/joanrod/star-vector.git
     

   • Allez dans le dossier du projet :

     cd star-vector
     

4. Installation des dépendances
   • Mettre à jour pip et installer les bibliothèques nécessaires :

     pip install --upgrade pip
     pip install -e .
     

   • Ceci installera tous les paquets Python nécessaires au fonctionnement de StarVector.
5. Définition des variables d'environnement
   • Les variables suivantes doivent être configurées si vous souhaitez entraîner le modèle ou utiliser des fonctions avancées :

     export HF_HOME=<模型存储路径>
     export HF_TOKEN=<你的 Hugging Face 令牌>
     export WANDB_API_KEY=<你的 Weights & Biases 令牌>
     export OUTPUT_DIR=<输出路径>
     

   • Elles peuvent être saisies dans le terminal ou écrites dans le fichier de configuration de l'environnement.

Utilisation

Générer des SVG à partir d'images

1. Préparer l'image
   • Sélectionnez une icône, un logo ou une image de diagramme technique à enregistrer dans un format courant (tel que PNG ou JPG).
   • Remarque : StarVector ne convient pas pour travailler avec des paysages naturels ou des illustrations complexes, il est préférable d'utiliser des graphiques simples.
2. code en cours d'exécution
   • Placez l'image dans le dossier du projet et tapez-la dans le terminal :

     python scripts/image_to_svg.py --input <图像路径> --output <输出SVG路径>
     

   • Par exemple :

     python scripts/image_to_svg.py --input icon.png --output icon.svg
     

3. Voir les résultats
   • Le fichier SVG généré est enregistré dans le chemin spécifié. Il peut être ouvert pour inspection à l'aide d'un navigateur ou d'un logiciel de graphisme vectoriel (par exemple Inkscape).

Générer un SVG à partir d'un texte

1. Saisir des commandes de texte
   • Ouvrez un terminal et exécutez le script de génération de texte :

     python scripts/text_to_svg.py --text "一个红色圆形" --output circle.svg
     

   • Soyez aussi précis que possible, par exemple "une étoile noire à cinq branches" ou "une boîte rectangulaire bleue".
2. Vérifier la sortie
   • Le fichier SVG généré sera sauvegardé dans le chemin spécifié, ouvrez-le pour voir s'il répond aux attentes.

Fonctionnalités avancées : Modèles de formation

• Si vous souhaitez entraîner le modèle vous-même, vous pouvez utiliser l'ensemble de données SVG-Stack.
• Exécutez la commande d'entraînement (StarVector-1B par exemple) :

deepspeed scripts/train.py --data_path <SVG-Stack路径> --output_dir <输出路径>

• Remarque : la formation nécessite un ordinateur de configuration supérieure et peut nécessiter la prise en charge du GPU.

compétence opérationnelle

• ajuster les composants pendant les essaisSi les résultats générés ne sont pas satisfaisants, vérifiez si l'image d'entrée est trop complexe ou si la description du texte est claire.
• personnalisationLes paramètres peuvent être ajustés dans le code, par exemple en augmentant le nombre d'échantillons pour améliorer la précision.
• Voir le documentLe fichier README.md dans le répertoire racine du projet contient plus d'instructions, il est donc recommandé de le lire attentivement.

En suivant ces étapes, vous pouvez facilement générer des fichiers SVG à partir d'images ou de texte. Le processus d'installation prend environ 10 à 20 minutes et il est facile à utiliser. Il convient donc aux concepteurs ou aux développeurs ayant des compétences de base en programmation.

scénario d'application

1. Conception d'icônes
   Les concepteurs peuvent utiliser StarVector pour convertir rapidement des croquis en icônes vectorielles, ce qui leur permet de gagner du temps sur le traçage manuel.
2. document technique
   Les ingénieurs peuvent l'utiliser pour générer des diagrammes ou des organigrammes qui peuvent être intégrés directement dans des documents ou des pages web.
3. Démonstrations pédagogiques
   Les enseignants peuvent créer des graphiques pédagogiques avec des descriptions textuelles pour démontrer visuellement les concepts.
4. développement web
   Les développeurs peuvent l'utiliser pour créer rapidement des éléments web zoomables et augmenter la vitesse de chargement.

QA

1. StarVector peut-il traiter des photos ?
   Ne peut pas. Il est conçu pour les icônes, les logos et les diagrammes techniques et ne convient pas aux images naturelles ou aux illustrations complexes.
2. Dois-je payer ?
   StarVector est un projet open source dont le code et les fonctionnalités de base sont libres d'utilisation.
3. Le SVG généré peut-il être modifié ?
   Oui. Les SVG générés sont dans un format standard et peuvent être édités dans Inkscape ou Illustrator.
4. Que se passe-t-il si l'installation échoue ?
   Vérifiez que la version de Python est correcte, assurez-vous que votre connexion réseau fonctionne, ou recherchez les messages d'erreur du terminal.