Macro MultiCopy/fr

Description
'MultiCopy' est une macro créée et destinée à être utilisée dans l'application FreeCAD. MultiCopy permet la duplication (copier-coller) de plusieurs objets FreeCAD qui peuvent être étiquetés séquentiellement et de manière personnalisée.

Voici l'icône MultiCopy Macro.

La macro MultiCopy peut être téléchargée en utilisant le Gestionnaire d'addons intégré au logiciel FreeCAD.

Caractéristiques principales

 * Deux méthodes de saisie : par la souris ou par le clavier (commandes de collage de code).
 * Méthodes de copie standard et de copie simple prises en charge
 * Duplication dans deux documents différents
 * Suppression des objets sélectionnés après la duplication
 * Duplication avec ou sans dépendances
 * Ajout de séparateurs d'étiquettes personnalisés
 * Ajout d'une numérotation supplémentaire aux étiquettes
 * Types de numérotation : Chiffres ordinaires, chiffres romains majuscules/minuscules et caractères alphabétiques majuscules/minuscules.
 * Des "commandes de collage de code" uniques qui permettent la duplication multiple de manière procédurale ainsi que dans des boucles imbriquées.
 * Les deux méthodes CUI et GUI disponibles



Linux
MultiCopy peut être installé manuellement, de manière similaire à l'installation de Windows, ou en utilisant le terminal de commande et ses commandes pertinentes, comme indiqué dans le fichier INSTALL.

Par défaut, le terminal de commande Linux peut être lancé en appuyant simultanément sur les touches suivantes du clavier :

Windows
MultiCopy peut être installé à l'aide des deux étapes suivantes :


 * 1) Téléchargez le fichier MultiCopy.zip file.
 * 2) Extrayez le contenu du fichier ZIP dans l'emplacement du répertoire de la macro utilisateur de FreeCAD.

Par défaut, le répertoire de la macro utilisateur de FreeCAD doit être situé à :

Utilisation - Méthode GUI
MultiCopy peut être chargé en effectuant les étapes suivantes :


 * 1) Lancez l'application FreeCAD.
 * 2) Allez dans.
 * 3) Cliquez sur l'onglet Macros utilisateur dans la boîte de dialogue contextuelle.
 * 4) Sélectionnez.
 * 5) Cliquez sur.

Avant de charger la macro MultiCopy, sélectionnez d'abord un ou plusieurs objets dans le doccument FreeCAD actif, puis chargez la macro. Ensuite, suivez les instructions de la boîte de dialogue, remplissez les entrées requises, et cliquez sur le bouton 'Paste'. En cas d'erreur ou d'avertissement, vous en serez automatiquement informé. Si vous rencontrez une erreur inattendue, communiquez-la en mentionnant la version de FreeCAD, en retraçant les étapes suivies et en précisant si un résultat a été généré (et dans quelle mesure).

Utilisation - Méthode CUI (console Python)
Avant d'exécuter l'opération MultiCopy, sélectionnez d'abord un ou plusieurs objets dans le document FreeCAD actif.

To perform the terminal-based operation:
The MultiCopy command is as follows :

The MultiCopy command's parameters are as follows : 1. Name             : paste_code Type             : String Is Optional      : False Description      : The paste code commands string. For indentations, use \'\\t\'. For line breaks, use \'\\n\'.

2. Name             : copy_type Type             : Boolean or String or Integer Is Optional      : True Description      : The copy operation mode. Acceptable Values : 'Standard', 'Simple', True, False, 1, 2  Default Value     : True

3. Name             : delete_selection Type             : Boolean Is Optional      : True Description      : If true, the selected objects are deleted after the MultiCopy operation. Default Value    : False

4. Name             : paste_document_label Type             : String or FreeCAD.Document Is Optional      : True Description      : The label of the document to paste to, or the document object itself. Default Value    : FreeCAD.ActiveDocument

Example 1 :
To paste the selected objects to the currently active document as a standard copy, and to not delete the selections after the operation.

