st_grf(1) — UTek 4.0



STGRF(1)               COMMAND REFERENCE               STGRF(1)



NAME
     st_grf - convert Smalltalk window dump format to GRF format

SYNOPSIS
     stgrf -h
     stgrf [ -k colordefinitionsfile ] [ print_options ] file

DESCRIPTION
     The filter program stgrf converts a Smalltalk format file
     produced from a copy of the screen display into the Generic
     Raster Format (GRF) for printing on a Tektronix color
     printer.  The converted image file is written to standard
     output.  This utility is called by the screencopy command
     (see screencopy(1)) with the -S option to produce hard copy
     output for a color printer.

     While in the Smalltalk environment, the System Background
     Menu is used to dump the screen to a file.  This menu is
     available when the cursor is over the gray background (not
     in a window) and the middle mouse button is pressed.  The
     copydisplay menu choice can be used to copy the screen
     bitmap to a file; the user is prompted for the file name.
     The file containing the screen bitmap is then supplied to
     the stgrf utility for conversion to GRF either by invoking
     the screencopy -S -F file command or by invoking the stgrf
     command.

     See the Tektronix Smalltalk User's Manual for more
     information on the Smalltalk environment.

OPTIONS
     print_options
                  The print_options are the same as those used by
                  the screencopy command and are documented in
                  screencopy(1).

     -h           Generates an extended set of help messages for
                  the stgrf command.  No translation from
                  Smalltalk dump format to GRF is produced when
                  this option is given.

     -k colordefinitionsfile
                  Specifies a color definition file for stgrf to
                  use. This file contains an entry for each color
                  defined, consisting of the RGB value separated
                  by spaces or a tab with a character string used
                  for the color name.

                  The stgrf utility has the following colors
                  predefined: 255 0 0 red, 0 255 0 green, 0 0 255
                  blue, 0 255 255 cyan, 255 0 255 magenta, 255
                  255 0 yellow, 255 255 255 white, and 0 0 0



Printed 4/6/89                                                  1



STGRF(1)               COMMAND REFERENCE               STGRF(1)



                  black.

EXAMPLES
     This example translates a Smalltalk file into GRF and queues
     it to the default tcpr (tcpr(1mdqs)) Tektronix color
     printer.

          st_grf smalltalk_file >grf_file
          tcpr grf_file

     This example shows how to convert a Smalltalk file to GRF
     with grayshading image rendering and interpolation sizing
     on the Tektronix 4693D color printer.

     x_grf -e gray_shading -s interpolation -o 4693D smalltalk_file >grf_file

FILES
     /usr/lib/tcpr/grf_header.xxxx
                         Contains the default header for each of
                         the color printers, where xxxx is the
                         Tektronix 4692, 4693D, or 4696 printer.

     /usr/lib/tcpr/dbm_xxxx
                         Contains a data base of valid printer
                         options, where xxxx is a Tektronix 4692,
                         46923D, or 4696 color printer.  The
                         stgrf utility uses this file to check
                         for valid command line options for each
                         of the color printers and generate valid
                         GRF header tags.

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system
                    errors.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.





Printed 4/6/89                                                  2



STGRF(1)               COMMAND REFERENCE               STGRF(1)



SEE ALSO
     processing(1), screencopy(1), tcpr(1mdqs), x_grf(1),
     xwd(1x), dbm_469X(5), grf(5), and grf_header.469X(5).

REFERENCES
     For more information, consult the Tektronix Smalltalk Users
     Manual and the Users Manual for your system.
















































Printed 4/6/89                                                  3

%%index%%
na:284,111;
sy:395,400;
de:795,2062;
op:2857,2322;5535,76;
ex:5611,723;
fi:6334,897;
rv:7231,837;
se:8424,331;
re:8755,351;
%%index%%000000000157

Museum

Related Articles