1NGPSWK(3NCARG)                   NCAR GRAPHICS                  NGPSWK(3NCARG)
2
3
4

NAME

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

SYNOPSIS

11       CALL NGPSWK(PSTYPE, ORIENT, COLOR)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       void c_ngpswk(char *pstype, char *orient, char *color)
17

DESCRIPTION

19       PSTYPE      (an input variable of type CHARACTER) specifying the type
20                   of the PostScript file.  It can be one of:
21
22                   'PS'     regular PostScript
23
24                   'EPS'    Encapsulated PostScript (can have only a single
25                            picture).
26
27                   'EPSI'   Encapsulated PostScript Interchange format (an EPS
28                            file containing a preview bitmap).
29
30       ORIENT      (an input variable of type CHARACTER) specifying the
31                   orientation of the output plot.  It can be one of:
32
33                   'PORTRAIT'      portrait orientation (long side of page is
34                                   vertical).
35
36                   'LANDSCAPE'     landscape orientation (long side of the
37                                   page is horizontal).
38
39       COLOR       (an input variable of type CHARACTER) specifying whether
40                   the plot will be color or monochrome.  It can be one of:
41
42                   'MONOCHROME'       the plot with be plotted with all
43                                      graphics objects being plotted using the
44                                      foreground color.
45
46                   'COLOR'            the plot will be plotted using color, if
47                                      available, or intensities obtained from
48                                      the NTSC color to black-and-white
49                                      intensity mapping if gray-scale is
50                                      available.
51

C-BINDING DESCRIPTION

53       The C binding argument descriptions are the same as the FORTRAN
54       argument descriptions.
55

USAGE

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

EXAMPLES

63       The invocation:
64
65               IWK = NGPSWK('EPS', 'LANDSCAPE', 'COLOR')
66
67       would return the value "27" for IWK.  This is the workstation type that
68       would be used as the third argument in a call to the GKS function GOPWK
69       for a workstation that would produce Encapsulated color Postscript in
70       landscape mode.
71

ACCESS

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

MESSAGES

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

SEE ALSO

84       Online: gopwk(3NCARG), ncarg_gks(3NCARG), ncarg_cbind(3NCARG)
85
86       Online URL:  http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
87
88       Hardcopy: NCAR Graphics Fundamentals, UNIX Version;
89

91       Copyright (C) 1987-2009
92       University Corporation for Atmospheric Research
93       The use of this Software is governed by a License Agreement.
94
95
96
97UNIX                              April 1994                    NGPSWK(3NCARG)
Impressum