src/ParametersPlugin/doc/managerFeature.rst

   1 .. _parameters:
   2 .. |paper_roll.icon|    image:: images/paper_roll.png
   3
   4
   5 Parameters manager
   6 ==================
   7
   8 To create/edit simultaneously a set of parameters  in the active partset or part instead of calling them one by one:
   9
  10 #. select in the Main Menu *Part - > Parameters* item or
  11 #. click |paper_roll.icon| **Parameters** button in the toolbar:
  12
  13 The following dialog box with parameter table appears:
  14
  15 .. image:: images/parameters.png
  16    :align: center
  17
  18 .. centered::
  19    Parameters dialog box
  20
  21 .. |param_up| image:: images/parameters_up.png
  22 .. |param_down| image:: images/parameters_down.png
  23
  24 **Input fields**:
  25
  26 - **Name** defines parameter name. Name follows the naming rules of the python language for variables;
  27 - **Expression** allows manual input of python expression;
  28 - **Result** evaluates expression as real number by python *eval()* function;
  29 - **Comment** contains any text. This field is optional;
  30 - **Add** button adds a new empty string in the end of table. Default  **Name** is *<NoName>*, **Expression** is   *<NoValue>*
  31 - **Insert** button adds a new empty string before the selected parameter;
  32 - **Delete** button removes the selected parameter from the table;
  33 - **Modify parameter position** button moves the selected parameter
  34
  35     | |param_up| one string higher in the table,
  36     | |param_down| one string lower in the table.
  37
  38 **TUI Command**:
  39
  40 .. py:function:: model.addParameter(Part_doc, Name, Value, Comment)
  41
  42     :param part: The current part object
  43     :param string: The parameter name
  44     :param number: The parameter value
  45     :param string: The parameter comment
  46     :return: Created object.
  47
  48 **See Also** a sample TUI Script of :ref:`tui_parametersFeature` operation.
  49
  50 Result
  51 ------
  52
  53 Created parameters and their current values are displayed in the Object Browser, in a special section **Parameters**.
  54
  55 .. image:: images/object_browser_parameters.png
  56    :align: center
  57
  58 .. centered::
  59    **Parameters** in object browser