Draft Upgrade/it: Difference between revisions

From FreeCAD Documentation
(Created page with "{{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}}")
No edit summary
Tag: Manual revert
 
(42 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=Assembla|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Promuovi|Shortcut=U 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>
Questo strumento 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 Pomuovi 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]].

La controparte di questo strumento è l'operazione [[Draft Downgrade/it|Declassa]].


[[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 ==


# Opzionalmente selezionare uno o più oggetti.
<div class="mw-translate-fuzzy">
# Esistono diversi modi per invocare il comando:
# Selezionare uno o più oggetti che si desidera aggiornare
# 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.
</div>
#* 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>
The selected objects are modified or upgraded according to the following conditions, in order:
==Note==
# If there are more than one face in the selection, the faces are merged (union).
# If there is only one face in the selection, nothing is done.
# If there is only one open wire in the selection, it gets closed, making a face.
# If there are only edges in the selection, all edges are joined into a wire, and the wire is closed if possible.
# If none of the above is possible, a compound object is created.


* [[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]].
It is worth trying to upgrade a selection several times to see if a better shape is obtained. For example:
# Upgrading two [[Draft Line]]s connected at one end will result in a non-editable wire.
# Upgrading this element again will add a third line and close the non-editable wire.
# Upgrading this element again will add a face to the closed, non-editable wire.
# Upgrading this element again will turn it into a [[Draft Wire]], which can be fully edited, and all its properties modified.


<span id="Scripting"></span>
The resulting wire can be better manipulated than the original lines. The fusion of single lines can also be done directly with the [[Draft Wire]] tool. Some fusion operations can also be done with the [[Part Union|Part Union]] tool.
==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.
<div class="mw-translate-fuzzy">
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
</div>

<div class="mw-translate-fuzzy">
== Script ==
</div>

<div class="mw-translate-fuzzy">
Lo strumento Upgrade può essere utilizzato negli script python e nelle [[macros/it|macro]] in questo modo:
</div>


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


* {{incode|objects}} contiene gli oggetti da promuovere. È un singolo oggetto o un elenco di oggetti.
<div class="mw-translate-fuzzy">
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* Eleva di grado l'oggetto dato (può essere un oggetto o un elenco di oggetti).
* {{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"}}.
* Se ''delete'' è ''true'', i vecchi oggetti vengono eliminati.
* 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.
* 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
* Restituisce un dizionario contenente due liste, un elenco di nuovi oggetti e un elenco di oggetti da eliminare
</div>


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


{{Docnav|[[Draft_Split|Split]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft]]|IconL=Draft_Split.svg|IconC=Workbench_Draft.svg|IconR=Draft_Downgrade.svg}}


{{Docnav/it
{{Draft Tools navi}}
|[[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}}
{{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()