Section 3: library functions
gset_vp (Set viewport) – establishes a rectangular subspace of normalized device coordinates space. Calls to gset_vp 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_vp(Gint tran_num, const Glimit *vp_limits); Descriptiontran_num (Input) A normalization transformation number. The number of available…
gset_text_path (Set text path) – sets the text paths or directions in which text is to be drawn. Synopsis#include <ncarg/gks.h> void gset_text_path(Gtext_path text_path); Descriptiontext_path (Input) Gives the direction in which a character string is to be drawn. Options are: GPATH_RIGHT Draw successive characters in the string such that character n+l appears to the right of…
gset_text_font_prec (Set text font and precision) – sets the text font and precision. Synopsis#include <ncarg/gks.h> void gset_text_font_prec(const Gtext_font_prec *text_font_prec); Descriptiontext_font_prec.font (Gint, Input) Specifies the text font to be used in subsequent calls to the gtext output primitive. Options are: 1 ASCII font (default) -2 Hershey cartographic Roman -3 Hershey cartographic Greek -4 Hershey simplex Roman…
gset_text_colr_ind (Set text color index) – sets the text color index. Synopsis#include <ncarg/gks.h> void gset_text_colr_ind(Gint text_colr_ind); Descriptiontext_colr_ind (Input) A color index.UsageAll text strings drawn with calls to the gtext output primitive will be drawn with the color associated with index text_colr_ind until gset_text_colr_ind is called again and a new index is assigned. For all GKS…
gset_text_align (Set text alignment) – sets the text alignment. Synopsis#include <ncarg/gks.h> void gset_text_align(const Gtext_align *text_align); Descriptiontext_align.hor (Input) Determines the horizontal alignment of the text to be drawn. Options are: GHOR_NORM Normal (default) GHOR_LEFT Left GHOR_CTR Center GHOR_RIGHT Righttext_align.vert (Input) Determines the vertical alignment of the text to be drawn. Options are: GVERT_NORM Normal (default) GVERT_TOP…
gset_seg_tran (Set segment transformation) – Associates a segment transformation with a named segment. Synopsis#include <ncarg/gks.h> void gset_seg_tran(Gint seg_name, const Gtran_matrix tran_matrix); Descriptionseg_name (Input) A segment name as used in a previous gcreate_seg call. tran_matrix (Gfloat, Input) – A 2×3 array giving the GKS segment transformation to be associated with the segment specified in seg_name.UsageWhen the…
gset_marker_type (Set marker type) – sets the type of polymarker to be used in subsequent GPM calls. Synopsis#include <ncarg/gks.h> void gset_marker_type(Gint marker_type); Descriptionmarker_type (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 is the default 4 o (circle)…
gset_marker_size (Set marker size scale factor) – sets the polymarker size scale factor — the relative size of the marker. Synopsis#include <ncarg/gks.h> void gset_marker_size(Gdouble marker_size); Descriptionmarker_size (Input) A scale factor to control the size of the marker. It must be greater than or equal to 0. Since marker_size = 1.0 by default, setting marker_size =…
gset_marker_colr_ind – (Set polymarker color index) – sets the polymarker color index. Synopsis#include <ncarg/gks.h> void gset_marker_colr_ind(Gint marker_colr_ind); Descriptionmarker_colr_ind (Input) – A color index.UsageAll polymarkers drawn with calls to the GPM output primitive will be drawn with the color associated with index marker_colr_ind until gset_marker_colr_ind is called again and a new index is assigned. For all…
gset_linewidth (Set linewidth scale factor) – sets the linewidth scale factor, or relative thickness of a polyline. Synopsis#include <ncarg/gks.h> void gset_linewidth(Gdouble linewidth); Descriptionlinewidth (Input) – A scale factor to control the linewidth of the polyline to be drawn. It must be greater than or equal to 0. linewidth is applied to the nominal linewidth on…
gset_linetype (Set line type) – sets the line type to solid or various dashed patterns. Synopsis#include <ncarg/gks.h> void gset_linetype(Gint linetype); Descriptionlinetype (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 line 4 Dashed dotted line…
gset_line_colr_ind (Polyline color index) – sets the polyline color index. Synopsis#include <ncarg/gks.h> void gset_line_colr_ind(Gint line_colr_ind); Descriptionline_colr_ind (Input) – A color index.UsageAll lines drawn with calls to the gpolyline output primitive will be drawn with the color associated with index line_colr_ind until gset_line_colr_ind is called again and a new index is assigned. For all GKS output…
gset_fill_style_ind (Set fill are style index) – sets the fill area style index. Synopsis#include <ncarg/gks.h> void gset_fill_style_ind(Gint fill_style_ind); Descriptionfill_style_ind (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 Lines of positive slope 4…
gset_fill_int_style (Set fill area interior style) – sets the fill style of polygons drawn with gfill_area. Synopsis#include <ncarg/gks.h> void gset_fill_int_style(Gfill_int_style fill_int_style); Descriptionfill_int_style (Input) – Gives the style of fill to be used in subsequent calls to the gfill_area output primitive. Options are: GSTYLE_HOLLOW Hollow fill (the default) GSTYLE_SOLID Solid fill GSTYLE_PAT Pattern fill (not implemented…
gset_fill_colr_ind (Set fill area color index) – sets the fill area color index. Synopsis#include <ncarg/gks.h> void gset_fill_colr_ind(Gint fill_colr_ind); Descriptionfill_colr_ind (Input) – A color index.UsageAll filled areas drawn with calls to the gfill_area output primitive will be drawn with the color associated with index fill_colr_ind until gset_fill_colr_ind is called again and a new index is assigned….
gset_colr_rep (Set color representation) – associates a color value with a color index. Synopsis#include <ncarg/gks.h> void gset_colr_rep(Gint ws_id, Gint colr_ind, const Gcolr_rep *colr_rep); Descriptionws_id (Input) – A workstation identifier. ws_id must be the same as that used in some previous gopen_ws call. colr_ind (Input) – A color index. colr_rep.rgb.red (Gfloat, Input) – An intensity value…
gset_clip_ind (Set clipping indicator) – controls whether data are displayed outside the boundaries of the world coordinate window of the current normalization transformation. Synopsis#include <ncarg/gks.h> void gset_clip_ind(Gclip_ind clip_ind); Descriptionclip_ind (Input) – A flag to turn clipping on or off. GIND_NO_CLIP Clipping is off. Data outside of the window will be plotted. GIND_CLIP Clipping is on….
gset_char_up_vec (Set character up vector) – specifies the angle at which subsequent text is to be drawn with gtext. Synopsis#include <ncarg/gks.h> void gset_char_up_vec(const Gvec *char_up_vec); Descriptionchar_up_vec.delta_x (Gfloat, Input) – Gives the X (horizontal) world coordinate of a vector. char_up_vec.delta_y (Gfloat, Input) – Gives the Y (vertical) world coordinate of a vector.UsageThe coordinates (char_up_vec.delta_x, char_up_vec.delta_y) relative…
gset_char_space (Set character spacing) – sets the character spacing for text. Synopsis#include <ncarg/gks.h> void gset_char_space(Gdouble char_space); Descriptionchar_space (Input) – Specifies how much additional white space should be inserted between characters drawn using the gtext output primitive. char_space is specified as a fraction of the character height. A character spacing of zero positions the character body…
gset_char_ht (Set character height) – sets the character height for text. Synopsis#include <ncarg/gks.h> void gset_char_ht(Gdouble char_ht); Descriptionchar_ht (Input) – Gives the height in world coordinates at which a character is drawn using the GTX output primitive. char_ht > 0. By default char_ht = 0.01.AccessTo use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries….