Name:       mouse_trap_iv

Language:   C

Author:     Ian Curington
            ianc@avs.com

Source:     mouse_trap_iv.c

Inputs:     none
               (Direct X-window input used)
Outputs:    none
               (CLI communication used)
Parameters: none

Description:

The "Mouse Trap IV" module accesses the X-Window of the
Image Viewer display, and changes the mouse button definitions.
It intercepts all mouse events, and then selectively sends
commands on to AVS for action. This version ignores all normal
image viewer mouse controls, and causes special behavior instead.
The left button will "zoom in" the image, while
the right button will "zoom out" again, each by a preset amount.
It is intended as an AVS application developers example,
to create custom interface controls.
This module also shows how to change the mouse cursor shape
while over viewer window.
This is intended as a source example for further development work.

The implementation is to make an invisible input only window,
exactly covering the geometry viewer window.
Events from this invisible window are detected,
masking the geometry viewer window native events.
Commands are then sent via the CLI mechanism.
As a coroutine, this module can also take events from
user interface parameters, or send event information
to output ports, although none are present in this version.


Related modules: mouse_trap