Draft Upgrade/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Tag: Manual revert
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Draft_Split/it|Dividi]]|[[Draft_Downgrade/it|Declassa]]|[[Draft_Module/it|Draft]]|IconL=Draft_Split.svg|IconC=Workbench_Draft.svg|IconR=Draft_Downgrade.svg}}


{{Docnav/it
{{GuiCommand/it|Name=Draft Upgrade|Name/it=Promuovi|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Promuovi|Shortcut={{KEY|U}} {{KEY|P}}|SeeAlso=[[Draft Downgrade/it|Declassa]], [[Part Union/it|Unione di Part]]}}
|[[Draft_Split/it|Dividi]]
|[[Draft_Downgrade/it|Declassa]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}


{{GuiCommand/it
==Descrizione==
|Name=Draft Upgrade
|Name/it=Promuovi
|MenuLocation=Modifiche → Promuovi
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|U}} {{KEY|P}}
|SeeAlso=[[Draft_Downgrade/it|Declassa]]
}}


<span id="Description"></span>
Lo strumento [[Image:Draft Upgrade.svg|16px]] Promuovi converte più oggetti in un unico oggetto di livello superiore in diversi modi.
==Descrizione==


Il comando [[Image:Draft_Upgrade.svg|24px]] '''Draft Promuovi''' promuove gli oggetti selezionati. Il risultato dipende dal numero di oggetti selezionati e dal loro tipo. Il comando può ad esempio fondere elementi e creare facce. Vale la pena provare ad aggiornare più volte una selezione per vedere se è possibile ottenere un risultato migliore. Vedere l'esempio nell'immagine. Si noti che non tutti gli oggetti possono essere aggiornati. Questo comando è la controparte del comando [[Draft_Downgrade/it|Draft Declassa]].
Lo strumento Promuovi esegue operazioni come la creazione di facce e la fusione di elementi diversi. Questo strumento funziona con elementi 2D di Draft. Per fondere i solidi 3D usare [[Part Union/it|Unione di Part]] e le relative operazioni booleane di [[Part Workbench/it|Part]], e le [[PartDesign Boolean/it|operazioni booleane]] di [[PartDesign Workbench/it|PartDesign]].

<div class="mw-translate-fuzzy">
La controparte di questo strumento è l'operazione [[Draft Downgrade/it|Declassa]].
</div>


[[Image:Draft_Upgrade_example.jpg|400px]]
[[Image:Draft_Upgrade_example.jpg|400px]]
{{Caption|Contorno aperto promosso in contorno chiuso, e quindi in una faccia; un quadrato chiuso promosso in faccia e quindi fuso con la faccia precedente}}
{{Caption|Una polilinea aperta non modificabile viene aggiornata ad una polilinea chiusa e quindi ad una faccia. Anche un contorno quadrato chiuso non modificabile viene aggiornato ad una faccia. Le due facce vengono quindi aggiornate per creare un composto, che viene infine aggiornato ad una singola Polilinea modificabile.}}


<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 Upgrade.svg|16px]] [[Draft Upgrade/it|Promuovi]]}} o premere i tasti {{KEY|U}} e {{KEY|P}}. Se nessun oggetto è selezionato, si viene invitati a selezionarne uno.
#* Premere il pulsante {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/it|Promuovi]]}}.
#* Selezionare l'opzione {{MenuCommand|Modifica → [[Image:Draft_Upgrade.svg|16px]] Promuovi}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|U}} poi {{KEY|P}}.
# Se non si ha ancora selezionato un oggetto: selezionare un oggetto nella [[3D_view/it|Vista 3D]].


<span id="Notes"></span>
Gli oggetti selezionati vengono modificati/assemblati seguendo l'ordine di questa lista:
==Note==
* se sono selezionate più facce, le facce vengono fuse (unione),
* se è selezionata solo una faccia, non viene eseguito nulla,
* se è selezionato un solo contorno aperto, il contorno viene chiuso,
* Se sono selezionati solo bordi, i bordi vengono uniti in un contorno (chiuso quando è possibile),
* Se nessuna delle precedenti operazioni è possibile, viene creato un oggetto composito,


