PartDesign Body/tr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 26: Line 26:
</div>
</div>


The Body provides an {{MenuCommand|Origin}} object which includes local X, Y, and Z axes, and planes. These elements can be used as references to attach [[Sketch|sketches]] and [[PartDesign_CompPrimitiveAdditive|primitive objects]].
The Body provides an {{MenuCommand|Origin}} object which includes local X, Y, and Z axes, and standard planes. These elements can be used as references to attach [[Sketch|sketches]] and [[PartDesign_CompPrimitiveAdditive|primitive objects]].


Since the Body is supposed to be a [[PartDesign_Body#Single_contiguous_solid|single contiguous solid]], it can be moved entirely as a unit, without moving the individual features. Multiple bodies can be placed inside [[Std_Part|Std Parts]] in order to create assemblies.
Since the Body is supposed to be a [[PartDesign_Body#Single_contiguous_solid|single contiguous solid]], it can be moved entirely as a unit, without moving the individual features. Multiple bodies can be placed inside [[Std_Part|Std Parts]] in order to create assemblies.
Line 77: Line 77:


* {{PropertyView|Display Mode Body}}: sets the display mode specifically for the Body with one of two types.
* {{PropertyView|Display Mode Body}}: sets the display mode specifically for the Body with one of two types.
** {{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) exposes all objects inside the Body, that is, [[Sketch|sketches]], [[PartDesign Feature|PartDesign 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 the {{KEY|Space}} bar on the keyboard.
** {{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.
** {{incode|Tip}} exposes only the final shape of the Body, which is defined by the {{PropertyData|Tip}} property. Everything else, including [[Sketch|sketches]], [[PartDesign Feature|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.


== Full description ==
== Body concept ==


=== Single contiguous solid ===
=== Single contiguous solid ===


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 not intended to break apart.
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 steel 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 not intended to break apart.


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, and remain individual parts.
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, but they are simply "stacked" or placed next to each other, and remain individual parts.


[[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]]
Line 93: Line 93:
=== Feature editing ===
=== Feature editing ===


A PartDesign Body is intended to work by creating an initial solid, either from a [[Sketch|sketch]] or from a [[PartDesign_CompPrimitiveAdditive|primitive shape]], and then modifying it through [[PartDesign Feature|"features"]] that add or remove material from the previous shape. For a full explanation go to [[feature editing|feature editing]].
A PartDesign Body is intended to work by creating an initial solid, either from a [[Sketch|sketch]] or from a [[PartDesign_CompPrimitiveAdditive|primitive shape]], and then modifying it through [[PartDesign Feature|"features"]] to add or remove material from the previous shape. For a full explanation go to [[feature editing|feature editing]].


A PartDesign Body will perform an automatic fusion of the solid elements inside of it. This means that (1) partial solids should be touching when created, and (2) disconnected solids are not allowed.
A PartDesign Body will perform an automatic [[Part_Union|fusion]] (union) of the solid elements inside of it. This means that (1) partial solids should be touching when created, and (2) 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]]
Line 102: Line 102:
[[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|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.}}

== Detailed explanation of the properties ==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 113: Line 115:
* Double click on it on the [[tree view|tree view]], or
* Double click on it on the [[tree view|tree view]], or
* Open the context menu (right click) and select {{MenuCommand|Toggle active body}}.
* Open the context menu (right click) and select {{MenuCommand|Toggle active body}}.

[[File:PartDesign_Body_active.png]]


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Bir Cismi etkinleştirmek, aynı zamanda aktif çalışma tezgahı değilse, arayüzü otomatik olarak Parça tasarım tezgahına da geçirir.
Bir Cismi etkinleştirmek, aynı zamanda aktif çalışma tezgahı değilse, arayüzü otomatik olarak Parça tasarım tezgahına da geçirir.
</div>
</div>

[[File:PartDesign_Body_active.png]]

{{Caption|Document with two PartDesign Bodies, of which the second one is active.}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 128: Line 132:
# Create the Body.
# Create the Body.
# 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 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|lines]], [[PartDesign Plane|planes]], and [[PartDesign_CoordinateSystem|coordinate systems]].


{{Emphasis|Note:}} 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. 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, for example, [[Sketch|sketches]] and [[PartDesign Feature|PartDesign Features]].
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 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]].}}
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.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 148: Line 152:
The Base Feature is the first [[PartDesign Feature|PartDesign Feature]] in the Body when the Body is based on another solid shape. This solid can be created by any workbench, or imported from an external file, for example, a STEP file.
The Base Feature is the first [[PartDesign Feature|PartDesign Feature]] in the Body when the Body is based on another solid shape. This solid can be created by any workbench, or imported from an external file, for example, a STEP file.


[[File:PartDesign_Body_tree-03.png|none]]
[[File:PartDesign_Body_BaseFeature_tree.png]]
{{Caption|PartDesign Bodies, each of them with a single Base Feature, which are taken from previously created solids.}}


To create the Base Feature:
To create the Base Feature:
Line 164: Line 169:
{{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.
{{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 importing an object from outside the Body. If no external solid is imported, 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.
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]]
[[File:PartDesign_Body_BaseFeature_Tip.svg]]
Line 183: Line 188:
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]].
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, or exposing a different shape to external tools.
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">
Line 189: Line 194:
</div>
</div>


[[File:PartDesign_Body_tree-04.png]]
[[File:PartDesign_Body_Tip_tree.png]]
{{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.}}

<div class="mw-translate-fuzzy">
=== Görünürlük Yönetimi ===
Cismin görünürlüğü, içerdiği herhangi bir cismin görünürlüğünün yerini alır. Cisim gizliyse, görünürlükleri true olarak ayarlanmış olsa bile içerdiği nesneler de gizlenir. Bir seferde yalnızca bir özellik görünebilir. Gizli bir özellik seçmek ve boşluk çubuğuna basmak onu görünür hale getirecek ve daha önce görünen özelliği otomatik olarak gizleyecektir.
</div>

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.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 203: Line 202:
</div>
</div>


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.
By default, [[PartDesign Feature|PartDesign Features]] inside a Body are selectable, as this is required to edit and add more features with the [[PartDesign Workbench|PartDesign Workbench]] tools. Nevertheless, selecting the individual features to use them with tools from other workbenches, like [[Part Module|Part]] and [[Draft Module|Draft]], is not advised, as the results may be unexpected; in most cases, an error message saying that {{Emphasis|Links go out of the allowed scope}} will appear in the [[Report view|report view]].


<div class="mw-translate-fuzzy">
Bu nedenle, diğer tezgahlarla etkileşimler için, Model ağacından yalnızca Cismin kendisi seçilmelidir. Gövde üzerinde belirli bir topoloji seçmenin gerekli olduğu durumlarda (tepe, kenar, yüz), Cismin Görüntüleme Modu Gövde görünümü özelliği, Geçiş (varsayılan) ile Uç arasında değiştirilebilir . Bu özelliğe Görünüm panelinden erişilebilir. Gelen Öneri modunda Gövde altında nesnelere erişimi (özellikler, veriler, eskizler) devre dışıdır; İpucu özelliği dışındaki her şey, hangi nesne görünür olarak ayarlanmış olursa olsun 3D görünümde gizlenir.
Bu nedenle, diğer tezgahlarla etkileşimler için, Model ağacından yalnızca Cismin kendisi seçilmelidir. Gövde üzerinde belirli bir topoloji seçmenin gerekli olduğu durumlarda (tepe, kenar, yüz), Cismin Görüntüleme Modu Gövde görünümü özelliği, Geçiş (varsayılan) ile Uç arasında değiştirilebilir . Bu özelliğe Görünüm panelinden erişilebilir. Gelen Öneri modunda Gövde altında nesnelere erişimi (özellikler, veriler, eskizler) devre dışıdır; İpucu özelliği dışındaki her şey, hangi nesne görünür olarak ayarlanmış olursa olsun 3D görünümde gizlenir.
</div>


<div class="mw-translate-fuzzy">
Diğer tezgahlarda işlemler tamamlandıktan sonra, Cismi düzenleyebilmek için, '''Cismi görüntüle modu''' özelliğini sıfırlamayı unutmayın.
Diğer tezgahlarda işlemler tamamlandıktan sonra, Cismi düzenleyebilmek için, '''Cismi görüntüle modu''' özelliğini sıfırlamayı unutmayın.
</div>

[[File:PartDesign_Body_Tip_Display_mode.svg]]

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

<div class="mw-translate-fuzzy">
=== Görünürlük Yönetimi ===
Cismin görünürlüğü, içerdiği herhangi bir cismin görünürlüğünün yerini alır. Cisim gizliyse, görünürlükleri true olarak ayarlanmış olsa bile içerdiği nesneler de gizlenir. Bir seferde yalnızca bir özellik görünebilir. Gizli bir özellik seçmek ve boşluk çubuğuna basmak onu görünür hale getirecek ve daha önce görünen özelliği otomatik olarak gizleyecektir.
</div>

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 individual {{PropertyView|Visibility}} property is set to {{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 mechanism see [[Part_Attachment|Part Attachment]].

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 ===

Revision as of 09:39, 13 December 2019

Cisim Oluştur

Menü konumu
Parça tasarım → Cisim Oluştur
Tezgahlar
Parça tasarım
Varsayılan kısayol
Hiçbiri
Versiyonda tanıtıldı
-
Ayrıca bkz
Parça Oluştur

Tanım

Cisim Oluştur Eskizler, veriler ve parça tasarım ile ilgili bir dizi özellikleri içeren tek bir bitişik katı oluşturur. Özellikler tarafından referans olarak kullanılabilecek bir Orijin (standart düzlem ve eksenlerle) sağlar. Ayrıca, özel özellikleri taşımaya gerek kalmadan bir birim olarak serbestçe hareket ettirilebilir.

The Body provides an Origin object which includes local X, Y, and Z axes, and standard planes. These elements can be used as references to attach sketches and primitive objects.

Since the Body is supposed to be a single contiguous solid, it can be moved entirely as a unit, without moving the individual features. Multiple bodies can be placed inside Std Parts in order to create assemblies.

Left: the tree view showing the features that sequentially produce the final shape of the object. Right: the final object visible in the 3D view.

Nasıl kullanılır

If no previous solid is selected:

  1. Press the Body button. An empty Body is created and automatically becomes active.
  2. Now you can press New sketch to create a sketch in the Body that can be used with Pad.
  3. Alternatively, add a primitive PartDesign Feature, for example, Additive box.

If a solid object is selected:

  1. Press the Body button. A new Body is created containing a single Base Feature. This Base Feature element is a simple reference to another object previously created or imported into the document. See Base Feature for more information. An existing Body or PartDesign Feature cannot be selected when pressing Body.

Notes

  • If no Body currently exists when New sketch is pressed, a new Body will be automatically created. If a Body already exists, it has to be made active before using New sketch.
  • Double-click the Body in the tree view or open the context menu (right-click) and select Toggle active body to activate or deactivate the Body. If another Body is active, it will be deactivated. See active status for more information.

Özellikler

A PartDesign Body (PartDesign::Body class) is derived from a Part Feature (Part::Feature class), therefore it shares all the latter's properties.

In addition to the properties described in Part Feature, the PartDesign Body has the following properties in the property editor.

Data

Base

  • VeriTip: the PartDesign Feature defined as "Tip", which is usually the last feature created in the Body. The Tip indicates the final shape of the Body, which is shown in the 3D view when GörünümDisplay Mode Body is set to Tip. See Tip for more information.
  • VeriBase Feature: an external shape used as the first PartDesign Feature in the Body. It is usually set when dragging a solid object into an empty Body. If no solid is imported in this way, this property will be empty. See Base Feature for more information.
  • VeriGroup: a list with the PartDesign Features in the Body.
  • VeriPlacement: the position of the object in the 3D view. The placement is defined by a Base point (vector), and a Rotation (axis and angle). See Placement.

View

  • GörünümDisplay Mode Body: Ekranı iki mod arasında ayarlar:
    • Üzerinden (varsayılan), cismin içindeki her şey (özellikler, veriler, eskizler vb.) görünür. Cismin içine özellikler eklemek ve düzenlemek için kullanılan moddur.
    • Tip , ayarlanan tipe göre sadece vücudun şeklini gösterir; eskizler dahil diğer her şey görünümden gizlenir ve görüntülenemez. Pratik kullanım: "Tip", diğer tezgahlardan operasyonlar oluşturmak için cismin kenarlarının ve yüzlerinin seçimine izin verir.
  • VeriTip: Tip olarak tanımlanan özelliği görüntüler / ayarlar.
  • VeriBase Feature: Temel özellik olarak kullanılan harici şekli görüntüler/ayarlar. Bir Parça tasarım özelliği temel özellik ise geçerli değildir.
  • VeriPlacement: Cismin 3D uzayda yönünü ve konumunu belirtir. Yerleşim bölümüne bakınız.
  • VeriLabel:Etiket işleme verilen addır. Bu ad, istediğiniz zaman değiştirilebilir.
  • VeriGroup:Cismin içindeki referans verilen nesneleri listeler.
  • GörünümDisplay Mode Body: sets the display mode specifically for the Body with one of two types.
    • Through (default) exposes all objects inside the Body, that is, sketches, PartDesign 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 GörünümVisibility to true or press the Space bar on the keyboard.
    • Tip exposes only the final shape of the Body, which is defined by the VeriTip property. Everything else, including sketches, partial features, datums, etc., is not displayed, even if they are visible in the 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.

Body concept

Single contiguous solid

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 steel 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 not intended to break apart.

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, but they are simply "stacked" or placed next to each other, and remain individual parts.

Left: three individual contiguous solids, each of them modelled by a PartDesign Body. Right: the individual Bodies put together in an assembly.

Feature editing

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" to add or remove material from the previous shape. For a full explanation go to feature editing.

A PartDesign Body will perform an automatic fusion (union) of the solid elements inside of it. This means that (1) partial solids should be touching when created, and (2) disconnected solids are not allowed.

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.

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.

Detailed explanation of the properties

Aktif Durum

Bir FreeCAD belgesi birden fazla Cisim içerebilir. Bu nedenle, belirli bir Cisme yeni bir özellik eklemek için aktif hale getirilmesi gerekir. Aktif bir gövde, ağaç görünümünde açık mavi bir arka plan rengiyle gösterilecektir. V0.18'de, Model ağacındaki etiketi de koyu renkli olarak gösterilecektir.

An open document can contain multiple Bodies. To add a new feature to a specific Body, it needs to be made active. An active body will be displayed in the tree view with the background color specified by the Active container value in the preferences editor (by default, light blue). An active body will also be shown in bold text.

To activate or de-activate a Body:

  • Double click on it on the tree view, or
  • Open the context menu (right click) and select Toggle active body.

Bir Cismi etkinleştirmek, aynı zamanda aktif çalışma tezgahı değilse, arayüzü otomatik olarak Parça tasarım tezgahına da geçirir.

Document with two PartDesign Bodies, of which the second one is active.

Orijin

Orijin, üç standart eksenden (X, Y, Z) ve üç standart düzlemden (XY, XZ ve YZ) oluşur. Eskizler bu düzlemlere eklenebilir. Parça içindeki tüm unsurlar Parça'nın orijini ile ilişkilendirilir; bu, Parçanın, içerisindeki öğelerin yerleşimini etkilemeden, küresel koordinat sistemine göre hareket ettirilebileceği ve döndürülebileceği anlamına gelir.

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 lines, planes, and coordinate systems.

Note: the Origin is an object of class App::Origin, 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, for example, sketches and PartDesign Features.

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 elements inside.

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

Temel Özellik

Temel özellik, tanım gereği Cisim'de oluşturulan ilk Parça tasarım özelliğidir. Ancak, eski tezgahların ve diğer özelliklerin eklenebileceği bir temel özellik olarak, diğer tezgahlarda içe eklenen veya modellenen katı bir şekil kullanmak mümkündür.

The Base Feature is the first PartDesign Feature in the Body when the Body is based on another solid shape. This solid can be created by any workbench, or imported from an external file, for example, a STEP file.

PartDesign Bodies, each of them with a single Base Feature, which are taken from previously created solids.

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 VeriBase 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 VeriGroup 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 VeriBase 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.

İpucu

İpucu, Cismin dışında kalan özelliktir. Ağacın altındaki son özelliğe otomatik olarak ayarlanır. Ancak bazen, Cisim ağacında daha önceki bir özelliğe geçmek için yararlı olabilir; o zaman daha önce eklenmiş olması gereken özellikleri eklemek mümkündür. Cisim ağacında, ipucu için ayarlanan özellik, içinde beyaz bir aşağı ok bulunan yeşil bir nokta görüntüler.

The Tip is the PartDesign Feature that is exposed outside the Body; that is, if another tool from any workbench (for example, Part SimpleCopy or Part Cut) needs to use the shape of the Body, it will use the shape of the Tip. Said in another way, the Tip is the final representation of the Body as if the parametric history didn't exist.

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 VeriTip 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.

Daha fazla detay için İpucu Taşı sayfasına bakınız.

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

Diğer tezgahlarla etkileşim

Varsayılan olarak, bir Cisim altındaki nesneler seçilebilir ve bu elbette Parça tasarım'daki özellikleri düzenlemek ve eklemek için gereklidir. Ancak , sonuçlar beklenmedik olabileceğinden, diğer tezgahlardan (Parça veya Taslak gibi) işlemler oluşturmak için bir Cismin özelliklerini seçmek önerilmez; Her durumda, "Bağlantılar izin verilen kapsam dışına çıkıldı", şeklinde bir hata Rapor görünümünde görünecektir.

By default, PartDesign Features inside a Body are selectable, as this is required to edit and add more features with the PartDesign Workbench tools. Nevertheless, selecting the individual features to use them with tools from other workbenches, like Part and Draft, is not advised, as the results may be unexpected; in most cases, an error message saying that Links go out of the allowed scope will appear in the report view.

Bu nedenle, diğer tezgahlarla etkileşimler için, Model ağacından yalnızca Cismin kendisi seçilmelidir. Gövde üzerinde belirli bir topoloji seçmenin gerekli olduğu durumlarda (tepe, kenar, yüz), Cismin Görüntüleme Modu Gövde görünümü özelliği, Geçiş (varsayılan) ile Uç arasında değiştirilebilir . Bu özelliğe Görünüm panelinden erişilebilir. Gelen Öneri modunda Gövde altında nesnelere erişimi (özellikler, veriler, eskizler) devre dışıdır; İpucu özelliği dışındaki her şey, hangi nesne görünür olarak ayarlanmış olursa olsun 3D görünümde gizlenir.

Diğer tezgahlarda işlemler tamamlandıktan sonra, Cismi düzenleyebilmek için, Cismi görüntüle modu özelliğini sıfırlamayı unutmayın.

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.

Görünürlük Yönetimi

Cismin görünürlüğü, içerdiği herhangi bir cismin görünürlüğünün yerini alır. Cisim gizliyse, görünürlükleri true olarak ayarlanmış olsa bile içerdiği nesneler de gizlenir. Bir seferde yalnızca bir özellik görünebilir. Gizli bir özellik seçmek ve boşluk çubuğuna basmak onu görünür hale getirecek ve daha önce görünen özelliği otomatik olarak gizleyecektir.

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 individual GörünümVisibility property is set to 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 VeriAttachment Offset property. For more information on the attachment mechanism see Part Attachment.

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

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.

Scripting

See also: FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information.

A PartDesign Body is created with the addObject() method of the document. Once a body exists, features, like additive and subtractive primitives, can be added and attached to that body.

import FreeCAD as App

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

feature = App.ActiveDocument.addObject('PartDesign::AdditiveBox', 'Box')
obj.addObject(feature)
App.ActiveDocument.recompute()

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 itself.

import FreeCAD as App
import FreeCADGui as Gui
App.newDocument()
obj = App.ActiveDocument.addObject('PartDesign::Body', 'Body')

Gui.ActiveDocument.ActiveView.setActiveObject('pdbody', obj)