Préambule

L'un d'entre vous (pas de nom, j'suis pas une balance) m'a demandé un tuto en français sur le programme F-Engrave. J'en avais parlé très rapidement dans cet article, mais je n'avais pas expliqué comment le programme fonctionne.
Comme je ne l'avais pas vraiment exploré à fond, je me suis dit que la première étape était de me taper la documentation, et tant qu'à faire, de la traduire en français pour nos amis non anglophones.
Ceci est donc la traduction française presque officielle du manuel de F-Engrave. J'ai contacté l'auteur, Scorch, qui m'a suggéré de l'héberger chez moi pour faciliter les futures corrections et mises à jour.

Alors en attendant le tutorial, voici déjà la documentation!
La version originale se trouve ici : http://www.scorchworks.com/Fengrave/fengrave_doc.html

[Edit du 3 novembre 2017] Un tuto (gravure de texte avec un e fraise droite) écrit par un de mes lecteurs est disponible ici!

Table des matières

Conseils de Scorch
Questions et réponses
Options de la ligne de commande
Raccourcis clavier
Souris
Fichier de configuration
Options de le fenêtre principale
Options générales
Paramètres V-Carve
Options PBM

Conseils de Scorch

Voici le conseil que je donnerais à un ami qui commence à utiliser F-Engrave.

Ouvrir des anciens fichiers .ngc F-Engrave peut ouvrir des fichiers g-code (.ngc) sauvegardés par F-Engrave. Si vous avez aimé les résultats obtenus la dernière fois, ou que vous voulez juste faire de petites modifications, ouvrez le fichier précédemment enregistré et travaillez sur les paramètres existants. Donc, pas besoin de recommencer à partir de zéro.
Paramètres V-Carve:
"Sub-Step Length"
Le paramètre v-carve "Sub-Step Length" est important pour la gravure avec une fraise en V (v-carving). L'algorithme de v-carving calcule la position de l'outil et la profondeur selon un intervalle fixe. Cet intervalle fixe est le "Sub-Step Length". Un grand substep length accélèrera le calcul, mais produira potentiellement des facettes au moment de la gravure.

Si vous utilisez des unités métriques, vous devriez augmenter la valeur par défaut de ce paramètre pour accélérer le calcul (une valeur de 0.25mm devrait suffire).
Paramètres V-Carve:
"Check all or Current Char Only"
Pour graver l'intérieur des caractères, laissez cette option à "Character only"

Si vous utilisez l'option "flip normals" pour graver l'extérieur des caractères, ce paramètre doit être "All"
Paramètres V-Carve:
"Inside corner angle"
"Outside corner angle"
Ne vous embêtez pas avec les paramètres "Inside corner angle" et "Outside corner angle". Les valeurs par défaut sont très raisonnables pour la majorité des situations.

Je documenterai ces paramètres plus tard, mais pour le moment laissez-les tels quels.
Utilisez Potrace pour transformer des images en fichiers DXF Potrace crée des fichiers DXF constitués de boucles fermées, ce qui est idéal pour graver avec F-Engrave. De plus, Potrace donne en général de bons résultats et offre beaucoup d'options pour ajuster le résultat selon vos besoins. Si vous devez calculer des chemins d'outil à partir d'images DXF complexes, attendez-vous à ce que les calculs prennent du temps.

Questions et réponses

Comment faire fonctionner le programme ttf2cxf_stream?

En arrière plan, F-Engrave utilise le programme ttf2cxf_stream. Pour utiliser un fichier de police True Type (TTF), vous devez l'installer dans le dossier des polices (ou dans le dossier indiqué dans les options). Le fichier TTF devrait apparaître dans la liste des polices disponibles, pour autant que le programme ttf2cxf_stream fonctionne correctement et se trouve dans le même répertoire que F-Engrave. Si le programme ttf2cxf_stream n'est pas présent ou ne fonctionne pas, vous devriez voir un message dans la fenêtre de la console indiquant que ttf2cxf ne fonctionne pas. Plus d'information ici:F-Engrave Setup

Options de la ligne de commande

Usage python f-engrave-XX.py [-g fichier | -f dossier_polices ]
ou
f-engrave-XX.exe [-g fichier | -f dossier_polices ]
-g
(ou --gcode_file)
Fichier g-code de f-engrave à charger
-f
(ou --fontdir)
chemin vers le dossier des polices
-h
(ou --help)
affiche l'aide dans la console.
Exemple
(Utilise le script python avec une
distribution python préinstallée)
python f-engrave-XX.py -g mon_fichier.ngc -f /mon_rep_polices/sous_repertoire
Exemple
(Utilise l'exécutable
Windows précompilé)
f-engrave-XX.exe -g mon_fichier.ngc -f C:/mon_rep_polices/sous_repertoire

Raccourcis clavier

F1 Ouvre la fenêtre d'aide (il n'y a rien dans l'aide, à part un lien vers cette page web et mon adresse e-mail)
F2 Ouvre la fenêtre des paramètres généraux
F3 Ouvre la fenêtre des paramètres de V-Carving
F4 Ouvre la fenêtre des paramètres PBM
F5 Recalculer (c'est la même fonction que le bouton "recalculate" sur la page principale)
Ctrl + flèche du haut Fait défiler la liste des polices (selon le système d'exploitation)
Ctrl + flèche du bas Fait défiler la liste des polices (selon le système d'exploitation)
Page Up Zoom avant vers le centre de l'affichage.
Page Down Zoom arrière vers le centre de l'affichage.

Souris

Bouton gauche Zoom avant et arrière. Maintenez le bouton gauche appuyé et déplacez la souris vers le haut ou le bas.
Bouton droit Déplacement. Maintenez le bouton gauche appuyé et déplacez la souris.
Molette Selon le sytème d'exploitation, la molette fait défiler la liste des polices.

Configuration File

config.ngc
ou
.fengraverc
Quand F-Engrave démarre, il cherche un fichier "config.ngc". S'il le trouve, ce fichier est lu et toutes les options de F-Engrave sont initialisées selon les options trouvées dans ce fichier de configuration. F-Engrave recherche ce fichier dans le répertoire courant et dans le répertoire home de l'utilisateur (répertoire d'enregistrement par défaut). Le fichier de configuration peut s'appeler "config.ngc" ou ".fengraverc". Si l'un des deux est trouvé, il sera utilisé pour initialiser les options if either of these are found it will be used to set the default settings. Seul le premier fichier est utilisé.

Pour créer un fichier de configuration avec vos options préférées, ouvrez simplement F-Engrave, changer les paramètres selon vos besoins, et enregistrez un fichier "config.ngc" dans votre répertoire utilisateur (répertoire d'enregistrement par défaut), ou dans le répertoire où se trouve F-Engrave. (Si vous n'utilisez pas la version précompilée pour Windows, vous pouvez aussi modifier directement les paramètres dans le fichier .py)

Fenêtre principale (mode Texte et mode Image)

![image](main_text.jpg) ![image](main_image.jpg)

Champ Description
Text Height
ou
Image Height
Hauteur des caractère pour une ligne de texte. Cette option contrôle aussi la hauteur des images (DXF ou PBM) importées. (F-Engrave traite les données DXF comme un caractère)
Line Thickness Epaisseur ou largeur des lignes pour afficher le texte. Pour prévisualiser ce qui sera gravé, ce paramètre doit être égal au diamètre de la fraise.

Quand l'option V-Carve est sélectionnée, ce paramètre n'a pas d'effet sur l'épaisseur des lignes affichées.
Text Width
ou
Image Width
C'est la largeur des caractères ou de l'image (DXF ou PBM). Si elle est de 100%, la largeur des caractères n'est pas modifiée. Pour des valeurs différentes de 100%, la largeur du caractère sera redimensionnée selon la valeur indiquée (i.e. les cercles deviennent des ellipses).
Char Spacing F-Engrave utilise un espacement constant entre tous les caractères. L'espacement entre les caractères est déterminé comme un pourcentage de la largeur maximale des caractères dans la police sélectionnée. Avec une valeur de 0%, tous les caractères se toucheront, et cela peut être utile dans certains cas spécifiques.
Word Spacing C'est l'espace entre les mots, ou la largeur du caractère "espace". Il est déterminé comme un pourcentage de la largeur maximale des caractères dans la police sélectionnée.
Line Spacing C'est l'espacement vertical entre les lignes de texte. C'est un multiple de la hauteur des caractères définie précédemment. Un espacement vertical de 1.0 peut conduire à deux lignes de texte qui se touchent si le caractère le plus grand est juste en dessous du caractère qui descend le plus pas (par exemple un "g")
Text Angle
ou
Image Angle
Rotation du texte ou de l'image (DXF or PBM) par rapport à l'horizontale.
Justify La justification aligne la gauche, droite ou le centre de plusieurs lignes de texte. Cette option n'a pas d'effet sur une seule ligne de texte.
Origin L'origine détermine la position relative du zéro (x,y) dans le g-code. La position actuelle de l'origine est affichée avec deux lignes, rouge et verte. La ligne rouge est l'axe x, la verte l'axe y.

Par défaut, l'origine est placée sur la position zéro du premier caractère. Si le texte est sur un cercle, cette option déplacera le centre du cercle.
Flip Text
ou
Flip Image
Bascule le texte ou l'image le long d'un axe horizontal. (comme "Mirror text", mais sur un axe horizontal)
Mirror Text
ou
Mirror Image
Bascule le texte ou l'image le long d'un axe vertical. (comme "Flip text", mais sur un axe vertical)
Circle Radius C'est le rayon du cercle sur lequel le texte est placé. Si le rayont vaut 0.0, le texte n'est pas placé sur un cercle.
Outside Circle Détermine si le texte est placé à l'intérieur ou à l'extérieur du cercle.
Top of Circle Détermine si le texte est placé en haut ou en bas du cercle. Si l'angle de texte est différent de 0.0, alors le haut et le bas du cercle seront pivotés de cet angle.
Feed Rate Détermine la vitesse d'avance de l'outil dans le fichier g-code.
Z Safe C'est l'emplacement z de l'outil à utiliser pour les déplacements rapides.
Cut Depth C'est la profondeur de coupe. Cette option n'a pas d'effet si l'option V-Carve est sélectionnée.
Font Files Cette liste affiche les noms de fichier des polices (CXF et TTF). Le répertoire des polices peut être changé dans la fenêtre "Settings/General settings".
Show All Font Characters Cette option affiche temporairement tous les caractères disponibles dans la police sélectionnée.
Engrave/V-Carve Permet de travailler en mode "Gravure" ou "V-Carve".
Calculate V-Carve Ce bouton lance le calcul pour le V-Carving. Le traitement peut être long.
Recalculate Racalcule l'affichage pour tous les options pour prévisualiser le résultat. Tout est recalculé, sauf le V-Carve.
Input Text C'est le texte qui sera affiché dans la prévisualisation, et exporté dans le fichier g-code.
Status Bar La barre d'état fournit quelques éléments d'information quand on travaille avec F-Engrave. Une des plus utiles est la taille de la boîte englobante (bounding box). Quand vous cliquez sur le bouton "Recalculate", la taille globale de la gravure ou du V-Carving est calculée et affichée dans la barre d'état, en termes de boite englobante (largeur et hauteur). C'est très utile si vous avez une surface limitée.

Options générales

![image](gen_settings.jpg)

Champ Description
Units (inch/mm) Définit les unités utilisées par F-Engrave (pouces ou mm). Cette option affecte les unités affichées, et les unités de sortie du fichier g-code.
X Offset and Y Offset Sur la fenêtre principale, le champ "origin" détermine la position du zéro x et y dans le g-code, par rapport au texte ou au dessin DXF. Le décalage (offset) X et Y sont des modifications supplémentaires pour l'emplacement du zéro. Ces décalages sont ajoutés aux valeurs X et X dans le g-code. Par exemple, si le texte est sur un cercle de centre x=0,y=0 et qu'on indique un décalage (x,y) de (3,4), alors le texte sera centré autour de x=3 et y=4.
Arc Angle Tous les arcs, cercles et splines sont réduits à des segments individuels par F-Engrave. Ce paramètre détermine combien de segments sont nécessaires pour décrire ces courbes. Si "arc angle" est de 90 degrés, un cercle sera représenté par un carré (coins de 90 degrés). Si l'angle est de 60 degrés, un cercle sera représenté par un hexagone. Plus l'angle est petit, plus la représentation est précise (avec comme conséquence un temps de calcul plus long, et potentiellement une baisse de performances de la machine CNC).
Accuracy
(Nouveau dans la version 0.5)
La précision détermine la distance maximale entr edeux points considérés comme coïncidents. Ce paramètre peut être augmenté pour limiter les mouvement Z qui ne sont pas nécessaires, lorsque la fin d'une ligne et le début de la suivante sont très proches mais pas coïncidents. Cette option réduit aussi la semsibilité des splines DXF avec des boucles sur des coins aigus, quoi peuvent générer des chemins V-Carve erronnés. (J'ajouterai un exemple de ce cas de figure).
G Code Header Le texte saisi dans ce champ sera ajouté au début du fichier g-code. Les commandes sont interprétées telles quelles par la machine CNC. LRd valeurs par défaut (G17 G90 G64 M3 S3000 M7) sont expliquées ci-dessous:
G17
Utiliser le plan XY
G90
Cycle fixe, cycle simple, pour dégrossir (emphase sur l'axe Z)
G64 P0.003
G64 P- (tolérance pour la fusion des mouvements définie à 0.003) C'est la valeur par défaut dans le programme historique "engrave.py"
G64
G64 sans l'option P conserve la meilleure vitesse possible, peu importe la distance par rapport au point de destination.
M3 S3000
Démarrage de la broche à 3000
M7
Active la pompe de refroidissement (si disponible)
G Code Postscript Ce texte sera ajouté à la fin du fichier g-code. Les commandes sont interprétées par la machine CNC telles quelles. Les valeurs par défaut (M5 M9 M2) sont expliquées ci-dessous:
M5
Arrêt de la broche
M9
Arrête la pompe de refroidissement
M2
Fin du programme
Font Directory C'est le répertoire utilisé pour chercher les fichiers de police (TTF et CXF) et les fichiers DXF. Les fichiers avec une extension correcte sont affichés dans la liste "Font Files". Si vous ouvrez un fichier DXF avec le menu, le répertoire "font directory" sera automatiquement modifié, et deviendra le répertoire qui contient votre fichier DXF.
Height Calculation
Max Used/Max All
La hauteur du texte peut être déterminée de deux façons. La première est la valeur saisie dans "Text height". Dans ce cas, la hauteur maximum du texte est celle saisie.

La seconde option est "Max All". Quand cette option est sélectionnée, c'est la hauteur maximale de tous les caractères de la police qui est utilisée pour déterminer la hauteur du texte. Quand "Max All" est utilisé, il est possible d'avoir une hauteur de texte en sortie plus petite que la hauteur entrée dans la fenêtre principale, car le caractère le plus grand de la police peut ne pas être utilisé dans le texte à graver.
Add Box/Circle Cette option ajoute une boîte englobante autour du texte. Si le texte est placé sur un cercle, alors un cercle englobant sera ajouté, plutôt qu'une boîte englobante.
Border Gap (multiple of line thickness) La marge de la bordure détermine la taille de la boîte englobante ajoutée avec l'option "Add Box/Circle". L'espace entre le texte et la boîte englobante est défini en unités de longueur (pouces ou mm).

Paramètres V-Carve

![image](vcarve_settings.jpg)

Champ Description
V-Bit Angle L'angle de la fraise en V à utiliser.
Il est possible que l'angle réel de la fraise ne corresponde pas exactement à celui indiqué par le fabricant.
V-Bit Diameter Diamètre maximal de coupe avec la fraise.
Il peut être plus petit que le diamètre réel de la fraise, pour contrôler la largeur/profondeur de coupe.
Sub-Step Length L'algorithme de v-carving calcule la position de l'outil et la profondeur selon un intervalle fixe. Cet intervalle fixe est le "Sub-Step Length". Un grand substep length accélèrera le calcul, mais produira potentiellement des facettes au moment de la gravure. Si vous réduisez trop le "Sub-Step Length", le temps de calcul peut devenir très long, ainsi que la performance de la machine au moment de l'usinage (à cause de commandes G1 très courtes). En cas de doute, commencez avec une valeur élevée, et diminuez jusqu'à obtenir des résultats corrects.
Check all or Current Char Only
All/Character only
Pour calculer les chemins de V-carving, F-Engrave recherche les autres segments pour limiter la profondeur de gravure. Cette option détermine si F-Engrave doit regarder les autres segments dans le caractère uniquement, ou dans toue les autres caractères. Si vous faites du V-Carving sur l'intérieur des caractères uniquement, il n'y a aucune raison de vérifier les segments des autres caractères. Mais si vous enlevez la matière autour des caractères, alors il faut vérifier les autres segments pour éviter d'enlever de la matière sur un autre caractère. (Vérifier tous les caractères est bien plus lent que vérifier un caractère uniquement).
Flip Normals
(V-Carve Side)
F-Engrave présume que la police ou l'image (DXF) crée des chemins fermés, dans le sens des aiguilles d'une montre autour du dessin qui doit être gravé. Et par défaut, il va graver l'intérieur des caractères. Cette option inverse le sens de traitement, et c'est donc l'extérieur des caractères ou du dessin DXF qui sera retiré.
Plot During V-Carve Calculation Active ou désactive le dessin pendant l'avancement des calculs de V-Carving. Désactivée, cette option accélère la vitesse de calcul sans affecter la sortie g-code.
Finish Pass Stock
et
Max Depth per Pass
Le "Finish Pass Stock" est la hauteur de matière qui restera pour la dernière passe. F-Engrave laissera toujours cette épaisseur pour la dernière passe, même si "Max depth per pass" est supérieur à la profondeur de coupe maximale.

Si vos paramètres sont:
Finish Pass Stock = 0.03
Max Depth per Pass = 0.1

Et que votre profondeur maximale à un endroit du dessin est de 0.5, alors la profondeur de coupe pour les passes à cet endroit seront:
passe 1: 0.1
passe 2: 0.2
passe 3: 0.3
passe 4: 0.4
passe 5: 0.47
passe 6: 0.5 (c'est la passe de finition: 0.5 - 0.47 = 0.03)
Cleanup Cut Diameter Cette option définit le diamètre de la fraise de nettoyage. Indiquez simplement le diamètre de la fraise à utiliser.
Cleanup Cut Step Over C'est le taux de recouvrement pour les passes de nettoyage. Cette valeur est un pourcentage du diamètre de la fraise de nettoyage.
Cleanup Cut Directions Ces cases à cocher indiquent les types de chemins d'outils à utiliser pour nettoyer.
P: Coupe le long du périmètre de la surface à nettoyer X: Coupe le long de l'axe X Y: Coupe le long de l'axe Y
V-Bit Cleanup Step C'est le taux de recouvrement à utiliser pour nettoyer les zones qui ne peuvent pas être atteintes avec la fraise de nettoyage. La coupe est destinée à être effectuée avec la même fraise en V que celle utilisée pour le V-Carving. Ce recouvrement est indiqué dans l'unité de longueur sélectionnée.
V-Bit Cut Directions Ces cases à cocher indiquent les types de chemins d'outils à utiliser avec la fraise en V.
P: Coupe le long du périmètre de la surface à nettoyer X: Coupe le long de l'axe X Y: Coupe le long de l'axe Y
Bouton:
Calculate Cleanup
Détermine la surface qui nécessite un nettoyage. Une fois cette surface déterminée, les parcours d'outil pour le nettoyage sont calculés selon les paramètres définis ci-dessus. Le calcul de la surface est effectué seulement une fois, après le calcul des chemins pour le V-Carve. F-Engrave se souviendra des résultats précédents et les utilisera jusqu'à ce qu'un nouveau calcul de chemin V-Carve soit effectué.
Bouton:
Save Cleanup G-Code
Ce bouton enregistre le G-Code de nettoyage dans un fichier.
Button:
Save V Cleanup G-Code
Ce bouton enregistre le G-Code de nettoyage (fraise en V) dans un fichier.

Options PBM

![image](pbm_settings.jpg)

Champ Description
(Ces options sont transmises directement à Potrace. Pour plus d'information, consultez la documentation de Potrace)
Turn Policy Indique à Potrace comment résoudre les ambiguités dans la décomposition des chemins.
Turd Size Supprime les éventuelles petites taches jusqu'à cette taille.
Alpha Max Seuil pour les coins.
Long Curve Active/désactive l'optimisation des longue courbes. L'optimisation permet de diminuer le temps de calcul pour le V-Carve.
Opt Tolerance Tolérance pour l'optimisation des courbes.

Conseils d'utilisateurs

Un utilisateur a remarqué que sur Linux (Ubuntu), il avait besoin de rendre le fichier python exécutable et de retirer les sauts de ligne DOS pour arriver à faire tourner le programme. Je n'ai pas réussi à reproduire le problème, mais voici les étapes à suivres si vous avez des soucis:
$ chmod 755 f-engrave-08.py # rendre le fichier exécutable
$ sudo apt-get install tofrodos
$ fromdos f-engrave-08.py # convertir les fins de lignes dos en unix

Problèmes connus

- F-Engrave génère une commande G1 pour chaque segment calculé quand on fait du V-Carving. Si la taille des segments (step size) est très petite, la machine CNC ne pourra jamais atteindre la vitesse indiquée dans le G-Code.

- Tous les fichiers DXF ne sont pas supportés. Il y a énormément de types d'entités différents dans le format DXF, et tous ne sont pas supportés.

- Toutes les polices TTF ne sont pas supportées. Certaines polices TTF encapsulent des images plutôt que des graphiques vectoriels. Les polices TTF basées sur des images ne sont pas supportées.


![image](scorch_logo.png)

Article précédent Article suivant