Draft Polygon/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(41 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Draft_Ellipse/it|Ellisse]]|[[Draft_Rectangle/it|Rettangolo]]|[[Draft_Module/it|Draft]]|IconL=Draft_Ellipse.svg |IconC=Workbench_Draft.svg|IconR=Draft_Rectangle.svg }}


{{Docnav
{{GuiCommand/it|Name=Draft Polygon|Name/it=Poligono|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Poligono |Shortcut={{KEY|P}} {{KEY|G}}|SeeAlso=[[Draft Circle/it|Cerchio]], [[Draft Pattern/it|Campitura]]
|[[Draft_Rectangle/it|Rettangolo]]
|Version=0.7}}
|[[Draft_BSpline/it|BSpline]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Rectangle.svg
|IconR=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/it
|Name=Draft Polygon
|Name/it=Poligono
|MenuLocation=Drafting → Poligono
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Shortcut={{KEY|P}} {{KEY|G}}
|Version=0.7
}}


<span id="Description"></span>
==Descrizione==
==Descrizione==


Lo strumento Poligono crea un poligono regolare inscritto in una circonferenza selezionando due punti, il centro e il raggio. Il poligono assume [[Draft Linestyle/it|il tipo di linea e il colore]] impostati nella [[Draft Tray/it|barra di Draft]].
Il comando [[Image:Draft_Polygon.svg|24px]] '''Poligono''' crea un poligono regolare nel [[Draft_SelectPlane/it|piano di lavoro]] corrente da un centro e un raggio. Il raggio può essere definito selezionando un punto.

Un Poligono può essere cambiato da inscritto a circoscritto modificando la sua proprietà {{PropertyData|Draw Mode}}. Gli angoli di un poligono possono essere raccordati (arrotondati) o smussati modificandone rispettivamente {{PropertyData|Fillet Radius}} o {{PropertyData|Chamfer Size}}.


[[Image:Draft_polygon_example.jpg|400px]]
[[Image:Draft_polygon_example.jpg|400px]]
{{Caption|Poligono regolare definito dal punto centrale e dal raggio}}
{{Caption|Poligono regolare definito da due punti, centro e raggio}}


==Usage==
<span id="Usage"></span>
==Utilizzo==


Vedere anche: [[Draft_Tray/it|Barra di Draft]], [[Draft_Snap/it|Aggancio]] e [[Draft_Constrain/it|Vincolare]].
<div class="mw-translate-fuzzy">
== Utilizzo ==
# Premere il pulsante {{Button|[[Image:Draft Polygon.png|16px]] [[Draft Polygon/it|Poligono]]}}, o premere i tasti {{KEY|P}} e poi {{KEY|G}}.
# Definire il numero di lati desiderato nella finestra di dialogo delle opzioni.
# Selezionare un primo punto nella vista 3D per stabilire il centro, oppure digitare le sue [[Draft_Coordinates/it|coordinate ]] e poi premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|Inserisci punto]]}}.
# Fare clic su un altro punto nella vista 3D o digitare un valore di raggio per definire il raggio del poligono.
</div>


# Esistono diversi modi per invocare il comando:
Il poligono può essere modificato facendo doppio clic sull'elemento nella vista ad albero o premendo il pulsante {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit/it|Modifica]]}}. Quindi si può spostare il il centro e il raggio in una nuova posizione.
#* Premere il pulsante {{Button|[[Image:Draft_Polygon.svg|16px]] [[Draft_Polygon/it|Poligono]]}}.
#* Selezionare l'opzione {{MenuCommand|Drafting → [[Image:Draft_Polygon.svg|16px]] Poligono}} dal menu.
#* Usare la scorciatoia da tastiera: {{KEY|P}} poi {{KEY|G}}.
# Si apre il pannello attività {{MenuCommand|Poligono}}. Vedere [[#Options|Opzioni]] per maggiori informazioni.
# Regolare il numero desiderato di {{MenuCommand|Lati}}.
# Scegliere il primo punto, il centro del poligono, nella [[3D_view/it|Vista 3D]], oppure digitare le coordinate e premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}}.
# Scegliere il secondo punto nella [[3D_view/it|Vista 3D]], o inserire un {{MenuCommand|Raggio}}.


<span id="Options"></span>
Il poligono viene creato inscritto in un cerchio di raggio specificato; dopo la creazione può essere convertito in circoscritto cambiando la proprietà della sua modalità di disegno.
==Opzioni==


È possibile modificare le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività. Vedere [[Draft_Preferences/it|Preferenze di Draft]]. Le scorciatoie qui menzionate sono le scorciatoie predefinite (per la versione 0.22).
Dopo la creazione può anche essere cambiato il numero di lati del poligono cambiando la sua proprietà numero facce.


* Per inserire manualmente le coordinate del centro, inserire le componenti X, Y e Z, e premere {{KEY|Enter}} dopo ciascuna. Oppure si può premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] Inserisci punto}} quando ha i valori desiderati. Si consiglia di spostare il puntatore fuori dalla [[3D_view/it|Vista 3D]] prima di inserire le coordinate.
== Opzioni ==
* Premere {{KEY|G}} o fare clic sulla casella di controllo {{MenuCommand|Globale}} per attivare o disattivare la modalità globale. Se la modalità globale è attiva, le coordinate sono relative al sistema di coordinate globale, altrimenti sono relative al sistema di coordinate [[Draft_SelectPlane/it|piano di lavoro]]. {{Version/it|0.20}}
* Per inserire le coordinate manualmente, è sufficiente inserire i numeri, quindi premere {{KEY|Invio}} per ciascun componente X, Y e Z. È possibile premere il pulsante {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint/it|Inserisci punto]]}} quando si hanno i valori desiderati per inserire il punto.
* Premere il tasto {{KEY|T}} oppure fare clic sulla casella di controllo per attivare la modalità "continua". Se la modalità continua è attiva, lo strumento Poligono si riavvia dopo aver terminato la forma in costruzione, e consente di disegnare un nuovo poligono senza premere nuovamente il pulsante dello strumento.
* Premere {{KEY|F}} o fare clic sulla casella di controllo {{MenuCommand|Riempito}} per attivare o disattivare la modalità riempimento. Se la modalità riempimento è attiva, il poligono creato avrà {{PropertyData|Make Face}} impostato su {{TRUE}} e avrà una faccia piena.
* Premere il tasto {{KEY|L}} oppure fare clic sulla casella di controllo per attivare la modalità ''riempito''. Se la modalità di riempimento è attiva, il poligono crea una faccia piena ({{PropertyData|Make Face}} {{TRUE}}); in caso contrario, il poligono non crea una faccia ({{PropertyData|Make Face}} {{FALSE}}).
* Premere {{KEY|N}} o fare clic sulla casella di controllo {{MenuCommand|Continua}} per attivare o disattivare la modalità continua. Se la modalità continua è attiva, il comando si riavvierà al termine, consentendo di continuare a creare poligoni.
* Premere {{KEY|S}} per attivare o disattivare [[Draft_Snap/it|Aggancia]].
* Tenere premuto {{KEY|Ctrl}} mentre si disegna per forzare [[Draft_Snap|l'aggancio]] del proprio punto alla posizione di aggancio più vicina, indipendentemente dalla distanza.
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.
* Tenere premuto {{KEY|Maiusc}} mentre si disegna per [[Draft_Constrain|vincolare]] il prossimo punto in orizzontale o in verticale rispetto all'ultimo.
* Premere il tasto {{KEY|Esc}} o il pulsante {{button|Chiudi}} per interrompere il comando corrente.


<span id="Notes"></span>
==Note==

* Un Poligono può essere modificato con il comando [[Draft_Edit/it|Modifica]].

<span id="Preferences"></span>
==Preferenze==

Vedere anche: [[Preferences_Editor/it|Impostare le preferenze]] e [[Draft_Preferences/it|Preferenze per l'ambiente Draft]].

* Se l'opzione {{MenuCommand|Modifica → Preferenze... → Draft → Generale → Crea primitive della parte se possibile}} è selezionata, il comando creerà un [[Part_RegularPolygon/it|Part Poligono regolare]] invece di un Draft Poligono.

<span id="Properties"></span>
== Proprietà ==
== Proprietà ==


Vedere anche: [[Property_editor/it|Editor delle proprietà]].

Un oggetto Draft Poligono è derivato da un [[Part_Part2DObject/it|Part Part2DObject]] e ne eredita tutte le proprietà. Ha anche le seguenti proprietà aggiuntive:

<span id="Data"></span>
===Dati===
===Dati===
* {{PropertyData|Radius}}: specifica il raggio del cerchio che definisce il poligono.
* {{PropertyData|Draw Mode}}: specifica se il poligono è inscritto in un cerchio o circoscritto attorno a un cerchio.
* {{PropertyData|Faces Number}}: specifica il numero di lati del poligono.
* {{PropertyData|Chamfer Size}}: specifica la dimensione degli smussi (segmenti retti) creati agli angoli del poligono.
* {{PropertyData|Fillet Radius}}: specifica il raggio dei raccordi (segmenti di arco) creati agli angoli del poligono.
* {{PropertyData|Make Face}}: specifica se la forma è una faccia o no. Se è {{TRUE}} viene creata una faccia, altrimenti solo il perimetro è considerato parte dell'oggetto.


{{TitleProperty|Draft}}
===Vista===
* {{PropertyView|Pattern}}: specifica un [[Draft Pattern/it|Modello]] con cui riempire la faccia del poligono. Questa proprietà funziona solo se {{PropertyData|Make Face}} è {{TRUE}}, e se {{PropertyView|Display Mode}} è "Flat Lines".
* {{PropertyView|Pattern Size}}: specifica la dimensione del [[Draft Pattern/it|Modello]].


* {{PropertyData|Area|Area}}: (sola lettura) specifica l'area della faccia del poligono. Il valore sarà {{value|0.0}} se {{PropertyData|Make Face}} se {{FALSE}}.
== Script ==
* {{PropertyData|Chamfer Size|Length}}: specifica la lunghezza degli smussi agli angoli del poligono.
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
* {{PropertyData|Draw Mode|Enumeration}}: specifica se il poligono è {{value|inscritto}} in un cerchio o {{value|circoscritto}} attorno a un cerchio.
* {{PropertyData|Faces Number|Integer}}: specifica il numero di lati del poligono.
* {{PropertyData|Fillet Radius|Length}}: specifica il raggio dei raccordi agli angoli del poligono.
* {{PropertyData|Make Face|Bool}}: specifica se il poligono forma o meno una faccia. Se è {{TRUE}} viene creata una faccia, altrimenti solo il perimetro è considerato parte dell'oggetto.
* {{PropertyData|Radius|Length}}: specifica il raggio del cerchio che definisce il poligono.


<span id="View"></span>
Lo strumento Poligono può essere usato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
===Viste===

{{TitleProperty|Draft}}

* {{PropertyView|Pattern|Enumeration}}: specifica la [[Draft_Pattern/it|Campitura]] con cui riempire la faccia del poligono. Questa proprietà funziona solo se {{PropertyData|Make Face}} è {{TRUE}} e se {{PropertyView|Display Mode}} è {{value|Flat Lines}}.
* {{PropertyView|Pattern Size|Float}}: specifica la dimensione della [[Draft_Pattern/it|Campitura]].

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

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

Per creare un Draft Poligono utilizzare il metodo {{incode|make_polygon}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makePolygon}}.


{{Code|code=
{{Code|code=
Polygon = makePolygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
polygon = make_polygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
}}
}}
* Crea un oggetto {{incode|Polygon}} con il dato numero di lati ({{incode|nfaces}}), e basato su un cerchio di {{incode|radius}} in millimettri.
* Crea un oggetto {{incode|polygon}} con il numero specificato di facce ({{incode|nfaces}}) e basato su un cerchio di {{incode|radius}} in millimetri.
* Se {{incode|inscribed}} è {{incode|True}}, il poligono è inscritto nel cerchio, altrimenti è circoscritto.
* Se {{incode|inscribed}} è {{incode|True}}, il poligono è inscritto nel cerchio, altrimenti sarà circoscritto.
* Se {{incode|placement}} è {{incode|None}} il poligono viene creato all'origine e uno dei suoi vertici giace sull'asse X.
** Uno dei vertici del poligono giace sull'asse X se non viene assegnato nessun altro posizionamento.
* Se è dato un {{incode|placement}}, esso viene usato; altrimenti la forma viene creata all'origine.
* Se {{incode|face}} è {{incode|True}}, il poligono formerà una faccia, cioè apparirà pieno.
* Se {{incode|face}} è {{incode|True}}, la forma crea una faccia, cioè appare riempita.


Esempio:
Esempio:
{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
Polygon1 = Draft.makePolygon(4, radius=500)
Polygon2 = Draft.makePolygon(5, radius=750)


polygon1 = Draft.make_polygon(4, radius=500)
ZAxis = FreeCAD.Vector(0, 0, 1)
polygon2 = Draft.make_polygon(5, radius=750)
p3 = FreeCAD.Vector(1000, 1000, 0)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 90))


zaxis = App.Vector(0, 0, 1)
Polygon3 = Draft.makePolygon(6, radius=1450, placement=place3)
p3 = App.Vector(1000, 1000, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 90))

Polygon3 = Draft.make_polygon(6, radius=1450, placement=place3)

doc.recompute()
}}
}}



