Salome HOME
Cosmetics. Move XML files to the separate folder inside a corresponding project in VS.
[modules/shaper.git] / src / SketchPlugin / doc / projectionFeature.rst
index 27f83721ecb8a36222f4f0b5a0b851303b30d25c..a02299b6da3cc4df71616d07cabfe554b6d37c88 100644 (file)
@@ -1,10 +1,50 @@
+.. |projection.icon|    image:: images/Projection.png
 
 Projection
 ==========
 
+| The Projection operation creates a projection of 3D edge or vertex onto the sketch plane.
+| The result of projection is a line.
 
-.. image:: images/Projection.png
-  :align: center
+To create a Projection in the active Sketch:
 
-.. centered::
-  Create a projection
+#. select in the Main Menu *Sketch - > Projection* item  or
+#. click |projection.icon| **Projection** button in Sketch toolbar:
+
+Property panel:
+
+.. figure:: images/Projection_panel.png
+   :align: center
+
+   Projection
+
+Input fields:
+
+- **Object** is the 3D object (edge or vertex) to project onto the sketch plane.
+- **Include into the sketch result** option defines whether to include the projection line into the sketch result.
+
+**TUI Commands**:
+
+.. py:function:: Sketch_1.addProjection(EdgeOrVertex, IncludeIntoResult)
+
+    :param object: Edge or vertex.
+    :param boolean: Include into the result flag.
+    :return: Result object.
+
+.. py:function:: Sketch_1.addProjection(EdgeOrVertexName, IncludeIntoResult)
+
+    :param object: Edge or vertex name.
+    :param boolean: Include into the result flag.
+    :return: Result object.
+
+Result
+""""""
+
+Created Projection appears in the view.
+
+.. figure:: images/Projection_res.png
+   :align: center
+
+   Created projection (purple line)
+
+**See Also** a sample TUI Script of :ref:`tui_create_projection` operation.