Draft Upgrade/fr: Difference between revisions

From FreeCAD Documentation
m (Created page with "* Met à niveau de l'objet(s) donné (peut être un objet ou une liste d'objets). * Si supprimer est sur True, les anciens objets sont supprimés. * L'attribut force peut ê...")
No edit summary
 
(96 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/fr|Name=Draft Upgrade|Name/fr=Draft Upgrade (monter au niveau supérieur)|Workbenches=[[Draft Module/fr|Draft]]|MenuLocation=Draft -> Upgrade|Shortcut=U P}}

{{Docnav/fr
|[[Draft_Split/fr|Scinder]]
|[[Draft_Downgrade/fr|Désagréger]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/fr
|Name=Draft Upgrade
|Name/fr=Draft Agréger
|MenuLocation=Modification → Agréger
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Shortcut={{KEY|U}} {{KEY|P}}
|SeeAlso=[[Draft_Downgrade/fr|Draft Désagréger]]
}}


==Description==
==Description==


La commande [[Image:Draft_Upgrade.svg|24px]] '''Draft Agréger''' assemble les objets sélectionnés. Le résultat dépend du nombre d'objets sélectionnés et de leur type. La commande peut par exemple fusionner des éléments et créer des faces. Il vaut la peine d'essayer d'améliorer une sélection plusieurs fois pour voir si un meilleur résultat peut être obtenu. Voir l'exemple dans l'image. Notez que tous les objets ne peuvent pas être mis à jour. Cette commande est le pendant de la commande [[Draft_Downgrade/fr|Draft Désagréger]].
Cet outil monte d'un niveau supérieur les objets sélectionnés de différentes façons. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un.


[[Image:Draft_Upgrade_example.jpg|400px]]
[[Image:Draft_Upgrade_example.jpg|400px]]
{{Caption|Une polyligne ouverte non modifiable est transformée en polyligne fermée, puis en une face. Une polyligne carrée fermée non modifiable est également promue vers une face. Les deux faces sont ensuite promues pour créer un composé, qui est finalement promu vers une polyligne Draft modifiable.}}


<span id="Usage"></span>
==Utilisation==
==Utilisation==


#Sélectionnez un ou plusieurs objets que vous souhaitez mettre à jour
# En option, sélectionnez un ou plusieurs objets.
# Il existe plusieurs façons de lancer la commande :
#Cliquez sur le bouton {{KEY|[[Image:Draft Upgrade.png|16px]] [[Draft_Upgrade/fr|Draft Upgrade]]}} ou pressez sur les touches {{KEY|U}} puis {{KEY|P}}
#* Appuyez sur le bouton {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/fr|Agréger]]}}.
#* Sélectionnez l'option {{MenuCommand|Modification → [[Image:Draft_Upgrade.svg|16px]] Agréger}} dans le menu.
#* Utilisez le raccourci clavier : {{KEY|U}} puis {{KEY|P}}.
# Si vous n'avez pas encore sélectionné d'objet : sélectionnez un objet dans la [[3D_view/fr|Vue 3D]].


<span id="Notes"></span>
==Options==
==Remarques==


* Les [[Draft_Line/fr|Draft Lignes]] et [[Draft_Wire/fr|Draft Polylignes]] peuvent être jointes avec cette commande, mais aussi avec la commande [[Draft_Join/fr|Draft Joindre]] ou la commande [[Draft_Wire/fr|Draft Polylignes]] .
Les objets sélectionnés sont modifiés/mis à jour à un niveau supérieur en suivant (Upgrade) l'ordre de cette liste :
* S'il y a plus d'une face sélectionnée, les faces sont fusionnées.
* S'il n'y a qu'une seule face, rien ne se passe.
* S'il n'y a qu'un seul fil (wire) ouvert, il sera fermé.
* S'il n'y a seulement des bords (edges), touts les bords (arêtes) sont raccordés en un fil (wire) (fermé si possible).
* Si aucune de ces actions n'est possible, un objet composé sera créé.


<span id="Scripting"></span>
==Script==
==Script==


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
L'outil upgrade peut être utilisé dans un script Python ou dans une [[macros]] en faisant :


Pour mettre à jour des objets, utilisez la méthode {{incode|upgrade}} de l'atelier Draft.
<syntaxhighlight>
Draft.upgrade(objects, delete=False, force=None)
</syntaxhighlight>


{{Code|code=
* Met à niveau de l'objet(s) donné (peut être un objet ou une liste d'objets).
upgrade_list = upgrade(objects, delete=False, force=None)
* Si supprimer est sur True, les anciens objets sont supprimés.
}}
* L'attribut force peut être utilisé pour forcer un certain mode de mise à niveau. Il peut être : makeCompound, closeGroupWires, makeSolid, closeWire, turnToParts, makeFusion, makeShell, makeFaces, draftify, joinFaces, makeSketchFace, makeWires
* retourne un dictionnaire contenant deux listes, une liste des nouveaux objets et une liste d'objets à supprimer


