Section 3: library functions
gset_char_expan (Set character expansion factor) – sets the width to height ratio of text. Synopsis#include <ncarg/gks.h> void gset_char_expan(Gdouble char_expan); Descriptionchar_expan (Input) – Specifies a deviation of the width to height ratio for characters drawn using the GTX output primitive. char_expan of 10.0 would specify a character that is 10 times as wide as normal. char_expan…
gset_asfs – (Set aspect source flags) – Sets the aspect source flags that determine whether primitive attributes are to be selected from individual settings or from "bundle tables". Synopsis#include <ncarg/gks.h> void gset_asfs(const Gasfs *list_asf); Descriptionlist_asf (input) – A structure of settings for the thirteen attributes: list_asfs.linetype Linetype list_asfs.linewidth Linewidth scale factor list_asfs.line_colr_ind Polyline color index…
GSELNT (Select normalization transformation) – selects a predefined or user-defined transformation that maps world coordinates to normalized device coordinates. SynopsisCALL GSELNT (TRNUM) C-Binding Synopsis#include <ncarg/gks.h> void gsel_norm_tran(Gint tran_num); DescriptionTRNUM (Integer, Input) – A normalization transformation number. The number of available transformations is implementation specific. In the case of NCAR GKS-0A, two normalization transformations are provided:…
gsel_norm_tran (Select normalization transformation) – selects a predefined or user-defined transformation that maps world coordinates to normalized device coordinates. Synopsis#include <ncarg/gks.h> void gsel_norm_tran(Gint tran_num); Descriptiontran_num (Input) – A normalization transformation number. The number of available transformations is implementation specific. In the case of NCAR GKS-0A, two normalization transformations are provided: 0 Selects the identity transformation…
GSCR (Set color representation) – associates a color value with a color index. SynopsisCALL GSCR (WKID, CI, CR, CG, CB) C-Binding Synopsis#include <ncarg/gks.h> void gset_colr_rep(Gint ws_id, Gint colr_ind, const Gcolr_rep *colr_rep); DescriptionWKID (Integer, Input) – A workstation identifier. WKID must be the same as that used in some previous GOPWK call. CI (Integer, Input) –…
GSCLIP (Set clipping indicator) – controls whether data are displayed outside the boundaries of the world coordinate window of the current normalization transformation. SynopsisCALL GSCLIP (ICLIP) C-Binding Synopsis#include <ncarg/gks.h> void gset_clip_ind(Gclip_ind clip_ind); DescriptionICLIP (Integer, Input) – A flag to turn clipping on or off. 0 Clipping is off. Data outside of the window will be…
GSCHXP (Set character expansion factor) – sets the width to height ratio of text. SynopsisCALL GSCHXP (CHXP) C-Binding Synopsis#include <ncarg/gks.h> void gset_char_expan(Gdouble char_expan); DescriptionCHXP (Real, Input) – Specifies a deviation of the width to height ratio for characters drawn using the GTX output primitive. CHXP of 10.0 would specify a character that is 10 times…
GSCHUP (Set character up vector) – specifies the angle at which subsequent text is to be drawn with GTX. SynopsisCALL GSCHUP (CHUX, CHUY) C-Binding Synopsis#include <ncarg/gks.h> void gset_char_up_vec(const Gvec *char_up_vec); DescriptionCHUX (Real, Input) – Gives the X (horizontal) world coordinate of a vector. CHUY (Real, Input) – Gives the Y (vertical) world coordinate of a…
GSCHSP (Set character spacing) – sets the character spacing for text. SynopsisCALL GSCHSP (CHSP) C-Binding Synopsis#include <ncarg/gks.h> void gset_char_space(Gdouble char_space); DescriptionCHSP (Real, Input) – Specifies how much additional white space should be inserted between characters drawn using the GTX output primitive. CHSP is specified as a fraction of the character height. A character spacing of…
GSCHH (Set character height) – sets the character height for text. SynopsisCALL GSCHH (CHH) C-Binding Synopsis#include <ncarg/gks.h> void gset_char_ht(Gdouble char_ht); DescriptionCHH (Real, Input) – Gives the height in world coordinates at which a character is drawn using the GTX output primitive. CHH > 0. By default CHH = 0.01.AccessTo use GKS routines, load the NCAR…
GSASF – (Set aspect source flags) – Sets the aspect source flags that determine whether primitive attributes are to be selected from individual settings or from "bundle tables". SynopsisCALL GSASF (LASF) C-Binding Synopsis#include <ncarg/gks.h> void gset_asfs(const Gasfs *list_asf); DescriptionLASF (Integer array, input) – An array of settings for the thirteen attributes: 1 Linetype 2 Linewidth…
GRIDL – Draws a labeled grid with each major division labeled with its numeric value. SynopsisCALL GRIDL (MJRX,MNRX,MJRY,MNRY) C-Binding Synopsis#include <ncarg/ncargC.h> void c_gridl (int mjrx, int mnrx, int mjry, int mnry) DescriptionMJRX, MNRX, MJRY, and MNRY (input expressions of type INTEGER) specify the major and minor divisions of the horizontal (X) and vertical (Y) axes…
Gridall_params – This document briefly describes all Gridall internal parameters. DescriptionGRIDAL has twenty-two internal parameters, each of which affects, in some way, the behavior of the routines that draw backgrounds. The current value of a parameter may be retrieved by calling GAGETC, GAGETI, and/or GAGETR and it may be reset by calling GASETC, GASETI, and/or…
Gridall – Allows one to draw backgrounds for X/Y plots. Included are routines for drawing grids, perimeters, and pairs of axes. Internal parameters of Gridall control such things as the color indices and line width scale factors used to draw various parts of the background, the formats to be used for labels, the sizes of…
GRIDAL – Draws any of the supported types of backgrounds. Each of the other background-drawing routines is implemented by a call to GRIDAL. UtilityThis routine is part of the Gridall utility in NCAR Graphics. To see the overview man page for this utility, type "man gridall". Synopsis CALL GRIDAL (MJRX, MNRX, MJRY, MNRY, IXLB, IYLB, IGPH, +…
GRID – Draws an unlabeled grid. SynopsisCALL GRID (MJRX, MNRX, MJRY, MNRY) C-Binding Synopsis#include <ncarg/ncargC.h> void c_grid (int mjrx, int mnrx, int mjry, int mnry) DescriptionMJRX, MNRX, MJRY, and MNRY (input expressions of type INTEGER) specify the major and minor divisions of the horizontal (X) and vertical (Y) axes of the current viewport. The meanings…
GQTXP (Inquire text path) – retrieves the current text path. SynopsisCALL GQTXP (ERRIND, TXP) C-Binding Synopsis#include <ncarg/gks.h> void ginq_text_path(Gint *err_ind, Gtext_path *text_path); 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…
GQTXFP (Inquire text font and precision) – retrieves the current setting of the text font and precision values. SynopsisCALL GQTXFP (ERRIND, FONT, PREC) C-Binding Synopsis#include <ncarg/gks.h> void ginq_text_font_prec(Gint *err_ind, Gtext_font_prec *text_font_prec); DescriptionERRIND (Integer, Output) – If the inquired values cannot be returned correctly, a non-zero error indicator is returned in ERRIND, otherwise a zero is…
GQTXCI (Inquire text color index) – retrieves the current text color index. SynopsisCALL GQTXCI (ERRIND, COLI) C-Binding Synopsis#include <ncarg/gks.h> void ginq_text_colr_ind(Gint *err_ind, Gint *text_colr_ind); 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…
GQTXAL (Inquire text alignment) – retrieves the horizontal and vertical text alignments. SynopsisCALL GQTXAL (ERRIND, TXALH, TXALV) C-Binding Synopsis#include <ncarg/gks.h> void ginq_text_align(Gint *err_ind, Gtext_align *text_align); DescriptionERRIND (Integer, Output) – If the inquired values cannot be returned correctly, a non-zero error indicator is returned in ERRIND, otherwise a zero is returned. Consult "User’s Guide for NCAR…