Name
fbstretch — stretch a frame buffer image
Synopsis
fbstretch
[ -f input_image_name
] [ -s input_square_size
] [ -w input_width
]
[ -n input_height
] [-a ] [ -x horizontal_scale
factor
] [ -y vertical_scale
factor
]
[-v ] [ -S output_square_size
] [ -W output_width
] [ -N output_height
]
[[-F ] output_frame_buffer
name
]
DESCRIPTION
fbstretch
expands or compresses a frame buffer image,
in either or both the horizontal and vertical directions.
The image scaling origin (fixed point) is
the lower left-hand corner of the display.
When expanding (scale factor greater than 1), pixels are simply replicated;
when compressing (scale factor less than 1), pixel averaging is performed
unless sampling is explicitly requested by the
-a
option.
The default input image size is 512 by 512. Explicitly specified sizes override the default, and if actual input image size is smaller than requested, the actual size will be used. If not specified, requested output frame buffer size will be the stretched revised input size. If there are margins within the requested output beyond the stretched image, they will be cleared to background; if the stretched image would extend beyond the requested output size, it will be clipped to fit, even if there is room for it in the actual frame buffer. Actual sizes depend on details of specific frame buffers.
Options
- -f input_image_name
Inputs the image to be displayed from the specified frame buffer or pix(5) file, instead of modifying the output frame buffer in place. This option may not work if input and output frame buffers are the same device.
- -s input_square_size
Specifies input image width and height.
- -w input_ width
Specifies input image width.
- -n input_height
Specifies input image height.
- -a
(no averaging) Specifies that output pixels will be sampled from the input, instead of being computed by averaging RGB values.
- -v
(verbose) Causes actual sizes and scale factors used to be printed on the standard error output.
- -x horizontal_scale_factor
Scales the image by the specified factor in the horizontal direction; the default is the ratio of requested output to input widths, if specified, otherwise 1.
- -y vertical_scale_factor
Scales the image by the specified factor in the vertical direction; the default is the ratio of requested output to input heights, if specified, otherwise 1.
- -S output_square_size
Specifies output frame buffer width and height.
- -W output_width
Specifies output frame buffer width.
- -N output_height
Specifies output frame buffer height.
- -F output_frame_buffer_name
Outputs to the specified frame buffer instead of the one specified by the
FB_FILE
environment variable (or the default, ifFB_FILE
is not set). If this is the last option specified, the-F
is optional.
DISCUSSION
Pixel averaging may be meaningless for some images or color maps, in which case sampling should be specified. Images of the Mandelbrot set (see mandel(1)) are a good example of this.
EXAMPLE
The following procedure enlarges an image, obtained from a personal computer via the gif-fb utility, to fill a 1280-by-1024 frame buffer.
$ gif-fb image.gif # displays the 320x200 PC image
$ fbstretch -w 320 -n 200 -W 1280 -N 1024