* [[Draft_Line/it|Linee]] e [[Draft_Wire/it|Polilinee]] possono essere unite con questo comando, ma anche con il comando [[Draft_Join/it|Unisci]] o il comando [[Draft_Wire/it|Polilinea]].
Vale la pena provare a promuovere più volte una selezione per vedere se si ottiene una forma migliore. Per esempio:
# Promuovendo due [[Draft Line/it|Linee]] collegate ad un'estremità si ottiene un contorno non modificabile.
# Promuovendo di nuovo questo elemento si aggiunge una terza linea e si chiude il contorno non modificabile.
# La promozione di questo elemento aggiunge una faccia al contorno chiuso non modificabile.
# Promuovendo nuovamente questo elemento lo si trasformerà in una [[Draft Wire/it|Polilinea]], che può essere completamente editata, e tutte le sue proprietà sono modificabili.


<span id="Scripting"></span>
Il contorno risultante può essere manipolato più facilmente delle linee originali. La fusione di linee singole può anche essere eseguita direttamente con lo strumento [[Draft Wire/it|Polilinea]]. Alcune operazioni di fusione possono essere eseguite anche con lo strumento [[Part Union/it|Unione di Part]].
==Script==


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


Per promuovere gli oggetti usare il metodo {{incode|upgrade}} del modulo Draft.
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.

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

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


{{Code|code=
{{Code|code=
upgrade_list = upgrade(objects, delete=False, force=None)
upgrade_list = upgrade(objects, delete=False, force=None)
addList, deleteList = upgrade(objects, delete=False, force=None)
}}
}}


* Eleva di grado il dato {{incode|objects}}, che può essere un oggetto o un elenco di oggetti.
* {{incode|objects}} contiene gli oggetti da promuovere. È un singolo oggetto o un elenco di oggetti.
* Se {{incode|delete}} è {{incode|True}}, i vecchi oggetti vengono eliminati.
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* Se {{incode|force}} è dato, viene usato per forzare un certo tipo di promozione. Esso può essere: {{incode|"makeCompound"}}, {{incode|"closeGroupWires"}}, {{incode|"makeSolid"}}, {{incode|"closeWire"}}, {{incode|"turnToParts"}}, {{incode|"makeFusion"}}, {{incode|"makeShell"}}, {{incode|"makeFaces"}}, {{incode|"draftify"}}, {{incode|"joinFaces"}}, {{incode|"makeSketchFace"}}, {{incode|"makeWires"}}, o {{incode|"turnToLine"}}.
* {{incode|force}} forza un certo modo di promozione chiamando una specifica funzione interna. Può essere: {{incode|"makeCompound"}}, {{incode|"closeGroupWires"}}, {{incode|"makeSolid"}}, {{incode|"closeWire"}}, {{incode|"turnToParts "}}, {{incode|"makeFusion"}}, {{incode|"makeShell"}}, {{incode|"makeFaces"}}, {{incode|"draftify"}}, {{incode|"joinFaces "}}, {{incode|"makeSketchFace"}}, {{incode|"makeWires"}} o {{incode|"turnToLine"}}.
* Restituisce una {{incode|upgrade_list}}, che è una lista contenente due liste: una lista di nuovi oggetti ({{incode|addList}}) e una lista di oggetti da eliminare ({{incode|deleteList}}).
* Viene restituito {{incode|upgrade_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()
Circle = Draft.makeCircle(1000)
Rectangle = Draft.makeRectangle(2000, 800)


circle = Draft.make_circle(1000)
addList1, deleteList1 = Draft.upgrade([Circle, Rectangle], delete=False)
rectangle = Draft.make_rectangle(2000, 800)
fused = addList1[0]
doc.recompute()


add_list1, delete_list1 = Draft.upgrade([circle, rectangle], delete=False)
Line1 = Draft.makeLine(FreeCAD.Vector(2000, 0, 0), FreeCAD.Vector(2500, 1500, 0))
Line2 = Draft.makeLine(FreeCAD.Vector(2500, 1500, 0), FreeCAD.Vector(3000, -1000, 0))
addList2, deleteList2 = Draft.upgrade([Line1, Line2], delete=False)


line1 = Draft.make_line(App.Vector(2000, 0, 0), App.Vector(2500, 1500, 0))
simple_wire = addList2[0]
line2 = Draft.make_line(App.Vector(2500, 1500, 0), App.Vector(3000, -1000, 0))
addList3, deleteList3 = Draft.upgrade(simple_wire, delete=False)
doc.recompute()


add_list2, delete_list2 = Draft.upgrade([line1, line2], delete=False)
closed_wire = addList3[0]
addList4, deleteList4 = Draft.upgrade(closed_wire, delete=False)


face = addList4[0]
simple_wire = add_list2[0]
addList5, deleteList5 = Draft.upgrade(face, delete=False)
add_list3, delete_list3 = Draft.upgrade(simple_wire, delete=False)

closed_wire = add_list3[0]
add_list4, delete_list4 = Draft.upgrade(closed_wire, delete=False)

face = add_list4[0]
add_list5, delete_list5 = Draft.upgrade(face, delete=False)

doc.recompute()
}}
}}



