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

FreeBSD Manual Pages

  
 
  

home | help
BWSCALE(1)		     BRL-CAD User Commands		    BWSCALE(1)

NAME
       bwscale - change	the size of a black and	white bw file

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

DESCRIPTION
       bwscale Bwscale will take a black and white bw(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.

       By default, 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 doubling the	size of	a file,	for example, 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.

       The -h flag causes the frame buffer to be used in high-resolution mode
       (1024 x 1024). 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), bwcrop(1), bwrect(1),	bw(5), pixscale(1)

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

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

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

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

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

home | help