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. Warpimage 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 warping 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 target 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 target 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 generated 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 editing (moving) the tiepoints. The VIEW button on the main warpimage 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 limitations 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.