NAME

       NGPSWK - returns the workstation type, suitable for use as the third argument in a call to the NCAR GKS
       routine GOPWK, for the PostScript workstation whose attributes are specified in the function arguments.

SYNOPSIS

       CALL NGPSWK(PSTYPE, ORIENT, COLOR)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ngpswk(char *pstype, char *orient, char *color)

DESCRIPTION

       PSTYPE      (an  input variable of type CHARACTER) specifying the type of the PostScript file.  It can be
                   one of:

                   'PS'     regular PostScript

                   'EPS'    Encapsulated PostScript (can have only a single picture).

                   'EPSI'   Encapsulated PostScript  Interchange  format  (an  EPS  file  containing  a  preview
                            bitmap).

       ORIENT      (an  input variable of type CHARACTER) specifying the orientation of the output plot.  It can
                   be one of:

                   'PORTRAIT'      portrait orientation (long side of page is vertical).

                   'LANDSCAPE'     landscape orientation (long side of the page is horizontal).

       COLOR       (an input variable  of  type  CHARACTER)  specifying  whether  the  plot  will  be  color  or
                   monochrome.  It can be one of:

                   'MONOCHROME'       the plot with be plotted with all graphics objects being plotted using the
                                      foreground color.

                   'COLOR'            the  plot  will  be  plotted  using  color,  if  available, or intensities
                                      obtained from the NTSC color to black-and-white intensity mapping if gray-
                                      scale is available.

C-BINDING DESCRIPTION

       The C binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       In specifying the arguments,  only  enough  characters  need  be  entered  so  that  the  values  can  be
       differentiated.   For  example,  to  specify  color, using 'C' as the third argument would be sufficient.
       Either upper case or lower case is accepted.

EXAMPLES

       The invocation:

               IWK = NGPSWK('EPS', 'LANDSCAPE', 'COLOR')

       would return the value "27" for IWK.  This is the workstation type  that  would  be  used  as  the  third
       argument  in  a  call  to  the GKS function GOPWK for a workstation that would produce Encapsulated color
       Postscript in landscape mode.

ACCESS

       To use NGPSWK or c_ngpswk, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably  in
       that order.

MESSAGES

       Warning  messages  will  be  issued if one calls NGPSWK with unrecognizable arguments.  The value 'PS' is
       used if the first argument is unrecognized; the value 'PORTRAIT'  is  used  if  the  second  argument  is
       unrecognized; the value 'COLOR' is used if the third argument is unrecognized.

SEE ALSO

       Online: gopwk(3NCARG), ncarg_gks(3NCARG), ncarg_cbind(3NCARG)

       Online URL:  http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version;

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               April 1994                                     NGPSWK(3NCARG)