Added a demo example for Python plugins

diff --git a/doc/salome/gui/input/using_pluginsmanager.doc b/doc/salome/gui/input/using_pluginsmanager.doc
index d6f8234ffd04bd67c52b7bbde872e109e50f9358..c44074cdc0810669a4517eb919f8050602891208 100644 (file)
--- a/doc/salome/gui/input/using_pluginsmanager.doc
+++ b/doc/salome/gui/input/using_pluginsmanager.doc
@@ -6,6 +6,7 @@
 -# \ref S2_SALOMEPLUGINS
 -# \ref S3_SALOMEPLUGINS
 -# \ref S4_SALOMEPLUGINS
+-# \ref S5_SALOMEPLUGINS
 
 \section S1_SALOMEPLUGINS Objectives
 
@@ -143,15 +144,46 @@ salome_pluginsmanager.AddFunction('O,Vx,Vy,Vz',
 Move this script in the directory
 ~/.config/salome/Plugins, run SALOME and enjoy your new function.
 
-\section S4_SALOMEPLUGINS Other examples
+\section S4_SALOMEPLUGINS How to select an object of the object browser
+
+Sometimes it can be useful to retrieve an object of the object browser to perform
+an action on it. For example it can be useful to select a mesh in order
+to display some information related to it.
+
+Some important methods and objects to use are the followings:
+-# context.sg.getObjectBrowser(): useful to connect the signal event 
+                                 `selectionChanged()` to a custom slot
+-# context.salome.sg.getAllSelected(): to get the list of selected object
+                                      in the object browser
+-# objId = context.salome.sg.getSelected(0): 
+  to get the first selected object in the object browser
+-# salomeObj = context.salome.study.FindObjectID(objId).GetObject():
+  to retrieve the salome object from the selection. It can be a GEOM, SMESH, or any
+  other module object. 
+
+  If it is a mesh, then it is possible to call GetMEDMesh() on the object. 
+  If it is not a mesh, this call will raise an exception. Then a possible way to get
+  a mesh can be written as following:
+\code
+mesh = None
+try:
+  mesh = salomeObj.GetMEDMesh()
+except:
+  print "The selection is not a mesh"
+\endcode
+
+A example of usage of those methods is available with the demo examples.
+See the next chapter \ref S5_SALOMEPLUGINS.
+
+\section S5_SALOMEPLUGINS Other examples
 
 The GUI module provides you with some basic demo examples, located in
 the directory src/SalomeApp/pluginsdemo of the source space, and
-installed in the directory $GUI_ROOT_DIR/share/salome/plugins/gui.
+installed in the directory $GUI_ROOT_DIR/share/salome/plugins/gui/demo.
 
 \note These examples are automatically installed when you install the GUI
 but are not activated. To activate the plugins, edit the file
-$GUI_ROOT_DIR/share/salome/plugins/gui/salome_plugins.py and turn the
+$GUI_ROOT_DIR/share/salome/plugins/gui/demo/salome_plugins.py and turn the
 variable DEMO_IS_ACTIVATED to True.
 
 The demo examples are:
@@ -165,5 +197,9 @@ The demo examples are:
    an additionnal preview function (button apply in the dialog box).
 -# \b runSalomeShellSession: run a SALOME prepared shell session in a
    xterm.
+-# \b minmax: computes the min and max values of a control on a selected mesh.
+  \note This plugin is available in the SMESH module only. To activate it, edit 
+  the file $GUI_ROOT_DIR/share/salome/plugins/gui/demo/smesh_plugins.py and turn the variable
+  DEMO_IS_ACTIVATED to True.
 
 */

diff --git a/src/SalomeApp/pluginsdemo/Makefile.am b/src/SalomeApp/pluginsdemo/Makefile.am
index ed5f9376336e6125aa6504ce40f8ac5a595a3585..1b4d2f07421980f25ed1080394b0dad19a432505 100644 (file)
--- a/src/SalomeApp/pluginsdemo/Makefile.am
+++ b/src/SalomeApp/pluginsdemo/Makefile.am
@@ -33,8 +33,11 @@ include $(top_srcdir)/adm_local/unix/make_common_starter.am
 pluginsdir =$(salomepluginsdir)/demo
 plugins_PYTHON = \
        salome_plugins.py \
+       smesh_plugins.py \
        trihedron.py      \
        tubedialog_ui.py  \
        tubedialog.py     \
        tubebuilder.py    \
-       xalome.py
+       xalome.py         \
+       minmax_dialog.py  \
+       minmax_plugin.py