
warpimage(1)                 Khoros                  warpimage(1)

PROGRAM
     warpimage - An interactive image warping application

SYNTAX
     warpimage

     [-src]         input source image

     [-target]      input target image

     [-tp_mode]     selection type :
                    1 (Select Source & Destination),
                    or 2 (Select Source Only)
                       [default = 1]

     [-fn]          Specifies the font for warpimage (use %
                    xlsfonts for available fonts)

     [-jr file.jp]  Creates a journal recording for warpimage

     [-jp file.jp]  Executes a journal playback for warpimage

     [-V]           Gives the version for warpimage

     [-U]           Gives the usage for warpimage

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called warpimage.ans
                    or file1

     [-a [file1]]   Uses warpimage.ans or file1 as the answer
                    file

DESCRIPTION
     Warpimage is a new, experimental program which allows one to
     create tiepoints in a source image and target image, and
     warp the source image based on the tiepoint selections. War-
     pimage takes all tiepoints and performs a least-squares- fit
     to produce four tiepoints. Then the source image is warped
     using a second order polynomial and bilinear interpolation.
     The coefficients are are generated by vbilinco and the warp-
     ing is performed by vwarp.  warpimage is still in a state of
     development;  however, it is made available at this release
     of Khoros for those who may find it useful.  Source and tar-
     get images may be provided at the time of execution, or may
     be input once the warpimage program is already started.

     Warpimage has two modes of operation. One mode (-tp_mode 1)
     allows both a source and a target image for input. In this
     mode the user will select both a source tiepoint in the
     source image and a target tiepoint in the target image. When
     the tiepoint in the source image is placed it will be red.
     Once its corresponding target tiepoint is placed in the tar-
     get image, both tiepoints will turn green.

     The other mode (-tp_mode 2) only allows for a source image.
     The user has the ability to add only source tiepoints. In
     this mode the user can not generate coefficients or warp the
     image becasue target tiepoints do not exist.

     Warpimage provides mechanisms to add, delete and move
     tiepoints. Also, tiepoints themselves, coefficients gen-
     erated from the tiepoints by vbilinco and the resulting
     warped image may be saved. Also, saved tiepoints may be read
     in. Also, warpimage provides a method for viewing and edit-
     ing (moving) the tiepoints. The VIEW button on the main war-
     pimage form will pop up a list of tiepoints when clicked on.

REQUIRED ARGUMENTS
     none

OPTIONAL ARGUMENTS
     -src   type: infile
            desc: input source image

     -target
            type: infile
            desc: input target image

     -tp_mode
            type: integer
            desc: selection type
            allowed values:
            1 (Select Source & Destination),
            or 2 (Select Source Only)

EXAMPLES
     warpimage -src img.xv -target ele.xv

     warpimage

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lwarpimage(3)
     editimage(1), viewimage(1)

RESTRICTIONS
     Warpimage is in its infancy. There are many limitations in
     this application at the present time. Some of these limita-
     tions include:

     1.   If a new color image is read in, this new image may
          steal the colors from the user interface. This will
          result in an all black user interface.

     2.   If the image is larger than 400x400, a pan box will
          come up to roam around in the image. If the zoom type
          is set to rubberband, after panning the zoom rectangle
          may not appear on the image. To get the retangle to
          redisplay move the pan box slightly.

     3.   When running warpimage with the -tp_mode 2 argument,
          coefficients cannot be generated nor can the source
          image be warped.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

