Draft Downgrade/fr: Difference between revisions

From FreeCAD Documentation
(Created page with " Cet outil descend d'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.")
No edit summary
 
(120 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/fr|Name=Draft_Downgrade|Name/fr=Draft Downgrade (descend d'un niveau inférieur)|Workbenches=[[Draft Module/fr|Draft]]|MenuLocation=Draft -> Downgrade|Shortcut=D N}}


{{Docnav/fr
==Description==
|[[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==
Cet outil descend d'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.

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]].


[[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>
==How to use==
==Utilisation==


# En option, sélectionnez un ou plusieurs objets.
# Select one or more objects you widh to downgrade
# Il existe plusieurs façons de lancer la commande :
# Press the {{KEY|[[Image:Draft Downgrade.png|16px]] [[Draft Downgrade]]}} button or press {{KEY|D}} then {{KEY|N}} keys
#* 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]].
The selected objects are modified/downgraded, according to the following conditions (in order):
* if only one object is selected and it contains more than one face, each face becomes a separate object
* if there are more than one face in the selection, the subsequent objects are subtracted from the first one
* if there is only one face in the selection, it gets converted into a wire
* otherwise all wires found in the selection are exploded into single edges


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


{{Code|code=
<gallery widths="300" heights="200">
downgrade_list = downgrade(objects, delete=False, force=None)
File:Draft Downgrade 01.png|Complete shape
}}
File:Draft Downgrade 02.png|Downgraded shape, with disconnected and split faces
</gallery>


* {{incode|objects}} contient les objets à déclasser. Il s'agit soit d'un objet unique, soit d'une liste d'objets.
==Scripting==
* 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 :
The Downgrade tool can be used in python scripts and [[macros]] by using the following function:


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


doc = App.newDocument()
* Downgrades the given object(s) (can be an object or a list of objects).
* If delete is True, old objects are deleted.
* The force attribute can be used to force a certain way of downgrading. It can be: explode, shapify, subtr, splitFaces, cut2, getWire, splitWires.
* Returns a dictionnary containing two lists, a list of new objects and a list of objects to be deleted


circle = Draft.make_circle(1000)
Example:
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()