Draft Polygon/it: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Docnav/it|Ellisse|Rettangolo|Draft|IconL=Draft_Ellipse.svg |IconC=Workbench_Draft.svg|IconR=Draft_Rectangle.s...")
No edit summary
 
(56 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}}.
<div class="mw-translate-fuzzy">
Crea un poligono regolare a partire da due punti, il centro e un secondo punto che definisce un raggio. È possibile specificare il numero di lati. Viene creato un poligono regolare inscritto nel cerchio di cui si è dato il raggio. Il numero di lati e la condizione di '''inscritto''' o '''circoscritto''' sono modificabili in qualsiasi momento in Vista combinata → Proprietà → Dati → Draw Mode. Il poligono assume [[Draft Linestyle/it|il tipo di linea e il colore]] impostati in precedenza nella Barra dei comandi e modificabili tramite la stessa o nella scheda Vista combinata → Proprietà → Vista.
</div>


[[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>
<div class="mw-translate-fuzzy">
=== Utilizzo ===
==Utilizzo==


Vedere anche: [[Draft_Tray/it|Barra di Draft]], [[Draft_Snap/it|Aggancio]] e [[Draft_Constrain/it|Vincolare]].
# Premere il pulsante {{KEY/it|[[Image:Draft Polygon.png|16px]] Poligono}}, o premere i tasti {{KEY/it|P}} e {{KEY/it|G}},
# Selezionare il primo punto nella vista 3D, per stabilire il centro, oppure digitare le sue [[Draft_Coordinates/it|coordinate ]],
# Impostare il numero di lati desiderato nella finestra delle Opzioni del comando attivo,
# Selezionare un altro punto della vista 3D, o digitare un valore per definire il raggio del poligono. Il poligono è anche una faccia, nonostante appaia come reticolo.
</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.
<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}}
=== Opzioni ===
* 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 {{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]].
* Premere {{KEY|Esc}} o il pulsante {{Button|Chiudi}} per interrompere il comando.


<span id="Notes"></span>
* Per [[Draft_Coordinates/it|inserire le coordinate manualmente]], è sufficiente inserire il loro valore, poi premere {{KEY/it|INVIO}} per ogni componente X, Y e Z. È bene tenere il puntatore del mouse fuori dall'area di lavoro in quanto un suo movimento accidentale cattura e inserisce nel campo di input le coordinate a cui si trova e costringe a ripetere l'inserimento.
==Note==
* Premere {{KEY/it|T}} oppure fare clic sulla casella di controllo per selezionare o deselezionare la modalità {{KEY/it|Continua}}. In modalità '''Continua''', al termine dell'operazione, lo strumento Poligono si riavvia automaticamente e permette di disegnare un nuovo poligono senza dover ripetere il comando.
* Premere {{KEY/it|CTRL}} mentre si disegna per [[Draft_Snap/it|ancorare]] il proprio punto al punto agganciabile più vicino, indipendentemente dalla distanza.
* Premere {{KEY/it|SHIFT}} mentre si disegna per [[Draft_Constrain/it|vincolare]] orizzontalmente o verticalmente il secondo punto rispetto al primo.
* Premere {{KEY/it|I}} o il pulsante {{KEY/it|Pieno}} per far apparire il poligono come una faccia dopo che è stato chiuso.
* Premere {{KEY/it|ESC}} o premere il pulsante {{KEY/it|Cancella}} per uscire dal comando attivo.
* Quando il poligono è visualizzato in modalità "Flat Lines" può essere riempito con un tratteggio specificando le proprietà "Pattern".
</div>


* Un Poligono può essere modificato con il comando [[Draft_Edit/it|Modifica]].
<div class="mw-translate-fuzzy">
=== Proprietà ===
==== Vista ====
Sono disponibili le [[DraftStandardProperty/it|Proprietà standard]] di visualizzazione.
* {{ProprietaVista|Pattern}}: Specifica un tratteggio con cui riempire il cerchio
* {{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="Preferences"></span>
===Data===
==Preferenze==
* {{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.


Vedere anche: [[Preferences_Editor/it|Impostare le preferenze]] e [[Draft_Preferences/it|Preferenze per l'ambiente Draft]].
===View===
* {{PropertyView|Pattern}}: specifies a [[Draft Pattern]] with which to fill the face of the polygon. This property only works if {{PropertyData|Make Face}} is {{TRUE}}, and if {{PropertyView|Display Mode}} is "Flat Lines".
* {{PropertyView|Pattern Size}}: specifies the size of the [[Draft Pattern]].


* 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.
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].


<span id="Properties"></span>
Lo strumento Poligono può essere usato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando la seguente funzione:
== 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 numero specificato di facce ({{incode|nfaces}}) e basato su un cerchio di {{incode|radius}} in millimetri.
<div class="mw-translate-fuzzy">
* Se {{incode|inscribed}} è {{incode|True}}, il poligono è inscritto nel cerchio, altrimenti sarà circoscritto.
* La funzione crea un oggetto poligono con il numero di lati e il raggio indicati.
* Se inscribed è False, il poligono è circoscritto al cerchio di raggio dato, altrimenti è inscritto.
* Se {{incode|placement}} è {{incode|None}} il poligono viene creato all'origine e uno dei suoi vertici giace sull'asse X.
* Se face è True, la forma risultante viene visualizzata come una faccia, altrimenti come un reticolo.
* Se {{incode|face}} è {{incode|True}}, il poligono formerà una faccia, cioè apparirà pieno.
* Restituisce l'oggetto appena creato.
</div>


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