Selector
Outil de sélection de maillage dans un fichier LDraw

Mise à jour de la page : 29 mars 2014.

L'utilitaire Selector permet de sélectionner les éléments de surface d'un maillage dans un fichier LDraw, en étendant la sélection d'une ou plusieurs surfaces prédéfinies par leur couleur clef à ses voisines. Cette expansion peut s'arrêter suivant divers critères, en rencontrant une ligne de bord, ou un angle plus prononcé, ou à tous les éléments connectés. Les lignes de bords et les lignes conditionnelles entourant ou bordant la sélection peuvent également être sélectionnées. La sélection est faite en changeant la couleur des éléments par une couleur clef. Facultativement, la sélection peut être déplacée à la fin du fichier de sortie.

C'est une simple application en ligne de commande. Le code source est fourni ci-dessous, pour celui qui voudrait l'intégrer dans une interface plus conviviale. Il est possible de l'utiliser sous Windows, grâce à l'interface LETGUI de Michael Heidemann, ce qui est hautement recommandé (voir plus bas).

Téléchargement

Selector package

Historique du programme

V1.0 : 17 décembre 2012, version initiale.
V1.1 : 20 février 2013, ajout des options -m, -b, -d et -d+.
V1.2 : 6 mars 2014, corrigé bug option -d et -d+ avec -m implicite, les lignes conditionnelles en bordure ne sont plus sélectionnées avec l'option -b, les lignes conditionnelles et les lignes de bord sont maintenant triées séparément lorsque l'option -s est spécifiée.

Installation

Décompressez le fichier et mettez le programme dans un simple dossier, comme vos autres utilitaires LDraw.
Exemple : c:\lego\selector

Utilisation

Le fichier d'entrée doit être un fichier au format LDraw valide. Selector traite uniquement les éléments de surfaces et de lignes (lignes du fichier LDraw de type 2, 3, 4 ou 5). Les lignes de fichier LDraw d'autres types sont ignorées, incluant les sous-fichiers et primitives (Selector vise principalement les maillages en provenance de LDD ou d'autres outils 3D).
Ouvrez une fenêtre "Invite de commandes" (ex fenêtre Dos), et allez dans le dossier contenant le programme et le fichier d'entrée.
Tapez la ligne de commande : selector [options] LdrawFile LdrawFileOut. Selector créera LdrawFileOut, contenant le fichier LDraw avec les faces adjacentes à celle ayant la couleur prédéfinie. Nota : Si le fichier LdrawFileOut existe, il est écrasé sans message d'erreur.

Voici une copie d'écran d'une simple exécution du programme :

Liste des options

-p <val> : Tolérance de continuité entre les faces (0.001 par défaut).
-k <val> : Couleur clef (5 par défaut (rose foncé)).
-c <val> : Couleur pour les lignes bordant la couleur clef (la couleur clef par défaut).
-b : Ne sélectionne pas les lignes bordant la couleur clef.
-s : Tri les éléments de la couleur clef à la fin du fichier.
-d : Enlève la couleur des éléments ayant la couleur clef (option -s nécessaire).
-d+ : Enlève la couleur de tout le fichier (option -s nécessaire).
-x- : N'étend pas la surface de la couleur clef.
-xl : Etend la surface de la couleur clef, jusqu'aux lignes de bord servant de frontière (par défaut).
-x+ : Etend la surface de la couleur clef, à toutes les faces adjacentes.
-a <val> : N'étend pas la surface de la couleur clef si l'angle entre deux faces est > à val.
-m : Ne limite pas l'extension aux faces ayant le couleur principale (couleur 16).

Intégration de Selector dans LETGUI

Il est possible de lancer Selector à partir d'une interface plus conviviale que la ligne de commande. LETGUI crée par Michael Heidemann est fait pour cela.

Utilisation de l'interface

Sélectionnez "Selector" dans le menu déroulant "Tool".
Entrez le chemin d'accès à l'utilitaire Selector, si cela n'a pas été configuré, dans le champ "Selector".
Entrez le nom du fichier d'entrée avec son chemin, dans le champ "Inputfile", ou le sélectionner avec le bouton . Ce fichier peut être visualisé en cliquant sur le bouton , ou édité avec le bouton
Entrez le nom du fichier de sortie, ou gardez celui défini automatiquement, dans le champ "Outputfile".
Modifiez, si besoin les valeurs des options -p (precision), -k (key color) et -c (bording key color).
Cochez, si besoin l'option de non sélection des lignes de bord -b (don't select bordering edge lines).
Cochez, si besoin l'option de tri -s (Sort ... to the end of file).
Cochez, si besoin l'option -d pour décolorer les éléments sélectionnés (Uncolor selected elements) ou -d+ pour tout le fichier (Uncolor whole file).
Cochez, si besoin les options de l'étendue de la sélection -x- (Don't expend), -xl (Expand edge line), -x+ (Expand neighbour), -a (Expand angle) en modifiant si besoin l'angle de cette dernière option et -m (Regardless of color).
Exécutez la commande en cliquant sur le bouton .

