src/BuildPlugin/doc/edgeFeature.rst

   1 .. |feature_edge.icon|    image:: images/feature_edge.png
   2
   3 Edge
   4 ====
   5
   6 Edge feature creates one or several edges using shapes already existing in other objects.
   7
   8 To create edges in the active part:
   9
  10 #. select in the Main Menu *Build - > Edge* item  or
  11 #. click |feature_edge.icon| **Edge** button in the toolbar
  12
  13 The options to create edges:
  14
  15 .. image:: images/edge_by_segments_32x32.png
  16    :align: left
  17    :height: 24px
  18
  19 **By edges** creates edges using already existing edges in other shapes or full sketches.
  20
  21 .. image:: images/edge_by_points_32x32.png
  22    :align: left
  23    :height: 24px
  24
  25 **By points** creates segment between two points.
  26
  27 --------------------------------------------------------------------------------
  28
  29 By edges
  30 --------
  31
  32 .. image:: images/Edge.png
  33   :align: center
  34
  35 .. centered::
  36   Create by edges
  37
  38 Select one or several edges in the viewer. Also, the full sketch can be selected. In this case, all edges of the sketch will be processed.
  39 Checkbox **Compute intersections** forces to split sketch edges in the points of intersection.
  40
  41 **Apply** button creates edges.
  42
  43 **Cancel** button cancels the operation.
  44
  45 **TUI Command**:
  46
  47 .. py:function:: model.addEdge(Part_doc, Shapes, Intersect)
  48
  49     :param part: The current part object.
  50     :param list: A list of shapes.
  51     :param bool: Split edges by intersection points. False by default.
  52     :return: Result object.
  53
  54 Result
  55 """"""
  56
  57 The result of the operation will be a set of edges created from the selected shapes:
  58
  59 .. image:: images/CreateEdge.png
  60   :align: center
  61
  62 .. centered::
  63   Result of the operation.
  64
  65 **See Also** a sample TUI Script of :ref:`tui_create_edge` operation.
  66
  67
  68 By two points
  69 -------------
  70
  71 .. image:: images/EdgeByTwoPoints.png
  72   :align: center
  73
  74 .. centered::
  75   Create by points
  76
  77 Select two points in the viewer.
  78
  79 **Apply** button creates a segment.
  80
  81 **Cancel** button cancels the operation.
  82
  83 **TUI Command**:
  84
  85 .. py:function:: model.addEdge(Part_doc, Point_1, Point_2)
  86
  87     :param part: The current part object.
  88     :param object: First point.
  89     :param object: Second point.
  90     :return: Result object.
  91
  92 Result
  93 """"""
  94
  95 The result of the operation will be a segment bounded by selected points:
  96
  97 .. image:: images/CreateEdgeByPoints.png
  98   :align: center
  99
 100 .. centered::
 101   Result of the operation.
 102
 103 **See Also** a sample TUI Script of :ref:`tui_create_segment` operation.