Draft Upgrade/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(23 intermediate revisions by 2 users not shown)
Line 3: Line 3:
{{Docnav/fr
{{Docnav/fr
|[[Draft_Split/fr|Scinder]]
|[[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 12: Line 12:
{{GuiCommand/fr
{{GuiCommand/fr
|Name=Draft Upgrade
|Name=Draft Upgrade
|Name/fr=Draft Mettre à niveau
|Name/fr=Draft Agréger
|MenuLocation=Modification → Mettre à niveau
|MenuLocation=Modification → Agréger
|Workbenches=[[Draft_Module/fr|Draft]], [[Arch_Module/fr|Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Shortcut={{KEY|U}} {{KEY|P}}
|Shortcut={{KEY|U}} {{KEY|P}}
|SeeAlso=[[Draft_Downgrade/fr|Draft Rétrograder]]
|SeeAlso=[[Draft_Downgrade/fr|Draft Désagréger]]
}}
}}


==Description==
==Description==


La commande [[Image:Draft_Upgrade.svg|24px]] '''Draft Mettre à niveau''' met à niveau les objets 2D 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 Rétrograder]].
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]].


[[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 mise à niveau vers une face. Les deux faces sont ensuite mises à niveau pour créer un composé, qui est finalement mis à niveau vers une polyligne Draft modifiable.}}
{{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==


# 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 {{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.
</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]].


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


* [[Draft_Line|Draft Lines]] and [[Draft_Wire|Draft Wires]] can be joined with this command, but also with the [[Draft_Join|Draft Join]] command or the [[Draft_Wire|Draft Wire]] command.
* 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]] .


<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]].
<div class="mw-translate-fuzzy">
Voir aussi: [https://www.freecadweb.org/api Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts FreeCAD]].
</div>


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


{{Code|code=
{{Code|code=
Line 51: Line 52:
}}
}}


* {{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 les {{incode|objets}} donnés, qui peuvent être un objet unique 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 {{incode|delete}} est {{incode|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.
* 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|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}}) .
</div>


Exemple :
Exemple :
Line 93: Line 92:
{{Docnav/fr
{{Docnav/fr
|[[Draft_Split/fr|Scinder]]
|[[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

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