From: vsv <vsv@opencascade.com>
Date: Mon, 13 Aug 2018 15:11:36 +0000 (+0300)
Subject: Create Build/Vertex help page
X-Git-Url: http://git.salome-platform.org/gitweb/?a=commitdiff_plain;h=add5742b9894d6303efdef2234007ca5120ec8c0;p=modules%2Fshaper.git

Create Build/Vertex help page
---

diff --git a/.salomeport b/.salomeport
index eafc9999e..145d7e23c 100644
--- a/.salomeport
+++ b/.salomeport
@@ -1 +1 @@
-2811
\ No newline at end of file
+2810
\ No newline at end of file
diff --git a/src/BuildPlugin/doc/TUI_vertexFeature.rst b/src/BuildPlugin/doc/TUI_vertexFeature.rst
new file mode 100644
index 000000000..d1224145e
--- /dev/null
+++ b/src/BuildPlugin/doc/TUI_vertexFeature.rst
@@ -0,0 +1,12 @@
+
+  .. _tui_create_vertex:
+
+Create Vertex
+=============
+
+.. literalinclude:: examples/vertex.py
+    :linenos:
+    :language: python
+
+:download:`Download this script <examples/vertex.py>` 
+   
diff --git a/src/BuildPlugin/doc/examples/vertex.py b/src/BuildPlugin/doc/examples/vertex.py
new file mode 100644
index 000000000..ea2979b7f
--- /dev/null
+++ b/src/BuildPlugin/doc/examples/vertex.py
@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Box_1 = model.addBox(Part_1_doc, 10, 10, 10)
+Vertex_1_objects = [model.selection("VERTEX", "Box_1_1/Back&Box_1_1/Left&Box_1_1/Top"),
+                    model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Left&Box_1_1/Top"),
+                    model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Right&Box_1_1/Top"),
+                    model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Left&Box_1_1/Bottom"),
+                    model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Right&Box_1_1/Bottom")]
+Vertex_1 = model.addVertex(Part_1_doc, Vertex_1_objects)
+model.do()
+model.end()
diff --git a/src/BuildPlugin/doc/images/CreateVertex.png b/src/BuildPlugin/doc/images/CreateVertex.png
new file mode 100644
index 000000000..3391f0928
Binary files /dev/null and b/src/BuildPlugin/doc/images/CreateVertex.png differ
diff --git a/src/BuildPlugin/doc/images/Vertex.png b/src/BuildPlugin/doc/images/Vertex.png
index 38143d486..a7a820b66 100644
Binary files a/src/BuildPlugin/doc/images/Vertex.png and b/src/BuildPlugin/doc/images/Vertex.png differ
diff --git a/src/BuildPlugin/doc/images/feature_vertex.png b/src/BuildPlugin/doc/images/feature_vertex.png
new file mode 100644
index 000000000..62406daff
Binary files /dev/null and b/src/BuildPlugin/doc/images/feature_vertex.png differ
diff --git a/src/BuildPlugin/doc/vertexFeature.rst b/src/BuildPlugin/doc/vertexFeature.rst
index dc8cb4c75..e314d3c4c 100644
--- a/src/BuildPlugin/doc/vertexFeature.rst
+++ b/src/BuildPlugin/doc/vertexFeature.rst
@@ -2,9 +2,37 @@
 Vertex
 ======
 
+To create vertices in the active part:
+
+#. select in the Main Menu *Build - > Vertex* item  or
+#. click **Vertex** button in the toolbar
+
+.. image:: images/feature_vertex.png
+  :align: center
+
+.. centered::
+  **Vertex** button
+
+The following property panel will be opened:
 
 .. image:: images/Vertex.png
   :align: center
 
 .. centered::
-  Create a vertex
+  Create vertices
+
+Select one or several vertices in viewer.
+
+**Apply** button creates vertices.
+
+**Cancel** button cancels operation. 
+
+The result of the operation will be set of vertices created from selected shapes:
+
+.. image:: images/CreateVertex.png
+  :align: center
+
+.. centered::
+  Result of the operation.
+
+**See Also** a sample TUI Script of a :ref:`tui_create_vertex` operation.