PIXSHRINK(1)

NAME
pixshrink - shrink a color pix file

SYNOPSIS
pixshrink [-s squareinsize] [-w in_width] [-n in_height] [-f shrink_factor] [-h] [-u] [infile.pix] > outfile.pix

DESCRIPTION
Pixshrink will take a color pix(5) format file of given dimensions and produce a smaller scaled version. The -w and -n flags specify the input file width and number of scan lines in pixels. They can both be set to the same value via -s. Defaults of 512 are assumed for unspecified dimensions. The integer scaling factor is set with the -w flag. By default, the factor is 2. Thus, pixshrink forms the logical opposite of the pixinterp2x (1) program.

The program reads the entire image into memory, and then scales the image down by to 1/factor the original size in both dimensions. By default, pixshrink uses boxcar averaging to produce the output pixels from the input. The -u option causes pixshrink to use image undersampling instead.

The -h flag causes the frame buffer to be used in high resolution mode (1024x1024). This is important for frame buffers such as the Adage which operate differently depending on the display size. Without this flag the default size for the selected device will be used (usually the entire screen).

SEE ALSO
brlcad(1), pixcrop(1), pixrect(1), pixinterp2x(1), pixscale(1), pix(5).

BUGS
If the dimensions of the input image are not evenly divisible by the shrink factor, incorrect and bizzare output is generated.

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