Macro d'exportation en .svg et .stl pour FreeCAD.
  • Python 99.9%
  • Shell 0.1%
Find a file
2026-11-20 16:38:50 +00:00
docs/exemples Plateaux : TourVidage 45 × 45 mm par défaut (créée avec les propriétés de plateau), exemples mis à jour 2026-11-20 17:04:16 +01:00
PlaisirMaths Plateaux : TourVidage 45 × 45 mm par défaut (créée avec les propriétés de plateau), exemples mis à jour 2026-11-20 17:04:16 +01:00
.gitignore Package the export as the PlaisirMaths FreeCAD module, add BOM save observer 2026-10-31 10:28:44 +01:00
Align_View_to_Face.FCMacro maj 2025-05-15 16:15:40 +02:00
Align_View_to_Face.FCMacro.manifest maj 2025-05-15 16:15:40 +02:00
install.sh Package the export as the PlaisirMaths FreeCAD module, add BOM save observer 2026-10-31 10:28:44 +01:00
Macro_Align_View_to_Face.png maj 2025-05-15 16:15:40 +02:00
MultiExport.FCMacro Package the export as the PlaisirMaths FreeCAD module, add BOM save observer 2026-10-31 10:28:44 +01:00
README.md Plateaux : TourVidage 45 × 45 mm par défaut (créée avec les propriétés de plateau), exemples mis à jour 2026-11-20 17:04:16 +01:00

Plaisir-Maths pour FreeCAD (export, nomenclature, étiquettes)

Description

