Draft Downgrade/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(100 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/fr|Name=Draft Downgrade|Name/fr=Rétrograder|Workbenches=[[Draft Module/fr|Draft]]|MenuLocation=Draft → Rétrograder|Shortcut=D N}}

{{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|Draft Rétrograder]]}} 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.
#* 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>
==Options==
==Script==


Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].
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.


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


{{Code|code=
<gallery widths="300" heights="200">
downgrade_list = downgrade(objects, delete=False, force=None)
File:Draft Downgrade 01.png|Forme complète
}}
File:Draft Downgrade 02.png|Forme dégradée, avec éclatement des faces
</gallery>


* {{incode|objects}} contient les objets à déclasser. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
==Script==
* Si {{incode|delete}} est {{incode|True}}, les objets sources sont supprimés.
* {{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|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 :
L'outil Rétrograder peut être utilisé dans un script Python ou dans une [[macros/fr|macro]] en utilisant la fonction suivante :


{{Code|code=
<syntaxhighlight>
import FreeCAD as App
downgrade (objects [delete], [force])
import Draft
</syntaxhighlight>


doc = App.newDocument()
* Downgrades les objet(s) donnés (qui peut être un objet ou une liste d'objets).
* Si delete est sur True, les anciens objets 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.
* Retourne un dictionnaire contenant deux listes, une liste des nouveaux objets et une liste d'objets à supprimer


circle = Draft.make_circle(1000)
Exemple:
rectangle = Draft.make_rectangle(2000, 800)
doc.recompute()


add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=True)
<syntaxhighlight>
import FreeCADGui,Draft
selection = FreeCADGui.Selection.getSelection()
Draft.downgrade(selection)
</syntaxhighlight>


compound = add_list1[0]
<languages/>
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()
}}


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