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
PIX-BW(1) BRL-CAD PIX-BW(1)

pix-bw - combine pix color planes into a bw black and white image

pix-bw [-s squaresize] [-w width] [-n height] [[-e ntsc|crt|hdtv|hdr|avg] [ [-R r_weight] [-G g_weight] [-B b_weight] ]] [-o out.bw] [[<]in.pix] > out.bw

pix-bw will combine or select the color planes of a pix(5) format file from its standard input and produce a black and white bw(5) file on its standard output.

The -w file_width flag specifies the width of each scanline in the input file, in pixels. The -n file_height flag specifies the height in scanlines of the input file. They are set to the same value using -s squarefilesize.

By default all three colors are weighted equally. The -e type flag can be used to specify a standard weighting scheme; the type choices include:

ntsc

Weighting used is based on the NTSC primaries and white alignment. Conforming with Rec.ITU-R BT.601-7, this uses 0.299/0.587/0.114 RGB weights. This gives a simplified linear conversion of perceived luminance that reflects human physiological sensitivity to green and least to blue.

crt

Weighting scheme matches "historic" CRT phosphor chromaticities and a D6500 white alignment. Uses 0.26/0.66/0.08 RGB weights.

hdtv

Weighting scheme matches "modern" HDTV display chromacities. Uses 0.2126/0.7152/0.0722 RGB weights per Rec.ITU-R BT.709

hdr

Weighting scheme matches high dynamic range (HDR) chromacities. Uses 0.2627/0.6780/0.0593 RGB weights per Rec.ITU-R BT.2020

avg

Weighting scheme simply takes the average of all three values (i.e., R + G + B / 3.0).

Individual color plane(s) can be selected via the -R#, -G#, and -B# options. The value used with each flag will be treated as a weight to be applied to that color.

If 0 is supplied by the user for weights, then the weights assigned are 1.0 divided by the number of colors selected.

pix-bw -R0.0 -B0.0 < file.pix > file.bw

will equally blend the red and blue color planes; because -G is omitted, the green color plane is not considered. (Had "-G0.0" been included in this example, the three colors would have been weighted equally, as in the default condition.)

pix-bw -R0.3 -G0.6 -B0.1 < file.pix > file.bw

applies weights close to the -ntsc flag.

brlcad(1), pix-bw3(1), bw-pix(1), pix(5), bw(5)

BRL-CAD Team

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

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

07/04/2025 BRL-CAD

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

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