Section 3: library functions
GQCHH (Inquire character height) – retrieves the current character height. SynopsisCALL GQCHH (ERRIND, CHH) C-Binding Synopsis#include <ncarg/gks.h> void ginq_char_ht(Gint *err_ind, Gdouble *char_ht); DescriptionERRIND (Integer, Output) – If the inquired value cannot be returned correctly, a non-zero error indicator is returned in ERRIND, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A Graphics" for…
GQASF – (Inquire aspect source flags) – Inquires the values for the aspect source flags that determine whether primitive attributes are to be selected from individual settings or from "bundle tables". SynopsisCALL GQASF (ERRIND,LASF) C-Binding Synopsis#include <ncarg/gks.h> void ginq_asfs(Gint *err_ind, Gasfs *list_asf); DescriptionERRIND (Integer, Output) – If the inquired value cannot be returned correctly, a…
gpolymarker (Polymarker) – the polymarker output primitive draws selected symmetric symbols to mark user-specified coordinate positions. Synopsis#include <ncarg/gks.h> void gpolymarker(const Gpoint_list *point_list); Descriptionpoint_list.num_points (Gint, Input) – The number of markers to be drawn. Must be greater than zero. point_list.points (Gpoint *, Input) – The X and Y coordinates of the point_list.num_points markers to be drawn,…
gpolyline (Polyline) – This output primitive draws line segments connecting a sequence of user-specified coordinate pairs. Synopsis#include <ncarg/gks.h> void gpolyline(const Gpoint_list *point_list); Descriptionpoint_list.num_points (Gint, Input) – The number of points in the line to be drawn. Must be larger than one. point_list.points (Gint *, Input) – The X and Y coordinates (specified in world coordinates)…
GPM (Polymarker) – the polymarker output primitive draws selected symmetric symbols to mark user-specified coordinate positions. SynopsisCALL GPM (N, X, Y) C-Binding Synopsis#include <ncarg/gks.h> void gpolymarker(const Gpoint_list *point_list); DescriptionN (Integer, Input) – The number of markers to be drawn. N must be greater than zero. X (N) (Real Array, Input) – The X coordinates of…
GPL (Polyline) – This output primitive draws line segments connecting a sequence of user-specified coordinate pairs. SynopsisCALL GPL (N, X, Y) C-Binding Synopsis#include <ncarg/gks.h> void gpolyline(const Gpoint_list *point_list); DescriptionN (Integer, Input) – The number of points in the line to be drawn. N must be larger than one. X (N) (Real Array, Input) – The…
GOPWK (Open workstation) – opens a GKS workstation. SynopsisCALL GOPWK (WKID, CONID, WKTYPE) C-Binding Synopsis#include <ncarg/gks.h> void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type); DescriptionWKID (Integer, Input) – A number assigned to a workstation as an identifier that is to be used in all subsequent calls to GKS functions that require a workstation identifier. In…
GOPKS (Open GKS) – opens the GKS package SynopsisCALL GOPKS (ERRFIL, BUFA) C-Binding Synopsis#include <ncarg/gks.h> void gopen_gks(const char *err_file, size_t mem_unit); DescriptionERRFIL (Input, Integer) – The Fortran unit number to which error messages are to be written. Typically this should be unit 6. BUFA (Input, Integer) – The dimension of an internal buffer. Currently in…
gopen_ws (Open workstation) – opens a GKS workstation. Synopsis#include <ncarg/gks.h> void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type); Descriptionws_id (Input) – A number assigned to a workstation as an identifier that is to be used in all subsequent calls to GKS functions that require a workstation identifier. In NCAR GKS, ws_id can be any non-negative…
gopen_gks (Open GKS) – opens the GKS package Synopsis#include <ncarg/gks.h> void gopen_gks(const char *err_file, size_t mem_unit); Descriptionerr_file (Input) – The place to which error messages are to be written. Typically this should be "stdout". mem_unit (Input) – The dimension of an internal buffer. Currently in NCAR GKS-0A, mem_unit is ignored.UsageTo get output to any workstation,…
GKS – GKS (the Graphical Kernel System) is a set of low-level graphics functions that are standardized by the American National Standards Institute (ANSI) and the International Standards Institute (ISO). The collection of man pages in 3NCARG reflects those GKS functions documented in the NCAR UserDoc "User’s Guide for NCAR GKS-0A Graphics". This collection does…
ginq_text_path (Inquire text path) – retrieves the current text path. Synopsis#include <ncarg/gks.h> void ginq_text_path(Gint *err_ind, Gtext_path *text_path); Descriptionerr_ind (Output) – If the inquired value cannot be returned correctly, a non-zero error indicator is returned in err_ind, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A Graphics" for a description of the meaning of…
ginq_text_font_prec (Inquire text font and precision) – retrieves the current setting of the text font and precision values. Synopsis#include <ncarg/gks.h> void ginq_text_font_prec(Gint *err_ind, Gtext_font_prec *text_font_prec); Descriptionerr_ind (Output) – If the inquired values cannot be returned correctly, a non-zero error indicator is returned in err_ind, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A…
ginq_text_colr_ind (Inquire text color index) – retrieves the current text color index. Synopsis#include <ncarg/gks.h> void ginq_text_colr_ind(Gint *err_ind, Gint *text_colr_ind); Descriptionerr_ind (Output) – If the inquired value cannot be returned correctly, a non-zero error indicator is returned in err_ind, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A Graphics" for a description of the…
ginq_text_align (Inquire text alignment) – retrieves the horizontal and vertical text alignments. Synopsis#include <ncarg/gks.h> void ginq_text_align(Gint *err_ind, Gtext_align *text_align); Descriptionerr_ind (Output) – If the inquired values cannot be returned correctly, a non-zero error indicator is returned in err_ind, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A Graphics" for a description of the…
ginq_set_seg_names (Inquire set of segment names in use) – Retrieves what segment names are currently in use. Synopsis#include <ncarg/gks.h> void ginq_set_seg_names(Gint num_elems_appl_list, Gint start_pos, Gint *err_ind, Gint_list *seg_names, Gint *length_list); Descriptionnum_elems_appl_list (Input) – The number of elements in the application list you wish to request. start_pos (Input) – The first set member requested. err_ind (Output)…
ginq_op_st (Inquire operating state value) – returns the operating state of GKS. Synopsis#include <ncarg/gks.h> void ginq_op_st(Gop_st *op_st); Descriptionop_st (Output) – Returns the GKS operating state: GST_GKCL GKS is closed GST_GKOP GKS is open GST_WSOP Additionally, a workstation is open GST_WSAC Additionally, a workstation is active GST_SGOP Additionally, a segment is open AccessTo use the GKS…
ginq_norm_tran (Inquire normalization transformation) – retrieves the window and viewport associated with a given normalization transformation. Users of NCAR Graphics are encouraged to use the SPPS routines c_set and c_getset to handle normalization transformations instead of the GKS entries gset_win, gset_vp, gsel_norm_tran, and ginq_norm_tran. Synopsis#include <ncarg/gks.h> void ginq_norm_tran(Gint num, Gint *err_ind, Gtran *norm_tran); Descriptionnum (Input)…
ginq_name_open_seg (Inquire name of open segment) – returns the name of the currently open segment. Synopsis#include <ncarg/gks.h> void ginq_name_open_seg(Gint *err_ind, Gint *name_open_seg); Descriptionerr_ind (Output) – If the GKS state is SGOP (segment open), then err_ind is returned as "0"; otherwise err_ind is returned as "4". name_open_seg (Output) – If the GKS state is SGOP (segment…
ginq_max_norm_tran_num (Inquire maximum normalization transformation number) – retrieves the maximum number of supported normalization transformations. Synopsis#include <ncarg/gks.h> void ginq_max_norm_tran_num(Gint *err_ind, Gint *max_norm_tran_num); Descriptionerr_ind (Output) – If the inquired value cannot be returned correctly, a non-zero error indicator is returned in err_ind, otherwise a zero is returned. Consult "User’s Guide for NCAR GKS-0A Graphics" for a…