Difference between revisions of "Part Module/cs"

From FreeCAD Documentation
Jump to navigation Jump to search
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(22 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<languages/>
 
<languages/>
{{docnav|[[OpenSCAD Module|OpenSCAD Module]]|[[PartDesign Workbench|PartDesign Workbench]]|IconL=OpenSCADWorkbench.svg|IconR=Workbench_PartDesign.svg}}
+
{{Docnav
 
+
|[[OpenSCAD Module|OpenSCAD Module]]
[[Image:Workbench_Part.svg|64px]]
+
|[[PartDesign Workbench|PartDesign Workbench]]
 +
|IconL=Workbench_OpenSCAD.svg
 +
|IconR=Workbench_PartDesign.svg
 +
}}
  
 +
[[Image:Workbench_Part.svg|thumb|128px|Part workbench icon]]
 +
{{TOCright}}
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
 
CAD možnosti FreeCADu jsou založeny na jádře [http://en.wikipedia.org/wiki/Open_CASCADE OpenCasCade]. Modul Díl umožňuje FreeCADu přístup a používání objektů a funkcí OpenCasCade. OpenCascade je profesionální CAD jádro, jehož vlastnosti umožňují pokročilou manipulaci s 3D konstrukcemi a objekty. Objekty Díl, narozdíl od objektů [[Mesh Module/cs|Modulu Síť]], jsou mnohem komplexnější a proto umožňují mnohem dokonalejší operace, jako jsou logické boolean operace, modifikace historie a parametrické chování.
 
CAD možnosti FreeCADu jsou založeny na jádře [http://en.wikipedia.org/wiki/Open_CASCADE OpenCasCade]. Modul Díl umožňuje FreeCADu přístup a používání objektů a funkcí OpenCasCade. OpenCascade je profesionální CAD jádro, jehož vlastnosti umožňují pokročilou manipulaci s 3D konstrukcemi a objekty. Objekty Díl, narozdíl od objektů [[Mesh Module/cs|Modulu Síť]], jsou mnohem komplexnější a proto umožňují mnohem dokonalejší operace, jako jsou logické boolean operace, modifikace historie a parametrické chování.
 
</div>
 
</div>
  
The objects created with the Part Workbench are relatively simple; they are intended to be used with boolean operations (unions and cuts) in order to build more complex shapes. This modelling paradigm is known as the [[constructive solid geometry]] (CSG) workflow, and it was the traditional methodology used in early CAD systems. On the other hand, the [[PartDesign Workbench|PartDesign Workbench]] provides a more modern workflow to constructing shapes: it uses a parametrically defined sketch, that is extruded to form a basic solid body, which is then modified by parametric transformations ([[feature editing|feature editing]]), until the final object is obtained.
+
The objects created with the Part Workbench are relatively simple; they are intended to be used with boolean operations (unions and cuts) in order to build more complex shapes. '''This modeling paradigm is known as the [[constructive solid geometry]] (CSG) workflow, and it was the traditional methodology used in early CAD systems.''' On the other hand, the [[PartDesign Workbench|PartDesign Workbench]] provides a more modern workflow to constructing shapes: it uses a parametrically defined sketch, that is extruded to form a basic solid body, which is then modified by parametric transformations ([[feature editing|feature editing]]), until the final object is obtained.
  
 
Part objects are more complex than mesh objects created with the [[Mesh Workbench|Mesh Workbench]], as they permit more advanced operations like coherent boolean operations, modifications history, and parametric behaviour.
 
Part objects are more complex than mesh objects created with the [[Mesh Workbench|Mesh Workbench]], as they permit more advanced operations like coherent boolean operations, modifications history, and parametric behaviour.
 
{{TOCright}}
 
[[Image:Part example.jpg]]
 
  
 
[[Image:Part_Workbench_relationships.svg|600px]]
 
[[Image:Part_Workbench_relationships.svg|600px]]
  
{{Caption|The Part Workbench is the basic layer that exposes the OCCT drawing functions to all workbenches in FreeCAD}}
+
{{Caption|The Part Workbench is the basic layer that exposes the OCCT drawing functions to all workbenches in FreeCAD.}}
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 31: Line 33:
 
These are tools for creating primitive objects.
 
These are tools for creating primitive objects.
  
* [[Image:Part_Box.png|32px]] [[Part_Box|Box]]: Draws a box by specifying its dimensions
+
* [[Image:Part_Box.svg|32px]] [[Part_Box|Box]]: Draws a box by specifying its dimensions
* [[Image:Part_Cylinder.png|32px]] [[Part_Cylinder|Cylinder]]: Draws a cylinder by specifying its dimensions
+
* [[Image:Part_Cylinder.svg|32px]] [[Part_Cylinder|Cylinder]]: Draws a cylinder by specifying its dimensions
* [[Image:Part_Sphere.png|32px]] [[Part_Sphere|Sphere]]: Draws a sphere by specifying its dimensions
+
* [[Image:Part_Sphere.svg|32px]] [[Part_Sphere|Sphere]]: Draws a sphere by specifying its dimensions
* [[Image:Part_Cone.png|32px]] [[Part_Cone|Cone]]: Draws a cone by specifying its dimensions
+
* [[Image:Part_Cone.svg|32px]] [[Part_Cone|Cone]]: Draws a cone by specifying its dimensions
* [[Image:Part_Torus.png|32px]] [[Part_Torus|Torus]]: Draws a torus (ring) by specifying its dimensions
+
* [[Image:Part_Torus.svg|32px]] [[Part_Torus|Torus]]: Draws a torus (ring) by specifying its dimensions
* [[Image:Part_CreatePrimitives.png|32px]] [[Part_CreatePrimitives|CreatePrimitives]]: A tool to create various parametric geometric primitives
+
* [[Image:Part_Primitives.svg|32px]] [[Part_Primitives|Primitives]]: A tool to add any of the defined geometric primitives.
* [[Image:Part_Shapebuilder.png|32px]] [[Part_Shapebuilder|Shapebuilder]]: A tool to create more complex shapes from various parametric geometric primitives
+
* [[Image:Part_Shapebuilder.svg|32px]] [[Part_Builder|Shapebuilder]]: A tool to create more complex shapes from various parametric geometric primitives
  
 
===Modifying objects===
 
===Modifying objects===
Line 43: Line 45:
 
These are tools for modifying existing objects. They will allow you to choose which object to modify.
 
These are tools for modifying existing objects. They will allow you to choose which object to modify.
  
* [[Image:Part_Extrude.png|32px]] [[Part_Extrude|Extrude]]: Extrudes planar faces of an object
+
* [[Image:Part_Extrude.svg|32px]] [[Part_Extrude|Extrude]]: Extrudes planar faces of an object
* [[Image:Part_Revolve.png|32px]] [[Part_Revolve|Revolve]]: Creates a solid by revolving another object (not solid) around an axis
+
* [[Image:Part_Revolve.svg|32px]] [[Part_Revolve|Revolve]]: Creates a solid by revolving another object (not solid) around an axis
* [[Image:Part_Mirror.png|32px]] [[Part_Mirror|Mirror]]: Mirrors the selected object on a given mirror plane
+
* [[Image:Part_Mirror.svg|32px]] [[Part_Mirror|Mirror]]: Mirrors the selected object on a given mirror plane
* [[Image:Part_Fillet.png|32px]] [[Part_Fillet|Fillet]]: Fillets (rounds) edges of an object
+
* [[Image:Part_Fillet.svg|32px]] [[Part_Fillet|Fillet]]: Fillets (rounds) edges of an object
* [[Image:Part_Chamfer.png|32px]] [[Part_Chamfer|Chamfer]]: Chamfers edges of an object
+
* [[Image:Part_Chamfer.svg|32px]] [[Part_Chamfer|Chamfer]]: Chamfers edges of an object
* [[Image:Part_RuledSurface.png|32px]] [[Part_RuledSurface|Ruled Surface]]:
+
* [[Image:Part_RuledSurface.svg|32px]] [[Part_RuledSurface|Ruled Surface]]:
* [[Image:Part_Loft.png|32px]] [[Part_Loft|Loft]]: Lofts from one profile to another
+
* [[Image:Part_Loft.svg|32px]] [[Part_Loft|Loft]]: Lofts from one profile to another
* [[Image:Part_Sweep.png|32px]] [[Part_Sweep|Sweep]]: Sweeps one or more profiles along a path
+
* [[Image:Part_Sweep.svg|32px]] [[Part_Sweep|Sweep]]: Sweeps one or more profiles along a path
  
 
* [[Image:Part_CompOffsetTools.png|48px]] [[Part_CompOffsetTools|Offset tools]]:
 
* [[Image:Part_CompOffsetTools.png|48px]] [[Part_CompOffsetTools|Offset tools]]:
** [[Image:Part_Offset.png|32px]] [[Part_Offset|3D Offset]]: Constructs a parallel shape at a certain distance from original.
+
** [[Image:Part_Offset.svg|32px]] [[Part_Offset|3D Offset]]: Constructs a parallel shape at a certain distance from original.
** [[Image:Part_Offset2D.png|32px]] [[Part_Offset2D|2D Offset]]: Constructs a parallel wire at certain distance from original, or enlarges/shrinks a planar face. {{Version|0.17}}
+
** [[Image:Part_Offset2D.svg|32px]] [[Part_Offset2D|2D Offset]]: Constructs a parallel wire at certain distance from original, or enlarges/shrinks a planar face. {{Version|0.17}}
  
* [[Image:Part_Thickness.png|32px]] [[Part_Thickness|Thickness]]: Hollows out a solid, leaving openings next to select faces.
+
* [[Image:Part_Thickness.svg|32px]] [[Part_Thickness|Thickness]]: Hollows out a solid, leaving openings next to select faces.
  
 
* [[Image:Part_ProjectionOnSurface.png|32px]] [[Part_ProjectionOnSurface|Projection on surface]]: Project a logo, text or any face,wire,edge to a surface. With the projection part it is possible to create a solid or wire. {{Version|0.19}}
 
* [[Image:Part_ProjectionOnSurface.png|32px]] [[Part_ProjectionOnSurface|Projection on surface]]: Project a logo, text or any face,wire,edge to a surface. With the projection part it is possible to create a solid or wire. {{Version|0.19}}
  
* [[Image:Part_CompCompoundTools.png|48px]] [[Part_CompCompoundTools|Compound Tools]]:
+
* [[Image:Part_Compound.svg|48px]] [[Part_CompCompoundTools|Compound Tools]]:
** [[Image:Part MakeCompound.png|32px]] [[Part MakeCompound|Make compound]]: Creates a compound from the selected objects.
+
** [[Image:Part_Compound.svg|32px]] [[Part_Compound|Make compound]]: Creates a compound from the selected objects.
 
** [[Image:Part_ExplodeCompound.svg|32px]] [[Part_ExplodeCompound|Explode Compound]]: Tool to split up compounds of shapes
 
** [[Image:Part_ExplodeCompound.svg|32px]] [[Part_ExplodeCompound|Explode Compound]]: Tool to split up compounds of shapes
** [[Image:Part Compound‏‎Filter.png|32px]] [[Part Compound‏‎Filter|Compound Filter]]: The CompoundFilter can be used to extract the individual pieces.
+
** [[Image:Part Compound‏‎Filter.svg|32px]] [[Part Compound‏‎Filter|Compound Filter]]: The CompoundFilter can be used to extract the individual pieces.
  
* [[Image:Part_Booleans.png|32px]] [[Part_Booleans|Booleans]]: Performs boolean operations on objects
+
* [[Image:Part_Booleans.svg|32px]] [[Part_Boolean|Boolean]]: Performs boolean operations on objects
* [[Image:Part_Union.png|32px]] [[Part_Union|Union]]: Fuses (unions) two objects
+
* [[Image:Part_Fuse.svg|32px]] [[Part_Union|Union]]: Fuses (unions) two objects
* [[Image:Part_Common.png|32px]] [[Part_Common|Common]]: Extracts the common (intersection) part of two objects
+
* [[Image:Part_Common.svg|32px]] [[Part_Common|Common]]: Extracts the common (intersection) part of two objects
* [[Image:Part_Cut.png|32px]] [[Part_Cut|Cut]]: Cuts (subtracts) one object from another
+
* [[Image:Part_Cut.svg|32px]] [[Part_Cut|Cut]]: Cuts (subtracts) one object from another
  
 
* [[Image:Part_CompJoinFeatures.png|48px]] [[Part CompJoinFeatures|Join features]]: smart booleans for walled objects (e.g., pipes) {{Version|0.16}}
 
* [[Image:Part_CompJoinFeatures.png|48px]] [[Part CompJoinFeatures|Join features]]: smart booleans for walled objects (e.g., pipes) {{Version|0.16}}
** [[Image:Part JoinConnect.png|32px]] [[Part_JoinConnect|Connect]]: Connects interiors of objects {{Version|0.16}}
+
** [[Image:Part_JoinConnect.svg|32px]] [[Part_JoinConnect|Connect]]: Connects interiors of objects {{Version|0.16}}
** [[Image:Part JoinEmbed.png|32px]] [[Part_JoinEmbed|Embed]]: Embeds a walled object into another walled object {{Version|0.16}}
+
** [[Image:Part_JoinEmbed.svg|32px]] [[Part_JoinEmbed|Embed]]: Embeds a walled object into another walled object {{Version|0.16}}
** [[Image:Part JoinCutout.png|32px]] [[Part_JoinCutout|Cutout]]: Creates a cutout in a wall of an object for another walled object {{Version|0.16}}
+
** [[Image:Part_JoinCutout.svg|32px]] [[Part_JoinCutout|Cutout]]: Creates a cutout in a wall of an object for another walled object {{Version|0.16}}
  
 
* [[Image:Part_CompSplittingTools.png|48px]] [[Part CompSplittingTools|Splitting tools]]: {{Version|0.17}}
 
* [[Image:Part_CompSplittingTools.png|48px]] [[Part CompSplittingTools|Splitting tools]]: {{Version|0.17}}
** [[Image:Part BooleanFragments.png|32px]] [[Part_BooleanFragments|Boolean fragments]]: makes all the pieces that can be obtained by Boolean operations between objects {{Version|0.17}}
+
** [[Image:Part_BooleanFragments.svg|32px]] [[Part_BooleanFragments|Boolean fragments]]: makes all the pieces that can be obtained by Boolean operations between objects {{Version|0.17}}
 
** [[Image:Part SliceApart.svg|32px]] [[Part_SliceApart|Slice a part]]: tool to split shapes by intersection with other shapes
 
** [[Image:Part SliceApart.svg|32px]] [[Part_SliceApart|Slice a part]]: tool to split shapes by intersection with other shapes
** [[Image:Part Slice.png|32px]] [[Part_Slice|Slice]]: Splits an object into pieces by intersections with another object {{Version|0.17}}
+
** [[Image:Part_Slice.svg|32px]] [[Part_Slice|Slice]]: Splits an object into pieces by intersections with another object {{Version|0.17}}
** [[Image:Part XOR.png|32px]] [[Part_XOR|XOR]]: removes space shared by even number of objects (symmetric version of [[Part_Cut|Cut]]) {{Version|0.17}}
+
** [[Image:Part_XOR.svg|32px]] [[Part_XOR|XOR]]: removes space shared by even number of objects (symmetric version of [[Part_Cut|Cut]]) {{Version|0.17}}
  
 
* [[Image:Part Defeaturing.svg|32px]] [[Part_Defeaturing|Defeaturing]]: {{Version|0.18}}
 
* [[Image:Part Defeaturing.svg|32px]] [[Part_Defeaturing|Defeaturing]]: {{Version|0.18}}
* [[Image:Part_Section.png|32px]] [[Part_Section|Section]]: Creates a section by intersecting an object with a section plane
+
* [[Image:Part_Section.svg|32px]] [[Part_Section|Section]]: Creates a section by intersecting an object with a section plane
* [[Image:Part_SectionCross.png|32px]] [[Part_SectionCross|Cross sections...]]:
+
* [[Image:Part_CrossSections.svg|32px]] [[Part_SectionCross|Cross sections...]]: Creates one or more cross-sections through a selected shape
 
* [[Image:Part Attachment.svg|32px]] [[Part Attachment|Attachment]]: attachment is a utility to attach an object to another one.
 
* [[Image:Part Attachment.svg|32px]] [[Part Attachment|Attachment]]: attachment is a utility to attach an object to another one.
  
Line 115: Line 117:
  
 
* [[Image:Part_CheckGeometry.svg|32px]] [[Part CheckGeometry|Check geometry]]: Checks the geometry of selected objects for errors.
 
* [[Image:Part_CheckGeometry.svg|32px]] [[Part CheckGeometry|Check geometry]]: Checks the geometry of selected objects for errors.
 +
 +
=== Contextual Menu items ===
 +
 +
*[[Std_SetAppearance|Appearance]]: determines appearance of the whole part (color transparency etc.).
 +
*[[Std SetColors|Set colors]]: assigns colors to part faces.
  
 
== Preferences ==
 
== Preferences ==
  
* [[Image:Preferences-import-export.svg|32px]] [[Import_Export_Preference|Preference ...]] Import Export
+
<!--The PartDesign preferences are defined in the Part workbench and both the PartDesign workbench and the Part workbench use them-->
 +
* [[Image:Preferences-part_design.svg|32px]] [[PartDesign_Preferences|Preferences]]: preferences available for Part Tools (the Part workbench also uses the PartDesign Preferences).
 +
* [[Image:Preferences-import-export.svg|32px]] [[Import_Export_Preferences|Import Export Preferences]]: preferences available for importing from and exporting to different file formats.
 +
* [[Fine-tuning]]: some extra parameters to fine-tune Part behavior.
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 136: Line 146:
 
</div>
 
</div>
  
 +
<blockquote style="color: slategray">''At a very high level, topology tells what pieces an object is made of, and the logical relationships between them. A shape is made of a certain set of faces. A face is bounded by a certain set of edges. Two faces are adjacent if they share a common edge.''</blockquote>
 +
 +
<blockquote style="color: slategray">''Topology alone does not tell you the size, curvature, or 3D locations of any of those pieces. However, each piece of topology does knows about it's underlying geometry. A face knows what surface it lies on. An edge knows what curve it lies on. The geometry knows about curvature and location in space.'' - [https://www.opencascade.com/content/geometry-and-topology Source]</blockquote>
 +
 +
<hr />
 +
 +
<blockquote style="color: slategray">''Thus, Topology defines the relationship between simple geometric entities, which can be linked together to represent complex shapes.'' - [https://www.opencascade.com/doc/occt-7.0.0/overview/html/occt_user_guides__modeling_data.html Modeling Data User's Guide]</blockquote>
 +
 +
[[File:ClassTopoDS_Shape_inherit_graph.png]]
 +
 +
<div class="mw-translate-fuzzy">
 
Geometrické typy mohou být rozděleny do dvou hlavních skupin: linky a povrchy. Nad linkami (přímka, kružnice,...) můžete přímo budovat hrany, na plochách (rovina, válec, ...) zase povrchy. Například základní přímka je nekonečná, tj. je definována základním vektorem a směrovým vektorem, zatímco jeho tvarová reprezentace musí být nějak omezena počátečním a koncovým bodem. A kvádr -- těleso -- může být vytvořeno šesti omezenými rovinami.
 
Geometrické typy mohou být rozděleny do dvou hlavních skupin: linky a povrchy. Nad linkami (přímka, kružnice,...) můžete přímo budovat hrany, na plochách (rovina, válec, ...) zase povrchy. Například základní přímka je nekonečná, tj. je definována základním vektorem a směrovým vektorem, zatímco jeho tvarová reprezentace musí být nějak omezena počátečním a koncovým bodem. A kvádr -- těleso -- může být vytvořeno šesti omezenými rovinami.
 +
</div>
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 142: Line 164:
 
</div>
 
</div>
  
 +
<div class="mw-translate-fuzzy">
 
Tudíž, z tvarů můžete stavět velmi komplexní díly nebo opačně odebírat všechny poddíly pro vytváření ještě komplexnějších dílů.
 
Tudíž, z tvarů můžete stavět velmi komplexní díly nebo opačně odebírat všechny poddíly pro vytváření ještě komplexnějších dílů.
 +
</div>
 +
 +
 +
Thus, out of shapes you can build very complex parts or, the other way round, extract all sub-shapes a more complex shape is made of.
 +
 +
[[File:Part_TopoShape_relationships.svg|600px]]
 +
 +
{{Caption|The {{incode|Part::TopoShape}} class is the geometrical object that is seen on screen. Essentially all workbenches use these [[Part_TopoShape|TopoShapes]] internally to build and display edges, faces, and solids.}}
  
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
Line 158: Line 189:
 
The most basic object that can be created is a [[Part Feature|Part Feature]], which has a simple {{PropertyData|Placement}} property, and basic properties to define its color and appearance.  
 
The most basic object that can be created is a [[Part Feature|Part Feature]], which has a simple {{PropertyData|Placement}} property, and basic properties to define its color and appearance.  
  
Another simple object used in 2D geometrical objects is [[Part Part2DObject|Part Part2DObject]], which is the base of [[Sketcher Workbench|Sketches]], and most [[Draft Workbench|Draft elements]].
+
Another simple object used in 2D geometrical objects is [[Part Part2DObject|Part Part2DObject]], which is the base of [[Sketcher_SketchObject|Sketcher SketchObject]] ([[Sketcher Workbench|Sketcher]]), and most [[Draft Workbench|Draft elements]].
 +
 
 +
=== Test script ===
 +
 
 +
Test the creation of [[Part_Primitives|Part Primitives]] with a script. {{Version|0.19}}
 +
 
 +
{{Code|code=
 +
import parttests.part_test_objects as pto
 +
pto.create_test_file("example_file")
 +
}}
 +
 
 +
This script is located in the installation directory of the program, and can be examined to see how the basic primitives are built.
 +
{{Code|code=
 +
$INSTALL_DIR/Mod/Part/parttests/part_test_objects.py
 +
}}
  
 
=== Příklady ===
 
=== Příklady ===
  
 
Pro vytvoření přímkového elementu přepněte do konzoly Pythonu a zapište:
 
Pro vytvoření přímkového elementu přepněte do konzoly Pythonu a zapište:
 +
 
{{Code|code=
 
{{Code|code=
 
import Part,PartGui  
 
import Part,PartGui  
Line 172: Line 218:
 
doc.recompute()
 
doc.recompute()
 
}}
 
}}
 +
 
Projděme si výše uvedený příklad v Pythonu krok po kroku:
 
Projděme si výše uvedený příklad v Pythonu krok po kroku:
 +
 
{{Code|code=
 
{{Code|code=
 
import Part,PartGui
 
import Part,PartGui
 
doc=App.newDocument()
 
doc=App.newDocument()
 
}}
 
}}
 +
 
natáhne modul Díl (Part) a vytvoří nový dokument
 
natáhne modul Díl (Part) a vytvoří nový dokument
 +
 
{{Code|code=
 
{{Code|code=
 
l=Part.LineSegment()
 
l=Part.LineSegment()
Line 183: Line 233:
 
l.EndPoint=(1.0,1.0,1.0)
 
l.EndPoint=(1.0,1.0,1.0)
 
}}
 
}}
 +
 
přímka je ve skutečnosti přímkový segment, proto má počáteční a koncový bod.
 
přímka je ve skutečnosti přímkový segment, proto má počáteční a koncový bod.
 +
 
{{Code|code=
 
{{Code|code=
 
doc.addObject("Part::Feature","Line").Shape=l.toShape()
 
doc.addObject("Part::Feature","Line").Shape=l.toShape()
 
}}
 
}}
 +
 
<div class="mw-translate-fuzzy">
 
<div class="mw-translate-fuzzy">
 
Přidá do dokumentu objektový typ Díl (Part) a přiřadí přidanému objektu reprezentaci tvaru přímkového segmentu do vlastnosti 'Tvar' (Shape). Zde je důležité pochopit, že jsme použili geometrický primitiv (Přímka - Part.Line) k vytvoření TopoTvaru ( metoda toShape() ). Do dokumentu mohou být přidávány pouze tvary. Ve FreeCADu jsou geometrické primitivy používány jako "stavební struktury" pro Tvary.
 
Přidá do dokumentu objektový typ Díl (Part) a přiřadí přidanému objektu reprezentaci tvaru přímkového segmentu do vlastnosti 'Tvar' (Shape). Zde je důležité pochopit, že jsme použili geometrický primitiv (Přímka - Part.Line) k vytvoření TopoTvaru ( metoda toShape() ). Do dokumentu mohou být přidávány pouze tvary. Ve FreeCADu jsou geometrické primitivy používány jako "stavební struktury" pro Tvary.
 
</div>
 
</div>
 +
 
{{Code|code=
 
{{Code|code=
 
doc.recompute()
 
doc.recompute()
 
}}
 
}}
 +
 
Aktualizuje dokument. Také připravuje vizuální reprezentaci nového dílu.
 
Aktualizuje dokument. Také připravuje vizuální reprezentaci nového dílu.
  
Line 198: Line 253:
 
Všimněte si také, že přímka může být vytvořena přímo zadáním jejího počátečního a koncového bodu v konstruktoru, např. Part.Line(point1,point2) nebo můžeme vytořit obecnou přímku a pak jí dodatečně přiřadit vlastnosti, jako jsme to udělali zde.
 
Všimněte si také, že přímka může být vytvořena přímo zadáním jejího počátečního a koncového bodu v konstruktoru, např. Part.Line(point1,point2) nebo můžeme vytořit obecnou přímku a pak jí dodatečně přiřadit vlastnosti, jako jsme to udělali zde.
 
</div>
 
</div>
 +
 +
A Line can be created also using:
 +
 +
{{Code|code=
 +
import FreeCAD
 +
import Part
 +
DOC = FreeCAD.newDocument()
 +
 +
def mycreateLine(pt1, pt2, objName):
 +
    obj = DOC.addObject("Part::Line", objName)
 +
    obj.X1 = pt1[0]
 +
    obj.Y1 = pt1[2]
 +
    obj.Z1 = pt1[2]
 +
 +
    obj.X2 = pt2[0]
 +
    obj.Y2 = pt2[1]
 +
    obj.Z2 = pt2[2]
 +
 +
    DOC.recompute()
 +
    return obj
 +
 +
line = mycreateLine((0,0,0), (0,10,0), "LineName")
 +
 +
}}
 +
 +
  
 
Kružnice může být vytvořena podobně:
 
Kružnice může být vytvořena podobně:
 +
 
{{Code|code=
 
{{Code|code=
 
import Part
 
import Part
Line 209: Line 291:
 
doc.recompute()
 
doc.recompute()
 
}}
 
}}
 +
 +
or using:
 +
 +
{{Code|code=
 +
import FreeCAD
 +
import Part
 +
DOC = FreeCAD.newDocument()
 +
 +
def mycreateCircle(rad, objName):
 +
    obj = DOC.addObject("Part::Circle", objName)
 +
    obj.Radius = rad
 +
 +
    DOC.recompute()
 +
    return obj
 +
 +
circle = mycreateCircle(5.0, "CircleName")
 +
 +
}}
 +
 +
 
Znovu si všimněte, že jsme použili kružnici (geometrický primitiv) ke konstrukci tvaru nad ní. Samozřejmě stále zůstává přístup ke geometrii konstrukce, zadáním:
 
Znovu si všimněte, že jsme použili kružnici (geometrický primitiv) ke konstrukci tvaru nad ní. Samozřejmě stále zůstává přístup ke geometrii konstrukce, zadáním:
 +
 
{{Code|code=
 
{{Code|code=
 
s = f.Shape
 
s = f.Shape
Line 215: Line 318:
 
c = e.Curve
 
c = e.Curve
 
}}
 
}}
 +
 
Zde si vezmeme tvar(Shape) našeho objektu f, potom si z něho vezmeme seznam hran. V tomto případě to bude jen jedna hrana, protože celý tvar děláme z jedné kružnicem a proto si vezmeme ze seznamu pouze první hranu a z ní její přímku. Každá hrana má přímku, což je geometrický primitiv, na kterém je hrana založena.
 
Zde si vezmeme tvar(Shape) našeho objektu f, potom si z něho vezmeme seznam hran. V tomto případě to bude jen jedna hrana, protože celý tvar děláme z jedné kružnicem a proto si vezmeme ze seznamu pouze první hranu a z ní její přímku. Každá hrana má přímku, což je geometrický primitiv, na kterém je hrana založena.
  
Line 230: Line 334:
 
</div>
 
</div>
  
{{Userdocnavi}}
+
{{Part Tools navi{{#translation:}}}}
[[Category:Part]]
+
{{Userdocnavi{{#translation:}}}}
[[Category:Workbenches]]
+
[[Category:Workbenches{{#translation:}}]]

Latest revision as of 16:25, 6 August 2020

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎中文(台灣)‎ • ‎日本語
Part workbench icon

CAD možnosti FreeCADu jsou založeny na jádře OpenCasCade. Modul Díl umožňuje FreeCADu přístup a používání objektů a funkcí OpenCasCade. OpenCascade je profesionální CAD jádro, jehož vlastnosti umožňují pokročilou manipulaci s 3D konstrukcemi a objekty. Objekty Díl, narozdíl od objektů Modulu Síť, jsou mnohem komplexnější a proto umožňují mnohem dokonalejší operace, jako jsou logické boolean operace, modifikace historie a parametrické chování.

The objects created with the Part Workbench are relatively simple; they are intended to be used with boolean operations (unions and cuts) in order to build more complex shapes. This modeling paradigm is known as the constructive solid geometry (CSG) workflow, and it was the traditional methodology used in early CAD systems. On the other hand, the PartDesign Workbench provides a more modern workflow to constructing shapes: it uses a parametrically defined sketch, that is extruded to form a basic solid body, which is then modified by parametric transformations (feature editing), until the final object is obtained.

Part objects are more complex than mesh objects created with the Mesh Workbench, as they permit more advanced operations like coherent boolean operations, modifications history, and parametric behaviour.

Part Workbench relationships.svg

The Part Workbench is the basic layer that exposes the OCCT drawing functions to all workbenches in FreeCAD.


Nástroje

Nástroje modulu Díl jsou všechny umístěny v menu Díl, který se zobrazí když natáhnete modul Díl.

Primitives

These are tools for creating primitive objects.

  • Part Box.svg Box: Draws a box by specifying its dimensions
  • Part Cylinder.svg Cylinder: Draws a cylinder by specifying its dimensions
  • Part Sphere.svg Sphere: Draws a sphere by specifying its dimensions
  • Part Cone.svg Cone: Draws a cone by specifying its dimensions
  • Part Torus.svg Torus: Draws a torus (ring) by specifying its dimensions
  • Part Primitives.svg Primitives: A tool to add any of the defined geometric primitives.
  • Part Shapebuilder.svg Shapebuilder: A tool to create more complex shapes from various parametric geometric primitives

Modifying objects

These are tools for modifying existing objects. They will allow you to choose which object to modify.

  • Part Extrude.svg Extrude: Extrudes planar faces of an object
  • Part Revolve.svg Revolve: Creates a solid by revolving another object (not solid) around an axis
  • Part Mirror.svg Mirror: Mirrors the selected object on a given mirror plane
  • Part Fillet.svg Fillet: Fillets (rounds) edges of an object
  • Part Chamfer.svg Chamfer: Chamfers edges of an object
  • Part RuledSurface.svg Ruled Surface:
  • Part Loft.svg Loft: Lofts from one profile to another
  • Part Sweep.svg Sweep: Sweeps one or more profiles along a path
  • Part Thickness.svg Thickness: Hollows out a solid, leaving openings next to select faces.
  • Part Booleans.svg Boolean: Performs boolean operations on objects
  • Part Fuse.svg Union: Fuses (unions) two objects
  • Part Common.svg Common: Extracts the common (intersection) part of two objects
  • Part Cut.svg Cut: Cuts (subtracts) one object from another

Measure

Std Measure Menu.png Measure: Allows linear and angular measurement between points, edges, and faces.

Other tools

Contextual Menu items

  • Appearance: determines appearance of the whole part (color transparency etc.).
  • Set colors: assigns colors to part faces.

Preferences

  • Preferences-part design.svg Preferences: preferences available for Part Tools (the Part workbench also uses the PartDesign Preferences).
  • Preferences-import-export.svg Import Export Preferences: preferences available for importing from and exporting to different file formats.
  • Fine-tuning: some extra parameters to fine-tune Part behavior.

Vysvětlení pojmů

V terminologii OpenCasCade odlišujeme geometrické primitivy a (topologické) tvary. Geometrický primitiv může být bod, linka, kružnice, rovina atd. nebo i komplexnější typy jako je B-Spline (aproximační) křivka nebo plocha. Topologický tvar může být vrchol, hrana, drát, povrch, těleso nebo složenina z jiných tvarů. Geometrické primitivy nejsou určeny k přímému zobrazení ve 3D zobrazení, ale hlavně k použití jako stavební prvek pro 3D tvary. Například hrana může být zkonstruována z linky nebo z části kružnice.

Souhrnně se dá říct, že geometrické primitivy jsou "beztvaré" stavební bloky. A tvary jsou prostorové konstrukce na prvcích vystavěné.

Jejich kompletní seznam je na OCC documentation (Alternativně: sourcearchive.com) a hledání textů Geom_* (pro geometrické primitivy) a TopoDS_* (pro tvary). Můžete se tam také dočíst o rozdílech mezi geometrickými primitivy a tvary. Všimněte si také, prosím, že naneštěstí oficiální OCC dokumentace není dostupná online (musíte si stáhnout archiv) a je hlavně určena pro programátory a ne pro koncové uživatele. Ale pro začátek naštěstí najdete dost informací zde.

At a very high level, topology tells what pieces an object is made of, and the logical relationships between them. A shape is made of a certain set of faces. A face is bounded by a certain set of edges. Two faces are adjacent if they share a common edge.

Topology alone does not tell you the size, curvature, or 3D locations of any of those pieces. However, each piece of topology does knows about it's underlying geometry. A face knows what surface it lies on. An edge knows what curve it lies on. The geometry knows about curvature and location in space. - Source


Thus, Topology defines the relationship between simple geometric entities, which can be linked together to represent complex shapes. - Modeling Data User's Guide

ClassTopoDS Shape inherit graph.png

Geometrické typy mohou být rozděleny do dvou hlavních skupin: linky a povrchy. Nad linkami (přímka, kružnice,...) můžete přímo budovat hrany, na plochách (rovina, válec, ...) zase povrchy. Například základní přímka je nekonečná, tj. je definována základním vektorem a směrovým vektorem, zatímco jeho tvarová reprezentace musí být nějak omezena počátečním a koncovým bodem. A kvádr -- těleso -- může být vytvořeno šesti omezenými rovinami.

Z hran nebo povrchů se můžete také vrátit k jeho původním geometrickým primitivům.

Tudíž, z tvarů můžete stavět velmi komplexní díly nebo opačně odebírat všechny poddíly pro vytváření ještě komplexnějších dílů.


Thus, out of shapes you can build very complex parts or, the other way round, extract all sub-shapes a more complex shape is made of.

Part TopoShape relationships.svg

The Part::TopoShape class is the geometrical object that is seen on screen. Essentially all workbenches use these TopoShapes internally to build and display edges, faces, and solids.


Skriptování

See also: Part scripting

Hlavní datová struktura použitá v modulu Díl je datový typ

BRep z OpenCascade.

Téměř celý obsah a objektové typy modulu Díl jsou dostupné skriptování v Pythonu. Zahrnuje to geometrické primitivy, jako jsou Linky, Kružnice (nebo Úhly) a celá oblast TopoTvarů, jako jsou Vrcholy, Hrany, Dráty, Plochy, Tělesa a Složeniny. Pro každý z těchto objektů existuje několik metod pro jejich vytváření a pro některé z nich, zvláště pro TopoTvary, jsou dostupné rozšířené operace jako logické sjednocení/rozdíly/průniky. Projděte si obsah modulu Díl jak je popsán na stránce FreeCAD Scripting Basics abyste jej lépe pochopili.

The most basic object that can be created is a Part Feature, which has a simple DataPlacement property, and basic properties to define its color and appearance.

Another simple object used in 2D geometrical objects is Part Part2DObject, which is the base of Sketcher SketchObject (Sketcher), and most Draft elements.

Test script

Test the creation of Part Primitives with a script. introduced in version 0.19

import parttests.part_test_objects as pto
pto.create_test_file("example_file")

This script is located in the installation directory of the program, and can be examined to see how the basic primitives are built.

$INSTALL_DIR/Mod/Part/parttests/part_test_objects.py

Příklady

Pro vytvoření přímkového elementu přepněte do konzoly Pythonu a zapište:

import Part,PartGui 
doc=App.newDocument()  
l=Part.LineSegment()
l.StartPoint=(0.0,0.0,0.0)
l.EndPoint=(1.0,1.0,1.0)
doc.addObject("Part::Feature","Line").Shape=l.toShape() 
doc.recompute()

Projděme si výše uvedený příklad v Pythonu krok po kroku:

import Part,PartGui
doc=App.newDocument()

natáhne modul Díl (Part) a vytvoří nový dokument

l=Part.LineSegment()
l.StartPoint=(0.0,0.0,0.0)
l.EndPoint=(1.0,1.0,1.0)

přímka je ve skutečnosti přímkový segment, proto má počáteční a koncový bod.

doc.addObject("Part::Feature","Line").Shape=l.toShape()

Přidá do dokumentu objektový typ Díl (Part) a přiřadí přidanému objektu reprezentaci tvaru přímkového segmentu do vlastnosti 'Tvar' (Shape). Zde je důležité pochopit, že jsme použili geometrický primitiv (Přímka - Part.Line) k vytvoření TopoTvaru ( metoda toShape() ). Do dokumentu mohou být přidávány pouze tvary. Ve FreeCADu jsou geometrické primitivy používány jako "stavební struktury" pro Tvary.

doc.recompute()

Aktualizuje dokument. Také připravuje vizuální reprezentaci nového dílu.

Všimněte si také, že přímka může být vytvořena přímo zadáním jejího počátečního a koncového bodu v konstruktoru, např. Part.Line(point1,point2) nebo můžeme vytořit obecnou přímku a pak jí dodatečně přiřadit vlastnosti, jako jsme to udělali zde.

A Line can be created also using:

import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateLine(pt1, pt2, objName):
    obj = DOC.addObject("Part::Line", objName)
    obj.X1 = pt1[0]
    obj.Y1 = pt1[2]
    obj.Z1 = pt1[2]

    obj.X2 = pt2[0]
    obj.Y2 = pt2[1]
    obj.Z2 = pt2[2]

    DOC.recompute()
    return obj

line = mycreateLine((0,0,0), (0,10,0), "LineName")


Kružnice může být vytvořena podobně:

import Part
doc = App.activeDocument()
c = Part.Circle() 
c.Radius=10.0  
f = doc.addObject("Part::Feature", "Circle")
f.Shape = c.toShape()
doc.recompute()

or using:

import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateCircle(rad, objName):
    obj = DOC.addObject("Part::Circle", objName)
    obj.Radius = rad

    DOC.recompute()
    return obj

circle = mycreateCircle(5.0, "CircleName")


Znovu si všimněte, že jsme použili kružnici (geometrický primitiv) ke konstrukci tvaru nad ní. Samozřejmě stále zůstává přístup ke geometrii konstrukce, zadáním:

s = f.Shape
e = s.Edges[0]
c = e.Curve

Zde si vezmeme tvar(Shape) našeho objektu f, potom si z něho vezmeme seznam hran. V tomto případě to bude jen jedna hrana, protože celý tvar děláme z jedné kružnicem a proto si vezmeme ze seznamu pouze první hranu a z ní její přímku. Každá hrana má přímku, což je geometrický primitiv, na kterém je hrana založena.

Chcete-li vědět více jděte na stránku Topological data scripting.

Tutorials

Arrow-left.svg Pracovní plocha Sít Předchozí:
Další: Modul Výkres Arrow-right.svg