Example 2 :
To paste the selected objects to a different document as a simple copy, and to delete the selections after the operation.

Commandes de collage de code


Les deux commandes récurrentes dans leur forme générique sont les suivantes :



Pendant la saisie des Commandes de code de collage dans la zone de texte de saisie concernée, il y a trois indications sous forme de bandes colorées situées en bas de la zone de texte :
 * 1) Noir indique que la zone de texte est focalisée, et que l'utilisateur est en train d'y saisir les commandes du code à coller.
 * 2) Rouge indique que la zone de texte est en dehors de la focalisation, et que les commandes entrées par l'utilisateur sont SYNTAXIQUEMENT INCORRECTES.
 * 3) Vert indique que la zone de texte est hors focus et que les commandes saisies par l'utilisateur sont SYNTAXIQUEMENT CORRECTES.

Exemple 1
from 1 to 3 : [1] = {1}-Something_{n#}

Les valeurs 1 et 3 représentent la plage de duplication où les deux valeurs sont INCLUSIVES. La première valeur (de) doit toujours être INFÉRIEURE OU ÉGALE à la deuxième valeur (à). Les valeurs (ensemble) peuvent prendre la forme de l'un des cinq types de numérotation (Vérifiez 'Caractéristiques principales').

représente le premier objet d'une liste supposée d'objets sélectionnés par l'utilisateur. représente le nom de l'étiquette du premier objet. représente une étiquette de numérotation du type 'Numériques ordinaires''. (on y reviendra, plus tard)

REMARQUEZ que des retraits de tabulation corrects sont cruciaux pour les commandes ; ils ne peuvent pas être remplacés par des espaces.

Les crochets ne sont utilisés que pour les commandes du deuxième type générique. Les crochets [ et ] se trouvent toujours à gauche de la commande ; tandis que les parenthèses { et } se trouvent toujours à droite de la commande.

Laissons le nom de l'étiquette originale du premier objet être Corps. Ensuite, les commandes ci-dessus produiraient un ensemble d'objets dupliqués (du premier objet), chacun étiqueté comme suit :

Body-Something_1 Body-Something_2 Body-Something_3

Représentation de l'objet
Soit i un i-ème objet arbitraire d'une liste supposée d'objets sélectionnés par l'utilisateur. représente le i-ième objet sans dépendances (par défaut). représente le i-ième objet sans dépendances (autre forme). représente le i-ième objet AVEC des dépendances incluses.

Les étiquettes de numérotation
code>{n#} ou  sont du type "Chiffres ordinaires". ou  ou   sont du type "Chiffres romains majuscules". ou  ou   sont du type "Chiffres romains minuscules". ou  ou   sont du type "Alphabet majuscule". ou  ou   sont de type "Alphabet minuscule".

Une étiquette de numérotation peut avoir deux options supplémentaires :
 * 1)   Padding (de chiffres 'X').
 * 2)   Assignation d'un niveau de boucle imbriquée (à une boucle étiquetée 'i1')

Dans le cas d'une affectation de niveau de boucle imbriquée SANS remplissage, faites :
 * 1)   OU

Exemple 2
from 1 to 2 : i1 : from a to b : i2 : [1|1] = Pasted-{1}-{n#3|i1}-{AU#0|i2}

Ici, les objets sont collés ainsi que les dépendances. L'étiquette 'Chiffre ordinaire' a un padding de '3', et l'étiquette 'Alphabet majuscule' a un padding de '0'.

NOTEZ comment la boucle 'from-to' utilise l'alphabet en minuscules ; mais l'étiquette sera sortie en majuscules. Les commandes ci-dessus produiraient un ensemble d'objets dupliqués (du premier objet) chacun étiqueté comme suit :

Pasted-Body-001-A Pasted-Body-001-B Pasted-Body-002-A Pasted-Body-002-B







Liens
[1] Dépôt Github de MultiCopy [2] Dépôt Github des macros FreeCAD - MultiCopy [3] Page de discussion du forum FreeCAD - MultiCopy