Draft Upgrade/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Tag: Manual revert
 
(5 intermediate revisions by 2 users not shown)
Line 22: Line 22:
==Descrizione==
==Descrizione==


Il comando [[Image:Draft_Upgrade.svg|24px]] '''Draft Promuovi''' aggiorna 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. Guarda 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]].
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]].


[[Image:Draft_Upgrade_example.jpg|400px]]
[[Image:Draft_Upgrade_example.jpg|400px]]
Line 33: Line 33:
# Esistono diversi modi per invocare il comando:
# Esistono diversi modi per invocare il comando:
#* Premere il pulsante {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/it|Promuovi]]}}.
#* Premere il pulsante {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/it|Promuovi]]}}.
#* Selezionare l'opzione {{MenuCommand|Modifica → [[Image:Draft_Upgrade.svg|16px]] Aggiorna}} dal menu.
#* Selezionare l'opzione {{MenuCommand|Modifica → [[Image:Draft_Upgrade.svg|16px]] Promuovi}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|U}} poi {{KEY|P}}.
#* 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]].
# Se non si ha ancora selezionato un oggetto: selezionare un oggetto nella [[3D_view/it|Vista 3D]].
Line 47: Line 47:
Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].


Per promuovere gli oggetti usare il metodo {{incode|upgrade}} del modulo Draft.
<div class="mw-translate-fuzzy">
Lo strumento Promuovi può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] tramite la seguente funzione:
</div>


{{Code|code=
{{Code|code=
Line 55: Line 53:
}}
}}


* {{incode|objects}} contiene gli oggetti da promuovere. È un singolo oggetto o un elenco di oggetti.
<div class="mw-translate-fuzzy">
* Eleva di grado il dato {{incode|objects}}, che può essere un oggetto o un elenco di oggetti.
* Se {{incode|delete}} è {{incode|True}} gli oggetti di origine vengono eliminati.
* {{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 {{incode|delete}} è {{incode|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.
* 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"}}.
* 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}}).
</div>


Esempio:
Esempio:

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