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-2007
92       University Corporation for Atmospheric Research
93
94       This documentation is free software; you can redistribute it and/or
95       modify it under the terms of the GNU General Public License as
96       published by the Free Software Foundation; either version 2 of the
97       License, or (at your option) any later version.
98
99       This software is distributed in the hope that it will be useful, but
100       WITHOUT ANY WARRANTY; without even the implied warranty of
101       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
102       General Public License for more details.
103
104       You should have received a copy of the GNU General Public License along
105       with this software; if not, write to the Free Software Foundation,
106       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
107
108
109
110UNIX                              April 1994                    NGPSWK(3NCARG)
Impressum