Draft Polygon/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(73 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/it|Name=Draft Polygon|Name/it=Poligono|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Poligono |Shortcut=P G}}

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

{{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}}.
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 '''circosritto''' 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.


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


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


# Esistono diversi modi per invocare il comando:
=== Opzioni ===
#* 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>
* 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.
==Opzioni==
* 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".


È 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).
=== 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}}


* 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.
Vedere anche la pagina [[Draft Pattern/it|Draft Pattern]].
* 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}}
* 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>
=== Script ===
==Note==


Lo strumento Poligono può essere utilizzato nelle [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] tramite la seguente funzione:
* 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à ==

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=
makePolygon(nfaces,[radius],[inscribed],[placement],[face])
polygon = make_polygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
}}
}}
* La funzione crea un oggetto poligono con il numero di lati e il raggio indicati.
* Crea un oggetto {{incode|polygon}} con il numero specificato di facce ({{incode|nfaces}}) e basato su un cerchio di {{incode|radius}} in millimetri.
* Se inscribed è False, il poligono è circoscritto al cerchio di raggio dato, altrimenti è inscritto.
* 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.
* 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.


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

Draft.makePolygon(5,radius=3)
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()
}}
}}

{{clear}}

<languages/>
{{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:}}}}
{{Userdocnavi{{#translation:}}}}

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