img2sticker

J.C. Tchang

Voir l'annonce en Anglais de Timothy Gould sur Lugnet

Cet utilitaire permet de générer automatiquement le fichier LDraw vectoriel d'un autocollant (sticker) à partir d'une image ou d'une photo. Cet autocollant pouvant être ensuite incorporé dans un modèle LDraw.

Téléchargement

• Le programme img2sticker :
  img2sticker-install.zip Version 0.9 (141 Ko).
• L'environnement PERL pour Windows :
  Page ActivePerl, et téléchargez le fichier .msi en cliquant sur le bouton correspondant à votre version Windows Download ActivePerl ... (ActivePerl-5.12.3.1204-MSWin32-x86-294330.msi = 24.5 Mo).

Installation

• En pré-requis l'environnement LDraw doit être installé sur votre ordinateur (voir www.ldraw.org).
• Installez l'environnement PERL en double-cliquant sur le fichier .msi, et répondez aux questions d'usage (en Anglais).
• Décompressez le fichier img2sticker-install.zip, et mettez le résultat dans un dossier comme C:/LEGO/img2sticker par exemple.
• Copiez le fichier ldraw.pal de ce dossier dans le dossier d'installation de LDraw (par exemple : C:/LEGO/ldraw).
• Créez une variable d'environnement LDRAWDIR définissant le chemin vers le dossier LDraw.
  Pour cela :
  - Allez dans le Panneau de configuration / Système et maintenance / Système.
  - Cliquez dans la fenêtre sur "Modifier les paramètres", et confirmer si besoin pour être administrateur (Merci Vista).
  - Sur l'onglet "Paramètres système avancés", cliquez sur "Variables d'environnement".
  - Sous "Variables utilisateur" cliquez sur "Nouvelle..." et créez la variable LDRAWDIR avec comme valeur le chemin du dossier de LDraw (par exemple : C:/LEGO/ldraw), puis validez.
• Redémarrez le PC.

Usage du programme img2sticker

• Lancez une fenêtre "Invite de commande" (ex mode DOS).
• Se mettre dans le dossier d'installation de img2sticker. Exemple : cd c:\lego\img2sticker.
• Lancez la commande suivant le format : img2sticker.pl [options] INFILE [OUTFILE].

Exemple d'exécution du programme :

Description des paramètres et options

• INFILE : Fichier d'entrée, avec son extension, d'une image BMP (non compressée, en 8 ou 24 bits soit 256 ou 16,8 millions de couleurs) ou RGB.
• OUTFILE : Fichier de sortie généré au format LDraw (.DAT ou .LDR). Si le nom n'est pas spécifié la sortie se fait sur STDOUT (écran par défaut).
• -help : Montre la liste des options.
• -version : Montre le numéro de version et le copyright.
• -lduwidth=F : Largeur de l'autocollant en LDU (valeur par défaut = 40 LDU = 2 briques élémentaires).
  Nota : La hauteur de l'autocollant est calculée à partir de la largeur pour garder les proportions de l'image fournie en entrée.
• -ldudepth=F : Epaisseur de l'autocollant en LDU (valeur par défaut = 0.25 LDU).
• -width=I, -height=I : Largeur et hauteur de l'image RGB en pixels. Nécessaire si le fichier d'entrée est un fichier RGB, sinon ces options sont ignorées.
• -devthresh=F : Tolérance de création des sommets des polygones. De grandes valeurs créent des bords rugueux, et de petites valeurs créent des bords plus lisses mais en conséquence génère plus de polygones. (valeur par défaut : 0.3).
• -maxlength=I : Nombre maximum de lignes de bords (1 à 2 fois le nombre de pixels) convertissables en vecteur (valeur par défaut : 20).
• -pallette=CSV : Liste des couleurs séparées par une virgule (pas d'espace) de la palette LDraw contenue dans l'autocollant. Seules les couleurs spécifiées dans le fichier ldraw.pal sont utilisables. Ce fichier peut être modifié selon besoin. Couleurs par défaut : 0,1,4,7,14,15.
• -transcolour=I : Numéro de la couleur affectée comme transparente. Mettre -1 pour pas de transparence. Valeur par défaut : 15 (blanc).
• -backcolour=I : Numéro de la couleur du fond de l'autocollant (Extérieur du motif, cotés et dessous de l'autocollant). Mettre à -1 pour ne pas avoir de fond. Valeur par défaut : 15 (blanc).
• -povpng[=S] : Spécifie un fichier PNG alternatif à utiliser par POV-Ray. Si le nom du fichier n'est pas fourni avec l'option le nom sera inname.png lorsque le fichier d'entrée est inname.bmp.
  Sans l'option, le fichier alternatif devra être inséré dans le fichier.

Exemple :
img2sticker.pl -pallette=4,15 -lduwidth=80 -povpng the_ghan_logo2.bmp

L'image the_ghan_logo2.bmp est traitée et n'utilise que 2 couleurs : 4 (rouge) et 15 (blanc). La sortie se fait à l'écran (STDOUT) pour un autocollant de 80 LDU de large avec un fichier POV alternatif.

Tutoriel