* {{incode|objects}} contient les objets à mettre à jour. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
Some of the operations of the Upgrade tool can also be made with the [[Part Fuse]] or [[Draft Wire]] tools.
* Si {{incode|delete}} est {{incode|True}}, les objets sources sont supprimés.
* {{incode|force}} force une certaine manière de mettre à niveau en appelant une fonction interne spécifique. Cela peut être : {{incode|"makeCompound"}}, {{incode|"closeGroupWires"}}, {{incode|"makeSolid"}}, {{incode|"closeWire"}}, {{incode|"turnToParts"}}, {{incode|"makeFusion"}}, {{incode|"makeShell"}}, {{incode|"makeFaces"}}, {{incode|"draftify"}}, {{incode|"joinFaces"}}, {{incode|"makeSketchFace"}}, {{incode|"makeWires"}} ou {{incode|"turnToLine"}}.
* {{incode|upgrade_list}} est retourné. C'est une liste contenant deux listes : une liste de nouveaux objets et une liste d'objets à supprimer. Si {{incode|delete}} est {{incode|True}}, la seconde liste est vide.


Exemple:
Exemple :


{{Code|code=
<syntaxhighlight>
import FreeCAD as App
import Draft
import Draft
mycircle = Draft.makeCircle(2)
face1 = Draft.upgrade([mycircle],True)
</syntaxhighlight>


doc = App.newDocument()
<languages/>

circle = Draft.make_circle(1000)
rectangle = Draft.make_rectangle(2000, 800)
doc.recompute()

add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=False)

line1 = Draft.make_line(App.Vector(2000, 0, 0), App.Vector(2500, 1500, 0))
line2 = Draft.make_line(App.Vector(2500, 1500, 0), App.Vector(3000, -1000, 0))
doc.recompute()

add_list2, delete_list2 = Draft.upgrade([line1, line2], delete=False)

simple_wire = add_list2[0]
add_list3, delete_list3 = Draft.upgrade(simple_wire, delete=False)

closed_wire = add_list3[0]
add_list4, delete_list4 = Draft.upgrade(closed_wire, delete=False)

face = add_list4[0]
add_list5, delete_list5 = Draft.upgrade(face, delete=False)

doc.recompute()
}}


{{Docnav/fr
|[[Draft_Split/fr|Scinder]]
|[[Draft_Downgrade/fr|Désagréger]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}

{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 17:02, 8 December 2023

Draft Agréger

Emplacement du menu
Modification → Agréger
Ateliers
Draft, Arch
Raccourci par défaut
U P
Introduit dans la version
-
Voir aussi
Draft Désagréger

Description

La commande Draft Agréger assemble les objets sélectionnés. Le résultat dépend du nombre d'objets sélectionnés et de leur type. La commande peut par exemple fusionner des éléments et créer des faces. Il vaut la peine d'essayer d'améliorer une sélection plusieurs fois pour voir si un meilleur résultat peut être obtenu. Voir l'exemple dans l'image. Notez que tous les objets ne peuvent pas être mis à jour. Cette commande est le pendant de la commande Draft Désagréger.

Une polyligne ouverte non modifiable est transformée en polyligne fermée, puis en une face. Une polyligne carrée fermée non modifiable est également promue vers une face. Les deux faces sont ensuite promues pour créer un composé, qui est finalement promu vers une polyligne Draft modifiable.

Utilisation

  1. En option, sélectionnez un ou plusieurs objets.
  2. Il existe plusieurs façons de lancer la commande :
    • Appuyez sur le bouton Agréger.
    • Sélectionnez l'option Modification → Agréger dans le menu.
    • Utilisez le raccourci clavier : U puis P.
  3. Si vous n'avez pas encore sélectionné d'objet : sélectionnez un objet dans la Vue 3D.

Remarques

Script

Voir aussi : Autogenerated API documentation et FreeCAD Débuter avec les scripts.

Pour mettre à jour des objets, utilisez la méthode upgrade de l'atelier Draft.

upgrade_list = upgrade(objects, delete=False, force=None)
  • objects contient les objets à mettre à jour. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
  • Si delete est True, les objets sources sont supprimés.
  • force force une certaine manière de mettre à niveau en appelant une fonction interne spécifique. Cela peut être : "makeCompound", "closeGroupWires", "makeSolid", "closeWire", "turnToParts", "makeFusion", "makeShell", "makeFaces", "draftify", "joinFaces", "makeSketchFace", "makeWires" ou "turnToLine".
  • upgrade_list est retourné. C'est une liste contenant deux listes : une liste de nouveaux objets et une liste d'objets à supprimer. Si delete est True, la seconde liste est vide.

Exemple :

import FreeCAD as App
import Draft

doc = App.newDocument()

circle = Draft.make_circle(1000)
rectangle = Draft.make_rectangle(2000, 800)
doc.recompute()

add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=False)

line1 = Draft.make_line(App.Vector(2000, 0, 0), App.Vector(2500, 1500, 0))
line2 = Draft.make_line(App.Vector(2500, 1500, 0), App.Vector(3000, -1000, 0))
doc.recompute()

add_list2, delete_list2 = Draft.upgrade([line1, line2], delete=False)

simple_wire = add_list2[0]
add_list3, delete_list3 = Draft.upgrade(simple_wire, delete=False)

closed_wire = add_list3[0]
add_list4, delete_list4 = Draft.upgrade(closed_wire, delete=False)

face = add_list4[0]
add_list5, delete_list5 = Draft.upgrade(face, delete=False)

doc.recompute()