Pour plus d'informations générales sur cette interface, allez sur la page LETGUI.

Comment Selector travaille

Le fichier d'entrée et lu, analysé et stocké dans un tableau.
Sauf si l'option -x- est spécifié (pas d'extension de la couleur clef), le tableau est parcouru pour trouver des faces (triangles ou quadrilatères) adjacentes à celles ayant la couleur clef. Ces faces adjacentes sont colorées avec la couleur clef, si elles ont la couleur principale (couleur 16). Ce processus est répété tant que des faces sont colorées. Cette méthode est extrêmement inefficace, mais paraît assez rapide même avec des fichiers LDraw énormes... Pour permettre l'extension aux faces ayant une couleur différente de la couleur 16 utilisez l'option -m.
Cette coloration de faces est limitée par défaut à la rencontre de lignes de bords (option -xl). Si les éléments initiaux ayant la couleur clef sont placés dans une zone complètement entourée par des lignes de bord (attention aux fuites !), cette zone sera entièrement sélectionnée. Ou bien, vous pouvez spécifier l'option -x+. Dans ce cas, touts les éléments connectés seront sélectionnés (Les "éléments connectés" sont les faces qui partagent un bord commun). L'expansion peut aussi être limitée par une cassure angulaire définie avec les faces voisines. C'est spécifié avec l'option -a <angle>. Alors toutes les jonctions de faces qui ont un angle supérieur servent de frontière à l'extension. Notez que l'ajustement de la valeur de cet angle pour sélectionner ce que vous avez besoin peut être difficile ou impossible. -xl et -a peuvent être utilisés ensemble pour que l'extension soit limitée à la fois par des lignes de bords et par un angle.
Après extension, le tableau est de nouveau parcouru pour trouver des lignes (lignes de bord et lignes conditionnelles). Toutes les lignes qui bordent un élément ayant la couleur clef sont colorées. Facultativement, si l'option -c <couleur> est spécifié, les lignes qui ont une face colorée sur un seul côté sont colorés en utilisant cette couleur à la place de la couleur clef. Les lignes de bord (~~pas les lignes conditionnelles !~~ (v1.1) et les lignes conditionnelles (v1.2) ), peuvent également être omises de la sélection avec l'option -b.
Si l'option -s est utilisée, tous les éléments ayant la couleur clef sont groupés à la fin du fichier. Les éléments en bordure (si l'option -c <couleur> est utilisée) viennent en premier précédés par les lignes de commentaire : 0 // Bordering edge lines (lignes de bord) puis 0 // Bordering condlines (lignes conditionnelles en bordure). Vient ensuite le reste des éléments sélectionnés précédés par les lignes de commentaire : 0 // Key Colored edge lines (lignes de bord de la couleur clef), puis 0 // Key Colored condlines (lignes conditionnelles de la couleur clef), et enfin 0 // Key colored elements (éléments de la couleur clef).
L'option -d permet de redonner à tous les éléments sélectionnés leur état non coloré (faces en couleur principale 16, et lignes en couleur de bord 24). L'option -d+ va à une étape plus loin, et redonne l'état non coloré à tout le fichier. Bien sur, ces options peuvent être utilisées seulement si l'option -s est spécifiée, sinon tout le processus de sélection serait inutile ;)
L'option -p <valeur> contrôle la distance maximum entre deux points que Selector considère comme commun.
Le fichier de sortie est écrit.

