Draft Downgrade/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
Tag: Manual revert
 
(66 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Draft Downgrade|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Downgrade|Shortcut=D N|SeeAlso=[[Draft Upgrade|Draft Upgrade]]}}

{{Docnav/it
|[[Draft_Upgrade/it|Promuovi]]
|[[Draft_WireToBSpline/it|Polilinea in BSpline]]
|[[Draft_Workbench/it|Draft]]
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/it
|Name=Draft Downgrade
|Name/it=Declassa
|MenuLocation=Modifiche → Declassa
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|D}} {{KEY|N}}
|SeeAlso=[[Draft_Upgrade/it|Promuovi]], [[Part_Cut/it|Sottrazione booleana]]
}}


<span id="Description"></span>
==Descrizione==
==Descrizione==


Il comando [[Image:Draft_Downgrade.svg|24px]] '''Draft Declassa''' effettua il declassamento degli oggetti selezionati. Il risultato dipende dal numero di oggetti selezionati e dal loro tipo. Il comando può ad esempio scomporre un solido 3D in facce separate e una struttura filiforme in spigoli separati. Se sono selezionate due facce, da esse viene creato un oggetto [[Part_Cut/it|Sottrazione booleana]]. Si noti che non è possibile eseguire il declassamento di tutti gli oggetti. Questo comando è la controparte del comando [[Draft_Upgrade/it|Draft Promuovi]].
Questo strumento scompone gli oggetti selezionati (converte un oggetto in diversi oggetti di livello inferiore). Se nessun oggetto è selezionato, chiede di selezionarne uno.


[[Image:Draft_Downgrade_example.jpg|400px]]
[[Image:Draft_Downgrade_example.jpg|400px]]
{{Caption|Due facce sovrapposte vengono declassate a un oggetto Sottrazione booleana (Part Cut), che viene declassato a faccia. Quella faccia viene quindi declassata a un polilinea chiusa, che viene infine declassata a bordi separati.}}


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


# Selezionare uno o più oggetti che si desidera aggiornare
# Opzionalmente selezionare uno o più oggetti.
# Esistono diversi modi per invocare il comando:
# Premere il pulsante {{KEY/it|[[Image:Draft_Downgrade.png|16px]] Scomponi}} o premere i tasti {{KEY/it|D}} e {{KEY/it|N}}
#* Premiere il pulsante {{Button|[[Image:Draft_Downgrade.svg|16px]] [[Draft_Downgrade/it|Declassa]]}}.
#* Selezionare l'opzione {{MenuCommand|Modifiche → [[Image:Draft_Downgrade.svg|16px]] Declassa}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|D}} poi {{KEY|N}}.
# Se non si ha ancora selezionato un oggetto: selezionare un oggetto nella [[3D_view/it|Vista 3D]].


<span id="Scripting"></span>
== Opzioni ==
==Script==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
Gli oggetti selezionati vengono modificati, scomposti seguendo l'ordine di questa lista:
* se è selezionato un solo oggetto e esso contiene più di una faccia, le facce vengono separate in oggetti diversi
* se sono selezionate più facce, le facce successive vengono sottratte alla prima
* se è selezionata una sola faccia, essa viene convertita in un contorno
* negli altri casi i contorni vengono scomposti in segmenti separati


Per eseguire il declassamento degli oggetti utilizzare il metodo {{incode|downgrade}} del modulo Draft.
== Esempio ==


{{Code|code=
<gallery widths="300" heights="200">
downgrade_list = downgrade(objects, delete=False, force=None)
File:Draft Downgrade 01.png|Forma originale
}}
File:Draft Downgrade 02.png|Forma con le facce separate e distanziate
</gallery>


* {{incode|objects}} contiene gli oggetti di cui eseguire il declassamento. È un singolo oggetto o un elenco di oggetti.
== Script ==
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* {{incode|force}} forza un certo modo di declassare chiamando una specifica funzione interna. Può essere: {{incode|"explode"}}, {{incode|"shapify"}}, {{incode|"subtr"}}, {{incode|"splitFaces"}}, {{incode|"cut2 "}}, {{incode|"getWire"}}, {{incode|"splitWires"}} o {{incode|"splitCompounds"}}.
* Viene restituito {{incode|downgrade_list}}. È un elenco contenente due elenchi: un elenco di nuovi oggetti e un elenco di oggetti da eliminare. Se {{incode|delete}} è {{incode|True}} la seconda lista è vuota.


Esempio:
Lo strumento Downgrade può essere utilizzato nelle [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] tramite la seguente funzione:


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


doc = App.newDocument()
* Retrocede di grado l'oggetto dato (può essere un oggetto o un elenco di oggetti).
* Se delete è true, i vecchi oggetti vengono eliminati.
* L'attributo force può essere usato per forzare un certo tipo di downgrade. Può essere: explode, shapify, subtr, splitFaces, cut2, getWire, splitWires.
* Restituisce un dizionario contenente due liste, un elenco di nuovi oggetti e un elenco di oggetti da eliminare


circle = Draft.make_circle(1000)
Esempio:
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/it
|[[Draft_Upgrade/it|Promuovi]]
|[[Draft_WireToBSpline/it|Polilinea in BSpline]]
|[[Draft_Workbench/it|Draft]]
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
}}

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

Latest revision as of 15:48, 8 December 2023

Declassa

Posizione nel menu
Modifiche → Declassa
Ambiente
Draft, Arch
Avvio veloce
D N
Introdotto nella versione
-
Vedere anche
Promuovi, Sottrazione booleana

Descrizione

Il comando Draft Declassa effettua il declassamento degli oggetti selezionati. Il risultato dipende dal numero di oggetti selezionati e dal loro tipo. Il comando può ad esempio scomporre un solido 3D in facce separate e una struttura filiforme in spigoli separati. Se sono selezionate due facce, da esse viene creato un oggetto Sottrazione booleana. Si noti che non è possibile eseguire il declassamento di tutti gli oggetti. Questo comando è la controparte del comando Draft Promuovi.

Due facce sovrapposte vengono declassate a un oggetto Sottrazione booleana (Part Cut), che viene declassato a faccia. Quella faccia viene quindi declassata a un polilinea chiusa, che viene infine declassata a bordi separati.

Utilizzo

  1. Opzionalmente selezionare uno o più oggetti.
  2. Esistono diversi modi per invocare il comando:
    • Premiere il pulsante Declassa.
    • Selezionare l'opzione Modifiche → Declassa dal menu.
    • Usare la scorciatoia da tastiera: D poi N.
  3. Se non si ha ancora selezionato un oggetto: selezionare un oggetto nella Vista 3D.

Script

Vedere anche: Autogenerated API documentation e Script di base per FreeCAD.

Per eseguire il declassamento degli oggetti utilizzare il metodo downgrade del modulo Draft.

downgrade_list = downgrade(objects, delete=False, force=None)
  • objects contiene gli oggetti di cui eseguire il declassamento. È un singolo oggetto o un elenco di oggetti.
  • Se delete è True gli oggetti di origine vengono eliminati.
  • force forza un certo modo di declassare chiamando una specifica funzione interna. Può essere: "explode", "shapify", "subtr", "splitFaces", "cut2 ", "getWire", "splitWires" o "splitCompounds".
  • Viene restituito downgrade_list. È un elenco contenente due elenchi: un elenco di nuovi oggetti e un elenco di oggetti da eliminare. Se delete è True la seconda lista è vuota.

Esempio:

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