Draft Upgrade/it: Difference between revisions

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

{{Docnav/it
|[[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
|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>
==Descrizione==
==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]].
Questo strumento assembla in diversi modi gli oggetti selezionati (converte più oggetti in un unico oggetto di livello superiore). Se nessun oggetto è selezionato, viene chiesto di selezionarne uno.


[[Image:Draft_Upgrade_example.jpg|400px]]
[[Image:Draft_Upgrade_example.jpg|400px]]
{{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 aggiornare
# Opzionalmente selezionare uno o più oggetti.
# Esistono diversi modi per invocare il comando:
# Premere il pulsante {{KEY/it|[[Image:Draft Upgrade.png|16px]] Assembla}} o premere i tasti {{KEY/it|U}} e {{KEY/it|P}}
#* 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>
== Opzioni ==
==Note==


* [[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]].
Gli oggetti selezionati vengono modificati/assemblati seguendo l'ordine di questa lista:
* 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


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


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
Lo strumento Upgrade può essere utilizzato negli script python e nelle [[macros/it|macro]] in questo modo:

Per promuovere gli oggetti usare il metodo {{incode|upgrade}} del modulo Draft.


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


* Eleva di grado l'oggetto dato (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 ''delete'' è ''true'', i vecchi oggetti vengono eliminati.
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* L'attributo ''force'' può essere usato per forzare un certo tipo di upgrade. Può essere: makeCompound, closeGroupWires, makeSolid, closeWire, turnToParts, makeFusion, makeShell, makeFaces, draftify, joinFaces, makeSketchFace, makeWires
* {{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 un dizionario contenente due liste, un elenco di nuovi oggetti e un elenco di oggetti da eliminare
* 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.

Alcune delle operazioni dello strumento Promuovi possono essere fatte anche con gli strumenti [[Part Fuse/it|Part Unione]] o [[Draft Wire/it|Draft Wire]].


Esempio:
Esempio:


{{Code|code=
{{Code|code=
import FreeCAD as App
import Draft
import Draft

mycircle = Draft.makeCircle(2)
doc = App.newDocument()
face1 = Draft.upgrade([mycircle],True)

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



<languages/>
{{Docnav/it
|[[Draft_Split/it|Dividi]]
|[[Draft_Downgrade/it|Declassa]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Split.svg
|IconR=Draft_Downgrade.svg
|IconC=Workbench_Draft.svg
}}

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

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