1. Trouvez une image convenable Trouvez une image montrant clairement le logo à reproduire. Ici nous devons l'extraire de cette photo, mais souvent on trouve directement le logo dans un fichier déjà préparé.
2. Tailler à la dimension Puisque nous ne voulons pas convertir la photo en entier pour faire l'autocollant, coupons, sur une copie de la photo originale, la zone utile à convertir. Cela peut inclure les textes qui se trouvent à droite et à gauche, mais img2sticker ne traitant pas correctement les caractères il vaut mieux utiliser d'autres utilitaires spécialisés comme txt2dat pour cela. A cette étape, il peut également être nécessaire de "redresser" l'image si elle n'est pas droite.	(Cliquez sur l'image pour l'avoir à l'échelle 1)
3. Diminuer le nombre de couleurs Pour supprimer les dégradés de couleurs dans chaque zone, et obtenir des zones monochromes il suffit généralement de diminuer le nombre de couleurs avec votre programme d'imagerie habituel. Ici l'autocollant n'a besoin que de 2 couleurs (rouge et blanc) et donc on peut réduire les couleurs du fichier à 2. Dans d'autres cas il sera nécessaire de réduire à 16 ou 256 couleurs.
4. La corvée : Nettoyer C'est l'étape la plus laborieuse du processus, si la diminution du nombre de couleur n'a pas permis d'avoir des aplats monochromes. Vous devrez ajuster manuellement les couleurs proches dues souvent à l'anticrénelage (anti-aliasing), effacer les défauts (taches), rectifier certains bords droits ou lisser des bords courbes.
5. Conversion S'assurer de sauvegarder en final votre fichier image au format BMP non compressé (uncompressed), avec 256 couleurs ou en true-colour. Tous les éditeurs d'image savent en principe faire cela. Important : Si vous obtenez un résultat TOUT NOIR avec img2sticker, c'est que vous n'avez pas respecté le format de l'image (16 couleurs, 32K couleurs, fichier BMP compressée, autre format : .GIF, .JPG, ...).

6. Choisissez votre palette LDraw

Un bon choix de la palette LDraw permettra une exécution rapide de img2sticker, et un meilleur résultat. Dans notre exemple une palette de rouge et de blanc suffira (-palette=4,15).

7. Inverser la transparence ?

img2sticker permet de contrôler la transparence et la couleur de fond. Souvent celles-ci ont la même valeur afin que l'autocollant affiche un motif coloré sur une boite monochrome.

Dans notre exemple, il serait naturel de choisir comme couleur de transparence/fond le rouge (couleur LDraw 4). Cependant, cela occasionne toutes sortes de problèmes et, pour être franc, le résultat ne sera pas bon. Par contre, si nous choisissons le blanc (couleur LDraw 15) comme couleur de transparence/fond tout est correct.

Pourquoi ? Si vous regardez le code source de img2sticker vous pourrez remarquer qu'il y a une section consacrée aux trous. Les trous sont difficiles à traiter et parfois peuvent générer des choses incorrectes. En inversant les couleurs nous allons traiter uniquement les parties rouges qui ne contiennent pas de trous.

8. Lancement de img2sticker.pl

Supposons que la dernière image de notre exemple soit : ghanlogo.bmp. Pour générer l'autocollant ghansticker.ldr vous devez lancer la commande :

img2sticker.pl ghanlogo.bmp ghansticker.ldr -pallette=4,15 -transcolour=15 -backcolour=15

Une option supplémentaire que nous pourrions vouloir utiliser ici est : -povpng afin que si nous voulons convertir ultérieurement notre fichier .LDR en fichier .POV pour le programme de rendu POV-Ray grâce à l'utilitaire l3p il utilise le premier fichier avant traitement (step1.png).
La commande devient :

img2sticker.pl ghanlogo.bmp ghansticker.ldr -pallette=4,15 -transcolour=15 -backcolour=15 -povpng=step1.png

Et, dans le code du fichier .LDR se trouve maintenant l'usage du fichier step1.png comme affichage alternatif de l'autocollant lors de la conversion en fichier .POV.

9. Pour aller plus loin

Il y a d'autres options disponibles dans img2sticker.pl. Voir ci-dessus au chapitre "Description des paramètres et options", ou tapez la commande suivante pour en avoir la liste (en Anglais) :

img2sticker.pl -help

Fonctionnalités

Commentaires de J.C. Tchang : Dans l'état actuel des choses (version 0.9) le programme peut encore être considéré "en développement". Voici les fonctionnalités que j'ai testées :

• L'image doit être traitée soigneusement avant d'être utilisée (format, diminutions des couleurs, suppression de l'anticrénelage).
• Le support de l'autocollant est crée avec 5 faces non BFC. A faire évoluer vers la primitive box5-11.dat.
• Le fond du motif de l'autocollant (face supérieure du support) n'est pas calculé mais simulé par 1 seul quadrilatère positionné à Y-0.225 (par défaut).
• La couleur noire (0) n'est pas traitée et si utilisée remplacée par le couleur bleue (1).
• Comme indiqué par l'auteur du programme, le calcul des trous est très peu fonctionnel.
• Le calcul des bords du motif est également très approximatif.

Conclusion : Ce programme est une très bonne idée, et le seul premier, à ma connaissance, a créer des autocollants vectoriels de façon automatique. Mais dans la pratique le résultat doit être repris pour avoir une pièce valide à soumettre à "Parts Tracker" de LDraw.org. Le temps de traitement de l'image, plus le temps de reprise du résultat me semble supérieur au temps de création avec un programme interactif comme Quad2Dat. En conclusion il est inutilisable en l'état, mais l'idée est excellente et si le programme pouvait être amélioré, cette solution serait parfaite.

Droits et Copyright

Le programme img2sticker, et son tutoriel avec l'exemple "The Ghan" appartient à Timothy Gould.

Traduction et adaptation de ce manuel : J.C. Tchang.