PIXBLEND(1)

NAME

pixblend - blend two pix(5) or bw(5) images

SYNOPSIS

pixblend [-[r | i] value] [-s seedval] [-S] [-g gvalue] file1.pix file2.pix > out.pix

DESCRIPTION

pixblend, given two streams of data, typically pix(5) or bw(5) images, generates a "blended" output stream of the same size. This routine operates on a pixel-by-pixel basis, and thus is independent of the resolution of the image. The type of blending performed is determined by the following options:

OPTIONS

-r VALUE

This specifies random blending; for each pixel of the output stream, a number will be chosen uniformly from the interval [0, 1]. If this number exceeds VALUE, then the pixel from the first image will be output; otherwise, the pixel from the second image will be output. Note that if VALUE is 0, then the output will equal the first image; if VALUE is 1, then the output will equal the second image.

-i VALUE

This specifies linear interpolation; for each pixel of the output stream, the interpolated pixel ((1.0 - VALUE) * pixel1
VALUE * pixel2) will be output (where pixel1 and pixel2 are the corresponding pixels from file1 and file2, respectively). Note that if VALUE is 0, then the output will equal the first image; if VALUE is 1, then the output will equal the second image.

-s SEEDVAL

Sets the random number seed to SEEDVAL (default is 0).

-S

Instructs pixblend to use bits from the clock as a random number seed.

-g GVALUE

Tells pixblend to "glitterize" the image; if the random draw for a pixel is below GVALUE, then the pixel output is white; otherwise, the pixel used is determined by the ratio set with the -r option (see above).

EXAMPLES

pixblend -i .25 source.pix destination.pix > out.pix

pixblend -r .75 source.pix destination.pix > out.pix

pixblend -r .5 -s source.pix destination.pix > out.pix

pixblend -r .5 -s 23 source.pix destination.pix > out.pix

AUTHOR

BRL-CAD Team

This software is Copyright (c) 1989-2021 by the United States Government as represented by U.S. Army Research Laboratory.

BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org