Salome HOME
Merge branch HELP_DOCUMENTATION_EDITING into master.
[modules/shaper.git] / src / SketchPlugin / doc / lengthFeature.rst
index f4197f5cbaf0edb5cdc1db6c69e6d127c44bc79c..c74ec6ccd19435cd72f3251acdba626f5416fb09 100644 (file)
@@ -2,9 +2,67 @@
 Length constraint
 =================
 
+Length constraint fixes length of lines such as standalone line or rectangle side.
 
-.. image:: images/Length.png
-  :align: center
+To create Length constraint in the active Sketch:
+
+#. select in the Main Menu *Sketch - > Length* item  or
+#. click **Length** button in Sketch toolbar:
+
+.. image:: images/length.png
+   :align: center
+
+.. centered::
+   **Length**  button
+
+Property panel:
+
+.. image:: images/Length_panel.png
+   :align: center
+
+Input fields:
+
+- **Line** is the the line object selected in the view
+- **Value** is a line length, could be modified to set the desirable value
+- **Text location** is a position of the length value label relating to extension line (in the view)
+   .. image:: images/location_left.png
+      :align: left
+   **Left** inserts text at the left of the length extension line.
+
+   .. image:: images/location_automatic.png
+      :align: left
+   **Automatic** inserts text at the middle of the length extension line if it has enough length, otherwise - to the left.
+
+   .. image:: images/location_right.png
+      :align: left
+   **Right** inserts text to the right of the length extension line.
+
+When the line is selected length value is displayed in the property panel and in the view.
+
+When creating the constraint, after selection of a line at the first time:
+
+- drag the length presentation in the view to the desired position (by move mouse and click once)
+- set desirable length value in the input field in the view and press **Enter** or just press **Enter** to keep the current length
+
+.. image:: images/Length_field_view.png
+   :align: center
 
 .. centered::
-  Create a length constraint
+   Length input in the view
+
+**TUI Command**: *Sketch_1.setLength(LineObject, Value)*
+
+**Arguments**:  line + length value
+
+Result
+""""""
+
+Created Length appears in the view.
+
+.. image:: images/Length_res.png
+          :align: center
+
+.. centered::
+   Length created
+
+**See Also** a sample TUI Script of a :ref:`tui_create_length` operation.