Exemples

	Les exemples suivants sont basés sur ce maillage, une capture 3D de la pièce 2421 de LDD. Ce maillage est composé de 4 zones non connectés, la barre, le support de barre, la brique, et le tenon. Quelques triangles dans chaque zone ont été colorés en utilisant MLCad.
	En utilisant les options par défaut, la partie cylindrique de la barre est sélectionné, puisque le fichier source contenait 1 triangle rose foncé (couleur clef par défaut). Les lignes de bord bordant cette zone sont aussi sélectionnées. Ligne de commande : Selector 2921.dat sel1.dat
	Comme vous pouvez le voir, les lignes conditionnelles du cylindre sont également sélectionnées.
	Si l'option -x+ est utilisée, la barre en entier est sélectionnée. Les zones non connectées (pas de bord commun) ne sont pas sélectionnés. Ligne de commande : Selector -x+ 2921.dat sel2.dat
	Dans les modèles LDD (comme également beaucoup de modèles LDraw !), les tenons sont simplement posés sur la surface supérieure, et non connectés avec elle. Lorsque vous adaptez le maillage 3D de LDD au standard LDraw, les tenons ont besoin d'être substitués par des primitives. Sélectionner les tenons est facile, il suffit de colorer un triangle (ici en rouge) sur chaque tenon, d'utiliser l'option -x+, et tous les éléments de tenons LDD (y compris lignes de bord et lignes conditionnelles) peuvent être sélectionnés et supprimés en une fois ! Ligne de commande : Selector -x+ -k 4 2921.dat sel3.dat
	Lorsque la pièce contient beaucoup de tenons (comme sur les plaques de base), colorer un triangle sur chaque tenon peut être fastidieux ! Dans ce cas, il est plus simple de travailler à l'envers, en colorant un élément de chaque zone qui n'est pas un tenon. Ici je veux sélectionner toutes les zones vertes, tout en utilisant l'option -s pour grouper les éléments sélectionnés à la fin du fichier. Comme ouvrir un fichier énorme dans MLCad peut être très lent (une plaque de base LDD peut avoir un fichier de plusieurs Mo), il est plus rapide d'utiliser un éditeur de texte pour supprimer les tenons ! Ligne de commande : Selector -x+ -k 2 -s 2921.dat sel4.dat
	Ici nous voyons l'usage du paramètre couleur de l'option -c. Les lignes de bord limitant la zone sélectionnée sont maintenant colorées différemment, permettant de les sélectionner spécifiquement. Ligne de commande : Selector -c 1 2921.dat sel5.dat
	Voici est un exemple montrant la sélection avec une limite d'angle (exemple et image de J.C. Tchang). En limitant l'expansion des surfaces à un angle de 30°, nous sommes capables de sélectionner la face latérale de cette tête de vache d'un modèle LDD. Ligne de commande : Selector -a 30 64780.dat 64780b.dat
	Voici est un autre scénario de sélection, avec la pièce 98585 en provenance de LDD. Nous avons besoin de supprimer les trous de cheville et les trous d'axe, qui seront remplacés par des primitives. Comme il y a beaucoup de zones séparées par des lignes de bord dans les trous d'axe, il peut être fastidieux de colorer un triangle dans chaque zone. Nous allons donc utiliser une méthode un peu tordue pour simplifier les choses... La première étape est de créer une barrière à la sélection au fond et devant la pièce pour "isoler" les trous. Le fichier 98585a.dat est le quart de la pièce (créé à partir du fichier de maillage LDD en utilisant le programme Symsplitter). Un triangle du fond (z+) et un triangle de la face avant (z-) sont colorés en bleu (couleur clef = 1).
	Nous étendons les zones bleues... Ligne de commande : Selector -k 1 98585a.dat 98585b.dat
	En utilisant MLCad, nous colorons en rose foncé un élément de chaque trou. Il en résulte le fichier 64780c.dat.
	Maintenant, nous étendons les zones rose foncé (couleur clef par défaut) à tous les éléments connectés (option -x+). L'extension s'arrête lorsqu'elle rencontre une face qui n'est pas en couleur principale (couleur 16), donc les zones bleues ne sont pas sélectionnées. Naturellement, puisque nous avons trié ici les éléments avec l'option -s nous aurions pu utiliser l'option -d+ pour remettre tous les éléments à leur état non coloré, mais l'image ci-contre est plus explicite sans cela... Ligne de commande : Selector -x+ -s 98585c.dat 98585d.dat
	Nous enlevons maintenant, dans le fichier 98585d.dat, les lignes après 0 // Key colored elements, en utilisant LDDP ou MLCad. Ici le résultat dans le fichier 98585e.dat. Les éléments des trous sont complètement supprimés, en incluant les lignes conditionnelles (toujours difficiles à enlever manuellement).