Draft Downgrade/fr: Difference between revisions

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

{{Docnav/fr
{{Docnav/fr
|[[Draft_Upgrade/fr|Mettre à niveau]]
|[[Draft_Upgrade/fr|Agréger]]
|[[Draft_WireToBSpline/fr|Polyligne vers B-spline]]
|[[Draft_Scale/fr|Echelle]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Upgrade.svg
|IconL=Draft_Upgrade.svg
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Scale.svg
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Draft Downgrade
|Name=Draft Downgrade
|Name/fr=Rétrograder Draft
|Name/fr=Draft Désagréger
|MenuLocation=ModificationDésagréger
|Workbenches=[[Draft Module/fr|Atelier Draft]], [[Arch Module/fr|Atelier Arch]]
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|MenuLocation=DraftRétrograder
|Shortcut=D N
|Shortcut={{KEY|D}} {{KEY|N}}
|SeeAlso=[[Draft Upgrade/fr|Mettre à niveau Draft]], [[Part Cut/fr|Soustraction Part]]
|SeeAlso=[[Draft_Upgrade/fr|Draft Agréger]], [[Part_Cut/fr|Part Soustraction]]
}}
}}


==Description==
==Description==


La commande [[Image:Draft_Downgrade.svg|24px]] '''Draft Désagréger''' déclasse 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 déconstruire un solide 3D en faces séparées et un fil en arêtes séparées. Si deux faces sont sélectionnées, un objet [[Part_Cut/fr|Part Soustraction]] est créé à partir de celles-ci. Notez que tous les objets ne peuvent pas être déclassés. Cette commande est le pendant de la commande [[Draft_Upgrade/fr|Draft Agréger]].
Cet outil met à niveau les objets sélectionnés de différentes façons.

L'outil Rétrograder effectue des opérations telles que casser des faces et déconstruire des fils (wires) en unité. Il peut couper une forme avec une autre forme de la même manière que [[Part Cut/fr|SoustractionPart]].

La contrepartie de cet outil est l'opération [[Draft Upgrade/fr| Mettre à Niveau Draft]].


[[Image:Draft_Downgrade_example.jpg|400px]]
[[Image:Draft_Downgrade_example.jpg|400px]]
{{Caption|Deux faces se chevauchant sont déclassées en un objet Part Soustraction, qui est déclassé en une face. Cette face est ensuite déclassée en un fil fermé, qui est finalement déclassé en arêtes séparées.}}
{{Caption|Figure soustraite d'une autre figure puis rétrogradé en un fil fermé puis rétrogradé en segments}}


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


# Sélectionnez un ou plusieurs objets que vous souhaitez rétrograder.
# En option, sélectionnez un ou plusieurs objets.
# Il existe plusieurs façons de lancer la commande :
# Appuyez sur le bouton {{Button | [[Image: Draft Downgrade.png | 16px]] [[Draft Downgrade/fr|Rétrograder Draft]]}} ou appuyez sur les touches {{KEY|D}} puis {{KEY|N}}. Si aucun objet n'est sélectionné, vous serez invité à en sélectionner un.
#* Appuyez sur le bouton {{Button|[[Image:Draft_Downgrade.svg|16px]] [[Draft_Downgrade/fr|Désagréger]]}}.
#* Sélectionnez l'option {{MenuCommand|Modification → [[Image:Draft_Downgrade.svg|16px]] Désagréger}} dans le menu.
#* Utilisez le raccourci clavier : {{KEY|D}} puis {{KEY|N}}.
# Si vous n'avez pas encore sélectionné d'objet : sélectionnez un objet dans la [[3D_view/fr|Vue 3D]].


<span id="Scripting"></span>
Les objets sélectionnés sont modifiés/rétrogradés à un niveau inférieur, en suivant l'ordre de cette liste :
==Script==
# Si un seul objet est sélectionné et qu'il contient plusieurs faces, chaque face devient un objet séparé.
# S'il y a plus d'une face dans la sélection, les objets suivants sont soustraits de la première.
# S'il n'y a qu'une seule face dans la sélection, elle est convertie en un fil.
# Sinon, tous les fils trouvés dans la sélection sont éclatés en une seule arête.


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
==Options==


Pour désagréger des objets, utilisez la méthode {{incode|downgrade}} du module Draft.
Il n'y a pas d'options pour cet outil. Cela fonctionne avec les objets sélectionnés ou non.

==Exemple==

<gallery widths="300" heights="200">
File:Draft Downgrade 01.png|Forme complète
File:Draft Downgrade 02.png|Forme dégradée, avec éclatement des faces
</gallery>

==Script==
{{Emphasis|Voir aussi:}} [[Draft API/fr|Draft API]] et [[FreeCAD Scripting Basics/fr|FreeCAD scripts de base]].

L'outil Rétrograder peut être utilisé dans une [[macros/fr|macro]] et dans la console [[Python/fr|Python]] en utilisant la fonction suivante:


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


* Rétrograde les {{incode|objects}} sélectionnés: soit un objet unique ou une liste d'objets.
* {{incode|objects}} contient les objets à déclasser. 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 qui force selon une certaine manière de déclasser. Cela peut être: {{incode|"explode"}}, {{incode|"shapify"}}, {{incode|"subtr"}}, {{incode|"splitFaces"}}, {{incode|"cut2"}}, {{incode|"getWire"}} ou {{incode|"splitWires"}}.
* {{incode|force}} force une certaine manière de désagréger en appelant une fonction interne spécifique. Cela peut être : {{incode|"explode"}}, {{incode|"shapify"}}, {{incode|"subtr"}}, {{incode|"splitFaces"}}, {{incode|"cut2"}}, {{incode|"getWire"}}, {{incode|"splitWires"}} ou {{incode|"splitCompounds"}}.
* {{incode|upgrade_list}} est renvoyé laquelle liste contient deux listes: une liste de nouveaux objets ({{incode|addList}}) et une liste d'objets à supprimer ({{incode|deleteList}}).
* {{incode|downgrade_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()
# Create an union
Circle = Draft.makeCircle(1000)
Rectangle = Draft.makeRectangle(2000, 800)


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


add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=True)
# Downgrade the union twice
addList2, deleteList2 = Draft.downgrade(union, delete=False)
wire = addList2[0]


compound = add_list1[0]
list_edges, deleteList3 = Draft.downgrade(wire, delete=False)
add_list2, delete_list2 = Draft.downgrade(compound, delete=False)
face = add_list2[0]
add_list3, delete_list3 = Draft.downgrade(face, delete=False)


box = doc.addObject("Part::Box", "Box")
# Insert a solid box
box.Length = 2300
Box = FreeCAD.ActiveDocument.addObject("Part::Box", "Box")
Box.Length = 2300
box.Width = 800
Box.Width = 800
box.Height = 1000
Box.Height = 1000


list_faces, deleteList4 = Draft.downgrade(Box, delete=True)
add_list4, delete_list4 = Draft.downgrade(box, delete=True)

doc.recompute()
}}
}}



