- Python 99.9%
- Shell 0.1%
| docs/exemples | ||
| PlaisirMaths | ||
| .gitignore | ||
| Align_View_to_Face.FCMacro | ||
| Align_View_to_Face.FCMacro.manifest | ||
| install.sh | ||
| Macro_Align_View_to_Face.png | ||
| MultiExport.FCMacro | ||
| README.md | ||
Plaisir-Maths pour FreeCAD (export, nomenclature, étiquettes)
Description
Module FreeCAD qui, à partir des fichiers de conception :
- exporte les pièces en un clic :
.step/.3mfpour l'impression 3D,.svgpour 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
- Pièces : l'étiquette d'une pièce se termine par
_STEP(pièce 3D ; l'ancien_STLest traité de la même façon) ou_SVG(découpe laser). - Collections : chaque collection est un composé (Part::Compound) ou un groupe de l'arbre dont le nom se termine par
_COLL, par exempleCOMPTEUR_COLLpour la collectionCOMPTEUR. 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/_SVGproduisent des fichiers à l'export. Une pièce_STEP/_SVGrangée dans aucune collection n'est ni exportée ni comptée (elle est signalée). - 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. - Quantités : bouton BOM, voir ci-dessous.
Procédure
- Ajouter les propriétés : groupe
PlaisirMathssur chaque pièce,pm_quantiteetpm_remarquesur chaque membre des groupes_COLL. - Appliquer la table des références : références, versions et noms validés.
- BOM : vérifier les collections, ajuster les quantités, ajouter les pièces hors CAO, lire les avertissements.
- Enregistrer (Ctrl+S) : la BOM est écrite automatiquement.
- Exporter : un fichier par pièce dans
<Document>-Export/, puis la BOM réécrite avecfichiers.
« 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>.3mfpour les pièces 3D ;<étiquette>.svgpour 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 lienpm_filament(défaut 1) etpm_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, dansPlaisir-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,objetsavecboiteetlissageen 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
_COLLsé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, enpm_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::Linkexterne masqué vers la géométrie de la source et un clone Draft de ce lien, qui porte_STEP, lespm_*,pm_variante_deet 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
_COLLou 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/) ; formatplaisir-maths-bomtoujours en version 1. Les fichiers STEP/3MF d'un élément sont écrits dans l'export de chaque jeu, nommés d'aprèspm_nom. - Maître d'une variante de couleur : un clone Draft (label
_STEP, matériau propre) d'unApp::Linklocal vers<Famille> - géométrie.FCStd. UnApp::Linkseul ne convient pas : il transmetShapeMaterialà 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::Mirroringcré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_miroirdu miroir (groupePlaisirMaths) a deux valeurs :piece_differente(défaut) etmemes_pieces(l'original et son image sont 2 exemplaires des mêmes pièces par unité depm_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_miroirdont l'image est identique à sa source, miroir en pièce différente sans nom ni référence propre, miroirmemes_piecesavec 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ètreDossierBibliotheque.
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 formatplaisir-maths-bomversion 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 dossierPlaisir-Mathsqui contient le document (paramètreRacinepour 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.