Salome HOME
153c610059d709eb17a62eb8336dcd3b6426713e
[modules/geom.git] / doc / salome / gui / GEOM / input / creating_circle.doc
1 /*!
2
3 \page create_circle_page Circle
4
5 To create a \b Circle in the <b>Main Menu</b> select <b>New Entity - >
6 Basic - > Circle</b>
7
8 \n There are 3 algorithms to create a \b Circle in the 3D space. 
9 \n The \b Result of each operation will be a GEOM_Object (edge).
10
11 \n Firstly, you can define a \b Circle by a <b>Center Point</b>, a \b
12 Vector giving the circle's normal and a \b Radius.
13 \n <b>TUI Command:</b> <em>geompy.MakeCircle(Point, Vector,
14 Radius)</em>
15 \n <b>Arguments:</b> Name + 1 vertex (for the center) + 1 edge (for
16 the direction) + Radius.
17
18 \image html circle1.png
19
20 \n Secondly, you can define a \b Circle by three \b Points that lie on it. 
21 \n <b>TUI Command:</b> <em>geompy.MakeCircleThreePnt(Point1, Point2, Point3)</em>
22 \n <b>Arguments:</b> Name + 3 points which will form the circle.
23
24 \image html circle2.png
25
26 <b>Example:</b>
27 \image html circles.png
28
29 \n Finally, you can define a circle by a <b>Center Point</b> and two
30 \b Points.  
31 \n <b>TUI Command:</b> <em>geompy.MakeCircleCenter2Pnt(Point1, Point2,
32 Point3)</em>, where Point1 is the center of the circle, the distance
33 between point1 and Point2 is the radius of the circle and Point3 helps
34 to define the plane where the circle lies.
35 \n <b>Arguments:</b> Name + 3 points.
36
37 \image html circle3.png
38
39 Our <b>TUI Scripts</b> provide you with useful examples of creation of 
40 \ref tui_creation_circle "Basic Geometric Objects".
41
42 */