PartDesign Body/it: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(82 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Std Group/it|Gruppo]]|[[PartDesign_NewSketch/it|Creare uno schizzo]]|[[PartDesign_Workbench/it|PartDesign]]|IconL=Group.svg|IconC=Workbench_PartDesign.svg|IconR=PartDesign_NewSketch.png}}
{{Docnav/it||[[PartDesign_NewSketch/it|Creare uno schizzo]]|[[PartDesign_Workbench/it|PartDesign]]|IconR=PartDesign_NewSketch.svg|IconC=Workbench_PartDesign.svg}}


{{GuiCommand/it
{{GuiCommand/it
|Name=PartDesign Body
|Name=PartDesign Body
|Name/it=Corpo
|Name/it=Corpo
|Workbenches=[[PartDesign Workbench/it|PartDesign]]
|MenuLocation=Part Design → Crea un corpo
|MenuLocation=Part Design → Crea un corpo
|Workbenches=[[PartDesign_Workbench/it|PartDesign]]
|Version=0.17
|Version=0.17
|SeeAlso=[[Std Part/it|Parte standard]], [[feature editing/it|Editazione delle funzioni]]
|SeeAlso=[[Std_Part/it|Parte standard]], [[feature_editing/it|Editazione delle funzioni]]
}}
}}


<span id="Description"></span>
==Descrizione==
==Descrizione==


Un [[PartDesign Body/it|Corpo]] di PartDesign è l'elemento base per creare forme solide con [[PartDesign Workbench/it|PartDesign]]. Può contenere [[Sketch/it|schizzi]], oggetti di riferimento e [[Glossary#Feature|funzioni]] di PartDesign per produrre un [[PartDesign_Body/it#Singolo solido contiguo|singolo solido contiguo]].
Un [[PartDesign Body/it|Corpo]] di PartDesign è l'elemento base per creare forme solide con [[PartDesign Workbench/it|PartDesign]]. Può contenere [[Sketch/it|schizzi]], [[Datum/it|oggetti di riferimento]] e [[PartDesign Feature/it|funzioni di PartDesign]] che aiutano a produrre un [[PartDesign_Body/it#Singolo solido contiguo|singolo solido contiguo]].


Il Corpo fornisce un oggetto {{MenuCommand|Origin}} che include gli assi X,Y,Z, e i piani locali. Questi elementi possono essere usati come riferimenti per collegare gli [[Sketch/it|schizzi]] e gli oggetti primitivi.
Il Corpo fornisce un oggetto {{MenuCommand|Origin}} che include gli assi X,Y,Z, e i piani standard. Questi elementi possono essere usati come riferimenti per collegare gli [[Sketch/it|schizzi]] e gli [[PartDesign_CompPrimitiveAdditive/it|oggetti primitivi]].


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Poiché si suppone che il corpo sia un singolo solido contiguo, esso può essere spostato interamente come un'unità, senza spostare le singole funzioni. All'interno di una [[Std_Part/it|Parte standard]] è possibile posizionare più corpi per creare assiemi.
Poiché si suppone che il Corpo sia un [[PartDesign_Body/it#Singolo solido contiguo|singolo solido contiguo]], esso può essere spostato interamente come un'unità, senza spostare le singole funzioni. All'interno di una [[Std_Part/it|Parte standard]] è possibile posizionare più corpi per creare assiemi.
</div>
</div>


Line 25: Line 26:
}}
}}


<span id="Usage"></span>
== Utilizzo ==
== Utilizzo ==


Se non è stato selezionato alcun solido precedente:
<div class="mw-translate-fuzzy">
Premere il pulsante {{KEY|[[Image:PartDesign Body.png|24px]] '''Crea corpo'''}}. Il nuovo corpo viene creato e diventa automaticamente attivo.
# Premere il pulsante {{Button|[[Image:PartDesign_Body.svg|16px]] [[PartDesign Body/it|Corpo]]}}. Viene creato un corpo vuoto che diventa automaticamente {{Emphasis|[[PartDesign_Body/it#Stato attivo|attivo]]}}.
# Ora si può premere {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/it|Nuovo schizzo]]}} per creare uno [[Sketch/it|schizzo]] nel corpo. In seguito lo schizzo può essere utilizzato per creare una {{Button|[[File:PartDesign_Pad.svg|16px]] [[PartDesign_Pad/it|Estrusione]]}}.
</div>
# In alternativa, si può aggiungere una [[PartDesign Feature/it|funzione di PartDesign]] primitiva, ad esempio un {{Button|[[File:PartDesign_AdditiveBox.svg|16px]] [[PartDesign_AdditiveBox/it|Cubo additivo]]}}.


Se viene selezionato un oggetto solido:
If a solid object is selected:
# Press the {{Button|[[Image:PartDesign_Body.svg|16px]] [[PartDesign Body|Body]]}} button. A new body is created containing a single {{MenuCommand|BaseFeature}}. This BaseFeature element is a simple reference to another object previously created or imported into the document. The BaseFeature can also be created by dragging that solid into an empty Body. This is done when we have a pre-existing solid (for example, created with the [[Part Workbench|Part Workbench]] or imported from a Step file) that we want to modify further with PartDesign tools.
# Premere il pulsante {{Button|[[Image:PartDesign_Body.svg|16px]] [[PartDesign Body/it|Corpo]]}}. Viene creato un nuovo Corpo contenente una singola {{MenuCommand|Base Feature}}. Questo elemento Base Feature è un semplice riferimento a un altro oggetto precedentemente creato o importato nel documento. Per maggiori informazioni vedere [[PartDesign_Body/it#Funzione di base|Funzione di base]]. Non è possibile selezionare un Corpo esistente o una [[PartDesign_Feature/it|funzione di PartDesign]] quando si preme {{Button|[[Image:PartDesign_Body.svg|16px]] [[PartDesign Body/it|Corpo]]}}.


