ASCEE/pyqtgraph
5
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Added mouse interaction documentation

Browse Source
This commit is contained in:
Luke Campagnola 2012-03-12 12:31:17 -04:00
parent fe4e177d8e
commit aa853ff9bf
1 changed files with 42 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
documentation/source/mouse_interaction.rst Normal file
View File

@ -0,0 +1,42 @@
Mouse Interaction
=================
Most applications that use pyqtgraph's data visualization will generate widgets that can be interactively scaled, panned, and otherwise configured using the mouse. This section describes mouse interaction with these widgets.
2D Graphics
-----------
In pyqtgraph, most 2D visualizations follow the following mouse interaction:
* Left button: Interacts with items in the scene (select/move objects, etc). If there are no movable objects under the mouse cursor, then dragging with the left button will pan the scene instead.
* Right button drag: Scales the scene. Dragging left/right scales horizontally; dragging up/down scales vertically (although some scenes will have their x/y scales locked together). If there are x/y axes fisible in the scene, then right-dragging over the axis will _only_ affect that axis.
* Right button click: Clicking the right button in most cases will show a context menu with a variety of options depending on the object(s) under the mouse cursor.
* Middle button (or wheel) drag: Dragging the mouse with the wheel pressed down will always pan the scene (this is useful in instances where panning with the left button is prevented by other objects in the scene).
* Wheel spin: Zooms the scene in and out.
For machines where dragging with the right or middle buttons is difficult (usually Mac), another mouse interaction mode exists. In this mode, dragging with the left mouse button draws a box over a region of the scene. After the button is released, the scene is scaled and panned to fit the box. This mode can be accessed in the context menu or by calling::
pyqtgraph.setConfigOption('leftButtonPan', False)
Context Menu
------------
Right-clicking on most scenes will show a context menu with various options for changing the behavior of the scene. Some of the options available in this menu are:
* Enable/disable automatic scaling when the data range changes
* Link the axes of multiple views together
* Enable disable mouse interaction per axis
* Explicitly set the visible range values
The exact set of items available in the menu depends on the contents of the scene and the object clicked on.
3D Graphics
-----------
3D visualizations use the following mouse interaction:
* Left button drag: Rotates the scene around a central point
* Wheel spin: zoom in/out