PUBCAPTURE(1) — USER COMMANDS

NAME

pubcapture: A program for capturing screen images that is distributed with The Publisher.

SUNVIEW SYNOPSIS

pubcapture [-d delay ] [ -nolock ] [ -s width height ] [ -color | -nocolor ] file

X11 SYNOPSIS

pubcapture [-help] [-xwd] [-delay n] [-quiet] [-display host:display.screen] [-geometry spec] file

DESCRIPTION

PubCapture is a program for workstations running either X Window System, Version 11 or SunView and SunOS 3.2 or greater. It allows you to capture a screen image and save it in a file, which can be edited later with a paint program.

SUNVIEW OPTIONS

-d delay
delays taking snapshot by delay seconds after right mouse button is pressed. During this delay period the program goes to sleep and temporarily relinquishes control of the screen. When the sleep time expires, the program wakes up and beeps, then captures the selected area of the screen. PubCapture locks out screen access from all other programs during the capturing process.

-nolock
does not “lock” the screen when capturing the screen image. This must be specified if the image captured locks the screen itself upon display (eg, Suntools menus), otherwise PubCapture will wait indefinitely for the existing program to release the lock before capturing the image. Note that due to a Sun hardware bug, “-nolock” is not always reliable on some color systems; sometimes the resulting bitmap will appear thoroughly garbled. There is no universal solution at this time.

-s width height
allows you to specify initial box size, in pixels. Other units are allowed, eg: 2in 2in. Units available: pix, in, pt, pc, cm, mm (pixels, inches, points, picas, centimeters, millimeters).

-color | -nocolor
should be used when capturing an image on a color workstation as capturing an image on a color workstation yields a full color bitmap that is not directly usable by monochrome software. In this case, PubCapture transforms the colors to black-and-white by a sampling method quite similar to the rasfilter8to1 program. If “-color” is specified, PubCapture does not modify the image, leaving the filtering process to the end user. The default is “-nocolor”. This option has no effect on monochrome systems, i.e., strictly-monochrome monitors or when running on the monochrome overlay plane of a 10 bit graphics monitor. Be sure that suntools has been invoked with the -8bit_color_only option if “-nocolor” is specified.

fileis the Sun bitmap output file, ‘-’ means standard output.

SUNVIEW EXAMPLE

pubcapture -s 200 500 dump.pic

X11 OPTIONS

-helpproduces this message.

-xwdcauses the output file to be written in xwd format. Normally the output file is written in X11 bitmap file format.

-d delay
delays taking snapshot by delay seconds after right mouse button is pressed. During this delay period xpubcapture goes to sleep and temporarily relinquishes control of the screen. When the sleep time expires, the program wakes up and beeps, then captures the selected area of the screen.

-quietdoes not print status messages or prompts.

-display
uses the "display" and "screen" on "host". For example: -display hazel:0.0

-geometry
gives the initial size and/or position for the xpubcapture window where "spec" is [widthxheight][+x+y] where width and height are the width and height in pixels, x and y are the offsets of a corner of the window, the x between width and height is a literal x and either plus sign can be replaced with a minus sign to specify the lower or right corner rather than the left and upper corner. For example: -geometry 100x200+300-400 requests a window that is 100 pixels wide by 200 pixels tall and which has its left edge at position 300 and its bottom edge at position 400.

fileis the bitmap output file. ‘-’ means use the standard output.

Museum