Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PIXBLEND(1)			    BRL-CAD			   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

SEE ALSO
       brlcad(1), gencolor(1), pix(5), bw(5)

AUTHOR
       BRL-CAD Team

COPYRIGHT
       This software is	Copyright (c) 1995-2019	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

BRL-CAD				  03/02/2021			   PIXBLEND(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHOR | COPYRIGHT | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pixblend&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help