Part Box/it: Difference between revisions

From FreeCAD Documentation
(Created page with "==Opzioni== * Tramite l'editor delle Proprietà: ** '''Length:''' Imposta la lunghezza, sull'asse x, per l'oggetto Cubo (default è 10 mm). ** '''Widt...")
No edit summary
 
(84 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<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.svg|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]]
==Properties==
{{Properties_Title|Base}}
*{{PropertyData|Placement}}: Specifies the orientation and position of the Box in the 3D space. See [[Placement | Placement]]. The reference point is the left front lower corner of the box.
*{{PropertyData|Label}}: Label given to the Box object. Change to suit your needs.


<span id="Usage"></span>
{{Properties_Title|Box}}
== Utilizzo ==
*{{PropertyData|Length}}: The length parameter is the Box's dimension in the x-direction.
*{{PropertyData|Width}}: The width parameter is the Box's dimension in the y-direction.
*{{PropertyData|Height}}: The height parameter is the Box's dimension in the z-direction.


# 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>
==Scripting==
== Esempio ==
The Box command can by used in [[macros]] and from the python console using the following function:
<syntaxhighlight>
FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
</syntaxhighlight>
* Where "myBox" is the label for the Box object.
* Returns newly created object of type Box.


[[Image:Part_Box_Scripting_Example.png|thumb|Part Cubo dall'esempio di scripting]]
You can access and modify attributes of the Box object. For example, you may wish to modify the length, width and height parameters.
<syntaxhighlight>
FreeCAD.ActiveDocument.myBox.length = 25
FreeCAD.ActiveDocument.myBox.width = 15
FreeCAD.ActiveDocument.myBox.height = 30
</syntaxhighlight>


Qui viene mostrato un oggetto Part Cubo creato con l'[[#Script|esempio di scripting]] riportato di seguito.
You can change its placement with:
<syntaxhighlight>
FreeCAD.ActiveDocument.myBox.Placement = FreeCAD.Placement(FreeCAD.Vector(4, 6, 3), FreeCAD.Rotation(30, 45, 10))
</syntaxhighlight>


<span id="Notes"></span>
==FreeCAD - Version==
== Note ==


* È 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>
*{{Version|0.14}}
== Proprietà ==
Beginning in FreeCAD version 0.14, a Part Box is referred to in the GUI elements as a Cube and the default label is "Cube".


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

<languages/>
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:

{{Code|code=
box = FreeCAD.ActiveDocument.addObject("Part::Box", "myBox")
}}

* Dove {{Incode|"myBox"}} è il nome dell'oggetto.
* La funzione restituisce l'oggetto appena creato.

Esempio:

{{Code|code=
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()
}}


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

{{Part_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

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