1NCARG_GKS_CBIND(3NCARG) NCAR GRAPHICS NCARG_GKS_CBIND(3NCARG)
2
6 NCAR Graphics GKS C-binding - Description of how to use the NCAR Graph‐
7 ics GKS C-binding.
8
10 This section only briefly describes how to use the NCAR Graphics GKS C-
11 binding. If you intend to use the GKS C-bindings heavily, you may want
12 to get a copy of the American National Standard's "Computer Graphics -
13 Graphical Kernel System (GKS) - Functional Description". If you want
14 information on how to use the C-bindings for the NCAR Graphics utili‐
15 ties, please see ncarg_cbind(3NCARG) or the man page for any of the
16 NCAR Graphics routines.
17 The NCAR Graphics GKS C-binding adheres to the ISO/IEC standard. Only
19 the functions at level 0A have been implemented. At the time, not all
20 of these functions are supported; only the ones that have man pages
21 associated with them are supported. Below is a list of the currently
22 supported NCAR Graphics GKS C-bindings:
23 gaccum_tran_matrix
25 gactivate_ws
26 gcell_array
27 gclear_ws
28 gclose_gks
29 gclose_seg
30 gclose_ws
31 gcopy_seg_ws
32 gcreate_seg
33 gdeactivate_ws
34 gdel_seg
35 gescape
36 geval_tran_matrix
37 gfill_area
38 ginq_asfs
39 ginq_char_expan
40 ginq_char_ht
41 ginq_char_space
42 ginq_char_up_vec
43 ginq_clip
44 ginq_colr_rep
45 ginq_cur_norm_tran_num
46 ginq_fill_colr_ind
47 ginq_fill_int_style
48 ginq_fill_style_ind
49 ginq_line_colr_ind
50 ginq_linetype
51 ginq_linewidth
52 ginq_marker_colr_ind
53 ginq_marker_size
54 ginq_marker_type
55 ginq_max_norm_tran_num
56 ginq_name_open_seg
57 ginq_norm_tran
58 ginq_op_st
59 ginq_set_seg_names
60 ginq_text_align
61 ginq_text_colr_ind
62 ginq_text_font_prec
63 ginq_text_path
64 gopen_gks
65 gopen_ws
66 gpolyline
67 gpolymarker
68 gsel_norm_tran
69 gset_asfs
70 gset_char_expan
71 gset_char_ht
72 gset_char_space
73 gset_char_up_vec
74 gset_clip_ind
75 gset_colr_rep
76 gset_fill_colr_ind
77 gset_fill_int_style
78 gset_fill_style_ind
79 gset_line_colr_ind
80 gset_linetype
81 gset_linewidth
82 gset_marker_colr_ind
83 gset_marker_size
84 gset_marker_type
85 gset_seg_tran
86 gset_text_align
87 gset_text_colr_ind
88 gset_text_font_prec
89 gset_text_path
90 gset_vp
91 gset_win
92 gtext
93 gupd_ws
94 Please see the man page for any of these for more information on that
97 particular function. In the future, as higher level GKS Fortran func‐
98 tions are implemented, there may be C-bindings created for them as
99 well.
100 Notice that since the NCAR Graphics GKS C-binding adheres to the stan‐
102 dard, the names for the C-bindings are not like the Fortran names.
103 Instead, the functions names are more descriptive, like
104 gset_fill_colr_ind which corresponds to the Fortran GKS routine GSFACI.
105 If you know the name of the Fortran GKS routine and you need the C-
106 binding name, you can look at the man page for the Fortran routine to
107 get the name of the C-binding routine.
108
110 The argument list of each GKS C-binding closely corresponds with the
111 argument list of the Fortran routine, but in many cases, the arguments
112 are represented in the form of a C structure. These structures are
113 defined in the include file <ncarg/gks.h>.
114
116 The GKS C-bindings are intended to be ANSI C compliant. To get the
117 correct function prototypes, include <ncarg/gks.h> in your C program.
118
120 To compile your NCAR Graphics C program with the GKS C-bindings, use
121 the application ncargcc. ncargcc will take care of loading in the nec‐
122 essary C/Fortran interface libraries as well as the NCAR Graphics C and
123 Fortran libraries. You will either need to set the NCARG_ROOT or the
124 NCARG_BIN, NCARG_LIB, and NCARG_INCLUDE environment variables in order
125 to run ncargcc. See "man ncargintro" for more information.
126 If you do not wish to use ncargcc, then you can just run it with no
128 arguments to see what the necessary libraries are, and then put this in
129 your Makefile or whatever else you are using to compile your program.
130
132 An example of a C program that calls some of the NCAR Graphics GKS C-
133 bindings has been provided. To copy this C program into your direc‐
134 tory, and then compile, link, and run it, type ncargex c_gtxpac.
135
137 Online: ncarg_cbind(3NCARG), ncargex(1NCARG), ncargintro(5NCARG).
138 Hardcopy: NCAR Graphics Fundamentals, UNIX Version User's Guide for
140 NCAR GKS-0A Graphics
141
143 Copyright (C) 1987-2002
144 University Corporation for Atmospheric Research
145 This documentation is free software; you can redistribute it and/or
147 modify it under the terms of the GNU General Public License as pub‐
148 lished by the Free Software Foundation; either version 2 of the
149 License, or (at your option) any later version.
150 This software is distributed in the hope that it will be useful, but
152 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
153 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
154 Public License for more details.
155 You should have received a copy of the GNU General Public License along
157 with this software; if not, write to the Free Software Foundation,
158 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
159NCAR February 1993 NCARG_GKS_CBIND(3NCARG)