mirror of
https://git.salome-platform.org/gitpub/modules/geom.git
synced 2024-11-16 10:38:34 +05:00
88 lines
3.7 KiB
Plaintext
88 lines
3.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 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
|
|
|
|
Alternatively, it is possible to define the point by \b Edge and \b Length,
|
|
the given length can exceed the length of the edge or be negative
|
|
(except bezier and b-spline curves). The orientation of the edge can
|
|
be reversed by the \b StartPoint selection.
|
|
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurveByLength(Edge,Length,StartPoint=None).</em>
|
|
\n <b>Arguments:</b> Name + 1 edge + 1 Length defining the position
|
|
of the point on the given edge + 1 Point defining the direction for
|
|
the calculation of the length (if not defined, the first vertex of
|
|
Edge is used, else the vertex of Edge closest to StartPoint is used).
|
|
\image html point3_3.png
|
|
|
|
It is also possible to define 3D coordinates of the point
|
|
projected on the given edge to produce the resulting point.
|
|
\n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurveByCoord(Edge,X,Y,Z).</em>
|
|
\n <b>Arguments:</b> Name + 1 edge + 3 coordinate values of the
|
|
projected point.
|
|
\image html point3_2.png
|
|
|
|
\n Fourthly, we can define a point(s) by intersection of two \b Lines or \b Wires (or a Wire and a Line).
|
|
If they intersect only once, a point will be created. If there are several intersections, a compound of
|
|
points will be created. The type of the selected object (Line or Wire) can be changed in the popup menu,
|
|
after clicking the corresponding selection button. (see the picture below)
|
|
\n <b>TUI Command:</b> <em>geompy.MakePointOnLinesIntersection(myLine1,myWire1).</em>
|
|
\n <b>Arguments:</b> Name + 2 1D objects
|
|
|
|
\image html point4.png
|
|
|
|
\n Finally, we can define a point by a \b Face and
|
|
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.
|
|
|
|
\image html point5.png
|
|
|
|
Alternatively, it is possible to define 3D coordinates of the point projected on the given face.
|
|
\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
|
|
|
|
<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".
|
|
|
|
*/
|