{{Docnav/it|[[Draft_Ellipse/it|Ellisse]]|[[Draft_Rectangle/it|Rettangolo]]|[[Draft_Module/it|Draft]]|IconL=Draft_Ellipse.svg |IconC=Workbench_Draft.svg|IconR=Draft_Rectangle.svg }}
{{Docnav
|[[Draft_Rectangle/it|Rettangolo]]
|[[Draft_BSpline/it|BSpline]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Rectangle.svg
|IconR=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
}}


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

Latest revision as of 14:35, 12 January 2024

Poligono

Posizione nel menu
Drafting → Poligono
Ambiente
Draft, Arch
Avvio veloce
P G
Introdotto nella versione
0.7
Vedere anche
Nessuno

Descrizione

Il comando Poligono crea un poligono regolare nel piano di lavoro corrente da un centro e un raggio. Il raggio può essere definito selezionando un punto.

Un Poligono può essere cambiato da inscritto a circoscritto modificando la sua proprietà DatiDraw Mode. Gli angoli di un poligono possono essere raccordati (arrotondati) o smussati modificandone rispettivamente DatiFillet Radius o DatiChamfer Size.

Poligono regolare definito da due punti, centro e raggio

Utilizzo

Vedere anche: Barra di Draft, Aggancio e Vincolare.

  1. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Poligono.
    • Selezionare l'opzione Drafting → Poligono dal menu.
    • Usare la scorciatoia da tastiera: P poi G.
  2. Si apre il pannello attività Poligono. Vedere Opzioni per maggiori informazioni.
  3. Regolare il numero desiderato di Lati.
  4. Scegliere il primo punto, il centro del poligono, nella Vista 3D, oppure digitare le coordinate e premere il pulsante Inserisci punto.
  5. Scegliere il secondo punto nella Vista 3D, o inserire un Raggio.

Opzioni

È possibile modificare le scorciatoie da tastiera a carattere singolo disponibili nel pannello delle attività. Vedere Preferenze di Draft. Le scorciatoie qui menzionate sono le scorciatoie predefinite (per la versione 0.22).

  • Per inserire manualmente le coordinate del centro, inserire le componenti X, Y e Z, e premere Enter dopo ciascuna. Oppure si può premere il pulsante Inserisci punto quando ha i valori desiderati. Si consiglia di spostare il puntatore fuori dalla Vista 3D prima di inserire le coordinate.
  • Premere G o fare clic sulla casella di controllo Globale per attivare o disattivare la modalità globale. Se la modalità globale è attiva, le coordinate sono relative al sistema di coordinate globale, altrimenti sono relative al sistema di coordinate piano di lavoro. disponibile dalla versione 0.20
  • Premere F o fare clic sulla casella di controllo Riempito per attivare o disattivare la modalità riempimento. Se la modalità riempimento è attiva, il poligono creato avrà DatiMake Face impostato su true e avrà una faccia piena.
  • Premere N o fare clic sulla casella di controllo Continua per attivare o disattivare la modalità continua. Se la modalità continua è attiva, il comando si riavvierà al termine, consentendo di continuare a creare poligoni.
  • Premere S per attivare o disattivare Aggancia.
  • Premere Esc o il pulsante Chiudi per interrompere il comando.

Note

  • Un Poligono può essere modificato con il comando Modifica.

Preferenze

Vedere anche: Impostare le preferenze e Preferenze per l'ambiente Draft.

  • Se l'opzione Modifica → Preferenze... → Draft → Generale → Crea primitive della parte se possibile è selezionata, il comando creerà un Part Poligono regolare invece di un Draft Poligono.

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Draft Poligono è derivato da un Part Part2DObject e ne eredita tutte le proprietà. Ha anche le seguenti proprietà aggiuntive:

Dati

Draft

  • DatiArea (Area): (sola lettura) specifica l'area della faccia del poligono. Il valore sarà 0.0 se DatiMake Face se false.
  • DatiChamfer Size (Length): specifica la lunghezza degli smussi agli angoli del poligono.
  • DatiDraw Mode (Enumeration): specifica se il poligono è inscritto in un cerchio o circoscritto attorno a un cerchio.
  • DatiFaces Number (Integer): specifica il numero di lati del poligono.
  • DatiFillet Radius (Length): specifica il raggio dei raccordi agli angoli del poligono.
  • DatiMake Face (Bool): specifica se il poligono forma o meno una faccia. Se è true viene creata una faccia, altrimenti solo il perimetro è considerato parte dell'oggetto.
  • DatiRadius (Length): specifica il raggio del cerchio che definisce il poligono.

Viste

Draft

  • VistaPattern (Enumeration): specifica la Campitura con cui riempire la faccia del poligono. Questa proprietà funziona solo se DatiMake Face è true e se VistaDisplay Mode è Flat Lines.
  • VistaPattern Size (Float): specifica la dimensione della Campitura.

Script

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

Per creare un Draft Poligono utilizzare il metodo make_polygon (disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makePolygon.

polygon = make_polygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
  • Crea un oggetto polygon con il numero specificato di facce (nfaces) e basato su un cerchio di radius in millimetri.
  • Se inscribed è True, il poligono è inscritto nel cerchio, altrimenti sarà circoscritto.
  • Se placement è None il poligono viene creato all'origine e uno dei suoi vertici giace sull'asse X.
  • Se face è True, il poligono formerà una faccia, cioè apparirà pieno.

Esempio:

import FreeCAD as App
import Draft

doc = App.newDocument()

polygon1 = Draft.make_polygon(4, radius=500)
polygon2 = Draft.make_polygon(5, radius=750)

zaxis = App.Vector(0, 0, 1)
p3 = App.Vector(1000, 1000, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 90))

Polygon3 = Draft.make_polygon(6, radius=1450, placement=place3)

doc.recompute()