NAME

screenload − load frame buffer image from file

SYNOPSIS

screenload [ −dpr ] [ −f framebuffer ] [ −bgw ] [ −h count data ... ] [ −i color ] [ file ]

DESCRIPTION

Screenload reads the Sun standard rasterfile file (see /usr/include/rasterfile.h) and displays its contents on a frame buffer. Screenload is able to display monochrome images on a color display, but cannot display color images on a monochrome display.  If the input file contains a color image, a frame buffer has not been explicitly specified, and /dev/fb is a monochrome frame buffer, screenload will look for a color frame buffer with one of the standard names. 

If the image contained in the input file is larger than the actual resolution of the display, screenload clips the right and bottom edges of the input image.  If the input image is smaller than the display (for example, loading an 1152-by-900 image on a 1600-by-1280 high resolution display), screenload centers the image on the actual workstation screen and fills the border area with solid black (by default).  Various options may be used to change the fill pattern. 

OPTIONS

−d Print a warning message if the display size does not match the rasterfile image. 

−p Wait for a newline to be typed on the standard input before exiting. 

−r Reverse the foreground and background of the output image.  Useful when loading a screendump made from a reverse video screen. 

−f framebuffer
Display the image on the specified frame buffer device (default /dev/fb).

−b Fill the border area with a pattern of solid ones (default).  On a monochrome display this results in a black border; on a color display the color map value selected by the −i option determines the border color. 

−g Fill the border area with a pattern of “desktop grey”.  On a monochrome display this results in a border matching the default background pattern used by SunView; on a color display the color map value selected by the −i option determines the foreground border color, though the pattern is the same as on a monochrome display. 

−w Fill the border area with a pattern of solid zeros.  On a monochrome display this results in a white border; on a color display the color map value at index 0 determines the border color. 

−h count data ... 
Fill the border area with the bit pattern described by the following count 16-bit hexadecimal constants.  Note that a “1” bit is black and a “0” bit is white on the monochrome display; on a color diplay the color map value selected by the −i option determines the border foreground color.  The number of hex constants in the pattern is limited to 16. 

−i color
Fill the border area with the given color value (default 255).

EXAMPLES

tutorial% screenload saved.display.image
loads the raster image contained in the file saved.display.image on the display type indicated by the rasterfile header in that file. 

tutorial% screenload −f/dev/cgtwo0 monochrome.image
reloads the raster image in the file monochrome.image on the color frame buffer device /dev/cgtwo0. 

tutorial% screenload −h1 ffff small.saved.image
is equivalent to the −b option (fill border with black), while

tutorial% screenload −h4 8888 8888 2222 2222 small.saved.image
is equivalent to the −g option (fill border with desktop grey). 

FILES

/usr/lib/rasfilters/∗Filters for non-standard rasterfile formats

SEE ALSO

rasfilter8to1(1), rastrepl(1), screendump(1), screenload(1)

File I/O Facilities for Pixrects in Pixrect Reference Manual

Sun Release 3.2  —  Last change: 16 January 1987