Shape: Difference between revisions
(→Introduction: which have a MeshObject (Mesh::MeshObject class).) |
(Marked this version for translation) |
||
(12 intermediate revisions by 5 users not shown) | |||
Line 2: | Line 2: | ||
<translate> |
<translate> |
||
== Introduction == |
== Introduction == <!--T:1--> |
||
<!--T:2--> |
|||
In FreeCAD the word "[[Shape|Shape]]" is normally used to refer to a [[Part_TopoShape|Part TopoShape]] ({{incode|Part::TopoShape}} class), a type of object that gives an element its 3D geometrical and parametric representation (cube, pyramid, sphere, cylinder, fusion, etc.). |
In FreeCAD the word "[[Shape|Shape]]" is normally used to refer to a [[Part_TopoShape|Part TopoShape]] ({{incode|Part::TopoShape}} class), a type of object that gives an element its 3D geometrical and parametric representation (cube, pyramid, sphere, cylinder, fusion, etc.). |
||
<!--T:3--> |
|||
Essentially all objects that are displayed in the [[3D view|3D view]] have a [[Part_TopoShape|TopoShape]], with the exception of "[[Mesh|Meshes]]", which have a [[Mesh_MeshObject|MeshObject]] ({{incode|Mesh::MeshObject}} class). |
Essentially all objects that are displayed in the [[3D view|3D view]] have a [[Part_TopoShape|TopoShape]], with the exception of "[[Mesh|Meshes]]", which have a [[Mesh_MeshObject|MeshObject]] ({{incode|Mesh::MeshObject}} class). |
||
<!--T:4--> |
|||
See [[Part_TopoShape|Part TopoShape]] for more information about this type of object. |
See [[Part_TopoShape|Part TopoShape]] for more information about this type of object. |
||
<!--T:13--> |
|||
== How to use == |
|||
[[File:Shape_and_mesh.svg]] |
|||
<!--T:14--> |
|||
⚫ | |||
{{Caption|Left: parametric [[Shape|shape]] defined by properties. Right: [[Mesh|mesh]], defined by vertices and triangular surfaces.}} |
|||
==Usage== <!--T:5--> |
|||
<!--T:6--> |
|||
⚫ | |||
<!--T:7--> |
|||
Once a Shape is created, it can be used and modified by all [[Workbenches|workbenches]] by creating [[scripted objects|scripted objects]] around that Shape. |
Once a Shape is created, it can be used and modified by all [[Workbenches|workbenches]] by creating [[scripted objects|scripted objects]] around that Shape. |
||
<!--T:8--> |
|||
Essentially, every object derived from a [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class) is expected to hold and manipulate a Shape. |
Essentially, every object derived from a [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class) is expected to hold and manipulate a Shape. |
||
<!--T:15--> |
|||
⚫ | |||
Any OpenCascade Shape has a tesselation mainly to view the Shape on screen. More information about this can be found in this German [https://forum.freecad.org/viewtopic.php?t=77521&start=10#p674947 forum post] and in the [https://dev.opencascade.org/doc/overview/html/occt_user_guides__mesh.html OpenCascad Mesh documentation]. |
|||
⚫ | |||
<!--T:10--> |
|||
In informal usage, a "Shape" may be any geometrical figure that is visible in the [[3D view|3D view]], and thus its concept may be confused with that of "[[Body|Body]]" or "[[Part|Part]]". |
In informal usage, a "Shape" may be any geometrical figure that is visible in the [[3D view|3D view]], and thus its concept may be confused with that of "[[Body|Body]]" or "[[Part|Part]]". |
||
<!--T:11--> |
|||
However, when more precision is required, the distinction must be made. |
However, when more precision is required, the distinction must be made. |
||
* A "[[Body|Body]]" is an object derived from a [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class), |
* A "[[Body|Body]]" is an object derived from a [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class), created with the [[PartDesign_Workbench|PartDesign Workbench]]. |
||
* A "Shape" is an internal object, embedded within the "[[Body|Body]]". |
* A "Shape" is an internal object, embedded within the "[[Body|Body]]". |
||
* A "[[Part|Part]]" is used to group several "[[Body|Bodies]]" to form an assembly. A "Part" has a collection of "Shapes", but doesn't have a "Shape" of its own. |
* A "[[Part|Part]]" is used to group several "[[Body|Bodies]]" to form an [[assembly|assembly]]. A "Part" has a collection of "Shapes", but doesn't have a "Shape" of its own. |
||
⚫ | |||
⚫ | |||
</translate> |
</translate> |
||
⚫ | |||
{{Document objects navi{{#translation:}}}} |
|||
⚫ | |||
[[Category:Glossary{{#translation:}}]] |
Latest revision as of 19:17, 21 April 2023
Introduction
In FreeCAD the word "Shape" is normally used to refer to a Part TopoShape (Part::TopoShape
class), a type of object that gives an element its 3D geometrical and parametric representation (cube, pyramid, sphere, cylinder, fusion, etc.).
Essentially all objects that are displayed in the 3D view have a TopoShape, with the exception of "Meshes", which have a MeshObject (Mesh::MeshObject
class).
See Part TopoShape for more information about this type of object.
Left: parametric shape defined by properties. Right: mesh, defined by vertices and triangular surfaces.
Usage
Shapes are normally created by internal functions of the Part Workbench, and are ultimately defined by the OpenCASCADE Technology kernel (OCCT).
Once a Shape is created, it can be used and modified by all workbenches by creating scripted objects around that Shape.
Essentially, every object derived from a Part Feature (Part::Feature
class) is expected to hold and manipulate a Shape.
Any OpenCascade Shape has a tesselation mainly to view the Shape on screen. More information about this can be found in this German forum post and in the OpenCascad Mesh documentation.
Notes
In informal usage, a "Shape" may be any geometrical figure that is visible in the 3D view, and thus its concept may be confused with that of "Body" or "Part".
However, when more precision is required, the distinction must be made.
- A "Body" is an object derived from a Part Feature (
Part::Feature
class), created with the PartDesign Workbench. - A "Shape" is an internal object, embedded within the "Body".
- A "Part" is used to group several "Bodies" to form an assembly. A "Part" has a collection of "Shapes", but doesn't have a "Shape" of its own.
- Primitives: Box, Cylinder, Sphere, Cone, Torus, Tube, Create primitives, Shape builder
- Creation and modification: Extrude, Revolve, Mirror, Fillet, Chamfer, Make face from wires, Ruled Surface, Loft, Sweep, Section, Cross sections, 3D Offset, 2D Offset, Thickness, Projection on surface, Attachment
- Boolean: Make compound, Explode Compound, Compound Filter, Boolean, Cut, Fuse, Common, Connect, Embed, Cutout, Boolean fragments, Slice apart, Slice, XOR
- Measure: Measure Linear, Measure Angular, Measure Refresh, Clear All, Toggle All, Toggle 3D, Toggle Delta
- Core: App DocumentObject
- Basic: App FeaturePython, App GeoFeature, Part Feature, Mesh Feature, Fem FemMeshObject
- Internal shapes: Part TopoShape, Mesh MeshObject, Fem FemMesh
- Structure: App DocumentObjectGroup (Std Group), App Part (Std Part), App Link (Std LinkMake)
- Derived: Part Part2DObject, Sketcher SketchObject, PartDesign Body, PartDesign Feature
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub