doc/salome/gui/GEOM/input/chamfer_operation.doc

   1 /*!
   2
   3 \page chamfer_operation_page Chamfer
   4
   5 \n To produce a \b Chamfer in the <b>Main Menu</b> select
   6 <b>Operations - > Chamfer</b>
   7
   8 \n This operation allows you to make chamfer of the edges of a Shape.
   9 \n The \b Result will be a \b GEOM_Object.
  10
  11 \n To create chamfer on all edges of the given shape, you need to
  12 define the <b>Main Object</b> to create a chamfer on and the \b
  13 Dimension (radius) of the chamfer.
  14 \n <b>TUI Command:</b> <em>geompy.MakeChamferAll(Shape, D)</em>
  15 \n <b>Arguments:</b> Name + 1 SHAPE + 1 value (Chamfer dimension).
  16 \n <b>Advanced options</b> \ref preview_anchor "Preview"
  17
  18 \image html chamfer1.png
  19
  20 \image html chamfer_all.png "Chamfer on the whole object"
  21
  22 \n In the algorithms below there exist two ways to define the \b
  23 Dimension of the Chamfer
  24 \n Firstly the \b Dimension can be defined via \b D1 and \b D2, which
  25 represent the offset on the first and the second face forming the
  26 edge.
  27 \n Secondly the \b Dimension can be defined via \b D, which represents
  28 the offset on the first face, and the \b Angle, which is the angle
  29 between the first face and the chamfer plane.
  30
  31
  32 \n To create chamfer on the specified edges of the given shape,  you
  33 need to define the <b>Main Object</b> to create a fillet on, select
  34 the two faces to which belongs the necessary common edge in the viewer
  35 and define the \b Dimension of the Chamfer.
  36 \n <b>TUI Command:</b> <em>geompy.MakeChamferEdge(Shape, D1, D2,
  37 Face1, Face2),</em> where \em Shape is a shape to create a chamfer on,
  38 \em D1 is a chamfer size along \em Face1, \em D2 is a chamfer size
  39 along \em Face2, \em Face1 and \em Face2 are indices of faces in
  40 Shape.
  41
  42 \n <b>Alternative TUI Command:</b> <em>geompy.MakeChamferEdge(Shape, D, Angle,
  43 Face1, Face2),</em> where \em D1 is a chamfer size along \em Face1 and
  44 \em Angle is the angle between Face1 and the chamfer plane.
  45
  46 \image html chamfer2.png
  47
  48 \image html chamfer_edge.png "Chamfer on the specified edges"
  49
  50 \n To create chamfer on the specified faces of the given shape,  you need
  51 to define the <b>Main Object</b> to create a fillet on, select the
  52 necessary faces the OCC Viewer and define the \b Dimension of the
  53 Chamfer.
  54 \n <b>TUI Command:</b> <em>geompy.MakeChamferFaces(Shape, D1, D2,
  55 ListOfFaceID),</em> where \em Shape is a shape to create chamfer on,
  56 \em D1 and D2 are chamfer sizes along faces from  \em
  57 ListOfFaceID. For each Edge Face1 and Face2 are defined basing
  58 on their indices.
  59
  60 \n <b>Alternative TUI Command:</b> <em>geompy.MakeChamferFaces(Shape, D, Angle,
  61 ListOfFaceID),</em> where \em D1 is a chamfer size along \em Face1 and
  62 \em Angle is the angle between Face1 and the chamfer plane.
  63
  64 \image html chamfer3.png
  65
  66 \image html chamfer_faces.png "Chamfer on the specified faces"
  67
  68 \n To create chamfer on an arbitrary set of edges of the given shape
  69 to define the <b>Main Object</b> to create a fillet on, select the
  70 necessary edges the OCC Viewer and define the \b Dimension of the
  71 Chamfer.
  72 \n <b>TUI Command:</b> <em>geompy.MakeChamferEdges(Shape, D1, D2,
  73 ListOfEdgeID),</em> where \em Shape is a shape to create chamfer on,
  74 \em D1 and D2 are chamfer sizes along faces defined by the algorithm
  75 basing on \em ListOfEdgeID, which is a list of indices of edges in
  76 \em Shape. For each Edge the algorithm selects Face1 and Face2 basing
  77 on their indices.
  78
  79 \n <b>Alternative TUI Command:</b> <em>geompy.MakeChamferEdges(Shape, D, Angle,
  80 ListOfEdgeID),</em> where \em D1 is a chamfer size along \em Face1 and
  81 \em Angle is the angle between Face1 and the chamfer plane.
  82
  83 \image html chamfer4.png
  84
  85 Our <b>TUI Scripts</b> provide you with useful examples of the use of
  86 \ref tui_chamfer "Transformation Operations".
  87
  88 */