LETGUI
(LDraw Edit Tools GUI)

J.C. Tchang

Original Version On Michael Heidemann Site

Le programme LETGUI sert d'interface graphique à un certain nombre d'utilitaires en ligne de commande, prévus pour aider les concepteurs de pièces LDraw.

Utilitaires interfacés par LETGUI

	Coverer : Générateur de surfaces réglées entre deux chemins (v1.3).
	Dat2QP : Convertisseur de fichier LDraw en fichier Quad2Dat (v1.1 et v1.3).
	Edger : Générateur de bord (v0.7).
	Edger2 : Générateur de bord plus évolué (v1.3).
	Flipper : Recombine 2 triangles adjacents (v1.0).
	Inliner : Décompose un sous-fichier dans le fichier parent (v1.1.0.1).
	Intersector : Coupe un ensemble de surfaces et de lignes (v1.4).
	Isecalc : Calcul l'intersection de 2 ensembles de surfaces (v1.4).
	LDFlat : Outil pour aplatir des entités LDraw (v1.0.4).
	Linetrim : Limite les lignes à leur intersection avec des surfaces LDraw. (L'interfaçage de cet utilitaire a été supprimé à partir de la version 1.0.0.0 de LETGUI. Utilisez Intersector).
	PathTruder : Générateur de surfaces complexes (v1.2).
	PlanarCheck : Vérificateur de planéité de quadrilatères LDraw (v1.4).
	Projector : Outil d'embossage de motif LDraw (v1.2).
	Rectifier : Optimiseur de pièce LDraw (v1.9).
	Selector : Outil de sélection de maillage LDraw (v1.2).
	SlicerPro : Outil de découpage et d'embossage de motif LDraw (v1.1).
	Stl2dat : Convertisseur de fichier STL vers LDraw (v1.22).
	SymSplitter : Coupe un fichier LDraw, suivant un plan de symétrie (v1.2).
	Unificator : Unifie les sommets (v1.0).
	Unrectifier : Convertisseur de primitive et quadrilatère en triangles et lignes LDraw (v1.0).
	Windz : Rectifie le sens BFC des faces (v0.1.2.0).
	Ytruder : Générateur de bord (v1.4).

Il interface également un :

• Visualiseur de fichier LDraw (LDView, MLCad, etc).
• Editeur de fichier (MLCad, LDDesignPad, etc).

Nota : La plupart des images du tableau précédent proviennent du site de Philo.

Téléchargement

Télécharger le fichier compressé de la dernière version du programme sur le site de l'auteur.

• Programme letgui_1.7.3.0_full.zip Version 1.7.3.0 du 29-03-2014 (5371 Ko).

Ce fichier contient le programme lui-même, mais également tous les utilitaires en ligne de commande interfacés par celui-ci. Par contre, il ne contient pas le visualiseur, ni l'éditeur de fichier LDraw, qui peuvent être multiples.

Vous pouvez aller sur le dernier site de l'auteur pour voir si une version plus récente n'existe pas, ou voir plus bas à l'historique des versions pour télécharger des versions plus anciennes, sur l'ancien ou le nouveau site.

Installation

Pré-requis

• Ce programme a été écrit en Visual Basic Express 2005 et fonctionne sous tout système où MS NET Framework 2.0 est installé (voir le site http://www.microsoft.com/downloads pour le télécharger si besoin).
• L'utilitaire Edger nécessite également que Java soit installé (voir site http://java.sun.com/).
• Il a été testé avec succès sous Windows XP et sous Windows Vista - Edition Familiale Premium - Service Pack 1.
• Depuis la version 1.1.0.0, il peut également fonctionner avec Mono (www.mono-project.com).
• Cet utilitaire est donné par l'auteur à la communauté gratuitement, et doit être utilisé à vos propres risques sur les erreurs et dommages qu'il pourrait occasionner.

Installation

• Décompressez le fichier .ZIP téléchargé, dans le dossier de votre choix.
• Lancer l'exécutable d'installation, et répondez aux demandes de l'installeur.
• En mode "Full installation", tous les utilitaires (ou ceux qui vous manquent), sont également installés.

Configuration au premier lancement

• Au premier lancement, ne pas se formaliser si un message du type Could not read from file: c\lego\LETGUI\LETGUIINI.xml apparaît. Cela veut simplement dire qu'il faut le configurer pour pouvoir l'utiliser.
  Nota : Pour ceux qui ont déjà installé une version précédente, copier l'ancien fichier LETGUIINI.xml dans le nouveau dossier d'installation, cela vous évitera de redonner le chemin des utilitaires déjà connus.
  Nota : Depuis la version 1.7.0.1 le fichier doit se trouver dans le dossier : c:\users\currentuser\AppData\Local\Michael Heidemann\LETGUI
• Allez dans le menu Options et indiquez l'emplacement de tous les utilitaires et programmes interfacés par LETGUI, en cliquant sur les boutons respectifs.
  Exemple :
  .
• Si vous avez installé en mode "Full installation", tous les utilitaires en ligne de commande se trouvent dans un sous-dossier, portant leur nom, du dossier d'installation de LETGUI.
• Renseignez également l'emplacement du visualiseur (Viewer) de fichier LDraw, et de l'éditeur de fichier (Editor), non fournis avec LETGUI.
• Cochez si besoin la case "Warning if outputfile existe ?", pour qu'un message apparaisse, lorsque le fichier de sortie de chaque utilitaire existe déjà, et s'il doit être écrasé par le nouveau.
• Cochez si besoin la case "Use for all tools...", pour garder les mêmes chemins de recherche pour tous les utilitaires.
• Terminez l'installation en cliquant sur le bouton .

Utilisation

• Lancer le programme, et dans la fenêtre principale, sélectionnez l'utilitaire dont vous avez besoin, dans le menu déroulant "Tool" :
  

• Puis, renseignez les champs avec le nom du ou des fichiers d'entrée, et celui de sortie, en renseignant directement le champ, ou en cliquant sur le bouton correspondant , pour le sélectionner.
• Cochez, sélectionnez, ou renseignez les autres champs qui dépendent de chaque utilitaire.
• Exemple de fenêtre à renseigner pour l'utilitaire "Intersector" :
  
• Le bouton lance le visualiseur avec le fichier correspondant.
• Le bouton lance l'éditeur de fichier LDraw, avec le fichier correspondant.
• Le bouton à double flèche à droite des fichiers d'entrée permet de les intervertir.
• Cliquer sur le bouton pour envoyer la ligne de commande à l'utilitaire, avec ses paramètres et options renseignés.
• Les noms des fichiers entrés dans les boites de dialogue sont conservés par défaut lorsqu'on change d'utilitaire. Il n'y a pas besoin de validation dans LETGUI pour conserver les paramètres.

Nota : Pour avoir une description plus complète sur les champs et options de chaque utilitaire, allez dans la page correspondant à chaque utilitaire (voir les liens plus haut).

Attention : Il n'y a pas de validation des options et valeurs par LETGUI.

Message d'erreur

Nota : Si vous obtenez le message d'erreur ci-dessus, c'est sans doute que le programme que vous essayez d'utiliser à travers LETGUI a été supprimé ou déplacé après l'installation. Revérifiez son emplacement.

Modes d'utilisation spéciaux

Il y a plusieurs façons d'utiliser LETGUI :

• La façon "normale", qui est de lancer le programme, et de l'utiliser à partir de sa fenêtre principale, comme décrit plus haut.
• La possibilité suivante, est de mettre un lien vers LETGUI dans votre dossier "Envoyer vers" (Send To). Si cela a été fait, vous pouvez ouvrir LETGUI en sélectionnant un fichier de pièce au format LDraw (généralement .dat), puis en cliquant avec le bouton droit de la souris, sélectionnez LETGUI dans le menu "Envoyer vers". En utilisant cette méthode, le fichier sélectionné devient le premier fichier d'entrée des divers utilitaires (Input, ...)
• La dernière possibilité, si vous pouvez, est de combiner LETGUI avec d'autres programmes, qui ont la possibilité d'envoyer des paramètres. Dans ce cas, vous n'avez pas besoin de faire attention aux espaces dans les noms de fichiers.
  LETGUI accepte uniquement 1 paramètre, qui est le nom du fichier d'entrée, avec son chemin en absolu. Si ce fichier existe, il est traité de façon interne par LETGUI, et l'ouvre.

Dépannage

Depuis la version v1.7.1.0, le fichier : C:\ProgramData\LETGUI\letgui-commands.log contient la liste des commandes et paramètres passées par LETGUI. Cela peut être utile pour savoir quel est le paramètre qui pose problème lorsque le résultat ne correspond pas à l'attente.

Une autre façon de connaître les paramètres est d'utiliser l'utilitaire de Philo : PrintCmdLine.exe. Il suffit de l'installer dans le dossier de LETGUI (par exemple), puis de remplacer le chemin du programme à vérifier par le chemin de l'utilitaire. Au moment de l'exécution une fenêtre de commande s'ouvre, affichant la commande passée.

Pour obtenir l'utilitaire, voir le message du forum de LDraw.org : Edger2 help (en anglais).

Historique des versions

Attention : le numéro de version des "Packages" peut être différent des versions de l'exécutable LETGUI.exe.

Site actuel de l'auteur.
• Version 1.7.3.0 du 29-03-2014 (letgui_1.7.3.0_full.zip)
  Supporte Selector v1.2 et SymSplitter v1.2.
• Version 1.7.2.0 du 22-02-2014 (letgui_1.7.2.0_full.zip)
  Supporte Flipper v1.0 et Unrectifier v1.0.
• Version 1.7.1.0 du 02-03-2013 (letgui_1.7.1.0_full.zip)
  Supporte Selector v1.1, fichier log généré.

  Ancien site kilu.de de l'auteur (Attention ce site peut faire apparaître des images interdites aux plus jeunes).

• Version 1.7.0.2 du 25-01-2013 (letgui_1.7.0.2_full.zip)
  Message d'erreur affiché correctement lorsque la police de caractère n'est pas à 100%.
• Version 1.7.0.1 du 14-01-2013 (letgui_1.7.0.1_full.zip)
  Fichier de configuration LETGUIINI.xml déplacé du dossier d'installation au dossier Utilisateur Windows.
• Version 1.7.0.0 du 13-01-2013 (letgui_1.7.0.0_full.zip)
  Supporte Recifier 1.9 et Selector 1.0. Modifié implémentation de Windz pour fonctionner avec toutes les versions de Windows.
• Version 1.6.1.3 du 06-05-2012 (letgui_1.6.1.3_full.zip)
  Supporte Recifier 1.8, Isecalc 1.4 et Intersector 1.4.
• Version 1.6.1.1 du 24-07-2011 (letgui_1.6.1.1_full.zip)
  Supporte stldat v1.22 (v1.21 ?), Dat2QP v1.3 et Coverer v1.3.
• Version 1.6.1.0 du 23-02-2011 (letgui_1.6.1.0_full.zip)
  Supporte stldat v1.20, Rectifier v1.5 et Windz v0.1.2.0.
• Version 1.6.0.1 du 09-02-2011 (letgui_1.6.0.1_full.zip)
  Supporte stldat v1.19, corrigé glisser/coller et usage de la ligne de commande.
• Version 1.6.0.0 du 24-01-2011 (letgui_1.6.0.0_full.zip)
  Supporte Unificator v1.0 et stldat v1.18.
• Version 1.5.0.3 du 24-09-2010 (letgui_1.5.0.3_full.zip)
  Supporte Edger2 v1.3.
• Version 1.5.0.1 du 01-06-2010 (letgui_1.5.0.1_full.zip)
  Corrigé passage des paramètres à Edger2, Coverer et SymSplitter. Inclus la bonne version de Rectifier à l'installation.
• Version 1.5.0.0 du 21-05-2010 (letgui_1.5.0.0_full.zip)
  Ajouté SymSplitter, et nouvelles versions de Edger2, Pathtruder, Ytruder, Rectifier. Corrigé passage des valeurs numériques et paramètre "shape1" de Pathtruder. Partagé chemin de recherche à tous les utilitaires.
• Version 1.4.0.0 du 01-11-2009 (letgui_1.4.0.0_full.zip)
  Utilise LETGUI.exe Version 1.2.0.3.

• Version 1.x.x.x du xx-05-2009 Ajouté bouton "swap" d'inversion des fichiers d'entrée aux utilitaires Coverer et Intersector. Tous les outils sont inclus dans le programme d'installation, ainsi que LETGUI.exe version 1.2.1.1.

  Ancien site de l'auteur :

• Version 1.3.0.0 du 16-05-2009 (letgui_1.3.0.0_full.zip)
  Ajouté nouvel utilitaire Edger2 (v1.0). Tous les outils sont inclus dans le programme d'installation, ainsi que LETGUI.exe version 1.2.0.3.
• Version 1.2.0.0 du 22-01-2009 (letgui_1.2.0.0_full.zip)
  Ajouté nouvelle version de Rectifier (v1.2). Tous les outils sont inclus dans le programme d'installation, ainsi que LETGUI.exe version 1.1.0.1.
• Version 1.1.0.0 du 12-01-2009 (letgui_1.1.0.0_full.zip)
  Ajouté nouvelle version de Rectifier (v1.1) et Isecalc (v1.3). Optimisé pour être utilisé sous Mono (www.mono-project.com). Tous les outils sont inclus dans le programme d'installation, ainsi que LETGUI.exe version 1.1.0.1.
• Version 1.0.0.0 du 01-01-2009 (letgui_1.0.0.0_full.zip)
  Ajouté le support de Rectifier. Supprimé le support de l'utilitaire Linetrim (Utilisez Intersector en remplacement). Ajouté le numéro de version des utilitaires dans la boite de dialogue "LETGUI Options". Changé la numérotation des versions de LETGUI, pour un système plus courant (Majeur/Mineur/Création/Révision). Tous les outils sont inclus dans le programme d'installation.
• Version 0.1.0.18 du 12-12-2008 (letgui_0.1.0.18_full.zip)
  Ajouté les nouvelles options de Intersector, et Ytruder. Tous les outils sont inclus dans le programme d'installation.
• Version 0.1.0.17 du 27-10-2008 (letgui_0.1.0.17_full.zip)
  Ajouté PathTruder, et la nouvelle option "N" de Inliner. Tous les outils sont inclus dans le programme d'installation.
• Version 0.1.0.16 du 18-10-2008 (letgui_0.1.0.16_full.zip)
  Ajouté les nouvelles options de Inliner. Tous les outils sont inclus dans le programme d'installation.
• Version 0.1.0.15 du 10-10-2008 (letgui_0.1.0.15_full.zip)
  Ajouté les nouvelles options de PlanarCheck. Tous les outils sont inclus dans le programme d'installation.
• Version 0.1.0.14 du 08-07-2008 (letgui_0.1.0.14_full.zip)
  Inclus maintenant Edger. Les paramètres par défaut de Intersector et Coverer ont été changés. La liste des utilitaires est trié en ordre alphabétique. Mise à jour avec la dernière version en date de Coverer, Intersector, Isecalc, Projector et Ytruder.
• Version 0.1.0.13 du 28-06-2008 (letgui_0.1.0.13_full.zip)
  Inclus tous les utilitaires sauf Edger. Ajouté le support des nouveaux utilitaires Intersector et Inliner. Donne une note d'information aux utilisateurs de Dat2QP, si le fichier de sortie doit être modifié à la main.
• Version 0.1.0.12 du 22-05-2008 (letgui_0.1.0.12_full.zip)
  Inclus tous les utilitaires sauf Edger. Changé l'emplacement du fichier LETGUIINI.XML, maintenant dans le même dossier que l'application. Supporte maintenant également les noms de fichiers et lignes de commandes qui contiennent des espaces. Maintenant, vous pouvez avoir un message d'attention (Warning) si le fichier de sortie existe déjà. Quelques petites améliorations dans la validation des paramètres d'entrée. Erreur corrigée : Le fichier de sortie de Dat2QP prend maintenant la bonne extension.
• Version 0.1.0.10 du 17-05-2008 (letgui_setup.zip)
  Ajouté un réel Glisser/Déposer (Drag'n Drop) pour les fichiers d'entrée, également le fichier d'entrée est accepté en ligne de commande.
• Version 0.1.0.9 du 16.05.2008
  Maintenant avec installeur et désinstalleur. Ajouté le test de fichier, le Glisser/Déposer (Drag'n Drop) pour les fichiers d'entrée, la création automatique du nom du fichier de sortie.
• Version 0.1.0.8 du 14.05.2008 (LETGUI_0_1_0_8.zip)
  Ajouté le support de l'utilitaire LDFlat.
• Version 0.1.0.7 du 08-05-2008 (LETGUI_0_1_0_7.zip)
  Support des utilitaires Projector, Isecalc, Coverer, Ytruder, Linetrim, Dat2QP, Planarcheck, Edger (non fonctionnel).

Droits et Copyright

Le programme LETGUI et son manuel d'utilisation appartiennent à (c) Michael Heidemann (mikeheide).
Vous pouvez le retrouver sur sa page LETGUI, ou sa page de démarrage Home page.

Tous les autres programmes cités appartiennent leurs ayants droits respectifs.

Traduction et Adaptation : J.C. Tchang.