Draft Polygon/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(49 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=P G|SeeAlso=[[Draft Circle/it|Cerchio]]
|[[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==

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}}.
==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 nel [[Draft Tray/it|Vassoio di Draft]].


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


<span id="Usage"></span>
== Utilizzo ==
==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.


Vedere anche: [[Draft_Tray/it|Barra di Draft]], [[Draft_Snap/it|Aggancio]] e [[Draft_Constrain/it|Vincolare]].
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.


# Esistono diversi modi per invocare il comando:
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.
#* 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>
Dopo la creazione può anche essere cambiato il numero di lati del poligono cambiando la sua proprietà numero facce.
==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).
== Opzioni ==
* 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 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}}).
* 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.
* 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.


* 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.
<div class="mw-translate-fuzzy">
* 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}}
=== Proprietà ===
* 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.
==== Vista ====
* 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.
Sono disponibili le [[DraftStandardProperty/it|Proprietà standard]] di visualizzazione.
* Premere {{KEY|S}} per attivare o disattivare [[Draft_Snap/it|Aggancia]].
* {{ProprietaVista|Pattern}}: Specifica un tratteggio con cui riempire il cerchio
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.
* {{ProprietaVista|Pattern Size}}: Specifica la dimensione del tratteggio
==== Dati ====
{|
| [[File:DraftPolygonProperty_it.png]]
|
{{KEY/it|2D}}<br />
{{KEY/it|Base}}<br />
* {{ProprietaDati|Label}} : Nome dell'oggetto, modificabile a piacimento.
* {{ProprietaDati|Placement}} : Raggruppa tutti i dati di posizionamento relativi a Angle, Axis, e Position a cui si accede tramite il pulsante triangolare di espansione . Selezionando invece il titolo Placement, o i dati, appare un pulsante con tre puntini. Cliccare su {{KEY/it|''' ... '''}} per accedere alla finestra delle opzioni di [[Tasks_Placement/it|Posizionamento]].
** {{ProprietaDati|Angle}} : Angolo di rotazione rispetto alle coordinate X, Y, Z.
** {{ProprietaDati|Axis}} : Seleziona l'asse, o gli assi, di rotazione X, Y, o Z. Per esempio, con un angolo impostato pari a 15°, specificando un valore di 1,0 per X, e di 2,0 per Y causa una rotazione finale del pezzo di 15° sull'asse X e di 30° sull'asse Y.
** {{ProprietaDati|Position}} : Posizione delle coordinate X, Y, Z, rispetto all'origine 0, 0, 0.
{{KEY/it|Draft}}<br />
* {{ProprietaDati|Chamfer Size}}: Specifica uno smusso per gli angoli del poligono
* {{ProprietaDati|Draw Mode}}: Specifica se il poligono è inscritto o circoscritto al cerchio di definizione
* {{ProprietaDati|Faces Number}}: Il numero di lati del poligono
* {{ProprietaDati|Fillet Radius}}: Specifica un raggio di curvatura da dare agli angoli del poligono
* {{ProprietaDati|Radius}}: Il raggio del cerchio di definizione
* {{PropertyData|Make Face}}: Riempie il poligono con una faccia
|}
{{clear}}
</div>


<span id="Notes"></span>
===Data===
==Note==
* {{PropertyData|Radius}}: specifies the radius of the circle that defines the polygon.
* {{PropertyData|Draw Mode}}: specifies if the polygon is inscribed in a circle, or circumscribed around a circle.
* {{PropertyData|Faces Number}}: specifies the number of sides of the polygon.
* {{PropertyData|Chamfer Size}}: specifies the size of the chamfers (straight segments) created on the corners of the polygon.
* {{PropertyData|Fillet Radius}}: specifies the radius of the fillets (arc segments) created on the corners of the polygon.
* {{PropertyData|Make Face}}: specifies if the shape makes a face or not. If it is {{TRUE}} a face is created, otherwise only the perimeter is considered part of the object.


* Un Poligono può essere modificato con il comando [[Draft_Edit/it|Modifica]].
===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]].


<span id="Preferences"></span>
== Script ==
==Preferenze==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].


Vedere anche: [[Preferences_Editor/it|Impostare le preferenze]] e [[Draft_Preferences/it|Preferenze per l'ambiente Draft]].
Lo strumento Poligono può essere usato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:

* 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à ==

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

{{TitleProperty|Draft}}

* {{PropertyData|Area|Area}}: (sola lettura) specifica l'area della faccia del poligono. Il valore sarà {{value|0.0}} se {{PropertyData|Make Face}} se {{FALSE}}.
* {{PropertyData|Chamfer Size|Length}}: specifica la lunghezza degli smussi agli angoli del poligono.
* {{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>
===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 Tools navi/it}}
|[[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:}}}}
{{Userdocnavi/it}}
{{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()