<span id="Notes"></span>
<div class="mw-translate-fuzzy">
====Note sull'utilizzo====
=== Note ===
* Per attivare o disattivare un corpo fare doppio clic sul corpo nell'albero del modello, oppure fare clic con il tasto destro del mouse e selezionare '''Attiva/disattiva corpo'''. Se un altro corpo è già attivo, esso viene automaticamente disattivato.
* Se si seleziona prima una forma solida, al corpo viene aggiunto un oggetto solido '''BaseFeature'''; la BaseFeature è collegata alla forma solida originale. Le forme accettate possono essere un solido importato o un solido realizzato in qualsiasi altro ambiente di lavoro di FreeCAD.
* In un nuovo documento, quando viene creato uno schizzo dalla barra degli strumenti di PartDesign, viene anche creato automaticamente un nuovo corpo.
</div>


* Se, quando si preme il pulsante {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/it|Nuovo schizzo]]}} della barra degli strumenti di PartDesign non esiste ancora un corpo, ne viene creato automaticamente uno nuovo. Se esiste già un corpo, esso deve essere reso attivo prima di usare {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/it|Nuovo schizzo]]}}.
* An existing Body cannot be selected when pressing {{Button|[[Image:PartDesign_Body.svg|16px]] [[PartDesign Body|Body]]}} button. However, an existing Body can be used as the BaseFeature by adding that object to the {{PropertyData|Base Feature}} property.
* Fare doppio clic su Corpo nella [[tree view/it|vista ad albero]] o aprire il menu di scelta rapida (clic con il tasto destro) e selezionare {{MenuCommand|Attiva corpo}} per attivare o disattivare il corpo. Se un altro corpo è attivo, esso viene disattivato. Per maggiori informazioni vedere [[PartDesign_Body/it#Stato attivo|Stato attivo]].
* If no Body currently exists, when {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|New sketch]]}} is pressed on the PartDesign toolbar, a new Body will be automatically created.
* Double-click the Body in the [[tree view|tree view]] or open the context menu (right-click) and select {{MenuCommand|Toggle active body}} to activate or deactivate the Body. If another Body is active, it will be deactivated.


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


Line 51: Line 50:
Oltre alle proprietà descritte in [[Part Feature/it|Part Feature]], il corpo di PartDesign ha le seguenti proprietà nell'[[property editor/it|editor delle proprietà]].
Oltre alle proprietà descritte in [[Part Feature/it|Part Feature]], il corpo di PartDesign ha le seguenti proprietà nell'[[property editor/it|editor delle proprietà]].


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


{{TitleProperty|Base}}
{{TitleProperty|Base}}

* {{PropertyData|Tip|Link}}: è la [[PartDesign Feature/it|funzione di PartDesign]] definita come "funzione finale", che è in genere l'ultima funzione creata nel corpo. La funzione finale indica la forma finale del corpo, che viene mostrata nella [[3D view/it|Vista 3D]] quando {{PropertyView|Display Mode Body}} è impostata su {{incode|Tip}}. Per maggiori informazioni vedere [[PartDesign_Body/it#Tip|Tip]].
* {{PropertyData|Base Feature|Link}}: è una forma esterna usata come prima [[PartDesign Feature/it|funzione di PartDesign]] nel Corpo. Di solito viene impostata quando si trascina un oggetto solido in un corpo vuoto. Se non viene importato nessun solido in questo modo, questa proprietà rimane vuota. Per maggiori informazioni vedere [[PartDesign_Body/it#Funzione di base|Funzione di base]].
* {{PropertyData|Placement}}: la posizione dell'oggetto nella [[3D view/it|Vista 3D]]. Il posizionamento è definito da un punto {{incode|Base}} (vettore) e una {{incode|Rotation}} (asse e angolo). Vedere [[Placement/it|Posizionamento]].
* {{PropertyData|Group}}: un elenco di [[PartDesign Feature/it|funzioni di PartDesign]] nel Corpo

<span id="Hidden_properties_Data"></span>
====Proprietà dati nascoste====


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
* {{PropertyData|Origin|Link}}: l'oggetto [[App_Origin/it|App Origin]] che è il riferimento posizionale per tutti gli elementi elencati nel {{PropertyData|Gruppo}}.
* {{PropertyData|Tip}}: visualizza e imposta la funzione definita come "funzione finale".
* {{PropertyData|_ Group Touched|Bool}}: se il gruppo viene toccato o no.
* {{PropertyData|Base Feature}}: visualizza e imposta la forma esterna utilizzata come funzione di base. Non si applica se la funzione di base è unaa funzione di PartDesign.
* {{PropertyData|Group}}: elenca gli oggetti referenziati all'interno del corpo.
</div>
</div>


Oltre ale proprietà nascoste descritte in [[Part Feature/it|Part Feature]] il corpo di PartDesign ha le seguenti proprietà nell'[[Property_editor/it|editor delle proprietà]].

<span id="View"></span>
===Vista===
===Vista===


<div class="mw-translate-fuzzy">
{{TitleProperty|Base}}
{{TitleProperty|Base}}
* {{PropertyView/it|Display Mode Body}}: imposta la visualizzazione tra due modalità:
** ''Through'' (default) espone tutto all'interno del corpo (caratteristiche, riferimenti, schizzi, ecc.). È la modalità utilizzata per aggiungere e modificare le funzioni all'interno del corpo.
** ''Tip'' espone solo la forma del corpo stesso secondo la punta impostata; tutto il resto, inclusi gli schizzi, è nascosto alla vista e non può essere visualizzato. Uso pratico: "Tip" consente di selezionare i bordi e le facce del corpo per creare operazioni con altri ambienti di lavoro.
</div>


* {{PropertyView|Display Mode Body}}: sets the display mode specifically for the Body with one of two types.
* {{PropertyView|Display Mode Body|Enumeration}}: imposta la modalità di visualizzazione nella vista 3D specifica per il corpo in uno dei due tipi.
** {{incode|Through}} (default) exposes all objects inside the Body, that is, sketches, features, datum objects, etc. This mode allows visualizing partial operations done inside the Body, and thus it is the recommended mode when adding and editing features. Select the specific feature, and the set {{PropertyView|Visibility}} to {{TRUE}} or press {{KEY|Space}} on the keyboard.
** {{incode|Through}} (default) espone tutti gli oggetti all'interno del Corpo, ovvero [[Sketch/it|schizzi]], [[PartDesign Feature/it|funzioni di PartDesign]], oggetti di riferimento, ecc. Questa modalità consente di visualizzare le operazioni parziali eseguite all'interno del Corpo, quindi è la modalità raccomandata durante l'aggiunta e la modifica di funzioni. Selezionare la funzione desiderata e impostare {{PropertyView|Visibility}} su {{TRUE}} o premere la barra {{KEY|Spazio}} sulla tastiera.
** {{incode|Tip}} espone solo la forma finale del corpo, definita dalla proprietà {{PropertyData|Tip}}. Tutto il resto, tra cui [[Sketch/it|schizzi]], [[PartDesign Feature/it|funzioni di PartDesign]], oggetti di riferimento, ecc., non viene visualizzato, anche se sono visibili nella [[tree view/it|vista ad albero]]. Questa modalità è consigliata quando non è necessario modificare ulteriormente il corpo, quindi viene visualizzata una forma finale. Questa modalità è consigliata anche quando si desidera selezionare gli elementi secondari (vertici, bordi e facce) della forma finale da utilizzare con gli strumenti di altri ambienti da lavoro.
** {{incode|Tip}} exposes only the final shape of the Body, which is defined by the {{PropertyData|Tip}} property. Everything else, including sketches, partial features, datums, etc., is not displayed, even if they are visible in the [[tree view|tree view]]. This mode is recommended when the Body does not need to be modified further, so a fixed shape is shown. This mode is also recommended when you wish to select the sub-elements (vertices, edges, and faces) of the final shape to use with other workbenches' tools.


<span id="Body_concept"></span>
== Descrizione completa ==
== Concetto di Corpo ==


<span id="Single_contiguous_solid"></span>
=== Single contiguous solid ===
=== Singolo solido contiguo ===


Il corpo PartDesign è progettato per modellare un singolo solido contiguo. Per "contiguo" si intende un elemento realizzato in un unico pezzo, senza parti mobili o solidi disconnessi. Esempi di solidi contigui sono quelli fabbricati da un singolo pezzo di materia prima mediante un processo di fusione, taglio o fresatura. Ad esempio, un dado, una rondella e un bullone sono costituiti ciascuno da un unico pezzo di acciaio solido senza parti mobili, quindi ciascuno di essi può essere modellato come un corpo PartDesign. Gli oggetti creati saldando due pezzi possono anche essere modellati in un singolo corpo, purché il giunto di saldatura non sia destinato a rompersi.
A PartDesign Body is intended to model a single contiguous solid. The meaning of "contiguous" is an element made in one piece, with no moving parts, or disconnected solids. Examples of contiguous solids are those that are manufactured from a single piece of raw material by a process of casting, cutting, or milling. For example, a nut, a washer, and a bolt each consists of a single solid piece of metal with no moving parts, so each can be modelled by a PartDesign Body. Objects that are created by welding two pieces can also be modelled by a single Body as long as the weld joint is solid and not intended to break apart.


Quando questi solidi contigui vengono riuniti in un qualche tipo di disposizione, diventano un "assemblaggio". In un assemblaggio, gli oggetti non vengono fusi insieme, ma vengono semplicemente "impilati" o posizionati uno accanto all'altro e rimangono singole parti.
Once these contiguous solids are put together in some type of arrangement, then they become an "assembly". In an assembly, the objects are not fused together, they are "stacked" or placed next to each other but remain separate solids.


[[File:PartDesign_Body_contiguous_separate.png|x200px]] [[File:PartDesign_Body_contiguous_assembly.png|x200px]]
[[File:PartDesign_Body_contiguous_separate.png|x200px]] [[File:PartDesign_Body_contiguous_assembly.png|x200px]]
{{Caption|Left: three individual contiguous solids, each of them modelled by a PartDesign Body. Right: the individual Bodies put together in an assembly.}}
{{Caption|A sinistra: tre solidi contigui individuali, ciascuno modellato in un Corpo di PartDesign. A destra: i singoli Corpi riuniti in un'assemblaggio.}}


<span id="Feature_editing"></span>
=== Feature editing ===
=== Editazione delle funzioni ===


Un corpo di PartDesign è progettato per funzionare creando un solido iniziale, da uno [[Sketch/it|schizzo]] o da una [[PartDesign_CompPrimitiveAdditive/it|forma primitiva]], e quindi modificandolo tramite le [[PartDesign Feature/it|"funzioni"]] per aggiungere o rimuovere materiale dalla forma precedente. Per una spiegazione completa, vedere la pagina [[feature editing/it|editazione delle funzioni]].
A PartDesign Body is intended to work by creating an initial solid, either from a Sketch or from a primitive shape, and then modifying it through "features" that add or remove material from the previous shape. For a full explanation go to [[feature editing|feature editing]].


Un corpo di PartDesign esegue una [[Part_Fuse/it|fusione]] (unione) automatica degli elementi solidi al suo interno. Ciò significa che (1) i solidi parziali devono toccarsi quando vengono creati e (2) che i solidi disconnessi non sono consentiti.
A PartDesign Body will perform an automatic fusion of the solid elements inside of it. This means that the partial solids should be touching, and disconnected solids are not allowed.


[[File:PartDesign_Body_two_intersection.png|x200px]] [[File:PartDesign_Body_two_fusion.png|x200px]]
[[File:PartDesign_Body_two_intersection.png|x200px]] [[File:PartDesign_Body_two_fusion.png|x200px]]
{{Caption|A sinistra: due singoli solidi che si intersecano. A destra: un singolo corpo di PartDesign creato con due [[PartDesign Feature/it|funzioni additive]], che vengono automaticamente fuse insieme, quindi invece di intersecarsi, formano un singolo solido contiguo.}}
{{Caption|Left: two individual solids that intersect each other. Right: a single PartDesign Body with two additive features; they are automatically fused together, so instead of intersecting, they form a single contiguous solid.}}


[[File:PartDesign_Body_non-contiguous.png]]
[[File:PartDesign_Body_non-contiguous.png]]
{{Caption|Left: two disconnected solids; this isn't a valid PartDesign Body. Right: two touching solids; this results in a valid PartDesign Body. The newer feature should always contact or intersect the previous feature so that it is fused to it, and becomes a single contiguous solid.}}
{{Caption|A sinistra: due solidi disconnessi; questo non è un corpo PartDesign valido. A destra: due solidi che si toccano; ciò si traduce in un corpo PartDesign valido. La [[PartDesign Feature/it|funzione]] più recente deve sempre contattare o intersecare la funzione precedente in modo che sia fusa con essa e diventi un singolo solido contiguo.}}


{{Emphasis|Nota:}} altri programmi CAD come Catia consentono solidi non contigui nello stesso "Corpo". A partire dalla versione 0.19, FreeCAD non lo consente. Ci sono state delle discussioni nel [https://forum.freecadweb.org/index.php forum di FreeCAD] sulla revoca di questa restrizione, ma non è stata presa alcuna decisione concreta. Se desiderate saperne di più o presentare punti di vista diversi, potete discuterne nel [https://forum.freecadweb.org/index.php forum].
<div class="mw-translate-fuzzy">

<span id="Detailed_explanation_of_the_properties"></span>
== Spiegazione dettagliata delle proprietà ==

<span id="Active_status"></span>
===Stato attivo===
===Stato attivo===
</div>


Un documento aperto può contenere più corpi. Per aggiungere una nuova funzione a un corpo specifico, è necessario renderlo {{Emphasis|attivo}}. Un corpo attivo vinene visualizzato nella [[tree view/it|vista ad albero]] con il colore di sfondo specificato dal valore {{MenuCommand|Active container}} nell'[[Preferences_Editor/it#Colori|editor delle preferenze]] (per impostazione predefinita, blu). Un corpo attivo viene anche mostrato in grassetto.
<div class="mw-translate-fuzzy">
Un documento di FreeCAD può contenere più Corpi. Pertanto, per aggiungere una nuova funzionalità a un corpo specifico, è necessario renderlo attivo. Un corpo attivo viene visualizzato nell'albero con il colore di sfondo specificato nelle [[Preferences_Editor/it#Colors|Preferenze]] (impostando '''Contenitore attivo'''). Inoltre nella v0.18, la sua etichetta nell'albero del modello viene visualizzata in grassetto.
</div>


Per attivare o disattivare un corpo:
To activate or de-activate a Body:
* Double click on it on the [[tree view|tree view]], or
* Fare doppio clic su di esso nella [[tree view/it|vista ad albero]], oppure
* Open the context menu (right click) and select {{MenuCommand|Toggle active body}}.
* Aprire il menu contestuale (tasto destro) e selezionare {{MenuCommand|Attiva/disattiva il corpo}}.

L'attivazione di un corpo commuta automaticamente anche l'interfaccia nell'ambiente [[PartDesign Workbench/it|PartDesign]], se questo non era già l'ambiente attivo. Può essere attivo solo un singolo corpo per volta.


[[File:PartDesign_Body_active.png]]
[[File:PartDesign_Body_active.png]]


{{Caption|Documento con due corpi PartDesign, di cui il secondo è attivo.}}
<div class="mw-translate-fuzzy">
L'attivazione di un corpo commuta automaticamente anche l'interfaccia nell'ambiente PartDesign, se questo non era già l'ambiente attivo.
</div>


<span id="Origin"></span>
<div class="mw-translate-fuzzy">
===Origine===
===Origine===
L'origine comprende i tre assi standard (X, Y, Z) e tre piani standard (XY, XZ e YZ). Gli schizzi possono essere collegati a questi piani e i piani insieme agli assi possono essere utilizzati per creare altre geometrie di riferimento (datum). Tutti gli elementi all'interno del corpo sono riferiti all'origine del corpo; il che significa che il corpo può essere spostato e ruotato in riferimento al sistema di coordinate globale senza influire sul posizionamento di elementi all'interno del corpo.
</div>


The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). [[Sketch|Sketches]] and other objects can be attached to these elements when creating them.
The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). [[Sketch|Sketches]] and other objects can be attached to these elements when creating them.
# Create the Body.
# Create the Body.
# If the Body is selected in the [[tree view|tree view]], when {{Button|[[File:PartDesign NewSketch.svg|16px]] [[PartDesign NewSketch|New sketch]]}} is pressed, the [[task panel|task panel]] will open to allow selecting one of the planes.
# If the Body is selected in the [[tree view|tree view]], press {{Button|[[File:PartDesign NewSketch.svg|16px]] [[PartDesign NewSketch|New sketch]]}}; the [[task panel|task panel]] will open to allow selecting one of the planes.
# If the Body is not selected, select the Origin instead and make it visible in the [[3D view|3D view]] by pressing {{KEY|Space}} in the keyboard. Also expand the Origin object to see the axes and planes.
# If the Body is not selected, select the Origin instead and make it visible in the [[3D view|3D view]] by pressing the {{KEY|Space}} bar in the keyboard. Also expand the Origin object to see the axes and planes.
# Select one of the planes, either in the [[tree view|tree view]] or in the [[3D view|3D view]], then press {{Button|[[File:PartDesign NewSketch.svg|16px]] [[PartDesign NewSketch|New sketch]]}}. The sketch will be created on the chosen plane.
# Select one of the planes, either in the [[tree view|tree view]] or in the [[3D view|3D view]], then press {{Button|[[File:PartDesign NewSketch.svg|16px]] [[PartDesign NewSketch|New sketch]]}}. The sketch will be created on the chosen plane.


The same process can be used when creating auxiliary datum geometry like [[PartDesign Line|lines]], [[PartDesign Plane|planes]], and [[PartDesign_CoordinateSystem|coordinate systems]].
The same process can be used when creating auxiliary datum geometry like [[PartDesign Line|PartDesign Lines]], [[PartDesign Plane|PartDesign Planes]], and [[PartDesign_CoordinateSystem|PartDesign CoordinateSystems]].


{{Emphasis|Note:}} the Origin is an [[App_OriginGroupExtension|App Origin]] object ({{incode|App::Origin}} class), while the axes and planes are objects of type {{incode|App::Line}} and {{incode|App::Plane}} respectively. Each of these elements can be hidden and unhidden individually with the {{KEY|Space}} bar; this is useful to choose the correct reference when creating other objects.
All elements inside the Body are referenced to the Body's Origin which means that the Body can be moved and rotated in reference to the global coordinate system without affecting the placement of elements inside.

{{Emphasis|Note 2:}} all elements inside the Body are referenced to the Body's Origin which means that the Body can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.


[[File:PartDesign_Body_Origin_tree.png]] [[File:PartDesign_Body_Origin_view.png|x400px]]
[[File:PartDesign_Body_Origin_tree.png]] [[File:PartDesign_Body_Origin_view.png|x400px]]


{{Caption|PartDesign Origin in the [[tree view|tree view]], and as it appears displayed on the [[3D view|3D view]].}}
{{Caption|Left: PartDesign Body Origin in the [[tree view|tree view]]. Right: representation of the Origin elements in the [[3D view|3D view]].}}


<span id="Base_Feature"></span>
The Origin is an object of class {{incode|App::Origin}}, while the axes and planes are objects of type {{incode|App::Line}} and {{incode|App::Plane}} respectively.
=== Funzione di base ===


La Funzione di base, Base feature, è la prima [[PartDesign Feature/it|Funzione PartDesign]] creata nel corpo quando il corpo si basa su un'altra forma solida. Questo solido può essere creato in qualsiasi ambiente di lavoro o importato da un file esterno, ad esempio un file STEP.
<div class="mw-translate-fuzzy">

===Funzione di base===
[[File:PartDesign_Body_BaseFeature_tree.png]]
La funzione di base è per definizione la prima funzione PartDesign creata nel corpo. Come funzione di base è possibile utilizzare una forma solida, importata o modellata in altri ambienti, a cui è possibile aggiungere schizzi e altre funzionalità.
{{Caption|Two PartDesign Bodies, each with a single Base Feature taken from a previously created solid.}}
</div>

To create the Base Feature:
# select a solid shape external to any Body, and
# press {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|Body]]}}; this will create a new Body with a single Base Feature.

{{Emphasis|Note:}} you can't select an existing Body, or any of its [[PartDesign Feature|features]], when pressing {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|Body]]}}.

If you already have a Body, you can create the Base Feature in this way:
* in the [[tree view|tree view]], pick an object, and drag and drop it inside the Body, or
* in the [[property editor|property editor]], edit the value of {{PropertyData|Base Feature}} by pressing the ellipsis {{KEY|...}}, and choosing an object from the list. In this case you can choose an existing Body to be the Base Feature.

{{Emphasis|Note:}} dragging and dropping only works for Bodies which don't have a Base Feature already.

{{Emphasis|Note 2:}} if the Body already has several features, when you drag and drop the external solid, the Base Feature will be created at the beginning of the list of features, that is, it will be added to the beginning of the {{PropertyData|Group}} property.

The Base Feature is entirely optional; it is only present when including an object from outside the Body. If no external solid is included, you can still build your shape using [[Sketch|sketches]], [[PartDesign Pad|pads]], [[PartDesign_CompPrimitiveAdditive|primitive objects]], and other [[PartDesign Feature|PartDesign Features]]. In this case the {{PropertyData|Base Feature}} property remains empty.

[[File:PartDesign_Body_BaseFeature_Tip.svg]]

{{Caption|Left: PartDesign Body with a Base Feature that is taken from an external solid object, and many subsequent [[PartDesign Feature|PartDesign Features]] on top. Right: Body which doesn't have an explicit Base Feature.}}

{{Emphasis|Note:}} If another PartDesign body is selected as a BaseFeature it must have a shape. If it is empty (no features, no BaseFeature, ...) this will result in error.

===Tip===


The base feature is by definition the first PartDesign feature created in the Body. But it is possible to use a solid shape, either imported or modelled in other workbenches, as a base feature to which sketches and other features can be added.
[[File:PartDesign_Body_tree-03.png|none]]
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
La cima o punta (Tip) è la [[PartDesign Feature/it|PartDesign Feature]] del corpo che viene esposta all'esterno (quello che si vede). Viene automaticamente impostata sull'ultima funzione nella parte inferiore dell'albero; vale a dire che, se un altro strumento da qualsiasi ambiente di lavoro (ad esempio, [[Part_SimpleCopy/it|Copia semplice]] o [[Part_Cut/it|Sottrai]] di Part) deve utilizzare la forma del corpo, utilizzerà la forma della Punta. Detto in altro modo, la Punta è la rappresentazione finale del Corpo come se la storia parametrica non esistesse.
===Cima - Tip - Elemento finale===
La cima (tip) è la funzione del corpo che viene esposta all'esterno (quello che si vede). Viene automaticamente impostata sull'ultima funzione nella parte inferiore dell'albero. Ma a volte può essere utile cambiarla con una funzione precedente nell'albero del corpo, con l'effetto di riportare indietro la sua storia; questo rende possibile aggiungere delle funzionalità che avrebbero dovuto essere aggiunte in precedenza. Nell'albero del corpo, la funzione impostata su punta è mostrata con un punto verde con una freccia bianca rivolta verso il basso.
</div>
</div>


[[File:PartDesign_Body_Tip_final.svg]]
The tip is the feature that is exposed outside the Body. It is automatically set to the last feature at the bottom of the tree. But sometimes it can be useful to change it to an earlier feature in the Body tree, which in effect rolls back its history; then it is possible to add features that should have been added earlier. In the Body tree, the feature set to tip displays a green dot with a white down arrow in it.

[[File:PartDesign_Body_tree-04.png|none]]
{{Caption|Left: PartDesign Body with full parametric history including intermediate features. Right: the Tip is the final shape that can be exported from the Body, while omitting the model's history.}}
Per maggiori dettagli, vedere la pagina [[File:PartDesign_MoveTip.png|24px]] [[PartDesign MoveTip/it|Imposta come elemento finale ]].

The Tip is automatically set to the last feature created in the Body. Nevertheless, it can also be set to any of the intermediate features by opening the [[tree view|tree view]] context menu (right-click) and choosing {{MenuCommand|[[File:PartDesign_MoveTip.svg|16px]] [[PartDesign_MoveTip|Set tip]]}}, or by changing the Body's {{PropertyData|Tip}} value in the [[property editor|property editor]].

Changing the Tip in effect rolls back its history, making it possible to add features that should have been added earlier. It also exposes a different shape to external tools.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Nella [[tree view/it|vista ad albero]], la funzione finale del corpo è riconoscibile dalla [[PartDesign Feature/it|funzione di PartDesign]] che ha una icona sovrapposta costituita da una freccia bianca all'interno di un cerchio verde.
===Gestione della visibilità===
La visibilità del corpo prevale sulla visibilità di qualsiasi oggetto in esso contenuto. Se il corpo è nascosto, sono nascosti anche gli oggetti che esso contiene, anche se la loro visibilità è impostata su true. Può essere visibile una sola funzione per volta. Selezionare una funzione nascosta e premere {{KEY | barra spaziatrice}} per renderla visibile e nascondere automaticamente la funzione precedentemente visibile.
</div>
</div>


[[File:PartDesign_Body_Tip_tree.png]]
The Body's visibility supersedes the visibility of any object it contains. If the Body is hidden, the objects it contains will be hidden as well, even if their visibility is set to true. Only one feature can be visible at a time. Selecting a hidden feature and pressing the {{KEY|space bar}} will make it visible, and automatically hide the previously visible feature.
{{Caption|Two PartDesign Bodies, each of them with [[PartDesign Feature|PartDesign Features]]. The Tip is the last feature in them, and is marked with an overlay symbol.}}


<span id="Interaction_with_other_workbenches"></span>
<div class="mw-translate-fuzzy">
===Interazione con gli altri ambienti di lavoro ===
===Interazione con gli altri ambienti di lavoro ===

Per impostazione predefinita, gli oggetti sottostanti ad un Corpo sono selezionabili, e ovviamente ciò è necessario per poter modificare e aggiungere delle funzioni in PartDesign. Ma si sconsiglia di selezionare le funzioni di un corpo per creare operazioni con altri ambienti (come [[Part Module/it|Part]] o [[Draft Module/it|Draft]]) in quanto i risultati potrebbero essere inaspettati; in questi casi, nella finestra Report, appare l'errore ''Links go out of the allowed scope''.
<div class="mw-translate-fuzzy">
Per impostazione predefinita, le [[PartDesign Feature/it|funzioni]] all'interno di un corpo sono selezionabili, e ovviamente ciò è necessario per poter modificare e aggiungere delle funzioni in PartDesign. Tuttavia, non è consigliabile selezionare le singole funzioni per utilizzarle con gli strumenti di altri ambienti di lavoro, come [[Part_Workbench/it|Part]] e [[Draft_Workbench/it|Draft]], poiché i risultati potrebbero essere inaspettati; in tal caso, nella [[Report view/it|vista rapporto]] potrebbe apparire un messaggio di errore, {{Emphasis|Links go out of the allowed scope}}.
</div>
</div>


Pertanto, per le interazioni con gli altri ambienti, dovrebbe essere selezionato solo il Corpo stesso dall'albero del modello. Nei casi in cui è necessario selezionare un sottoelemento specifico del Corpo (vertice, bordo, faccia), allora la proprietà vista {{PropertyView|Display Mode Body}} del Corpo può essere modificata da ''Through'' (impostazione predefinita) a {{incode|Tip}}. Questa proprietà è accessibile dal pannello Vista. In modalità ''Tip'' l'accesso agli oggetti sottostanti al Corpo (funzioni, riferimenti, schizzi) è disabilitato; nella vista 3D viene nascosto tutto tranne la funzione tip, indipendentemente da quale oggetto è impostato come visibile.
By default, objects underneath a Body are selectable, and this is of course required to edit and add features in PartDesign. But selecting a Body's features to create operations from other workbenches (like [[Part Module|Part]] or [[Draft Module|Draft]]) is not advised, as the results may be unexpected; in all cases, an error labelled ''Links go out of the allowed scope'' will appear in the Report view.


Una volta completate le operazioni in altri ambienti, non dimenticare di ripristinare la proprietà {{PropertyView|Display Mode Body}} in {{incode|Through}} per essere di nuovo in grado di modificare il corpo.
Pertanto, per le interazioni con gli altri workbench, dovrebbe essere selezionato solo il Corpo stesso dall'albero del modello. Nei casi in cui è necessario selezionare una topologia specifica sul Corpo (vertice, bordo, faccia), allora la proprietà vista '''Display Mode Body''' del Corpo può essere modificata da ''Through'' (impostazione predefinita) a ''Tip''. Questa proprietà è accessibile dal pannello Vista. In modalità ''Tip'' l'accesso agli oggetti sottostanti al Corpo (funzioni, riferimenti, schizzi) è disabilitato; nella vista 3D viene nascosto tutto tranne la funzione tip, indipendentemente da quale oggetto è impostato come visibile.


[[File:PartDesign_Body_Tip_Display_mode.svg]]
Una volta completate le operazioni in altri workbench, non dimenticare di ripristinare la proprietà '''Display Mode Body''' in ''Through'' per essere di nuovo in grado di modificare il corpo.

{{Caption|Left: when "Display Mode Body" is set to {{incode|Through}} it is possible to select and perform operations with the individual [[PartDesign Feature|PartDesign Features]]; in general, this is not recommended. Right: when "Display Mode Body" is set to {{incode|Tip}} all selections and operations done on the Body will be done on the Tip, making sure only the final shape of the Body is exposed.}}

<span id="Visibility_management"></span>
===Gestione della visibilità===

La visibilità del corpo prevale sulla visibilità di qualsiasi oggetto in esso contenuto. Se il corpo è nascosto, sono nascosti anche gli oggetti che esso contiene, anche se la loro proprietà {{PropertyView|Visibility}} è impostata su {{TRUE}}.

Multiple [[Sketch|Sketches]] may be visible at one time, but only one [[PartDesign Feature|PartDesign Feature]] (solid result) can be visible at a time. Selecting a hidden feature and pressing the {{KEY|Space}} bar in the keyboard will make it visible, and automatically hide the previously visible feature.

[[File:PartDesign_Body_Visibility.png]]
{{Caption|PartDesign Body: multiple [[Sketch|Sketches]] may be visible simultaneously, but only one solid [[PartDesign Feature|PartDesign Feature]] may be visible at one time, whether it is the Tip or not.}}

=== Attachment ===

[[PartDesign Feature|PartDesign Features]], just like [[Part_Part2DObject|planar objects]], can be attached to different planes, usually the standard planes defined by the Body's [[PartDesign_Body#Origin|Origin]], or to custom [[PartDesign Plane|PartDesign Planes]].

[[Sketch|Sketches]] are normally attached to a plane when they are created. In similar way, [[PartDesign_CompPrimitiveAdditive|primitive features]] can also be attached. Attaching these objects to a plane allows them to be moved within the Body by changing their {{PropertyData|Attachment Offset}} property. For more information on the attachment modes see [[Part_EditAttachment|Part EditAttachment]].

A [[PartDesign Feature|PartDesign Feature]] that is not attached will be shown with a red overlay symbol next to their icon in the [[tree view|tree view]].

[[File:PartDesign_Body_Feature_attachment.png]]
{{Caption|PartDesign Body: [[PartDesign Feature|PartDesign Features]] that are not attached to a plane or coordinate system will be shown with an overlay symbol next to their icon in the [[tree view|tree view]].}}


=== Inheritance ===
=== Inheritance ===

A [[PartDesign_Body|PartDesign Body]] is formally an instance of the class {{incode|PartDesign::Body}}, whose parent is [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class) through the intermediate {{incode|Part::BodyBase}} class, and is augmented with an Origin extension.


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|PartDesign::Body}} object is intended to build parametric 3D solids, and thus is derived from the basic {{incode|Part::Feature}} object.}}
{{Caption|Simplified diagram of the relationships between the core objects in the program. The {{incode|PartDesign::Body}} object is intended to build parametric 3D solids, and thus is derived from the basic {{incode|Part::Feature}} object, and has an Origin to control the placement of the features used inside of it.}}


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


{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]].
{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]].


Vedere [[Part_Feature/it|Part Feature]] per le informazioni generali.
Vedere [[Part_Feature/it|Part Feature]] per le informazioni generali sull'aggiunta di oggetti al documento.


Un corpo PartDesign viene creato con il metodo {{incode|addObject()}} del documento. Quando esiste un corpo, ad esso possono essere aggiunte e associate le funzioni primitive additive e sottrattive.
Un corpo PartDesign viene creato con il metodo {{incode|addObject()}} del documento. Quando esiste un Corpo, ad esso si possono aggiungere le [[PartDesign Feature/it|funzioni]] con i metodi {{incode|addObject()}} o {{incode|addObjects()}} di questo Corpo.


{{Code|code=
{{Code|code=
Line 188: Line 252:


doc = App.newDocument()
doc = App.newDocument()
obj = App.ActiveDocument.addObject('PartDesign::Body', 'Body')
obj = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj.Label = "Custom label"
obj.Label = "Custom label"


feature = App.ActiveDocument.addObject('PartDesign::AdditiveBox', 'Box')
feat1 = App.ActiveDocument.addObject("PartDesign::AdditiveBox", "Box")
feat2 = App.ActiveDocument.addObject("PartDesign::AdditiveCylinder", "Cylinder")
obj.addObject(feature)

obj.addObjects([feat1, feat2])
App.ActiveDocument.recompute()
App.ActiveDocument.recompute()
}}
}}


The active Body can be set using the {{incode|setActiveObject}} method of the {{incode|ActiveView}}. The first argument is the fixed string {{incode|'pdbody'}}, and the second argument is the Body object itself.
In a document that has many Bodies, the [[PartDesign_Body#Active_status|active Body]] can be set using the {{incode|setActiveObject}} method of the {{incode|ActiveView}}. The first argument is the fixed string {{incode|"pdbody"}}, and the second argument is the Body object that should be made active.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
import FreeCADGui as Gui
import FreeCADGui as Gui
App.newDocument()
obj = App.ActiveDocument.addObject('PartDesign::Body', 'Body')


doc = App.newDocument()
Gui.ActiveDocument.ActiveView.setActiveObject('pdbody', obj)
obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("PartDesign::Body", "Body")

Gui.ActiveDocument.ActiveView.setActiveObject("pdbody", obj1)
App.ActiveDocument.recompute()
}}
}}


<div class="mw-translate-fuzzy">
{{Docnav/it|[[Std Group/it|Gruppo]]|[[PartDesign_NewSketch/it|Creare uno schizzo]]|[[PartDesign_Workbench/it|PartDesign]]|IconL=Group.svg|IconC=Workbench_PartDesign.svg|IconR=PartDesign_NewSketch.png}}
{{Docnav/it|[[Std Group/it|Gruppo]]|[[PartDesign_NewSketch/it|Creare uno schizzo]]|[[PartDesign_Workbench/it|PartDesign]]|IconL=Group.svg|IconC=Workbench_PartDesign.svg|IconR=PartDesign_NewSketch.svg}}
</div>


{{PartDesign Tools navi/it}}


{{PartDesign Tools navi{{#translation:}}}}
{{Userdocnavi/it}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 13:01, 6 January 2024

Corpo

Posizione nel menu
Part Design → Crea un corpo
Ambiente
PartDesign
Avvio veloce
Nessuno
Introdotto nella versione
0.17
Vedere anche
Parte standard, Editazione delle funzioni

Descrizione

Un Corpo di PartDesign è l'elemento base per creare forme solide con PartDesign. Può contenere schizzi, oggetti di riferimento e funzioni di PartDesign che aiutano a produrre un singolo solido contiguo.

Il Corpo fornisce un oggetto Origin che include gli assi X,Y,Z, e i piani standard. Questi elementi possono essere usati come riferimenti per collegare gli schizzi e gli oggetti primitivi.

Poiché si suppone che il Corpo sia un singolo solido contiguo, esso può essere spostato interamente come un'unità, senza spostare le singole funzioni. All'interno di una Parte standard è possibile posizionare più corpi per creare assiemi.

A sinistra: la vista ad albero che mostra le funzioni che producono in sequenza la forma finale dell'oggetto. A destra: l'oggetto finale visibile nella vista 3D.

Utilizzo

Se non è stato selezionato alcun solido precedente:

  1. Premere il pulsante Corpo. Viene creato un corpo vuoto che diventa automaticamente attivo.
  2. Ora si può premere Nuovo schizzo per creare uno schizzo nel corpo. In seguito lo schizzo può essere utilizzato per creare una Estrusione.
  3. In alternativa, si può aggiungere una funzione di PartDesign primitiva, ad esempio un Cubo additivo.

Se viene selezionato un oggetto solido:

  1. Premere il pulsante Corpo. Viene creato un nuovo Corpo contenente una singola Base Feature. Questo elemento Base Feature è un semplice riferimento a un altro oggetto precedentemente creato o importato nel documento. Per maggiori informazioni vedere Funzione di base. Non è possibile selezionare un Corpo esistente o una funzione di PartDesign quando si preme Corpo.

Note

  • Se, quando si preme il pulsante Nuovo schizzo della barra degli strumenti di PartDesign non esiste ancora un corpo, ne viene creato automaticamente uno nuovo. Se esiste già un corpo, esso deve essere reso attivo prima di usare Nuovo schizzo.
  • Fare doppio clic su Corpo nella vista ad albero o aprire il menu di scelta rapida (clic con il tasto destro) e selezionare Attiva corpo per attivare o disattivare il corpo. Se un altro corpo è attivo, esso viene disattivato. Per maggiori informazioni vedere Stato attivo.

Proprietà

Un Corpo di PartDesign (classe PartDesign::Body) è derivato da una Part Feature (classe Part::Feature), pertanto condivide tutte le proprietà di quest'ultimo.

Oltre alle proprietà descritte in Part Feature, il corpo di PartDesign ha le seguenti proprietà nell'editor delle proprietà.

Dati

Base

  • DatiTip (Link): è la funzione di PartDesign definita come "funzione finale", che è in genere l'ultima funzione creata nel corpo. La funzione finale indica la forma finale del corpo, che viene mostrata nella Vista 3D quando VistaDisplay Mode Body è impostata su Tip. Per maggiori informazioni vedere Tip.
  • DatiBase Feature (Link): è una forma esterna usata come prima funzione di PartDesign nel Corpo. Di solito viene impostata quando si trascina un oggetto solido in un corpo vuoto. Se non viene importato nessun solido in questo modo, questa proprietà rimane vuota. Per maggiori informazioni vedere Funzione di base.
  • DatiPlacement: la posizione dell'oggetto nella Vista 3D. Il posizionamento è definito da un punto Base (vettore) e una Rotation (asse e angolo). Vedere Posizionamento.
  • DatiGroup: un elenco di funzioni di PartDesign nel Corpo

Proprietà dati nascoste

  • DatiOrigin (Link): l'oggetto App Origin che è il riferimento posizionale per tutti gli elementi elencati nel DatiGruppo.
  • Dati_ Group Touched (Bool): se il gruppo viene toccato o no.

Oltre ale proprietà nascoste descritte in Part Feature il corpo di PartDesign ha le seguenti proprietà nell'editor delle proprietà.

Vista

Base

  • VistaDisplay Mode Body (Enumeration): imposta la modalità di visualizzazione nella vista 3D specifica per il corpo in uno dei due tipi.
    • Through (default) espone tutti gli oggetti all'interno del Corpo, ovvero schizzi, funzioni di PartDesign, oggetti di riferimento, ecc. Questa modalità consente di visualizzare le operazioni parziali eseguite all'interno del Corpo, quindi è la modalità raccomandata durante l'aggiunta e la modifica di funzioni. Selezionare la funzione desiderata e impostare VistaVisibility su true o premere la barra Spazio sulla tastiera.
    • Tip espone solo la forma finale del corpo, definita dalla proprietà DatiTip. Tutto il resto, tra cui schizzi, funzioni di PartDesign, oggetti di riferimento, ecc., non viene visualizzato, anche se sono visibili nella vista ad albero. Questa modalità è consigliata quando non è necessario modificare ulteriormente il corpo, quindi viene visualizzata una forma finale. Questa modalità è consigliata anche quando si desidera selezionare gli elementi secondari (vertici, bordi e facce) della forma finale da utilizzare con gli strumenti di altri ambienti da lavoro.

Concetto di Corpo

Singolo solido contiguo

Il corpo PartDesign è progettato per modellare un singolo solido contiguo. Per "contiguo" si intende un elemento realizzato in un unico pezzo, senza parti mobili o solidi disconnessi. Esempi di solidi contigui sono quelli fabbricati da un singolo pezzo di materia prima mediante un processo di fusione, taglio o fresatura. Ad esempio, un dado, una rondella e un bullone sono costituiti ciascuno da un unico pezzo di acciaio solido senza parti mobili, quindi ciascuno di essi può essere modellato come un corpo PartDesign. Gli oggetti creati saldando due pezzi possono anche essere modellati in un singolo corpo, purché il giunto di saldatura non sia destinato a rompersi.

Quando questi solidi contigui vengono riuniti in un qualche tipo di disposizione, diventano un "assemblaggio". In un assemblaggio, gli oggetti non vengono fusi insieme, ma vengono semplicemente "impilati" o posizionati uno accanto all'altro e rimangono singole parti.

A sinistra: tre solidi contigui individuali, ciascuno modellato in un Corpo di PartDesign. A destra: i singoli Corpi riuniti in un'assemblaggio.

Editazione delle funzioni

Un corpo di PartDesign è progettato per funzionare creando un solido iniziale, da uno schizzo o da una forma primitiva, e quindi modificandolo tramite le "funzioni" per aggiungere o rimuovere materiale dalla forma precedente. Per una spiegazione completa, vedere la pagina editazione delle funzioni.

Un corpo di PartDesign esegue una fusione (unione) automatica degli elementi solidi al suo interno. Ciò significa che (1) i solidi parziali devono toccarsi quando vengono creati e (2) che i solidi disconnessi non sono consentiti.

A sinistra: due singoli solidi che si intersecano. A destra: un singolo corpo di PartDesign creato con due funzioni additive, che vengono automaticamente fuse insieme, quindi invece di intersecarsi, formano un singolo solido contiguo.

A sinistra: due solidi disconnessi; questo non è un corpo PartDesign valido. A destra: due solidi che si toccano; ciò si traduce in un corpo PartDesign valido. La funzione più recente deve sempre contattare o intersecare la funzione precedente in modo che sia fusa con essa e diventi un singolo solido contiguo.

Nota: altri programmi CAD come Catia consentono solidi non contigui nello stesso "Corpo". A partire dalla versione 0.19, FreeCAD non lo consente. Ci sono state delle discussioni nel forum di FreeCAD sulla revoca di questa restrizione, ma non è stata presa alcuna decisione concreta. Se desiderate saperne di più o presentare punti di vista diversi, potete discuterne nel forum.

Spiegazione dettagliata delle proprietà

Stato attivo

Un documento aperto può contenere più corpi. Per aggiungere una nuova funzione a un corpo specifico, è necessario renderlo attivo. Un corpo attivo vinene visualizzato nella vista ad albero con il colore di sfondo specificato dal valore Active container nell'editor delle preferenze (per impostazione predefinita, blu). Un corpo attivo viene anche mostrato in grassetto.

Per attivare o disattivare un corpo:

  • Fare doppio clic su di esso nella vista ad albero, oppure
  • Aprire il menu contestuale (tasto destro) e selezionare Attiva/disattiva il corpo.

L'attivazione di un corpo commuta automaticamente anche l'interfaccia nell'ambiente PartDesign, se questo non era già l'ambiente attivo. Può essere attivo solo un singolo corpo per volta.

Documento con due corpi PartDesign, di cui il secondo è attivo.

Origine

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches and other objects can be attached to these elements when creating them.

  1. Create the Body.
  2. If the Body is selected in the tree view, press New sketch; the task panel will open to allow selecting one of the planes.
  3. If the Body is not selected, select the Origin instead and make it visible in the 3D view by pressing the Space bar in the keyboard. Also expand the Origin object to see the axes and planes.
  4. Select one of the planes, either in the tree view or in the 3D view, then press New sketch. The sketch will be created on the chosen plane.

The same process can be used when creating auxiliary datum geometry like PartDesign Lines, PartDesign Planes, and PartDesign CoordinateSystems.

Note: the Origin is an App Origin object (App::Origin class), while the axes and planes are objects of type App::Line and App::Plane respectively. Each of these elements can be hidden and unhidden individually with the Space bar; this is useful to choose the correct reference when creating other objects.

Note 2: all elements inside the Body are referenced to the Body's Origin which means that the Body can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.

Left: PartDesign Body Origin in the tree view. Right: representation of the Origin elements in the 3D view.

Funzione di base

La Funzione di base, Base feature, è la prima Funzione PartDesign creata nel corpo quando il corpo si basa su un'altra forma solida. Questo solido può essere creato in qualsiasi ambiente di lavoro o importato da un file esterno, ad esempio un file STEP.

Two PartDesign Bodies, each with a single Base Feature taken from a previously created solid.

To create the Base Feature:

  1. select a solid shape external to any Body, and
  2. press Body; this will create a new Body with a single Base Feature.

Note: you can't select an existing Body, or any of its features, when pressing Body.

If you already have a Body, you can create the Base Feature in this way:

  • in the tree view, pick an object, and drag and drop it inside the Body, or
  • in the property editor, edit the value of DatiBase Feature by pressing the ellipsis ..., and choosing an object from the list. In this case you can choose an existing Body to be the Base Feature.

Note: dragging and dropping only works for Bodies which don't have a Base Feature already.

Note 2: if the Body already has several features, when you drag and drop the external solid, the Base Feature will be created at the beginning of the list of features, that is, it will be added to the beginning of the DatiGroup property.

The Base Feature is entirely optional; it is only present when including an object from outside the Body. If no external solid is included, you can still build your shape using sketches, pads, primitive objects, and other PartDesign Features. In this case the DatiBase Feature property remains empty.

Left: PartDesign Body with a Base Feature that is taken from an external solid object, and many subsequent PartDesign Features on top. Right: Body which doesn't have an explicit Base Feature.

Note: If another PartDesign body is selected as a BaseFeature it must have a shape. If it is empty (no features, no BaseFeature, ...) this will result in error.

Tip

La cima o punta (Tip) è la PartDesign Feature del corpo che viene esposta all'esterno (quello che si vede). Viene automaticamente impostata sull'ultima funzione nella parte inferiore dell'albero; vale a dire che, se un altro strumento da qualsiasi ambiente di lavoro (ad esempio, Copia semplice o Sottrai di Part) deve utilizzare la forma del corpo, utilizzerà la forma della Punta. Detto in altro modo, la Punta è la rappresentazione finale del Corpo come se la storia parametrica non esistesse.

Left: PartDesign Body with full parametric history including intermediate features. Right: the Tip is the final shape that can be exported from the Body, while omitting the model's history.

The Tip is automatically set to the last feature created in the Body. Nevertheless, it can also be set to any of the intermediate features by opening the tree view context menu (right-click) and choosing Set tip, or by changing the Body's DatiTip value in the property editor.

Changing the Tip in effect rolls back its history, making it possible to add features that should have been added earlier. It also exposes a different shape to external tools.

Nella vista ad albero, la funzione finale del corpo è riconoscibile dalla funzione di PartDesign che ha una icona sovrapposta costituita da una freccia bianca all'interno di un cerchio verde.

Two PartDesign Bodies, each of them with PartDesign Features. The Tip is the last feature in them, and is marked with an overlay symbol.

Interazione con gli altri ambienti di lavoro

Per impostazione predefinita, le funzioni all'interno di un corpo sono selezionabili, e ovviamente ciò è necessario per poter modificare e aggiungere delle funzioni in PartDesign. Tuttavia, non è consigliabile selezionare le singole funzioni per utilizzarle con gli strumenti di altri ambienti di lavoro, come Part e Draft, poiché i risultati potrebbero essere inaspettati; in tal caso, nella vista rapporto potrebbe apparire un messaggio di errore, Links go out of the allowed scope.

Pertanto, per le interazioni con gli altri ambienti, dovrebbe essere selezionato solo il Corpo stesso dall'albero del modello. Nei casi in cui è necessario selezionare un sottoelemento specifico del Corpo (vertice, bordo, faccia), allora la proprietà vista VistaDisplay Mode Body del Corpo può essere modificata da Through (impostazione predefinita) a Tip. Questa proprietà è accessibile dal pannello Vista. In modalità Tip l'accesso agli oggetti sottostanti al Corpo (funzioni, riferimenti, schizzi) è disabilitato; nella vista 3D viene nascosto tutto tranne la funzione tip, indipendentemente da quale oggetto è impostato come visibile.

Una volta completate le operazioni in altri ambienti, non dimenticare di ripristinare la proprietà VistaDisplay Mode Body in Through per essere di nuovo in grado di modificare il corpo.

Left: when "Display Mode Body" is set to Through it is possible to select and perform operations with the individual PartDesign Features; in general, this is not recommended. Right: when "Display Mode Body" is set to Tip all selections and operations done on the Body will be done on the Tip, making sure only the final shape of the Body is exposed.

Gestione della visibilità

La visibilità del corpo prevale sulla visibilità di qualsiasi oggetto in esso contenuto. Se il corpo è nascosto, sono nascosti anche gli oggetti che esso contiene, anche se la loro proprietà VistaVisibility è impostata su true.

Multiple Sketches may be visible at one time, but only one PartDesign Feature (solid result) can be visible at a time. Selecting a hidden feature and pressing the Space bar in the keyboard will make it visible, and automatically hide the previously visible feature.

PartDesign Body: multiple Sketches may be visible simultaneously, but only one solid PartDesign Feature may be visible at one time, whether it is the Tip or not.

Attachment

PartDesign Features, just like planar objects, can be attached to different planes, usually the standard planes defined by the Body's Origin, or to custom PartDesign Planes.

Sketches are normally attached to a plane when they are created. In similar way, primitive features can also be attached. Attaching these objects to a plane allows them to be moved within the Body by changing their DatiAttachment Offset property. For more information on the attachment modes see Part EditAttachment.

A PartDesign Feature that is not attached will be shown with a red overlay symbol next to their icon in the tree view.

PartDesign Body: PartDesign Features that are not attached to a plane or coordinate system will be shown with an overlay symbol next to their icon in the tree view.

Inheritance

A PartDesign Body is formally an instance of the class PartDesign::Body, whose parent is Part Feature (Part::Feature class) through the intermediate Part::BodyBase class, and is augmented with an Origin extension.

Simplified diagram of the relationships between the core objects in the program. The PartDesign::Body object is intended to build parametric 3D solids, and thus is derived from the basic Part::Feature object, and has an Origin to control the placement of the features used inside of it.

Script

Vedere anche: Script di base per FreeCAD, e script di oggetti.

Vedere Part Feature per le informazioni generali sull'aggiunta di oggetti al documento.

Un corpo PartDesign viene creato con il metodo addObject() del documento. Quando esiste un Corpo, ad esso si possono aggiungere le funzioni con i metodi addObject() o addObjects() di questo Corpo.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj.Label = "Custom label"

feat1 = App.ActiveDocument.addObject("PartDesign::AdditiveBox", "Box")
feat2 = App.ActiveDocument.addObject("PartDesign::AdditiveCylinder", "Cylinder")

obj.addObjects([feat1, feat2])
App.ActiveDocument.recompute()

In a document that has many Bodies, the active Body can be set using the setActiveObject method of the ActiveView. The first argument is the fixed string "pdbody", and the second argument is the Body object that should be made active.

import FreeCAD as App
import FreeCADGui as Gui

doc = App.newDocument()
obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("PartDesign::Body", "Body")

Gui.ActiveDocument.ActiveView.setActiveObject("pdbody", obj1)
App.ActiveDocument.recompute()