<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it|[[Draft_Split/it|Dividi]]|[[Draft_Downgrade/it|Declassa]]|[[Draft_Module/it|Draft]]|IconL=Draft_Split.svg|IconC=Workbench_Draft.svg|IconR=Draft_Downgrade.svg}}
|[[Draft_Split/it|Dividi]]
</div>
|[[Draft_Downgrade/it|Declassa]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}


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

Latest revision as of 15:49, 8 December 2023

Promuovi

Posizione nel menu
Modifiche → Promuovi
Ambiente
Draft, Arch
Avvio veloce
U P
Introdotto nella versione
-
Vedere anche
Declassa

Descrizione

Il comando Draft Promuovi promuove gli oggetti selezionati. Il risultato dipende dal numero di oggetti selezionati e dal loro tipo. Il comando può ad esempio fondere elementi e creare facce. Vale la pena provare ad aggiornare più volte una selezione per vedere se è possibile ottenere un risultato migliore. Vedere l'esempio nell'immagine. Si noti che non tutti gli oggetti possono essere aggiornati. Questo comando è la controparte del comando Draft Declassa.

Una polilinea aperta non modificabile viene aggiornata ad una polilinea chiusa e quindi ad una faccia. Anche un contorno quadrato chiuso non modificabile viene aggiornato ad una faccia. Le due facce vengono quindi aggiornate per creare un composto, che viene infine aggiornato ad una singola Polilinea modificabile.

Utilizzo

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

Note

Script

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

Per promuovere gli oggetti usare il metodo upgrade del modulo Draft.

upgrade_list = upgrade(objects, delete=False, force=None)
  • objects contiene gli oggetti da promuovere. È un singolo oggetto o un elenco di oggetti.
  • Se delete è True gli oggetti di origine vengono eliminati.
  • force forza un certo modo di promozione chiamando una specifica funzione interna. Può essere: "makeCompound", "closeGroupWires", "makeSolid", "closeWire", "turnToParts ", "makeFusion", "makeShell", "makeFaces", "draftify", "joinFaces ", "makeSketchFace", "makeWires" o "turnToLine".
  • Viene restituito upgrade_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=False)

line1 = Draft.make_line(App.Vector(2000, 0, 0), App.Vector(2500, 1500, 0))
line2 = Draft.make_line(App.Vector(2500, 1500, 0), App.Vector(3000, -1000, 0))
doc.recompute()

add_list2, delete_list2 = Draft.upgrade([line1, line2], delete=False)

simple_wire = add_list2[0]
add_list3, delete_list3 = Draft.upgrade(simple_wire, delete=False)

closed_wire = add_list3[0]
add_list4, delete_list4 = Draft.upgrade(closed_wire, delete=False)

face = add_list4[0]
add_list5, delete_list5 = Draft.upgrade(face, delete=False)

doc.recompute()