{{Docnav/fr
{{Docnav/fr
|[[Draft_Upgrade/fr|Mettre à niveau Draft]]
|[[Draft_Upgrade/fr|Agréger]]
|[[Draft_WireToBSpline/fr|Polyligne vers B-spline]]
|[[Draft_Scale/fr|Echelle Draft]]
|[[Draft_Module/fr|Atelier Draft]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Upgrade.svg
|IconL=Draft_Upgrade.svg
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Scale.svg
}}
}}


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

{{Userdocnavi/fr}}
{{clear}}

Latest revision as of 18:23, 8 December 2023

Draft Désagréger

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

Description

La commande Draft Désagréger déclasse 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 déconstruire un solide 3D en faces séparées et un fil en arêtes séparées. Si deux faces sont sélectionnées, un objet Part Soustraction est créé à partir de celles-ci. Notez que tous les objets ne peuvent pas être déclassés. Cette commande est le pendant de la commande Draft Agréger.

Deux faces se chevauchant sont déclassées en un objet Part Soustraction, qui est déclassé en une face. Cette face est ensuite déclassée en un fil fermé, qui est finalement déclassé en arêtes séparées.

Utilisation

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

Script

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

Pour désagréger des objets, utilisez la méthode downgrade du module Draft.

downgrade_list = downgrade(objects, delete=False, force=None)
  • objects contient les objets à déclasser. 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 désagréger en appelant une fonction interne spécifique. Cela peut être : "explode", "shapify", "subtr", "splitFaces", "cut2", "getWire", "splitWires" ou "splitCompounds".
  • downgrade_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=True)

compound = add_list1[0]
add_list2, delete_list2 = Draft.downgrade(compound, delete=False)
face = add_list2[0]
add_list3, delete_list3 = Draft.downgrade(face, delete=False)

box = doc.addObject("Part::Box", "Box")
box.Length = 2300
box.Width = 800
box.Height = 1000

add_list4, delete_list4 = Draft.downgrade(box, delete=True)

doc.recompute()