Example Four:  Callbacks and the event Manager

This example illustrates the event Manager property of the camera.
 

First get a handle to the event manager:

>>> ehm=MyViewer.cameras[0].eventManager

The eventManager is a property of an individual camera.  You can get a complete listing off all the callback functions bound to keys strokes existing in the event Manager at any time:

>>> ehm.ListBindings()

or the list of all callbacks bound to any specific key stroke:

>>> ehm.ListBindings('<Button-1>')
 

Predefined callback functions can be added to specific key strokes in the camera:

>>> def mycallback1(event):
...     print 'mycallback1 Event at %d %d' % (event.x, event.y)
 
>>> def mycallback2(event):
...     print 'mycallback2 Event at %d %d' % (event.x, event.y)

>>> ehm.AddCallback("<F1>", mycallback1)

Note that the callback function must have 'event' as its parameter and the key stroke must occur with the cursor over the camera.  AddCallback adds this callback to whatever else may have been previously bound to this keystroke. Another function, SetCallback, replaces the previously bound funtions with the new one.  It returns a list of the previous callbacks which can be stored and restored.

>>> funcList = ehm.SetCallback("<F1>", mycallback2)
 

Now, funcList is a list of what was previously bound to <F1>:
 
>>> funcList

[<function mycallback1 at 102d1788>]
 

and mycallback2 is bound to F1.  mycallback1 could be restored as follows:

>>>  ehm.SetCallback("<F1>", funcList)

Callback functions can be removed:

>>>  ehm.RemoveCallback("<F1>", funcList)