Draft Downgrade/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(87 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/fr|Name=Draft Downgrade|Name/fr=Rétrograder|Workbenches=[[Draft Module/fr|Draft]], [[Arch Module/fr|Arch]]|MenuLocation=Pièce → Rétrograder|Shortcut=D N|SeeAlso=[[Draft Upgrade/fr|Mise à Niveau]]}}

{{Docnav/fr
|[[Draft_Upgrade/fr|Agréger]]
|[[Draft_WireToBSpline/fr|Polyligne <=> B-spline]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Upgrade.svg
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/fr
|Name=Draft Downgrade
|Name/fr=Draft Désagréger
|MenuLocation=Modification → Désagréger
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]
|Shortcut={{KEY|D}} {{KEY|N}}
|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 rétrograde à un niveau infé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_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.}}


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


# Sélectionnez un ou plusieurs objets que vous voulez descendre d'un niveau inférieur.
# En option, sélectionnez un ou plusieurs objets.
# Il existe plusieurs façons de lancer la commande :
# Cliquez sur le bouton {{KEY|[[Image:Draft Downgrade.png|16px]] [[Draft_Downgrade/fr| Retrograder]]}} ou pressez les touches {{KEY|D}} puis {{KEY|N}}
#* 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.
==Options==
#* 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]].
Les objets sélectionnés sont modifiés/rétrogradés à un niveau inférieur, en suivant l'ordre de cette liste :
* Uniquement si un objet est sélectionné et qu'il contient plus d'une face, les faces sont séparées en différents objets.
* S'il y a plus d'une face, les faces subséquentes sont soustraites d'une face.
* S'il n'existe qu'une seule face, elle est convertie en un fil (wire).
* Dans le cas contraire tous les fils (wire) sont éclatés en arêtes (edges) uniques.

==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>


<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 Rétrograder peut être utilisé dans un script Python ou dans une [[macros/fr|macro]] en utilisant la fonction suivante :

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


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


* Démonte les objet(s) donnés (qui peut être un objet 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 "delete" est réglé "True", les anciens objets sont supprimés.
* Si {{incode|delete}} est {{incode|True}}, les objets sources sont supprimés.
* L'attribut Force peut être utilisé pour forcer un certain mode de déclassement. Il peut être : explode, shapify, subtr, splitFaces, cut2, getWire, 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"}}.
* Retourne un dictionnaire contenant deux listes, une liste des nouveaux objets et une liste d'objets à supprimer
* {{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 FreeCADGui,Draft
import FreeCAD as App
import Draft
selection = FreeCADGui.Selection.getSelection()

Draft.downgrade(selection)
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()
}}
}}



<languages/>
{{Docnav/fr
|[[Draft_Upgrade/fr|Agréger]]
|[[Draft_WireToBSpline/fr|Polyligne <=> B-spline]]
|[[Draft_Workbench/fr|Atelier Draft]]
|IconL=Draft_Upgrade.svg
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
}}

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

Latest revision as of 13:46, 7 April 2024

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