Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PIXSCALE(1)			    BRL-CAD			   PIXSCALE(1)

NAME
       pixscale	- change the size of a color pix file

SYNOPSIS
       pixscale	[-h] [-r] [-s squareinsize] [-w	in_width] [-n in_height]
		[-S squareoutsize] [-W out_width] [-N out_height] [infile.pix]
		_ outfile.pix

DESCRIPTION
       Pixscale	will take a color pix(5) format	file of	given dimensions and
       produce a larger	or 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.	 Similarly, the	-W and -N flags
       specify the desired output 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 any unspecified dimensions.

       The algorithm used is bilinear interpolation if scaling up, and a box
       filter of arbitrary size	if scaling down. For the box filter a "square
       pixel" assumption is made; that is, all whole and fractional input
       pixels falling into a rectangle the size	of an output pixel contribute
       equally according to the	fraction of the	output pixel area they cover.
       When interpolating, the edge pixels are preserved, i.e. all of the
       interpolated pixels fall	inside of the edges. This can be a bit
       surprising when say doubling the	size of	a file as only the edge	pixels
       will fall at exactly the	location of an output pixel.

       Specifying the -r flag changes from bilinear interpolation to nearest
       neighbor	interpolation, i.e. it enlarges	the image by pixel
       replication.

       For 2X interpolation, a much faster alternative is pixinterp2x(1).

       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), pix(5).

BUGS
       This program cannot scale up in one dimension and down in the other at
       the same	time.  The box filter used for scaling down results in the
       usual high-frequency ripple.  Optional cubic interpolation would	be
       nice.

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

BRL-CAD				  07/08/2017			   PIXSCALE(1)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO | BUGS | AUTHOR | COPYRIGHT | BUG REPORTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pixscale&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help