## Name

pixhist — display a histogram of a color pix file on a framebuffer

## Synopsis

`pixhist` [-v ] [`file.pix`]

## DESCRIPTION

Pixhist displays a histogram of the pixel values of the given pix(5) format file, or, if no file is specified, will read from standard in. The environment variable `FB_FILE` is used to select the display device (see brlcad(1)). If this variable is not set, the default device for your system will be used.

The relative frequency is displayed on the x axis scaled so that the maximum is full screen. The value 0 is at the bottom of the screen, 255 is at the top. All three colors will be drawn on each scan line, and all are scaled by the same factor. The output is overlaid on whatever is currently on the display.

The `-v` flag will also output the histogram values on the terminal.

## SEE ALSO

brlcad(1), pixhist3d(1), pixstat(1), pix(5)

## BUGS

This program assumes it has at least 512 lines in y to work with.

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