Module FreeCAD qui, à partir des fichiers de conception :

  • exporte les pièces en un clic : .step / .3mf pour l'impression 3D, .svg pour la découpe laser ;
  • tient la nomenclature (BOM) des collections dans l'arbre du document et l'écrit dans <Document>.bom.json (lu par l'application Plaisir-Maths) et <Document>.BOM.md ;
  • produit des étiquettes de boîtes de stockage avec QR code.

Installation

Le code est un module FreeCAD, PlaisirMaths/, testé avec FreeCAD 1.1. Pour l'installer :

./install.sh            # copie vers ~/.local/share/FreeCAD/v1-1/Mod/PlaisirMaths

puis redémarrer FreeCAD. Le module ajoute :

  • une barre d'outils Plaisir-Maths, visible dans tous les ateliers : Exporter, BOM, Options d'export, Export personnalisé, Ajouter les propriétés, Ménage, Appliquer la table des références, BOM à l'enregistrement ;
  • un observateur qui écrit la BOM à chaque enregistrement ; il se désactive avec le bouton « BOM à l'enregistrement » (paramètre User parameter:BaseApp/Preferences/Macros/PlaisirMaths/EcritureAutomatique) ;
  • la bibliothèque de matériaux Plaisir-Maths de l'atelier Materials, lue dans Plaisir-Maths/CONCEPTION/Matériaux/ (Nextcloud).

MultiExport.FCMacro n'est plus qu'un lanceur de la fenêtre « Export personnalisé » ; il nécessite le module installé.

Utilisation

Organiser le document

  1. Pièces : l'étiquette d'une pièce se termine par _STEP (pièce 3D ; l'ancien _STL est traité de la même façon) ou _SVG (découpe laser).
  2. Collections : chaque collection est un composé (Part::Compound) ou un groupe de l'arbre dont le nom se termine par _COLL, par exemple COMPTEUR_COLL pour la collection COMPTEUR. Elle contient les instances de ses pièces, telles qu'on les monte : la pièce elle-même, ses clones Draft (clones de clones compris) ou des liens. La quantité d'une pièce est son nombre d'instances dans la collection. Une collection placée dans une autre (ou clonée dedans, comme 4 pieds dans un compteur) y est développée : ses pièces y comptent autant de fois. Tout élément d'une collection est une pièce de la BOM ; seules les pièces _STEP/_SVG produisent des fichiers à l'export. Une pièce _STEP/_SVG rangée dans aucune collection n'est ni exportée ni comptée (elle est signalée).
  3. Matériaux : dans l'onglet Données de chaque pièce, propriété Shape Material, choisir un matériau de la bibliothèque Plaisir-Maths (PLA basic noir, CTP bouleau 4mm…). Pour une pièce composée de plusieurs éléments (composé, fusion), on donne un matériau à chaque élément : la BOM les liste du plus volumineux au plus petit.
  4. Quantités : bouton BOM, voir ci-dessous.

Procédure

  1. Ajouter les propriétés : groupe PlaisirMaths sur chaque pièce, pm_quantite et pm_remarque sur chaque membre des groupes _COLL.
  2. Appliquer la table des références : références, versions et noms validés.
  3. BOM : vérifier les collections, ajuster les quantités, ajouter les pièces hors CAO, lire les avertissements.
  4. Enregistrer (Ctrl+S) : la BOM est écrite automatiquement.
  5. Exporter : un fichier par pièce dans <Document>-Export/, puis la BOM réécrite avec fichiers.

« Exporter » et « Écrire la BOM » proposent d'enregistrer le document s'il a des modifications non enregistrées : la BOM porte l'empreinte du fichier enregistré et doit le décrire.

Fenêtre BOM

Le bouton BOM ouvre une fenêtre qui liste chaque collection et ses pièces : nom, objet (et nombre d'instances), quantité par exemplaire de la collection, matériaux, référence, procédé, remarque (modifiable par double-clic), puis les pièces rangées dans aucune collection et les avertissements, recalculés à chaque modification. Cliquer sur une ligne sélectionne l'objet. Boutons :

  • Ajouter une pièce hors CAO… : vis, tige, notice, carton… ; crée un objet sans géométrie dans la collection choisie, avec nom, quantité, procédé (achat par défaut), référence et matériau ;
  • Couleurs depuis les matériaux : donne à chaque pièce (et à chacun de ses éléments) la couleur de son matériau ; les pièces sans matériau gardent leur couleur ;
  • Actualiser : relire l'arbre après y avoir déplacé des pièces ;
  • Exporter et Écrire la BOM.

La quantité d'une pièce présente en plusieurs instances (clones, liens, collection développée) est leur total : elle se change en ajoutant ou supprimant des clones dans l'assemblage. Celle d'une pièce présente une seule fois se modifie directement (propriété pm_quantite de l'instance). Toutes les modifications s'annulent par Ctrl+Z.

Exporter

Le bouton Exporter exporte chaque pièce rangée dans au moins un groupe _COLL une fois (les quantités servent à la production, pas aux fichiers) dans <Document>-Export/, à côté du .FCStd :

  • <étiquette>.step (couleurs par face) et, en option, <étiquette>.3mf pour les pièces 3D ;
  • <étiquette>.svg pour les pièces _SVG (contour projeté dans la direction de découpe) ;
  • en option, <étiquette>_etiquette.svg : l'étiquette de stockage.

Le dossier est vidé des fichiers de l'export précédent (.step, .3mf, .stl, .svg) avant d'être réécrit ; les autres fichiers et sous-dossiers ne sont pas touchés. Les formats et les étiquettes se règlent avec Options d'export.

Export personnalisé ouvre l'ancienne fenêtre d'export (dossier daté <Document>-AAAA-MM-JJ-Exports/<HH:MM:SS>/) pour les besoins particuliers : choix des pièces et du nombre d'exemplaires (ou « Collection × N »), calepinage SVG sur le plateau de la découpeuse (dimensions par défaut de la Trotec), fichier 3D combiné (les pièces y deviennent un seul élément), sauvegarde de la sélection dans un VarSet (Save / Load).

Étiquettes de stockage

Une étiquette SVG de 150 × 100 mm par pièce, pour les boîtes de rangement :

  • à gauche, un rendu 3D isométrique (chaque élément avec la couleur de son matériau) et une vue de dessus au trait avec cotes hors-tout et épaisseur ;
  • à droite, le pm_nom, la référence avec sa version (PM-CE-1012-003), les collections et quantités, le document d'origine et un QR code de la référence.

Une pièce sans pm_reference reçoit une étiquette « Référence à attribuer », sans QR code. Le document de travail n'est pas modifié : le rendu passe par un document temporaire.

Plateaux d'impression (nesting dans FreeCAD, tranchage sur le serveur)

Un document de jeu contient un Part::Compound PLATEAU_<modèle> par plateau (PLATEAU_P1S, PLATEAU_X1C, PLATEAU_P2S, PLATEAU_H2C, PLATEAU_XL5T) dont les pièces sont des App::Link vers les maîtres de la bibliothèque, en coordonnées du plateau (origine au coin avant gauche, Z = 0 sur le plateau). Un objet TourVidage (boîte, 45 × 45 mm par défaut : la tour réelle d'Orca fait environ 36 × 38 mm plus 3 mm de bordure) du compound donne la position de la tour de vidage des plateaux multicouleurs ; « Ajouter les propriétés de plateau » la crée si la table pm_filaments a plusieurs filaments.

  • Ajouter les propriétés de plateau : sur le compound pm_plateau (nom <JEU>-<quantité>-<Nom>, défaut : étiquette du document), pm_jeu, pm_machine, pm_plateau_x/pm_plateau_y (obligatoires pour H2C, sinon table du module), pm_filaments (une ligne par emplacement : 1;PLA;#0056B8;PLA basic bleu) ; sur chaque lien pm_filament (défaut 1) et pm_lissage (plages relatives à la base de la pièce, en mm : 1.8-2.0; 12-12.4).
  • Exporter les plateaux pour tranchage : contrôles bloquants par plateau (pièce hors plateau, ne reposant pas sur le plateau, chevauchement exact de deux pièces, tour hors plateau ou sur une pièce, tour absente en multicouleur, pièce sans pm_reference, filament absent de la table, plage de lissage hors de la pièce, dimensions inconnues) ; rien n'est écrit pour un plateau en erreur. Sinon, dans Plaisir-Maths/PRODUCTION/PLATEAUX/A_TRANCHER/<plateau>/ : <modèle>.3mf (géométrie seule, un objet par pièce, nom = pm_reference, déterministe donc même empreinte si rien ne change) et <modèle>.json (format 1 : plateau, jeu, modele_machine, source, empreinte = sha256 du 3MF, filaments, tour_vidage, objets avec boite et lissage en coordonnées plateau). Le JSON est écrit en dernier. Le module ne tranche pas : le serveur ajoute les réglages et tranche (OrcaSlicer).
  • Exemple synthétique : docs/exemples/plateaux/ ; essai : PlaisirMaths/tests/test_plateaux.py.

Bibliothèque d'éléments

Une pièce partagée entre plusieurs jeux (cheville, vis, pièce achetée) a un seul fichier maître dans CONCEPTION/Bibliothèque/ (<référence> <nom>.FCStd, plage PM-CE-1500 à 1599) ; les CAD des jeux la référencent par un App::Link externe relatif. Nom, référence, matériau et procédé viennent du maître. Spécification : CONCEPTION/Bibliothèque/Bibliothèque - spécification.md.

  • Panneau « Bibliothèque » : arbre des éléments (vignette, nom, référence), recherche, bouton « Insérer » (lien dans le groupe _COLL sélectionné, × n exemplaires = tableau de liens).
  • Publier dans la bibliothèque : copie la pièce sélectionnée dans un nouveau maître, limitée à sa chaîne géométrique (valeurs des tableurs/VarSet figées, esquisse posée sur une autre pièce détachée, vérification d'un seul objet exportable et du même volume ; sinon rien n'est écrit), avec son matériau (référence libre proposée, ligne ajoutée à Table des références.csv), puis remplace la pièce et ses clones de même matériau par des liens ; les originaux sont masqués, en pm_exporter = Faux, dans un groupe hors _COLL.
  • Ajouter une variante (bouton du panneau) : crée le maître d'une variante de couleur d'un élément (ou de sa source) : un App::Link externe masqué vers la géométrie de la source et un clone Draft de ce lien, qui porte _STEP, les pm_*, pm_variante_de et le matériau choisi. Option « Remplacer dans le document actif ».
  • Remplacer dans le document actif (bouton du panneau) : remplace par des liens les pièces locales de même forme (volume, aire et inerties, quelle que soit l'orientation) et de même matériau, clones chaînés compris, à leur place dans leur groupe _COLL ou leur composé ; compare les quantités par collection avant et après.
  • Vérifier la bibliothèque : un objet exportable par maître, champs obligatoires, références uniques dans la plage, vignette ; réécrit bibliotheque.json (contrat avec l'application). Le panneau affiche aussi les maîtres invalides (icône d'erreur, raison au survol). Aucune BOM n'est écrite à côté d'un maître.
  • Export : une pièce venue d'un lien prend tout du maître et porte le champ optionnel bibliotheque (chemin du maître relatif à CONCEPTION/Bibliothèque/) ; format plaisir-maths-bom toujours en version 1. Les fichiers STEP/3MF d'un élément sont écrits dans l'export de chaque jeu, nommés d'après pm_nom.
  • Maître d'une variante de couleur : un clone Draft (label _STEP, matériau propre) d'un App::Link local vers <Famille> - géométrie.FCStd. Un App::Link seul ne convient pas : il transmet ShapeMaterial à la géométrie, qui serait alors partagée par toutes les couleurs.
  • Visserie (atelier Fasteners) : reconnue sans maître, cherchée dans Visserie/Visserie.csv (norme, diamètre, longueur, matière) ; procédé achat, nom et référence de la table. Absente de la table : avertissement avec la ligne à ajouter.
  • Miroirs (décision de Pierre du 06/11) : un Part::Mirroring crée une pièce différente, avec son propre nom (_STEP) et sa propre référence ; pour dupliquer une pièce, on utilise un clone, un lien tourné ou un réseau. Pour les documents existants, la propriété pm_miroir du miroir (groupe PlaisirMaths) a deux valeurs : piece_differente (défaut) et memes_pieces (l'original et son image sont 2 exemplaires des mêmes pièces par unité de pm_quantite : une pièce, un élément de bibliothèque, une vis ou le contenu d'un composé). « Ajouter les propriétés » la pré-remplit d'après le comptage d'avant (composé ou groupe et vis Fasteners : memes_pieces ; pièce nommée : piece_differente) pour qu'aucune quantité ne change en silence ; le Ménage affiche la colonne.
  • Avertissements : miroir sans pm_miroir dont l'image est identique à sa source, miroir en pièce différente sans nom ni référence propre, miroir memes_pieces avec une quantité > 1 (rappel du total), lien ou maître introuvable (pièce ignorée), maître avec modifications non enregistrées (souvent un matériau changé depuis un lien : lien.ShapeMaterial écrit dans le maître), apparence remplacée (Override Material, interface seulement), pièce locale qui porte une référence de la plage (copie) ou ressemble à un élément (même nom ou même géométrie à 0,1 %).
  • Dossier de la bibliothèque : trouvé en remontant jusqu'à CONCEPTION/, ou paramètre DossierBibliotheque.

Référence

Propriétés PlaisirMaths

Propriété Sur Contenu Pré-remplie avec
pm_reference pièce PM-CE-XXXX ou PM-CO-XXXX, sans la version —
pm_version pièce numéro de version (0 = non renseigné) —
pm_nom pièce nom stable affiché dans l'application l'étiquette sans _STEP/_STL/_SVG ni _P1S
pm_procede pièce impression_3d, decoupe_laser, impression_dtf, pressage_a_chaud, decoupe_atelier, achat decoupe_laser pour _SVG, achat hors CAO, impression_3d sinon
pm_materiaux pièce matériaux saisis à la main, utilisés seulement si aucun matériau FreeCAD n'est choisi —
pm_poids_g pièce poids mesuré en grammes (0 = non mesuré) —
pm_exporter pièce faux pour l'écarter de la BOM et de l'export sans la renommer vrai
pm_quantite instance dans une collection (pièce, clone ou lien) nombre que compte cette instance 1
pm_remarque membre d'une collection remarque de nomenclature —

Une valeur déjà saisie n'est jamais modifiée par « Ajouter les propriétés », qui peut être relancée à tout moment.

Bibliothèque de matériaux

Un fichier .FCMat par matériau (couleur, densité) dans Plaisir-Maths/CONCEPTION/Matériaux/ (paramètre DossierMateriaux pour l'imposer), généré à partir de WebApp/MATERIAUX.md par materiaux.generer_bibliotheque(), qui ne modifie jamais un fichier existant. On peut ajouter des matériaux avec l'éditeur de matériaux de FreeCAD ; ils sont partagés par Nextcloud. Un matériau choisi hors de cette bibliothèque est signalé dans la BOM.

Ménage

Le bouton Ménage aide à trier les anciennes pièces : pour chaque pièce, visible ou masquée, objets qui la prennent comme entrée, présence dans le dernier export, doublon probable (même nom, ou même volume et même boîte englobante à 0,1 % près). Les pièces décochées passent à pm_exporter = Faux ; rien n'est renommé ni supprimé. Avec les collections, il suffit souvent de ne pas ranger une pièce dans un groupe _COLL.

Table des références

Les références PM-CE-XXXX ne sont jamais numérotées par le module seul : elles passent par CONCEPTION/Table des références.csv (séparateur ;), une ligne par pièce : document ; objet_cao ; suggestion ; pm_reference ; pm_version ; pm_nom ; pm_procede ; remarques. Cette table, déjà appliquée, fait foi : on la complète à la main pour les nouvelles pièces (plages par jeu : Maths et Sport 1000, ADP 1100, HexaGo 1200, H7 Junior 1300, H11 1400, H14 Luxe 1500, Labycoop 1600, Ressources 1900). Appliquer la table des références n'écrit pm_reference et pm_version que s'ils sont vides, pm_nom et pm_procede que s'ils ont encore leur valeur pré-remplie ; les différences sont signalées comme conflits.

Fichiers <Document>.bom.json et <Document>.BOM.md

À chaque enregistrement d'un document qui contient des pièces ou des collections, le module écrit à côté du .FCStd :

  • <Document>.bom.json : la nomenclature au format plaisir-maths-bom version 1 (pièces, lignes de nomenclature par collection, paramètres = cellules nommées des tableurs, empreinte SHA-256 du .FCStd, avertissements). Les chemins sont relatifs au dossier Plaisir-Maths qui contient le document (paramètre Racine pour l'imposer) ;
  • <Document>.BOM.md : le même contenu lisible, une section par collection puis les avertissements.

Le JSON est écrit même si la nomenclature est incomplète : les problèmes (référence ou matériau manquant, doublon, pièce orpheline, quantité invalide, lien qui ne désigne pas une pièce…) sont listés dans avertissements. Une erreur pendant cette écriture n'empêche jamais l'enregistrement du document. Les fichiers du dernier export restent listés dans fichiers aux enregistrements suivants, tant qu'ils existent, jusqu'au prochain export.

Les anciennes feuilles Nomenclature et PiecesHorsCAO ne sont plus lues (un avertissement le signale si elles contiennent des données) ; elles peuvent être supprimées.

Formats

  • STEP : la couleur de chaque face est embarquée (entités de couleur AP214). À ce jour, BambuStudio et PrusaSlicer l'ignorent à l'import.
  • 3MF : géométrie seule (pas de couleur ni de matériau) avec cette version de FreeCAD.