Coverer

J.C. Tchang

Original Version On Philo's Site.

Coverer est un programme générateur de faces LDraw, écrit par Philo (Philippe Hurbain).

Coverer est un utilitaire créant des faces réglées, composées de facettes triangulaires et quadrangulaires entre deux chemins formés de lignes. Chaque chemin doit être fourni à l'utilitaire dans un fichier LDraw séparé. Un troisième fichier contenant les facettes, et les lignes conditionnelles générées, est crée.

C'est une simple procédure de commande, dont le code source est fourni avec le programme ci-dessous, pour celui qui veut l'intégrer dans une interface plus conviviale.

Vous pouvez également utiliser Coverer sous Windows, grâce à l'interface graphique LETGUI de Michael Heidemann, ce qui vous est même fortement recommandé ! (voir plus bas).

Téléchargement

Sur le site de l'auteur : Coverer package, incluant le programme pour Windows, Mac et Linux, la documentation, les fichiers source (Visual C++ 6.0), et des fichiers exemples.

Nota : Version Linux courtoisement fourni par Mufti.
Nota : Version Macintosh (binaire universel) courtoisement fourni par Jim DeVona.

Historique

• V1.0 : Décembre 2007.
• Version Initiale.
• V1.1 : Juillet 2008.
  • Corrigé un bug, qui parfois créait une ligne conditionnelle supplémentaire et erronée.
  • Amélioré le format du fichier de sortie.
  • Ajouté l'option -b.
• V1.2 : Juillet 2008.
  • Corrigé un bug, qui amenait à générer des quadrilatères concaves.
• V1.3 : Juillet 2011.
  • Ajouté un nouvel algorithme par défaut qui donne généralement de meilleurs résultats. L'ancien algorithme est toujours disponible avec l'option -s.
  • L'angle limite pour la conversion en quadrilatère est maintenant ramené à 1°.

Utilisation

• Préparez les fichiers d'entrée LDraw. Coverer utilise uniquement des lignes dans ces fichiers (lignes type 2). Les autres types d'entités sont ignorés. Si vous voulez calculer une face entre deux bords composés de primitives, vous devez d'abord les décomposer en lignes de type 2 (Inlined). LDDesignPad fait cela très facilement.
• Ouvrez une fenêtre "Invite de commandes", et allez dans le dossier d'installation de Coverer.
• Tapez la ligne de commande :
  coverer [-r] [-s] [-l <length>] [-b <bias>] LdrawLineFile1 LdrawLineFile2 LdrawSurfaceFileOut.
  Coverer crée alors le fichier LdrawSurfaceFileOut contenant les facettes. Notez que si le fichier LdrawSurfaceFileOut existe déjà, il est écrasé sans message d'attention. -r, -s, -l et -b sont des paramètres optionnels contrôlant le comportement de Coverer. Ces options sont détaillées plus bas.
• Coverer écrit les valeurs dans le fichier de sortie avec 6 chiffres après la virgule. Cette précision est excessive pour la plupart des usages, et ces valeurs peuvent être arrondies. Ici encore LDDesignPad fait cela très bien.

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

Utilisation sur chemins multiples

Pour utiliser Coverer sur des chemins multiples, il faut employer une astuce :

- Lancer Coverer avec les fichiers à chemins multiples.
- Puis supprimer le premier chemin trouvé dans ces fichiers.
- Recommencer jusqu'à ce qu'il n'y ait plus de chemin.
- Assembler les différents fichiers intermédiaires.

Sinon, si les chemins sont identiques (lignes de projection parallèles) il est préférable d'utiliser Ytruder.

Intégration de Coverer dans LETGUI

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

Utilisation de l'interface

