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

NAME

6       NCAR Graphics GKS C-binding - Description of how to use the NCAR Graph‐
7       ics GKS C-binding.
8

SYNOPSIS

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
18       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
24       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
95
96       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
101       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

ARGUMENT LISTS

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

FUNCTION PROTOTYPES

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

COMPILING YOUR PROGRAM

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
127       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

EXAMPLES

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

SEE ALSO

137       Online: ncarg_cbind(3NCARG), ncargex(1NCARG), ncargintro(5NCARG).
138
139       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
146       The use of this Software is governed by a License Agreement.
147
148
149
150NCAR                             February 1993         NCARG_GKS_CBIND(3NCARG)
Impressum