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

80 lines
3.1 KiB
Plaintext

/*!
\page create_sketcher_page Sketcher
Sketcher allows to create curves of 2 types: line segment and arc.
By default the start point of the curve is located at the point of
origin of the reference coordinate system and the curve lies in the
plane XOY. The end of the curve is defined by
means of "destination", which can be a destination point (coupled with a radius
or a center for an arc) or a destination direction coupled with length
of a segment or angle and radius of an arc.
\n <b>Warning:</b> When constructing an arc by its center and destination point,
the constraint on the center is first taken into account. Therefore
if the constraints are incompatible the destination point <b> won't lie
on the constructed arc</b> (a warning message will be displayed).
\n Sketcher is able to create planar curves only. Therefore, it is
necessary to select coordinate system (Global or Local) before starting
a sketch. Sketcher creates curves lying in the XOY plane of the selected Coordinate System.
\n This functionality is available from the main menu via <em>New
Entity / Sketch</em>.
\n The Result of the operation will be a \b GEOM_Object.
\n <b>TUI Command:</b> <em>geompy.MakeSketcher(Command, WorkingPlane)</em>
\n This algorithm creates a sketcher (wire or face), following the
textual description, passed through the Command argument. The edges of
the resulting wire or face will be arcs of circles and/or linear
segments.
\n \em Command is a string, defining the sketcher by the coordinates of
points in the current LCS.
\n <em>WorkingPlane</em> can be a Local CS, a plane, or a planar face. The plane is
defined by the XYZ coordinates of three non-coincident points. The
planar face is an existing GEOM_Object.
\n <b>Arguments:</b>
<ol>
<li>Coordinate system (Local or Global CS can be selected)</li>
<li>Element type (segment or arc).</li>
<li>Destination type (point or direction).</li>
<li>Destination point by means of:</li>
<ul>
<li>absolute coordinates X,Y;</li>
<li>relative coordinates DX, DY (with respect to the current point);</li>
<li>selection of an existing point.</li>
</ul>
<li>Destination direction by means of:</li>
<ul>
<li>angle between the new segment and the previous one;</li>
<li>perpendicular to the previous segment (same as previous, but angle
is predefined and is equal to 90 degrees);</li>
<li>tangent to the previous segment;</li>
<li>vector components DX, DY.</li>
</ul>
<li>Parameters of an element (for segment : length or target X or Y coordinate value, for arc : radius, angle or center coordinates).</li>
</ol>
\b Buttons:
<b>"Restore"</b> button orientates the viewer correspondingly to the chosen working plane and fits the scene to show all its objects.
\n <b>"Sketch Validation"</b> button applies the wire, only red part will be built by "Sketch Validation".
\n <b>"Sketch Closure"</b> will close the Sketch by straight line from last red part and apply it.
\n <b>Dialog Box:</b>
\image html neo-scetcher1.png
<br>
\image html neo-scetcher2.png
\n <b>Example:</b>
\image html image204.png "Creation of a circle with sketcher"
Our <b>TUI Scripts</b> provide you with useful examples of the use of
\ref tui_sketcher_page "Sketcher".
*/