


                                  - 1 -



       COMMAND

       iiiimmmmaaaaggggeeee ---- ppppeeeerrrrffffoooorrrrmmmm ddddiiiiggggiiiittttiiiizzzziiiinnnngggg ssssccccaaaannnn

       USAGE

       iiiimmmmaaaaggggeeee [----yyyywwwwrrrrdddd] [_r_a_w_f_i_l_e] [_s_e_c_o_n_d_s]

       DESCRIPTION

       This is the command which actually performs the digitizing
       operation.  For most purposes the command is given without
       arguments.  You will be prompted for an image name and when
       to start the scan.

       The following options are available:

       ----yyyy          Skip the prompts for name and ready.  The name
                   will default to that given in the startup
                   configuration file.  The scan will start
                   immediately unless delayed with the ----dddd option.

       ----wwww          Save the raw data in the format received from
                   the hardware in the file specified by _r_a_w_f_i_l_e.
                   A normal image is also made.  Useful when the
                   software is uncooperative and for debugging.

       ----rrrr          Instead of reading from the actual hardware,
                   take image data from _r_a_w_f_i_l_e.  Used with files
                   created with the ----wwww option.  The image
                   processing software is unaware of the
                   redirection caused by this handy debugging
                   option.

       ----dddd          Like the delay timer on your pocket camera.  The
                   image start will be delayed by 10 seconds, or
                   the amount specified in the _s_e_c_o_n_d_s argument.

       _r_a_w_f_i_l_e     The filename required for the ----rrrr and ----wwww options.
                   No filename expansion or path defaulting is
                   provided.

       _s_e_c_o_n_d_s     The number of seconds to delay.  Defaults to 10.

       The digitizer or motion platform must be at the home
       position.

       Except for cases where the ----rrrr option is specified, the
       digitizer will begin the scan operation.  The raw data from
       the video camera and control electronics is read into a raw
       image buffer.  This data is not yet corrected for optical











                                  - 2 -



       distortions or other effects of the optical geometry.  The
       raw image also contains synchronization and status data.

       The raw image is then processed into a range map type image
       using the variables defined in the configuration files.

       If any operational errors are detected the data is abandoned
       and no image is made.

       SEE ALSO

       Since the process of digitizing and processing the raw data
       into a range map relies on many variables the documentation
       in the appropriate set-up guide should be consulted if any
       changes need to be made.  The iiiimmmmaaaaggggeeee command expects to find
       parameters in the file defined by the startup configuration
       (environment) variable ECHO_OPTICAL_CONFIG.  Many
       operational problems can be attributed to this file.









































