Part Box/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(71 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand/it|Name=Part Box|Name/it=Cubo|Workbenches=[[Part Module/it|Parte]], Completo|MenuLocation=Parte → Primitive → Cubo|Shortcut=Nessuno|SeeAlso=Parte → [[Part_CreatePrimitives/it|Crea primitive...]] → Cubo}}


{{Docnav/it
==Descrizione==
|
Il comando Cubo dell'ambiente [[Part_Workbench/it|Part]] inserisce nel documento attivo un [http://en.wikipedia.org/wiki/Cuboid#Rectangular_cuboid parallelepipedo] parametrico. Di default, inserisce un cubo con i lati di 10 mm, posizionato nell'origine, e con l'etichetta "Cubo". Questi parametri possono essere modificati dopo aver aggiunto l'oggetto.
|[[Part_Cylinder/it|Cilindro]]
|[[Part_Workbench/it|Part]]
|IconL=
|IconR=Part_Cylinder.svg
|IconC=Workbench_Part.svg
}}


{{GuiCommand/it
[[Image:Part_Box.jpg|400px|Part_Box]]
|Name=Part Box
|Name/it=Part Cubo
|MenuLocation=Parte → Primitive → Cubo
|Workbenches=[[Part_Workbench/it|Part]]
|SeeAlso=[[Part_CreatePrimitives/it|Part Primitive]]
}}


<span id="Description"></span>
==Uso==
== Descrizione ==
* Cliccare sull'icona {{KEY|[[Image:Part Box.png|30px]]}} dell'ambiente Parte.
* In alternativa, selezionare {{MenuCommand|Parte → Primitive → Cubo}} nel menu a tendina di Part.


