NAME

screenload − restore frame buffer image

SYNOPSIS

screenload [ −d ] [ −f display ] [ −iindex ] [ −b ] [ −g ] [ −p ] [ −w ] [ −hhex-constants [ input-file ]

DESCRIPTION

Screenload accepts input in Sun standard rasterfile format (see /usr/include/rasterfile.h) and attempts to display the input on the appropriate monitor (monochrome or color). Screenload normally displays rasterfiles on the console display, but displays them on some heuristically determined color display if it finds no console display.  Screenload displays color rasterfiles only on a color monitor.  Screenload is able to display monochrome rasters on a color display. 

If the dimensions of the image contained in the input data are smaller than the actual resolution of the display (for example, loading a 1024-by-800 Sun-1 image on a 1152-by-900 Sun-2 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. 

If the dimensions of the image contained in the input data are larger than the actual resolution of the display, screenload clips the right and bottom edges of the input image. 

If there is an optional filename argument, screenload reads its input data from that file.  If no filename argument is given, screenload reads its input data from the standard input. 

The utility program screendump creates Sun standard rasterfiles from the display on a Sun Workstation monitor. 

OPTIONS

−dVerify that display dimensions and input data image dimensions match, and print warning messages if they do not. 

−f display
Use display as the name of the frame buffer device. 

−iindex
If the image is smaller than the display, use index (0 <= index < 256) as the index value into the color map for the foreground color of the border fill pattern.  The default index value is 255. 

−bIf the input data dimensions are smaller than the display dimensions, fill the border 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. 

−gIf the input data dimensions are smaller than the display dimensions, fill the border with  a pattern of “desktop grey”.  On a monochrome display this results in a border matching the 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. 

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

−wIf the input data dimensions are smaller than the display dimensions, fill the border 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. 

−hhex-constants
If the input data dimensions are smaller than the display dimensions, fill the border with the bit pattern described by the following # 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. 

EXAMPLES

tutorial% screenload saved.display.image reloads 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/cgone0 monochrome.image reloads the raster image in the file monochrome.image on the frame buffer device /dev/cgone0. 

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

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

FILES

/dev/fb Default name of console display frame buffer
/dev/cgone0Default name of Sun-1 color display frame buffer
/dev/cgtwo0Default name of the Sun-2 color display frame buffer. 
/usr/lib/rasfilters/∗Filters for the raster file

SEE ALSO

screendump(1)
pr_load in SunView Programmer’s Guide and SunView System Programmer’s Guide

Sun Release 3.2  —  Last change: 6 February 1985