Name: print_iv_pick  - Print Image Pick event structure

Author: Ian Curington, Advanced Visual Systems, Inc. Staines, UK

Synopsis: prints the contents of the image viewer "iv_pick" output.

Type:  Renderer

Source Files: print_iv_pick.c     source
              print_iv_pick.txt   doc
              print_iv_pick.net   test network
              Makefile (clean)    make

Inputs: struct iv_pick  (from image viewer)

Outputs: 4x integer output ports, for parameter use by network,
      X-View
      Y-View
      X-Image
      Y-Image

Parameters: Text Block Output messages

Description:

  Print the contents of the "iv_pick" output port of the AVS4
  image viewer module. This shows the results from picking on
  images with the left mouse button. It is a basic module
  showing the possibilities, and used for debugging of
  other image pick application modules.
  This module relies on features in AVS4, and will not function
  with earlier releases.
  This module will be useful for those building interactive
  image processing systems.

The AVS flow executive has a special case for effiently handling 
upstream flow. The print modules do not send anything
to the geometry viewer, and are hand-wired in afterwards,
so the flow exec bypasses them.

1. Have your probe and other upstream modules run at least once,
   so you know valid data is sitting at the GeomViewer output ports.

2. Get the print module to run, by tweeking a parameter (or add a
  one-shot "look" button, just to get it to fire. Or use the
  CLI to fire it, or make some port that you wire from an upstream
  module, like probe, so probe will fire the print module.

Test Network: print_iv_pick.net

        read_image
            |
        image_viewer
            |
        print_iv_pick
         |  |  |  |
       4x integer modules