MMACH commands


PROGRAM NAME

vless - Informs if one image is less than the other

DESCRIPTION

vless compares two images pixel by pixel and informs if the second input image is always equal or less than the first input image, in wich case it returns a variable set to one, or set to zero otherwise. A constant image (that can be entered in the place of image 1 or 2) can be specified by an integer parameter.

The two input images must be of the same size and have the same number of data bands. The input images may be of the same or different data types. If the input images are of different data types, then all input images will be upcast to the highest input image data type.

REQUIRED ARGUMENTS

Mutually Exclusive Group; you must specify ONE of:

-i1
type: infile
desc: Upper level
default: {none}
OR
-u
type: integer
desc: upper level
default: 255
bounds: 0 < [-u] < 255

-v
type: string
desc: variable
-o
type: outfile
desc: The first input image

Mutually Exclusive Group; you must specify ONE of:

-i2
type: infile
desc: Lower level
default: {none}
OR
-l
type: integer
desc: lower level
default: 128
bounds: 0 < [-l] < 255

OPTIONAL ARGUMENTS

none

EXAMPLES

vless -i1 img1.xv -i2 img2.xv -v value

will check if "img2.xv" <= "img1.xv". If true, "value" will be 1, 0 otherwise.

SEE ALSO

vcast1(1)

RESTRICTIONS

vless is presently only implemented for byte images

REFERENCES

COPYRIGHT

Copyright (C) 1993-1997 Junior Barrera, Roberto Lotufo. All rights reserved.