Draft Upgrade/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(75 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{docnav|[[Draft_Split|Split]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft]]|IconL=Draft_Split.svg|IconC=Workbench_Draft.svg|IconR=Draft_Downgrade.svg}}


{{Docnav/fr
<div class="mw-translate-fuzzy">
|[[Draft_Split/fr|Scinder]]
{{GuiCommand/fr|Name=Draft Upgrade|Name/fr=Mettre à niveau Draft|Workbenches=[[Draft Module/fr|Draft]], [[Arch Module/fr|Arch]]|MenuLocation=Pièce → Mettre à niveau|Shortcut=U P|SeeAlso=[[Draft Downgrade/fr|Rétrograder]]}}
|[[Draft_Downgrade/fr|Désagréger]]
</div>
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand/fr
==Description==
|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==
<div class="mw-translate-fuzzy">
Cet outil met à niveau les objets sélectionnés de différentes façons. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un.
</div>


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]].
The Upgrade tool performs things such as creating faces and fusing different elements. This tool works with 2D Draft elements. To fuse 3D solids use [[Part Union]] and related Boolean operations of the [[Part Workbench]], and [[PartDesign Boolean]] of the [[PartDesign Workbench]].

The counterpart to this tool is the [[Draft Downgrade]] operation.


[[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.}}
{{Caption|Open wire upgraded to a closed wire, then to a face; a closed square upgraded to a face, and then fused with the previous face}}


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


# En option, sélectionnez un ou plusieurs objets.
<div class="mw-translate-fuzzy">
#Sélectionnez un ou plusieurs objets que vous souhaitez mettre à niveau
# Il existe plusieurs façons de lancer la commande :
#Cliquez sur le bouton {{KEY|[[Image:Draft Upgrade.png|16px]] [[Draft_Upgrade/fr|Mettre à niveau]]}} 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.
</div>
#* 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>
The selected objects are modified or upgraded according to the following conditions, in order:
==Remarques==
# If there are more than one face in the selection, the faces are merged (union).
# If there is only one face in the selection, nothing is done.
# If there is only one open wire in the selection, it gets closed, making a face.
# If there are only edges in the selection, all edges are joined into a wire, and the wire is closed if possible.
# If none of the above is possible, a compound object is created.


* 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]] .
It is worth trying to upgrade a selection several times to see if a better shape is obtained. For example:
# Upgrading two [[Draft Line]]s connected at one end will result in a non-editable wire.
# Upgrading this element again will add a third line and close the non-editable wire.
# Upgrading this element again will add a face to the closed, non-editable wire.
# Upgrading this element again will turn it into a [[Draft Wire]], which can be fully edited, and all its properties modified.


<span id="Scripting"></span>
The resulting wire can be better manipulated than the original lines. The fusion of single lines can also be done directly with the [[Draft Wire]] tool. Some fusion operations can also be done with the [[Part Union|Part Union]] tool.

==Options==

<div class="mw-translate-fuzzy">
Les objets sélectionnés sont modifiés/mis à niveau en suivant 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 y a seulement des arêtes (edges), toutes les arêtes sont raccordées en un fil (wire) (fermé si possible).
* Si aucune de ces actions n'est possible, un objet composé sera créé.
</div>

<div class="mw-translate-fuzzy">
==Script==
==Script==
</div>


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
<div class="mw-translate-fuzzy">

L'outil mettre à niveau peut être utilisé dans un script Python ou dans une [[macros/fr|macro]] en faisant :
Pour mettre à jour des objets, utilisez la méthode {{incode|upgrade}} de l'atelier Draft.
</div>


{{Code|code=
{{Code|code=
upgrade_list = upgrade(objects, delete=False, force=None)
upgrade_list = upgrade(objects, delete=False, force=None)
addList, deleteList = upgrade(objects, delete=False, force=None)
}}
}}


* {{incode|objects}} contient les objets à mettre à jour. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
<div class="mw-translate-fuzzy">
* Si {{incode|delete}} est {{incode|True}}, les objets sources sont supprimés.
* Met à niveau l'objet(s) sélectionné (qui peut être un objet ou une liste d'objets).
* {{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"}}.
* Si supprimer est sur True, les anciens objets sont supprimés.
* {{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.
* 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.
</div>


Exemple:
Exemple :


{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
Circle = Draft.makeCircle(1000)
Rectangle = Draft.makeRectangle(2000, 800)


circle = Draft.make_circle(1000)
addList1, deleteList1 = Draft.upgrade([Circle, Rectangle], delete=False)
rectangle = Draft.make_rectangle(2000, 800)
fused = addList1[0]
doc.recompute()


add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=False)
Line1 = Draft.makeLine(FreeCAD.Vector(2000, 0, 0), FreeCAD.Vector(2500, 1500, 0))
Line2 = Draft.makeLine(FreeCAD.Vector(2500, 1500, 0), FreeCAD.Vector(3000, -1000, 0))
addList2, deleteList2 = Draft.upgrade([Line1, Line2], delete=False)


line1 = Draft.make_line(App.Vector(2000, 0, 0), App.Vector(2500, 1500, 0))
simple_wire = addList2[0]
line2 = Draft.make_line(App.Vector(2500, 1500, 0), App.Vector(3000, -1000, 0))
addList3, deleteList3 = Draft.upgrade(simple_wire, delete=False)
doc.recompute()


add_list2, delete_list2 = Draft.upgrade([line1, line2], delete=False)
closed_wire = addList3[0]
addList4, deleteList4 = Draft.upgrade(closed_wire, delete=False)


face = addList4[0]
simple_wire = add_list2[0]
addList5, deleteList5 = Draft.upgrade(face, delete=False)
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|[[Draft_Split|Split]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft]]|IconL=Draft_Split.svg|IconC=Workbench_Draft.svg|IconR=Draft_Downgrade.svg}}


{{Docnav/fr
{{Draft Tools navi}}
|[[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}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

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()