
        \\\\\\\\\\\\\\\\\\\\ ///////////////////////

        example programs dealing with 3D imaging

        //////////////////// \\\\\\\\\\\\\\\\\\\\\\

1.putimage3d

   This program displays 3D data as 3 orthogonal slices.  It puts up
   a display that looks like this:
 
    -------------------------------------------
    |                                         |
    |  ------------------------  -----------  |
    |  |                      |  |         |  |
    |  |    Z image:          |  | X image:|  |
    |  |                      |  |         |  |
    |  |   displays volume    |  | displays|  |
    |  |         as           A  |  volume |  |
    |  |   (width X height)   |  |   as    |  |
    |  |                      |  |(depth X |  |
    |  |                      |  | height) |  |
    |  |                      |  |         |  |
    |  |                      |  |         |  |
    |  ----------B------------|  ----------|  |
    |  -----------------------                |
    |  |    Y image:         |                |
    |  | displays volume as  |   (position)   |
    |  |  (width x depth)    |                |
    |  -----------------------                |
    |_________________________________________|
 
 
    To help in picturing the volume, imagine the X image to the right as 
    folded into the screen by 90 degrees, from the right edge of the Z image
    marked A;  imagine the Y image as folded into the screen by 90 degrees,
    from the bottom edge of the Z image marked B. Thus, the display represents
    half of a cube that has been "flattened" onto the screen.
 
    When you click in any of the images, the position object will indicate 
    the value at that position, where the dimensions are specified by the 
    image you clicked in -- it is (width x height) in the Z image, 
    (depth x height) in the X image, and (width x depth) in the Y image.
 
    Event handlers are installed on each of the images so that if you click
    anywhere in an image, the other two images will be updated so as to
    display that same location from the other two views.


