Draft Upgrade/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(44 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Draft_Split/fr|Fractionner]]
|[[Draft_Split/fr|Scinder]]
|[[Draft_Downgrade/fr|Rétrograder]]
|[[Draft_Downgrade/fr|Désagréger]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Split.svg
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconR=Draft_Downgrade.svg
Line 9: Line 10:
}}
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/fr
{{GuiCommand/fr
|Name=Draft Upgrade
|Name=Draft Upgrade
|Name/fr=Draft Mettre à niveau
|Name/fr=Draft Agréger
|MenuLocation=ModificationAgréger
|Workbenches=[[Draft Module/fr|Draft]], [[Arch Module/fr|Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|MenuLocation=DraftMettre à niveau
|Shortcut={{KEY|U}} {{KEY|P}}
|Shortcut={{KEY|U}} {{KEY|P}}
|SeeAlso=[[Draft Downgrade/fr|Draft Rétrograder]], [[Part Union/fr|Part Union]]
|SeeAlso=[[Draft_Downgrade/fr|Draft Désagréger]]
}}
}}
</div>


==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]].
<div class="mw-translate-fuzzy">
L'outil {{Button|[[Image:Draft Upgrade.svg|16px]] [[Draft Upgrade/fr|Draft Mettre à niveau]]}} met à niveau les objets sélectionnés de différentes façons.
</div>

L'outil Mettre à niveau effectue des tâches telles que la création de faces et la fusion de différents éléments. Cet outil fonctionne avec les éléments Draft 2D. Pour fusionner des solides 3D, utilisez [[Part Union/fr|Part Union]] et les opérations booléennes associées de [[Part Workbench/fr|l'atelier Part]] et les [[PartDesign Boolean/fr|opérations booléennes]] de [[PartDesign Workbench/fr|l'atelier PartDesign]].

La contrepartie de cet outil est l'opération {{Button|[[Image:Draft Downgrade.svg|16px]] [[Draft Downgrade/fr|Draft Rétrograder]]}}.


[[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|Fil ouvert mis à niveau en fil fermé, puis en face; un carré fermé transformé en face, puis fusionné avec la face précédente}}


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


#Sélectionnez un ou plusieurs objets que vous souhaitez mettre à niveau.
# En option, sélectionnez un ou plusieurs objets.
# Il existe plusieurs façons de lancer la commande :
#Cliquez sur le bouton {{Button|[[Image:Draft Upgrade.svg|16px]] [[Draft_Upgrade/fr|Mettre à niveau]]}} ou appuyez sur les touches {{KEY|U}} puis {{KEY|P}}. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un.
#* 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>
Les objets sélectionnés sont modifiés ou mis à niveau dans les conditions suivantes, dans l'ordre:
==Remarques==
# S'il y a plus d'une face dans la sélection, les faces sont fusionnées (union).
# S'il n'y a qu'une seule face dans la sélection, rien n'est fait.
# S'il n'y a qu'un seul fil ouvert dans la sélection, il se ferme et fait une face.
# S'il n'y a que des arêtes dans la sélection, toutes les arêtes sont jointes en un fil et ce dernier est fermé si possible.
# Si rien de ce qui précède n'est possible, un objet composé est créé.


* 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]] .
Il est intéressant d'essayer de mettre à niveau une sélection plusieurs fois pour voir si une meilleure forme est obtenue. Par exemple:
# La mise à niveau de deux [[Draft Line/fr|lignes]] connectées à une extrémité donnera un fil non modifiable.
# La mise à niveau de cet élément ajoutera une troisième ligne et fermera le fil non éditable.
# Une nouvelle mise à niveau de cet élément ajoutera une face au fil fermé et non modifiable.
# Une nouvelle mise à niveau de cet élément le transformera en un [[Draft Wire/fr|fil]], qui peut être entièrement modifié et toutes ses propriétés modifiées.

Le fil résultant peut être mieux manipulé que les lignes d'origine. La fusion de lignes simples peut également être effectuée directement à l'aide de l'outil [[Draft Wire/fr|fil]]. Certaines opérations de fusion peuvent également être effectuées avec l'outil [[Part Union/fr|Part Union]].

==Options==

Il n'y a pas d'options pour cet outil. Cela fonctionne avec les objets sélectionnés ou non.


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


{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD Scripting Basics]].
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].


Pour mettre à jour des objets, utilisez la méthode {{incode|upgrade}} de l'atelier Draft.
L'outil Mettre à niveau peut être utilisé dans une [[macros/fr|macro]] et dans la console [[Python/fr|Python]] en utilisant la fonction suivante :


{{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)
}}
}}


* Met à niveau les {{incode|objets}} donnés, qui peuvent être un objet unique ou une liste d'objets.
* {{incode|objects}} contient les objets à mettre à jour. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
* Si {{incode|delete}} est {{incode|True}}, les anciens objets sont supprimés.
* Si {{incode|delete}} est {{incode|True}}, les objets sources sont supprimés.
* Si {{incode|force}} est donné, c'est la fonction interne à appeler pour forcer un certain mode de mise à niveau. Il peut s'agir de: {{incode|"makeCompound"}}, {{incode|"closeGroupWires"}}, {{incode|"makeSolid"}}, {{incode|"closeWire"}}, {{incode|"turnToParts"}}, {{incode|"makeFusion"}}, {{incode|"makeShell"}}, {{incode|"makeFaces"}}, {{incode|"draftify"}}, {{incode|"joinFaces"}}, {{incode|"makeSketchFace"}}, {{incode|"makeWires"}}, or {{incode|"turnToLine"}}.
* {{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 renvoyé, qui est une liste contenant deux listes: une liste de nouveaux objets ({{incode|addList}}) et une liste d'objets à supprimer ({{incode|deleteList}}) .
* {{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=
{{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/fr
{{Docnav/fr
|[[Draft_Split/fr|Fractionner]]
|[[Draft_Split/fr|Scinder]]
|[[Draft_Downgrade/fr|Rétrograder]]
|[[Draft_Downgrade/fr|Désagréger]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Split.svg
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconR=Draft_Downgrade.svg
Line 109: Line 101:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{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()