5 ========================================
6 GUI: Definition of point of the geometry
7 ========================================
9 To make a vertex association you need to define the Geom Point you want to associate
12 There are five algorithms to create a Point in the 3D space in Geom.
13 Each time the Result of the operation will be a GEOM_Object (vertex).
16 .. _guiassovertexcoords:
21 Firstly, we can define a point by setting its X, Y and Z Coordinates.
25 - Name of the vertex of the model
26 - Name of the resulting point
27 - X, Y and Z coordinates of the point
29 The dialogue box to associate a vertex to a point defined by its coordinates is:
31 .. image:: _static/gui_vertex_assoc_coordinates.png
35 Point defined by its coordinates
43 Secondly, we can define a point by a Reference to another point and the shift of the coordinates of the new point regarding the coordinates of the old one.
47 - Name of the vertex of the model
48 - Name of the resulting point
50 - 3 coordinates defining the position of this point regarding the reference one
52 The dialogue box to associate a vertex to a point defined by a reference is:
54 .. image:: _static/gui_vertex_assoc_on_geom_point.png
58 Point defined by reference to a point of the geometry and a translation
61 .. _guiassovertexedgeparam:
63 By an Edge and a Parameter
64 ==========================
66 Thirdly, we can define a point by an Edge and a 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.
70 - Name of the vertex of the model
71 - Name of the resulting point
73 - 1 Parameter defining the position of the point on the given edge
76 The dialogue box to associate a vertex to a point of the geometry defined by an edge and parameter:
78 .. image:: _static/gui_vertex_assoc_on_edge_byParam.png
82 Point defined by an edge and a parameter
85 .. _guiassovertexedgelength:
87 By an Edge and a Length
88 =======================
90 Alternatively, it is possible to define a point by an Edge and a Length.
91 The Length defines the position of the point on the given edge.
92 It can exceed the length of the edge or be negative.
93 In this case the edge is extrapolated along its curve (except for bezier and b-spline curves).
94 The Start Point defines the direction for the length calculation (if not defined, the first vertex of Edge is used, else the vertex of Edge closest to StartPoint is used).
98 - Name of the vertex of the model
99 - Name of the resulting point
104 The dialogue box to associate a vertex to a point of the geometry defined by an edge and a length:
106 .. image:: _static/gui_vertex_assoc_on_edge_byLength.png
110 Point defined by an edge and a length
113 .. _guiassovertexedgecoords:
115 By an Edge and Coordinates
116 ==========================
118 It is also possible to define 3D coordinates of the point projected on the given edge to produce the resulting point.
122 - Name of the vertex of the model
123 - Name of the resulting point
124 - 3 coordinate values of the projected point
127 The dialogue box to associate a vertex to a point of the geometry defined by an edge and coordinates:
129 .. image:: _static/gui_vertex_assoc_on_edge_byCoords.png
133 Point defined by an edge and 3 coordinates
136 .. _guiassovertexlineintersect:
138 By intersection of two Lines or Wires
139 =====================================
141 Fourthly, we can define a point(s) by intersection of two Lines or Wires (or a Wire and a Line).
142 If they intersect only once, a point will be created. If there are several intersections, a compound of points will be created.
143 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)
147 - Name ot he vertex of the model
148 - Name of the resulting point
149 - 2 1D objects (Line or Wire)
151 The dialogue box to associate a vertex to a point of the geometry defined by the intersection of two lines or wires is:
153 .. image:: _static/gui_vertex_assoc_on_lines_intersection.png
157 Point defined by the intersection of two lines or wires
160 .. _guiassovertexpointonfaceparams:
162 By a face and two parameters
163 ============================
165 Finally, we can define a point by a Face and Two Parameters: U and V indicating its position on the Face, ranging from 0.0 to 1.0.
166 For example, (0.5; 0.5) means that the point is located in the middle of the face.
170 - Name of the vertex of the model
171 - Name of the resulting point
173 - 2 Parameters defining the position of the point on the given face
175 The dialogue box to associate a vertex to a point on a face using U and V parameters is:
177 .. image:: _static/gui_vertex_assoc_on_face_byParam.png
181 Point defined by a face and two parameters
184 .. _guiassovertexpointonfacecoords:
186 By a face and coordinates
187 =========================
189 Alternatively, it is possible to define 3D coordinates of the point projected on the given face.
193 - Name of the vertex of the model
194 - Name of the resulting point
195 - 3 coordinate values to project point on the given face
198 The dialogue box to associate a vertex to a point on a face using coordinates is:
200 .. image:: _static/gui_vertex_assoc_on_face_byCoords.png
204 Point defined by a face and 3 coordinates
207 GUI: :ref:`guiassovertex`