GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PIXMERGE (1)

.ds Aq ’

NAME

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

CONTENTS

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>.

Search for    or go to Top of page |  Section 1 |  Main Index


BRL-CAD PIXMERGE (1) 04/04/2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.