|pixshrink [-s squareinsize] [-w in_width] [-n in_height] [-f shrink_factor] [-h] [-u] [infile.pix] > outfile.pix|
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 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).
brlcad(1), pixcrop(1), pixrect(1), pixinterp2x(1), pixscale(1), pix(5).
If the dimensions of the input image are not evenly divisible by the shrink factor, incorrect and bizarre output is generated.
This software is Copyright (c) 1990-2013 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 <email@example.com>.