geom/doc/salome/gui/GEOM/input/creating_point.doc

76 lines
2.7 KiB
Plaintext

/*!
\page create_point_page Point
To create a \b Point in the <b>Main Menu</b> select <b>New Entity - >
Basic - > Point</b>
\n There are five algorithms to create a \b Point in the 3D space.
\n Each time the \b Result of the operation will be a GEOM_Object
(vertex).
\n Firstly, we can define a point by setting its X, Y and Z \b Coordinates.
\n <b>TUI Command:</b> <em>geompy.MakeVertex(X, Y, Z)</em>
\n \b Arguments: Name (Vertex_n by default) + X, Y and Z coordinates of
the point.
\image html point1.png
\n Secondly, we can define a point by a \b Reference to another point
and the shift of the coordinates of the new point regarding the
coordinates of the old one.
\n <b>TUI Command:</b> <em>geompy.MakeVertexWithRef(Reference, X,Y,Z).</em>
\n <b>Arguments:</b> Name + 1 reference point + 3 coordinates defining
the position of this point regarding the reference one.
\image html point2.png
\n Thirdly, we can define a point by an \b Edge and a \b
[list]
[*]Parameter
indicating its position on the Edge, ranging from 0.0 to 1.0. For example, 0.5 means that the
point is located in the middle of the edge.
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurve(Edge,Parameter).</em>
\n <b>Arguments:</b> Name + 1 edge + 1 Parameter defining the
position of the point on the given edge.
\image html point3.png
[*]3D co-ordinate of point to project on the given edge
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurveByCoord(Edge,X,Y,Z).</em>
\n <b>Arguments:</b> Name + 1 edge + 3 coordinate values
to project point on the given edge.
\image html point3_2.png
[/list]
\n Fourthly, we can define a point by intersection of two \b Lines.
\n <b>TUI Command:</b> <em>geompy.MakePointOnLinesIntersection(myLine1,myLine2).</em>
\n <b>Arguments:</b> Name + 2 lines
\image html point4.png
<b>Example:</b>
\n Finally, we can define a point by a \b Face and
[list]
[*]Two <b> Parameters: U </b> and \b V
indicating its position on the Face, ranging from 0.0 to 1.0. For example, (0.5; 0.5) means that the
point is located in the middle of the face.
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnSurface(myFace,myUParameter,myVParameter).</em>
\n <b>Arguments:</b> Name + 1 face + 2 Parameters defining the
position of the point on the given face.
[*] 3D co-ordinate of point to project on the given face.
\image html point5.png
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnSurface(myFace,X,Y,Z).</em>
\n <b>Arguments:</b> Name + 1 face + 3 coordinate values
to project point on the given face.
\image html point5_2.png
[/list]
<b>Example:</b>
\image html points.png "Points by edge and parameter and by coordinates"
Our <b>TUI Scripts</b> provide you with useful examples of creation of
\ref tui_creation_point "Basic Geometric Objects".
*/