Section 3: library functions
ARMVAM – Moves an area map from one integer array to another. SynopsisCALL ARMVAM (IAM,IAN,LAN) C-Binding Synopsis#include <ncarg/ncargC.h> void c_armvam (int *iam, int *ian, int lan) DescriptionIAM (an input array of type INTEGER) – An array containing an area map that has at least been initialized by a call to ARINAM. Note: As part of…
ARINAM – Initializes an area map. SynopsisCALL ARINAM (MAP,LMAP) C-Binding Synopsis#include <ncarg/ncargC.h> void c_arinam (int *map, int lmap) DescriptionMAP (output array, of type INTEGER, dimensioned at least LMAP) – An integer array in which an area map is to be constructed. Each vertex for an edge segment in your area map requires ten words in…
ARGTAI – Returns the area identifiers associated with a given point. SynopsisCALL ARGTAI (MAP,XCD,YCD,IAI,IAG,MAI,NAI,ICF) C-Binding Synopsis#include <ncarg/ncargC.h> void c_argtai (int *map, float xcd, float ycd, int *iai, int *iag, int mai, int *nai, int icf) DescriptionMAP (an input/output array of type INTEGER) – An array containing an area map that has been initialized by a…
ARGETR – Retrieves the real value of an Areas parameter. SynopsisCALL ARGETR (PNAM,RVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_argetr (char *pnam, float *rval) DescriptionPNAM (an input constant or variable of type CHARACTER) – The name of the parameter that you want to retrieve. The character string can be of any length, but only the first two…
ARGETI – Retrieves the integer value of an Areas parameter. SynopsisCALL ARGETI (PNAM,IVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_argeti (char *pnam, int *ival) DescriptionPNAM (an input constant or variable of type CHARACTER) – The name of the parameter that you want to retrieve. The character string can be of any length, but only the first two…
AREDAM – Adds edge segments to an area map. SynopsisCALL AREDAM (MAP,XCA,YCA,LCA,IGI,IDL,IDR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_aredam (int *map, float *xca, float *yca, int lca, int igi, int idl, int idr) DescriptionMAP (an input/output array of type INTEGER) – An array containing an area map that has been initialized by a call to ARINAM. Note:…
Areas_params – This document briefly describes all Areas parameters. DescriptionAreas currently supports nine parameters. These parameters are useful mostly for debugging Areas problems. The current values may be retrieved using one of the routines ARGETI or ARGETR. Parameter values may be reset using the routine ARSETI or ARSETR; the parameter ‘DI’ is for retrieval only…
Areas – A set of routines allowing you to create an area map from a set of edges and then to use the area map for various purposes. SynopsisARINAM – Initializes an area map. AREDAM – Adds edges to an area map. ARMVAM – Moves an area map from one integer array to another. ARPRAM…
ARDRLN – Draws a polyline that is masked by a given area map. SynopsisCALL ARDRLN (MAP,XCD,YCD,NCD,XCS,YCS,MCS,IAI,IAG,MAI,LPR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_ardrln (int *map, float *xcd, float *ycd, int ncd, float *xcs, float *ycs, int mcs, int *iai, int *iag, int mai, int (*lpr)(float *xcs, float *ycs, int *ncs, int *iai, int *iag, int *nai)) DescriptionMAP…
ARDBPA – Produces a plot showing all of the edge segments in an area map that have a specified group identifier IGRP; if IGRP is less than or equal to zero, all groups are included. Such plots allow one to debug problems with an area map. SynopsisCALL ARDBPA (MAP,IGRP,LABEL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_ardbpa (int…
ANOTAT – Changes the values of certain primary control parameters, purportedly having to do with "annotation" of a graph. SynopsisANOTAT (XLAB,YLAB,LBAC,LSET,NDSH,DSHC) C-Binding Synopsis#include <ncarg/ncargC.h> void c_anotat(char *xlab, char *ylab, int lbac, int lset, \ int ndsh, char *dshc[]) DescriptionXLAB (an input expression of type CHARACTER) defines a new "x-axis label". (If the first character of…
AGUTOL – Provides a way for the user to change the user-system-to-label-system mapping for one or more of the four axes. SynopsisSUBROUTINE AGUTOL (IAXS,FUNS,IDMA,VINP,VOTP) DescriptionIAXS (an input expression of type INTEGER) is the number of the axis. The values 1, 2, 3, and 4 imply the left, right, bottom, and top axes, respectively. FUNS (an…
AGSTUP – Performs "set-up" tasks required before AGBACK and AGCURV may be called. Basically, AGSTUP examines the current values of the primary control parameters for errors and computes from them and from its arguments the values of secondary control parameters. The primary and secondary control parameters together determine how the routines AGBACK and AGCURV will…
AGSETR – Allows a user program to store a real number as the value of a single parameter. SynopsisCALL AGSETR (TPGN,FUSR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agsetr (char *tpgn, float fusr) DescriptionTPGN (an input expression of type CHARACTER) is an parameter identifier, as described in AGSETP man page. If a group of more than one parameter…
AGSETP – Allows a user program to reset the values of a group of parameters containing one or more elements. SynopsisCALL AGSETP (TPGN,FURA,LURA) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agsetp (char *tpgn, float *fura, int lura) DescriptionTPGN (an input expression of type CHARACTER) is a character string of the form ‘k1/k2/ . . . kn.’, where each…
AGSETI – Allows a user program to store the real equivalent of an integer as the value of a single parameter. SynopsisCALL AGSETI (TPGN,IUSR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agseti (char *tpgn, int iusr) DescriptionTPGN (an input expression of type CHARACTER) is a parameter identifier, as described for AGSETP, above. If a group of more than…
AGSETF – Allows a user program to store a real number as the value of a single parameter. SynopsisCALL AGSETF (TPGN,FUSR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agsetf (char *tpgn, float fusr) DescriptionTPGN (an input expression of type CHARACTER) is an parameter identifier, as described in AGSETP man page. If a group of more than one parameter…
AGSETC – Allows a user program to (in effect) store a character string as the value of a specified single parameter. SynopsisCALL AGSETC (TPGN,CUSR) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agsetc (char *tpgn, char *cusr) DescriptionTPGN (an input expression of type CHARACTER) is a parameter identifier, as described for AGSETP, above. The specified parameter must be one…
AGSAVE – Saves the current state of Autograph for later restoration by AGRSTR. SynopsisCALL AGSAVE (IFNO) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agsave (int ifno) DescriptionIFNO (an input expression of type INTEGER) is the number of a unit to which a single unformatted record is to be written. It is the user’s responsibility to position this unit….
AGRSTR – Restores a saved state of Autograph. SynopsisCALL AGRSTR (IFNO) C-Binding Synopsis#include <ncarg/ncargC.h> void c_agrstr (int ifno) DescriptionIFNO (an input expression of type INTEGER) is the number of a unit from which a single unformatted record is to be read. It is the user’s responsibility to position this unit. AGRSTR does not rewind it,…