Draft Downgrade/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
Tag: Manual revert
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div class="mw-translate-fuzzy">
{{Docnav/it|[[Draft_Upgrade/it|Promuovi]]|[[Draft_Scale/it|Scala]]|[[Draft_Module/it|Draft]]|IconL=Draft_Upgrade.svg|IconC=Workbench_Draft.svg|IconR=Draft_Scale.svg}}
</div>


{{Docnav/it
<div class="mw-translate-fuzzy">
|[[Draft_Upgrade/it|Promuovi]]
{{GuiCommand/it|Name=Draft Downgrade|Name/it=Declassa|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Declassa|Shortcut={{KEY|D}} {{KEY|N}}|SeeAlso=[[Draft Upgrade/it|Promuovi]], [[Part Cut/it|Taglio di Part]]}}
|[[Draft_WireToBSpline/it|Polilinea in BSpline]]
</div>
|[[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]].
<div class="mw-translate-fuzzy">
Lo strumento [[Image:Draft Downgrade.svg|16px]] [[Draft Downgrade/it|Declassa]] scompone gli oggetti selezionati (converte un oggetto in diversi oggetti di livello inferiore). Lo strumento esegue il declassamento degli oggetti selezionati in modi diversi.
</div>

Lo strumento Declassa esegue operazioni come la rottura di facce e la decostruzione dei contorni nei loro singoli bordi. Può tagliare una forma con un'altra forma in modo simile al [[Image:Part_Cut.svg|16px]] [[Part Cut/it|Taglio booleano]] di Part.

La controparte di questo strumento è l'operazione [[Image:Draft Upgrade.svg|16px]] [[Draft Upgrade/it|Promuovi]].


[[Image:Draft_Downgrade_example.jpg|400px]]
[[Image:Draft_Downgrade_example.jpg|400px]]
{{Caption|Faccia tagliata con un'altra faccia; quindi faccia declassata in un contorno chiuso; e poi contorno scomposto in singole linee
{{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 declassare.
# Opzionalmente selezionare uno o più oggetti.
# Esistono diversi modi per invocare il comando:
# Premere il pulsante {{Button|[[Image:Draft Downgrade.png|16px]] [[Draft Downgrade/it|Declassa]]}} o premere i tasti {{KEY|D}} e {{KEY|N}}. Se nessun oggetto è selezionato, si viene invitati a selezionarne uno.
#* 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>
Gli oggetti selezionati vengono modificati o scomposti seguendo l'ordine di questa lista:
==Script==
* 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.


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
== Opzioni ==


Per eseguire il declassamento degli oggetti utilizzare il metodo {{incode|downgrade}} del modulo Draft.
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.

== Esempio ==

<gallery widths="300" heights="200">
File:Draft Downgrade 01.png|Forma originale
File:Draft Downgrade 02.png|Forma con le facce separate e distanziate
</gallery>

== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].

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


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


* Declassa gli {{incode|objects}} dati, che può essere un singolo oggetto o un elenco di oggetti.
* {{incode|objects}} contiene gli oggetti di cui eseguire il declassamento. È un singolo oggetto o un elenco di oggetti.
* Se {{incode|delete}} è {{incode|True}}, i vecchi oggetti vengono cancellati.
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* Se è dato {{incode|force}}, è la funzione interna chiamata per forzare un certo modo di declassamento. Può essere: {{incode|"explode"}}, {{incode|"shapify"}}, {{incode|"subtr"}}, {{incode|"splitFaces"}}, {{incode|"cut2"}}, {{incode|"getWire"}}, o {{incode|"splitWires"}}.
* {{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 restituita una {{incode|upgrade_list}}, che è una lista contenente due liste: la lista di nuovi oggetti ({{incode|addList}}) e la lista degli oggetti da eliminare ({{incode|deleteList}}).
* 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:
Esempio:


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



<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it|[[Draft_Upgrade/it|Promuovi]]|[[Draft_Scale/it|Scala]]|[[Draft_Module/it|Draft]]|IconL=Draft_Upgrade.svg|IconC=Workbench_Draft.svg|IconR=Draft_Scale.svg}}
|[[Draft_Upgrade/it|Promuovi]]
</div>
|[[Draft_WireToBSpline/it|Polilinea in BSpline]]
|[[Draft_Workbench/it|Draft]]
|IconR=Draft_WireToBSpline.svg
|IconC=Workbench_Draft.svg
}}


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

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