• Sélectionner "Coverer" dans le menu déroulant "Tool".
• Entrer le chemin d'accès à l'utilitaire Coverer, si cela n'a pas été configuré, dans le champ "Coverer".
• Entrer le nom du premier fichier d'entrée avec son chemin, dans le champ "Input1", ou le sélectionner avec le bouton . Ce fichier peut être visualisé en cliquant sur le bouton , ou édité avec le bouton
• Entrer le nom du second fichier d'entrée avec son chemin, dans le champ "Input2", comme ci-dessus.
• Le bouton "SWAP" à droite (doubles flèches) permet d'inverser les deux fichiers d'entrée, en changeant également le nom du fichier de sortie.
• Entrer le nom du fichier de sortie, ou garder celui défini automatiquement, dans le champ "Output".
• Cocher si besoin l'option "Reverse Lines" (inverser les lignes), pour inverser les lignes du second fichier (option -r).
• Cocher si besoin l'option "Split Long Lines" (couper les lignes longues), et entrer la valeur dans le champ "max. Length" (longueur maximum) pour couper les lignes en segments (option -l).
• Cocher si besoin l'option "Bias", et entrer la valeur dans le champ "Value" (valeur) pour faire partir plusieurs triangles du même point du chemin (option -b).
• Cocher si besoin l'option "use sequential sweep" (option -s), pour utiliser l'ancien algorithme de calcul.
• Exécuter la commande en cliquant sur le bouton .

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

Intégration de Coverer dans LDForge

Le programme Coverer a été interfacé dans LDForge.

Voir le chapitre : Programme d'extrusion de faces réglées : Coverer.

Comment Coverer fonctionne

• Les deux fichiers d'entrée sont lus et analysés. Tous les sommets de lignes sont mis dans des tableaux (limités à 2 000 lignes, ce qui devrait être suffisant !).
• Ces tableaux sont triés, permettant d'utiliser des fichiers LDraw dont les lignes ne sont pas ordonnées (par exemple des fichiers provenant d'Isecalc). Si plus d'un chemin est trouvé, un message d'erreur est affiché, car ceci dénote de mauvais fichiers d'entrée, qui produiraient un résultat erroné.
• Si l'option -r est présente, l'ordre du second fichier est inversé. Utilisez cette option lorsque la face résultante joint les chemins en inversant les extrémités (cela ressemble souvent à un papillon déchiqueté).
• Si l'option -s est présente, l'ancienne méthode séquentielle est utilisée (version 1.2 du programme). Tous les sommets des chemins sont pris séquentiellement. Sans l'option -s, le sommet donnant le triangle le plus compact est choisi.
• Si l'option -l xxx est utilisée, les lignes de longueur supérieure à xxx sont coupées en segments plus petits. Vous pouvez obtenir des faces plus lisses en utilisant cette option.
• Si l'option -b xxx est utilisée, la création de triangles peut se faire en éventail, en créant plusieurs triangles partant du même point, suivant la valeur xxx entre les limites -100 et 100. Voir les exemples plus loin.
  Nota : Cette option fonctionne uniquement avec l'option -s. Il est probable que les options par défaut donneront des résultats meilleurs qu'en utilisant les options -s -b.
• Les facettes triangulaires sont créées entre les deux chemins, progressant proportionnellement sur leurs longueurs. Lorsque des facettes dégénérées (réduites à une ligne) sont calculées (par exemple lorsque les chemins ont des points communs), elles ne sont pas créées.
• Une analyse des facettes triangulaires générées est faite. Si deux facettes consécutives sont dans le même plan et forment une facette quadrangulaire convexe, alors elles sont condensées. Si elles ne sont pas dans le même plan, une ligne conditionnelle est ajoutée (ligne de commande type 5).
• Le fichier de sortie est crée.

Exemples

Utilisation de base

Une bonne face entre deux arcs. Fichiers : arc1.dat, arc2.dat --> arc-out.dat Ligne de commande : Coverer arc1.dat arc2.dat arc-out.dat

Utilisation de l'option -r

Ici, l'ordre et la direction des lignes du second fichier est inversé, créant cette forme étrange. Fichiers : arc1.dat, arc2-r.dat --> arc-r-out.dat Ligne de commande : Coverer arc1.dat arc2-r.dat arc-r-out.dat Le paramètre -r corrige l'ordre, et génère la même face que dans le premier exemple. Fichiers : arc1.dat, arc2-r.dat --> arc-rok-out.dat Ligne de commande corrigée : Coverer -r arc1.dat arc2-r.dat arc-rok-out.dat

