PlanarCheck

J.C. Tchang

Original Version On Philo's Site.

PlanarCheck, est un vérificateur de planéité des quadrilatères LDraw.

PlanarCheck vous aide à vérifier que tous les quadrilatères d'un fichier de pièce LDraw sont suffisamment plans pour respecter les exigences du "LDraw Parts Tracker". Alors qu'un triangle est toujours plat, un quadrilatère peut-être vrillé. Cela peut donner des résultats de rendu étranges, comme le carré central de l'image ci-dessus (bien que l'effet soit souvent moins important, car pour l'exemple le carré central a été TRÈS déformé.

La vérification de planéité était précédemment faite en utilisant "Dist Coplanarity Check" et "Det Coplanarity Check" inclus dans L3P ou LDDP. Malheureusement le résultat donné par ces outils n'était pas facile à interpréter car la valeur de distance (Dist) est proportionnelle à la taille des quadrilatères, et la valeur (Det) proportionnelle au cube de la taille (Size). PlanarCheck tente de résoudre la solution en calculant l'angle entre les triangles qui composent un quadrilatère.

Le seuil d'erreur de planéité par défaut est de 3°, et un message d'avertissement est donné pour les quadrilatères dont l'angle des triangles dépasse 1°.

Téléchargement

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

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

Historique

• V1.1 : Décembre 2007, version initiale.
• V1.2 : Juillet 2008.
  • Amélioré le format du fichier de sortie.
  • Ajouté plusieurs options de contrôle.
  • -w <angle> : Définit le seuil limite de l'angle donnant un message d'avertissement.
  • -t <angle> : Définit le seuil limite de l'angle donnant un message d'erreur.
  • -c : Coupe automatiquement les quadrilatères vrillés en triangles.
  • -o : Ne crée pas de ligne conditionnelle lors de la coupe des quadrilatères.
• V1.3 : 9 octobre 2008.
  • Amélioré les messages de démarrage.
• V1.4 : 9 octobre 2008.

Utilisation

Utilisation dans une fenêtre Invite de commande

La façon la plus simple d'utiliser PlanarCheck est de glisser/déposer le fichier LDraw à vérifier sur le Raccourci du programme. Une fenêtre Invite de commande similaire à celle ci-dessous s'ouvre, montrant le résultat.

Utilisation avec le bouton droit de la souris

Comme autre possibilité, vous pouvez aussi placer un Raccourci de PlanarCheck.exe dans votre dossier "Envoyer Vers" (C:\Documents and Settings\<votre nom d'utilisateur Windows>\SendTo - attention, ce dossier est par défaut caché !). Puis, en faisant un clic droit sur le fichier à vérifier, sélectionnez Envoyer Vers > PlanarCheck, dans le menu contextuel.

Intégration de PlanarCheck dans LDraw Design Pad

De façon encore plus pratique, vous pouvez configurer PlanarCheck comme un programme externe du programme LDDesign Pad (LDDP). Voir la configuration ci-dessous.

Paramétrez l'onglet "User-defined-Program" des options, accessible par le menu "Tools > Options...", puis en cliquant sur "Add New Program". Introduisez dans les champs respectifs les informations comme dans l'exemple ci-dessous. Nota : Evidemment le champ "Path & Filename" doit avoir le chemin du dossier où VOUS avez installé le programme PlanarCheck.

Nota : Si vous utilisez souvent PlanarCheck avec les options de la version 1.2, il faut ajouter ces options dans le champ "Parameters:", avant de taper "%4".

PlanarCheck peut ensuite être utilisé sur le fichier actif dans LDDP en cliquant sur l'icône "User Defined Program" et sur "PlanarCheck" :

Intégration dans LETGUI

Il est possible de lancer PlanarCheck à 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 LETGUI

• Sélectionnez "PlanarCheck" dans le menu déroulant "Tool".
• Entrez le chemin d'accès à l'utilitaire PlanarCheck, si cela n'a pas été configuré, dans le champ "Planarcheck".
• 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".
• Cochez si besoin "Automatically split warped quads into triangles (-c)", pour utiliser l'option -c.
• Cochez si besoin "Do not create conditionnal lines when splitting quad (-o)", pour utiliser l'option -o.
• Cochez si besoin "Adjust Error and Warning Angle", et entrez les nouvelles valeurs dans les champs correspondants (options -t et -w).
• Exécutez la commande en cliquant sur le bouton .

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

Utilisation avancée de PlanarCheck

• Ouvrez une fenêtre Invite de commande.
• Tapez la ligne de commande de base : PlanarCheck LdrawFile LdrawFileOut.
• Lorsqu'un fichier de sortie (LdrawFileOut) est spécifié une suggestion de division de quadrilatère est ajouté comme un commentaire lorsque l'angle dépasse les valeurs limites.
  Exemple :

  4 11 10 0 0 10 0 10 20 0 10 20 0.5 0
  0 Angle 4.047210> 1.000000
  0 Suggested split:
  0 3 11 10 0 0 10 0 10 20 0 10
  0 3 11 10 0 0 20 0 10 20 0.5 0
  0 5 24 10 0 0 20 0 10 10 0 10 20 0.5 0

• Commande complète : PlanarCheck [-w <angle>] [-t <angle>] [-c] [-o] LdrawFile [LdrawFileOut]
• Les valeurs limites peuvent être modifiées si besoin. Utilisez pour cela les options de la ligne de commande :
  • -w <angle> : Définit le seuil limite de l'angle donnant un message d'avertissement (Warning).
  • -t <angle> : Définit le seuil limite de l'angle donnant un message d'erreur (ERROR).
  Notez que les valeurs par défaut ne doivent pas être changées pour passer le LDraw parts certification. Un message d'erreur est envoyé si vous les modifiez.
• La coupe des quadrilatères en triangles peut être automatisée :
  • -c : Coupe automatiquement les quadrilatères vrillés en triangles.
  • -o : Supprime la création des lignes conditionnelles lors de la coupe des quadrilatères.

Comment le programme PlanarCheck travaille

• Le fichier d'entré est lu et analysé.
• Chaque quadrilatère du fichier est divisé en 2 triangles (il y a 2 façons pour le faire).
• L'angle entre les plans des triangles est calculé pour chaque configuration de triangle.
• La valeur maximum est comparée avec les valeurs limites et un compteur est incrémenté en conséquence.
• Si un fichier de sortie est spécifié, une suggestion de division de quadrilatère est ajoutée lorsque l'angle dépasse la valeur d'avertissement.
• Un résumé est affiché.

Droits et Copyright

Le programme PlanarCheck 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.

Cette page

Traduction et Adaptation : J.C. Tchang.