Section 3: library functions
gupd_ws (Update workstation) – Insures that the workstation is current and reflects all requests that have been made. Synopsis#include <ncarg/gks.h> void gupd_ws(Gint ws_id, Gupd_regen_flag upd_regen_flag); Descriptionws_id (Input) A number identifying the workstation to be updated. ws_id must be the same as that used in some previous gopen_ws call. upd_regen_flag (Input) A flag to specify if…
GTX (Text) – The basic output primitive for drawing text. A number of attribute setting routines are available for selecting the size, font, precision, orientation, color, character spacing, etc. SynopsisCALL GTX (X, Y, STRING) C-Binding Synopsis#include <ncarg/gks.h> void gtext(const Gpoint *text_pos, const char *char_string); DescriptionX (Real, Input) – The X world coordinate of the text…
gtext (Text) – The basic output primitive for drawing text. A number of attribute setting routines are available for selecting the size, font, precision, orientation, color, character spacing, etc. Synopsisvoid gtext(const Gpoint *text_pos, const char *char_string); Descriptiontext_pos.x (Gfloat, Input) The x world coordinate of the text alignment of the first character in char_string. text_pos.y (Gfloat,…
GSWN (Set window) – establishes a window, or rectangular subspace, of world coordinates to be plotted. Calls to GSWN are discouraged with NCAR Graphics. Instead, use the SET subroutine because SET also supports mirror imaging and log scaling of axes. SynopsisCALL GSWN (TRNUM, XMIN, XMAX, YMIN, YMAX) C-Binding Synopsis#include <ncarg/gks.h> void gset_win(Gint tran_num, const Glimit…
GSVP (Set viewport) – establishes a rectangular subspace of normalized device coordinates space. Calls to GSVP are discouraged with NCAR Graphics. Instead, use the SET subroutine because SET also supports mirror imaging and log scaling of axes. SynopsisCALL GSVP (TRNUM, XMIN, XMAX, YMIN, YMAX) C-Binding Synopsis#include <ncarg/gks.h> void gset_vp(Gint tran_num, const Glimit *vp_limits); DescriptionTRNUM (Integer,…
GSTXP (Set text path) – sets the text paths or directions in which text is to be drawn. SynopsisCALL GSTXP (TXP) C-Binding Synopsis#include <ncarg/gks.h> void gset_text_path(Gtext_path text_path); DescriptionTXP (Integer, Input) – Gives the direction in which a character string is to be drawn. Options are: 0 Draw successive characters in the string such that character…
GSTXFP (Set text font and precision) – sets the text font and precision. SynopsisCALL GSTXFP (FONT, PREC) C-Binding Synopsis#include <ncarg/gks.h> void gset_text_font_prec(const Gtext_font_prec *text_font_prec); DescriptionFONT (Integer, Input) – Specifies the text font to be used in subsequent calls to the GTX output primitive. Options are: 1 ASCII font (default) -2 Hershey cartographic Roman -3 Hershey…
GSTXCI (Set text color index) – sets the text color index. SynopsisCALL GSTXCI (COLI) C-Binding Synopsis#include <ncarg/gks.h> void gset_text_colr_ind(Gint text_colr_ind); DescriptionCOLI (Integer, Input) – A color index.UsageAll text strings drawn with calls to the GTX output primitive will be drawn with the color associated with index COLI until GSTXCI is called again and a new…
GSTXAL (Set text alignment) – sets the text alignment. SynopsisCALL GSTXAL (TXALH, TXALV) C-Binding Synopsis#include <ncarg/gks.h> void gset_text_align(const Gtext_align *text_align); DescriptionTXALH (Integer, Input) – Determines the horizontal alignment of the text to be drawn. Options are: 0 Normal (default) 1 Left 2 Center 3 RightTXALV (Integer, Input) – Determines the vertical alignment of the text…
GSSGT (Set segment transformation) – Associates a segment transformation with a named segment. SynopsisCALL GSSGT(SGNA,M) C-Binding Synopsis#include <ncarg/gks.h> void gset_seg_tran(Gint seg_name, const Gtran_matrix tran_matrix); DescriptionSGNA (Integer, Input) – A segment name as used in a previous GCRSG call. M (Real, Input) – A 2×3 array giving the GKS segment transformation to be associated with the…
GSPMCI – (Set polymarker color index) – sets the polymarker color index. SynopsisCALL GSPMCI (COLI) C-Binding Synopsis#include <ncarg/gks.h> void gset_marker_colr_ind(Gint marker_colr_ind); DescriptionCOLI (Integer, Input) – A color index.UsageAll polymarkers drawn with calls to the GPM output primitive will be drawn with the color associated with index COLI until GSPMCI is called again and a new…
GSPLCI (Polyline color index) – sets the polyline color index. SynopsisCALL GSPLCI (COLI) C-Binding Synopsis#include <ncarg/gks.h> void gset_line_colr_ind(Gint line_colr_ind); DescriptionCOLI (Integer, Input) – A color index.UsageAll lines drawn with calls to the GPL output primitive will be drawn with the color associated with index COLI until GSPLCI is called again and a new index is…
GSMKSC (Set marker size scale factor) – sets the polymarker size scale factor — the relative size of the marker. SynopsisCALL GSMKSC (MSZSF) C-Binding Synopsis#include <ncarg/gks.h> void gset_marker_size(Gdouble marker_size); DescriptionMSZSF (Real, Input) – A scale factor to control the size of the marker. It must be greater than or equal to 0. Since MSZSF =…
GSMK (Set marker type) – sets the type of polymarker to be used in subsequent GPM calls. SynopsisCALL GSMK (MTYPE) C-Binding Synopsis#include <ncarg/gks.h> void gset_marker_type(Gint marker_type); DescriptionMTYPE (Integer, Input) – Selects the type of marker to be drawn. Options are: < 0 implementation dependent (not used in NCAR GKS-0A) 1 . (dot) 2 + (plus) 3 * (asterisk) This…
GSLWSC (Set linewidth scale factor) – sets the linewidth scale factor, or relative thickness of a polyline. SynopsisCALL GSLWSC (LWIDTH) C-Binding Synopsis#include <ncarg/gks.h> void gset_linewidth(Gdouble linewidth); DescriptionLWIDTH (Real, Input) – A scale factor to control the linewidth of the polyline to be drawn. It must be greater than or equal to 0. LWIDTH is applied…
GSLN (Set line type) – sets the line type to solid or various dashed patterns. SynopsisCALL GSLN (LTYPE) C-Binding Synopsis#include <ncarg/gks.h> void gset_linetype(Gint linetype); DescriptionLTYPE (Integer, Input) – The type of polyline to be drawn. Options are: < 0 Implementation dependent (not used in NCAR GKS-0A) 1 Solid line (default) 2 Dashed line 3 Dotted…
GSFASI (Set fill are style index) – sets the fill area style index. SynopsisCALL GSFASI (STYLI) C-Binding Synopsis#include <ncarg/gks.h> void gset_fill_style_ind(Gint fill_style_ind); DescriptionSTYLI (Integer, Input) – Specifies workstation-dependent options for hatch or pattern fills. Pattern fill options are not supported in NCAR Graphics. Hatch fill options are: 1 Horizontal lines (default) 2 Vertical lines 3…
GSFAIS (Set fill area interior style) – sets the fill style of polygons drawn with GFA. SynopsisCALL GSFAIS (INTS) C-Binding Synopsis#include <ncarg/gks.h> void gset_fill_int_style(Gfill_int_style fill_int_style); DescriptionINTS (Integer, Input) – Gives the style of fill to be used in subsequent calls to the GFA output primitive. Options are: 0 Hollow fill (the default) 1 Solid fill…
GSFACI (Set fill area color index) – sets the fill area color index. SynopsisCALL GSFACI (COLI) C-Binding Synopsis#include <ncarg/gks.h> void gset_fill_colr_ind(Gint fill_colr_ind); DescriptionCOLI (Integer, Input) – A color index.UsageAll filled areas drawn with calls to the GFA output primitive will be drawn with the color associated with index COLI until GSFACI is called again and…
gset_win (Set window) – establishes a window, or rectangular subspace, of world coordinates to be plotted. Calls to gset_win are discouraged with NCAR Graphics. Instead, use the c_set routine because c_set also supports mirror imaging and log scaling of axes. Synopsis#include <ncarg/gks.h> void gset_win(Gint tran_num, const Glimit *win_limits); Descriptiontran_num (Input) A normalization transformation number. The…