Section 3: library functions
GFLAS2 – Terminates putting plotting instructions to disk and resumes putting plotting instructions to the the output stream. A call to GFLAS2 can only be made after a previous call to GFLAS1. SynopsisCALL GFLAS2 C-Binding Synopsis#include <ncarg/ncargC.h> void c_gflas2() DescriptionNone. ExamplesUse the ncargex command to see the following relevant examples: ccpmovi, tgflas, fgke02. AccessTo use…
GFLAS1 – Initiates storage of plotting instructions into a disk file. Instructions subsequent to GFLAS1, but prior to a GFLAS2 call, will be stored on disk rather than inserted into the output metafile. SynopsisCALL GFLAS1 (IB) C-Binding Synopsis#include <ncarg/ncargC.h> void c_gflas1 (int ib) DescriptionIB (INTEGER, input) Can be any integer between 0 and 99 inclusive,…
gfill_area (Fill area) – output primitive for filling polygonal areas. Synopsis#include <ncarg/gks.h> void gfill_area(const Gpoint_list *point_list); Descriptionpoint_list.num_points (Gint, Input) – The number of points in the polygon to be filled. Must be greater than two. point_list.points (Gpoint *, Input) – The X and Y world coordinates of the polygon.UsageThe area to be filled is delimited…
GFA (Fill area) – output primitive for filling polygonal areas. SynopsisCALL GFA (N, X, Y) C-Binding Synopsis#include <ncarg/gks.h> void gfill_area(const Gpoint_list *point_list); DescriptionN (Integer, Input) – The number of points in the polygon to be filled. N must be greater than two. X (N) (Real Array, Integer) – The X world coordinates of the polygon….
GEVTM (Evaluate transformation matrix) – Constructs a GKS segment transformation matrix starting from a given point, a shift vector, a rotation angle, and X and Y scale factors. SynopsisCALL GEVTM(X0,Y0,DX,DY,PHI,FX,FY,SW,MOUT) C-Binding Synopsis#include <ncarg/gks.h> void geval_tran_matrix(const Gpoint *point, const Gvec *shift, Gdouble angle, const Gvec *scale, Gcoord_switch coord_switch, Gtran_matrix tran_matrix); DescriptionX0 (Real, Input) – An X…
geval_tran_matrix (Evaluate transformation matrix) – Constructs a GKS segment transformation matrix starting from a given point, a shift vector, a rotation angle, and X and Y scale factors. Synopsis#include <ncarg/gks.h> void geval_tran_matrix(const Gpoint *point, const Gvec *shift, Gdouble angle, const Gvec *scale, Gcoord_switch coord_switch, Gtran_matrix tran_matrix); Descriptionpoint.x (Gfloat, Input) – An X coordinate value for…
GETUSV – gets the value of one of the internal parameters of SPPS. SynopsisCALL GETUSV (VN,IV) C-Binding Synopsis#include <ncarg/ncargC.h> void c_getusv (char *vn, int *iv) DescriptionVN (an input constant or variable of type CHARACTER) is the name of a parameter; only the first two characters are meaningful. Remember that, in FORTRAN, a constant of type…
GETSI – returns the exponents which define the plotting range in the plotter address unit coordinate system. StatusPlotter Address Units (PAUs) are no longer used in NCAR Graphics; thus, GETSI is considered an obsolete routine. The current recognized coordinate systems are GKS world coordinates, GKS normalized device coordinates, NCAR Graphics fractional coordinates, and NCAR Graphics…
GETSET – returns a set of values which, if used as arguments in a call to SET, will cause normalization transformation 1, axis linear/log scaling (internal parameter ‘LS’), and axis mirror imaging (internal parameter ‘MI’) to be defined in such a way as to duplicate the combined effects of the current normalization transformation, axis scaling,…
gescape (Escape) – provides a standard way of implementing nonstandard GKS features. NCAR GKS has only two user-accessible escape functions defined: one for changing the name of a metafile and another for pausing in an X window. Synopsis#include <ncarg/gks.h> void gescape(Gint func_id, const Gescape_in_data *in_data, Gstore *store_data,Gescape_out_data **out_data); Descriptionfunc_id (Input) – A function identifier specifying…
GESC (Escape) – provides a standard way of implementing nonstandard GKS features. NCAR GKS has only two user-accessible escape functions defined: one for changing the name of a metafile and another for pausing in an X window. SynopsisCALL GESC (FCTID, LIDR, IDR, MXODR, LODR, ODR) C-Binding Synopsis#include <ncarg/gks.h> void gescape(Gint func_id, const Gescape_in_data *in_data, Gstore…
GDSG (Delete segment) – deletes a GKS segment. SynopsisCALL GDSG(SGNA) C-Binding Synopsis#include <ncarg/gks.h> void gdel_seg(Gint seg_name); DescriptionSGNA (Integer, Input) – Specifies the segment identifier for a segment that will be deleted by a call to this function.UsageThe segment name is removed from the set of names of segments that are currently in use. AccessTo use…
gdel_seg (Delete segment) – deletes a GKS segment. Synopsis#include <ncarg/gks.h> void gdel_seg(Gint seg_name); Descriptionseg_name (Input) – Specifies the segment identifier for a segment that will be deleted by a call to this function.UsageThe segment name is removed from the set of names of segments that are currently in use. AccessTo use the GKS C-binding routines,…
gdeactivate_ws (Deactivate workstation) – deactivates a workstation. Synopsis#include <ncarg/gks.h> void gdeactivate_ws(Gint ws_id); Descriptionws_id (Input) – A number identifying the workstation to be deactivated. ws_id must be the same as that used in some previous gactivate_ws call.UsageThe specified workstation is removed from the set of active workstations. GKS output primitives are not sent to workstations that…
GDAWK (Deactivate workstation) – deactivates a workstation. SynopsisCALL GDAWK (WKID) C-Binding Synopsis#include <ncarg/gks.h> void gdeactivate_ws(Gint ws_id); DescriptionWKID (Integer, Input) – A number identifying the workstation to be deactivated. WKID must be the same as that used in some previous GACWK call.UsageThe specified workstation is removed from the set of active workstations. GKS output primitives are…
GCSGWK (Copy segment to workstation) – copies a GKS segment to a GKS workstation. SynopsisCALL GCSGWK(WKID,SGNA) C-Binding Synopsis#include <ncarg/gks.h> void gcopy_seg_ws(Gint ws_id, Gint seg_name); DescriptionWKID (Integer, Input) – Specifies the workstation identifier (as defined in a GOPWK call) that is to receive the segment copy. SGNA (Integer, Input) – Identifies the segment that is to…
GCRSG (Create segment) – creates a GKS segment. SynopsisCALL GCRSG(SGNA) C-Binding Synopsis#include <ncarg/gks.h> void gcreate_seg(Gint seg_name); DescriptionSGNA (Integer, Input) – Specifies the segment identifier that will be used in calls to subsequent segment functions applying to this segment. There can be a maximum of 100 segments in a given job step. Legal values for SGNA…
gcreate_seg (Create segment) – creates a GKS segment. Synopsis#include <ncarg/gks.h> void gcreate_seg(Gint seg_name); Descriptionseg_name (Input) – Specifies the segment identifier that will be used in calls to subsequent segment functions applying to this segment. There can be a maximum of 100 segments in a given job step. Legal values for seg_name are integers between 0…
gcopy_seg_ws (Copy segment to workstation) – copies a GKS segment to a GKS workstation. Synopsis#include <ncarg/gks.h> void gcopy_seg_ws(Gint ws_id, Gint seg_name); Descriptionws_id (Input) – Specifies the workstation identifier (as defined in a gopen_ws call) that is to receive the segment copy. seg_name (Input) – Identifies the segment that is to be copied to the specified…
GCLWK (Close workstation) – closes a workstation. SynopsisCALL GCLWK (WKID) C-Binding Synopsis#include <ncarg/gks.h> void gclose_ws(Gint ws_id); DescriptionWKID (Input, Integer) – A number identifying the workstation to be closed. WKID must be the same as that used in some previous GOPWK call.UsageClose workstation updates the workstation and removes its identifier from the set of open workstations….