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

FreeBSD Manual Pages

  
 
  

home | help
PIXMERGE(1)			    BRL-CAD			   PIXMERGE(1)

NAME
       pixmerge	- merge	two pix(5) or bw(5) images by a	formula

SYNOPSIS
       pixmerge	[-glen]	[-w bytes_wide]	[-C r/g/b] foreground.pix
		background.pix _ out.pix

DESCRIPTION
       pixmerge	Given two streams of data, typically pix(5) or bw(5) images,
       generate	an output stream of the	same size, where the value of the
       output is determined by a formula involving the first (foreground)
       stream and a constant, or the value of the second (background) stream.
       This routine operates on	a pixel-by-pixel basis,	and thus is
       independent of the resolution of	the image. More	sophisticated
       processing can be performed by the pixmatte program.

       The formula can be any combination of -g	(fg greater than bg), -l (fg
       less than bg), -e (fg equal to bg), -n (fg not equal to bg). For
       example,	-le selects a foreground pixel when it is lexically less than
       or equal	to the background pixel, that is, when all bytes of the
       foreground pixel	are less than or equal to the background pixel.	The
       -w# flag	specifies the width (in	bytes) of each "pixel";	the default is
       3, i.e.	pix(5) file format. A width of 1 is used for processing	bw(5)
       files. It is unclear if other widths are	useful.	If the -C r/g/b	option
       is specified, then the constant color specified by r/g/b	is used	in
       place of	the appropriate	background pixel values. It is expected	that
       there will be up	to width slash-separated constants given as a single
       parameter here.

       If no formula is	specified, the default is to take all foreground
       pixels greater than black (all bytes zero), which can be	specified as:
       pixmerge	-g -C 0/0/0 fg.pix bg.pix

EXAMPLES
       gencolor	200 0 200 | pixmerge -g	-C 20/20/20 fg.pix - > out.pix

       pixbackgnd -t0 160 200 |	pixmerge -n -C 63/0/127	fg.pix - | pix-fb The
       second example is used to composite an rt(1) generated image on top of
       a shaded	background.

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

AUTHOR
       BRL-CAD Team

COPYRIGHT
       This software is	Copyright (c) 1989-2013	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				  07/08/2017			   PIXMERGE(1)

NAME | SYNOPSIS | DESCRIPTION | 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=pixmerge&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help