Alignement des chemins

Passer d'un carré à un cercle. Fichiers : sqc1.dat, sqc2.dat --> sqc-out.dat Ligne de commande : Coverer sqc1.dat sqc2.dat sqc-out.dat

Notez l'importance de l'orientation relative des deux chemins, même s'ils sont symétriques. Ici le cercle est tourné de 45°, le résultat est tordu. Notez que sans l'option -s un résultat correct est obtenu ici, mais si le cercle avait été tourné d'un angle plus grand, le résultat aurait aussi été déformé. Pour les chemins circulaires, vous devez vous assurer que la première ligne de chaque fichier LDraw se correspondent. Fichiers : sqc1.dat, sqc2-45.dat --> sqc-45-out.dat Ligne de commande : Coverer -s sqc1.dat sqc2-45.dat sqc-45-out.dat

Utilisation de l'option -l

	Cet exemple montre comment créer une face vrillée comme dans la pièce 43721 sloped wedge. Deux uniques lignes forment les bords. Une utilisation simple de Coverer donne un résultat grossier... Fichiers : wedge1.dat; wedge2.dat --> wedge-out.dat Ligne de commande : Coverer wedge1.dat wedge2.dat wedge-out.dat
	...le paramètre -l améliore le résultat : Fichiers : wedge1.dat; wedge2.dat --> wedge-l-out.dat  Ligne de commande : Coverer -l 10 wedge1.dat wedge2.dat wedge-l-out.dat

Utilisation de l'option -b

	La création des triangles se fait en se déplaçant alternativement d'un segment à la fois, sur le chemin du haut et le chemin du bas. Mais, dans cet exemple, en raison de la forme des segments du chemin du bas, la distance horizontale de déplacement sur le chemin du bas varie peu au début. La surface générée semble tordue et froissée. Fichiers : b1.dat; b2.dat --> bias-0-out.dat Ligne de commande : Coverer -s b1.dat b2.dat bias-0-out.dat
	Ici vous voyez l'utilisation du paramètre de l'option -b. Avec le paramètre -b 4 la vitesse de progression sur le chemin du bas est augmenté, et compense l'effet précédent. Plusieurs triangles peuvent partir du même point d'un des chemins, formant des triangles en éventail. Le résultat donne une surface plus lisse. Fichiers : b1.dat; b2.dat --> bias-4-out.dat Ligne de commande : Coverer -s -b 4 b1.dat b2.dat bias-4-out.dat
	... Mais avec le nouvel algorithme -b est inutile, et cela donne de meilleurs résultats! Ligne de commande : Coverer b1.dat b2.dat noneedbias-out.dat

Utilisation sur des chemins décentrés

	Lorsque la plupart des points d'un chemin sont proches de quelques points de l'autre chemin, tout en étant éloignés d'autres points, le nouvel algorithme fonctionne mal. Ligne de commande : Coverer el1.dat el2.dat elnosout.dat
	Dans ce cas l'option -s donne un meilleur résultat... Ligne de commande : Coverer -s el1.dat el2.dat elsout.dat
	... Résultat encore amélioré grâce à l'option -b. Ligne de commande : Coverer -s -b 1 el1.dat el2.dat elsb1out.dat

Utilisation dans le même plan

Un anneau particulier est probablement l'application la plus utile de Coverer. Cela permet de joindre des primitives standards à 16 ou 48 cotés, ayant des angles de départ différents. Je l'ai utilisé dans des pignons, roues et pneus, comme la pièce 30391 qui a une primitive de base 16, mais bordé de 40 bossages. Fichiers : cir21.dat, cir16.dat --> adapt1621.dat Ligne de commande : Coverer cir16.dat cir21.dat adapt1621.dat

Droits et Copyright

Le programme Coverer et son manuel d'utilisation appartiennent à (c) Philo (Philippe Hurbain).

Vous pouvez le retrouver sur son site et sa page des utilitaires LDraw, et sur la version d'origine en anglais de cette page.

Traduction et Adaptation : J.C. Tchang.