Il comando [[Image:Part_Box.svg|24px]] '''Part Cubo''' crea un solido cuboide parametrico, un [https://en.wikipedia.org/wiki/Cuboid#Rectangular_cuboid cuboide rettangolare]. Nel sistema di coordinate definito dalla sua proprietà {{PropertyData|Placement}}, la faccia inferiore del cuboide si trova sul piano XY con l'angolo anteriore sinistro all'origine e il bordo anteriore parallelo all'asse X.
==Opzioni==
* Tramite l'editor delle [[Property_editor/it | Proprietà]]:
** '''Length:''' Imposta la lunghezza, sull'asse x, per l'oggetto Cubo (default è 10 mm).
** '''Width:''' Imposta la larghezza, sull'asse y, per l'oggetto Cubo (default è 10 mm).
** '''Height:''' Imposta l'altezza, sull'asse z, per l'oggetto Cubo (default è 10 mm).
** '''Placement:''' Specifica l'orientamento e la posizione del Cubo nello spazio 3D. Vedere [[Placement/it| Posizionamento]]. Il punto di riferimento è l'angolo anteriore in basso a sinistra del cubo.
** '''Label:''' L'etichetta è il nome assegnato all'operazione. Questo nome può essere modificato a piacimento.


[[Image:Part_Box_Example.png|400px]]
==Proprietà==
{{Properties_Title|Base}}
*{{PropertyData|Placement}}: Specifica l'orientamento e la posizione del Cubo nello spazio 3D. Vedere [[Placement/it| Posizionamento]]. Il punto di riferimento è l'angolo anteriore in basso a sinistra del cubo.
*{{PropertyData|Label}}: L'etichetta è il nome assegnato all'operazione. Questo nome può essere modificato a piacimento.


<span id="Usage"></span>
{{Properties_Title|Box}}
== Utilizzo ==
*{{PropertyData|Length}}: Il parametro di lunghezza è la dimensione del Cubo nella direzione x.
*{{PropertyData|Width}}: Il parametro di larghezza è la dimensione del Cubo nella direzione y.
*{{PropertyData|Height}}: Il parametro di altezza è la dimensione del Cubo nella direzione z.


# Esistono diversi modi per richiamare il comando:
[[Image:Part_Box-Properties.jpg|Part_Box-Properties]]
#* Premere il pulsante {{Button|[[Image:Part_Box.svg|16px]] [[Part_Box/it|Cubo]]}}.
#* Seleziona l'opzione {{MenuCommand|Parte → Primitive → [[Image:Part_Box.svg|16px]] Cubo}} dal menu.
# Il cubo viene creato.
# Facoltativamente, modificare le dimensioni e il {{PropertyData|Placement}} del cubo effettuando una delle seguenti operazioni:
#* Fare doppio clic sull'oggetto nella [[Tree_view/it|Vista ad albero]]:
#*# Si apre il pannello delle attività {{MenuCommand|Primitive geometriche}}.
#*# Modificare una o più proprietà.
#*# L'oggetto viene aggiornato dinamicamente nella [[3D_view/it|vista 3D]].
#*# Premere il pulsante {{Button|OK}}.
#* Modificare le proprietà nell'[[Property_editor/it|Editor delle proprietà]].
#* Modificare il {{PropertyData|Placement}} con il comando [[Image:Std_TransformManip.svg|16px]] [[Std_TransformManip/it|Trasforma]].


<span id="Example"></span>
=== Script ===
== Esempio ==


[[Image:Part_Box_Scripting_Example.png|thumb|Part Cubo dall'esempio di scripting]]
Lo strumento Cubo può essere utilizzato nelle [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] utilizzando la seguente funzione:

{{Code|code=
Qui viene mostrato un oggetto Part Cubo creato con l'[[#Script|esempio di scripting]] riportato di seguito.
FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")

}}
<span id="Notes"></span>
* Dove "myBox" è l'etichetta per l'oggetto Box.
== Note ==
* Restituisce un oggetto di tipo Box di nuova creazione.

* È possibile creare un Part Cubo anche con il comando [[Image:Part_Primitives.svg|16px]] [[Part_Primitives/it|Part Primitive]]. Con questo comando si possono specificare le dimensioni e il posizionamento al momento della creazione.

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

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

Un oggetto Part Cubo deriva da un oggetto [[Part_Feature/it|Funzione Part]] e ne eredita tutte le proprietà. Ha inoltre le seguenti proprietà aggiuntive:

<span id="Data"></span>
=== Dati ===

{{TitleProperty|Attachment}}

L'oggetto ha le stesse proprietà di collegamento di un [[Part_Part2DObject/it#Dati|Part Part2DObject]].

{{TitleProperty|Box}}

* {{PropertyData|Length|Length}}: la lunghezza del cuboide. Questa è la dimensione nella sua direzione X. Il valore predefinito è {{Value|10mm}}.
* {{PropertyData|Width|Length}}: la larghezza del cuboide. Questa è la dimensione nella sua direzione Y. Il valore predefinito è {{Value|10mm}}.
* {{PropertyData|Height|Length}}: l'altezza del cuboide. Questa è la dimensione nella sua direzione Z. Il valore predefinito è {{Value|10mm}}.

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

Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation], [[Part_scripting/it|Script di Part]] e [[FreeCAD_Scripting_Basics/it|Script di base per FreeCAD]].

È possibile creare una Part Cubo con il metodo {{Incode|addObject()}} del documento:


È possibile accedere e modificare gli attributi dell'oggetto Box. Ad esempio, si potrebbe desiderare di modificare i parametri di lunghezza, larghezza e altezza.
{{Code|code=
{{Code|code=
FreeCAD.ActiveDocument.myBox.Length = 25
box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
FreeCAD.ActiveDocument.myBox.Width = 15
FreeCAD.ActiveDocument.myBox.Height = 30
}}
}}


* Dove {{Incode|"myBox"}} è il nome dell'oggetto.
È possibile modificare la sua posizione con:
* La funzione restituisce l'oggetto appena creato.

Esempio:

{{Code|code=
{{Code|code=
import FreeCAD as App
FreeCAD.ActiveDocument.myBox.Placement = FreeCAD.Placement(FreeCAD.Vector(4, 6, 3), FreeCAD.Rotation(30, 45, 10))

doc = App.activeDocument()

box = doc.addObject("Part::Box", "myBox")
box.Length = 4
box.Width = 8
box.Height = 12
box.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(75, 60, 30))

doc.recompute()
}}
}}


==Versione di FreeCAD==


{{Docnav/it
|
|[[Part_Cylinder/it|Cilindro]]
|[[Part_Workbench/it|Part]]
|IconL=
|IconR=Part_Cylinder.svg
|IconC=Workbench_Part.svg
}}


{{Part_Tools_navi{{#translation:}}}}
*{{Version|0.14}}
{{Userdocnavi{{#translation:}}}}
Dalla versione 0.14 di FreeCAD, un Box di Parte è indicato negli elementi della GUI come un Cubo e l'etichetta di default è "Cubo".

Latest revision as of 22:11, 2 January 2024

Part Cubo

Posizione nel menu
Parte → Primitive → Cubo
Ambiente
Part
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Part Primitive

Descrizione

Il comando Part Cubo crea un solido cuboide parametrico, un cuboide rettangolare. Nel sistema di coordinate definito dalla sua proprietà DatiPlacement, la faccia inferiore del cuboide si trova sul piano XY con l'angolo anteriore sinistro all'origine e il bordo anteriore parallelo all'asse X.

Utilizzo

  1. Esistono diversi modi per richiamare il comando:
    • Premere il pulsante Cubo.
    • Seleziona l'opzione Parte → Primitive → Cubo dal menu.
  2. Il cubo viene creato.
  3. Facoltativamente, modificare le dimensioni e il DatiPlacement del cubo effettuando una delle seguenti operazioni:
    • Fare doppio clic sull'oggetto nella Vista ad albero:
      1. Si apre il pannello delle attività Primitive geometriche.
      2. Modificare una o più proprietà.
      3. L'oggetto viene aggiornato dinamicamente nella vista 3D.
      4. Premere il pulsante OK.
    • Modificare le proprietà nell'Editor delle proprietà.
    • Modificare il DatiPlacement con il comando Trasforma.

Esempio

Part Cubo dall'esempio di scripting

Qui viene mostrato un oggetto Part Cubo creato con l'esempio di scripting riportato di seguito.

Note

  • È possibile creare un Part Cubo anche con il comando Part Primitive. Con questo comando si possono specificare le dimensioni e il posizionamento al momento della creazione.

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Part Cubo deriva da un oggetto Funzione Part e ne eredita tutte le proprietà. Ha inoltre le seguenti proprietà aggiuntive:

Dati

Attachment

L'oggetto ha le stesse proprietà di collegamento di un Part Part2DObject.

Box

  • DatiLength (Length): la lunghezza del cuboide. Questa è la dimensione nella sua direzione X. Il valore predefinito è 10mm.
  • DatiWidth (Length): la larghezza del cuboide. Questa è la dimensione nella sua direzione Y. Il valore predefinito è 10mm.
  • DatiHeight (Length): l'altezza del cuboide. Questa è la dimensione nella sua direzione Z. Il valore predefinito è 10mm.

Script

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

È possibile creare una Part Cubo con il metodo addObject() del documento:

box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
  • Dove "myBox" è il nome dell'oggetto.
  • La funzione restituisce l'oggetto appena creato.

Esempio:

import FreeCAD as App

doc = App.activeDocument()

box = doc.addObject("Part::Box", "myBox")
box.Length = 4
box.Width = 8
box.Height = 12
box.Placement = App.Placement(App.Vector(1, 2, 3), App.Rotation(75, 60, 30))

doc.recompute()