Section 3: library functions
nnalg – a tool for displaying features of the Natgrid algorithm Synopsis nnalg algorithmic_data_file Description "nnalg" takes a single argument which is a the name of a special file created by the Fortran subroutine NATGRIDS or the C function c_natgrids in the Natgrid package. This file contains data appropriate for displaying various features of the…
NGWSYM – Draws a symbol from the standard WMO/NOAA meteorological fonts by reference to the font name and symbol number within that font. Synopsis CALL NGWSYM(FTYPE,NUM,X,Y,SIZE,ICOLOR,IALT) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngwsym(char *ftype, int num, float x, float y, float size, int icolor, int ialt) Description FTYPE (an input parameter of type CHARACTER) specifying the…
NGSRAT – save/restore/set NCAR GKS primitive attribute values in toto. Synopsis CALL NGSRAT(IOPT, IAT, RAT) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngsrat(int iopt, int *iat, float *rat) Description IOPT (an input variable of type INTEGER) indicating the desired action: = 0 save the current settings of all attributes internal to the subroutine, i.e. not in the…
NGSETR – Provides a new real value for an internal parameter of Ngmisc of type REAL. See the ngmisc_params man page for a complete list of all the Ngmisc internal parameters. Synopsis CALL NGSETR (PNAM, RVAL) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngsetr (char *pnam, float rval) Description PNAM (an input constant or variable of type…
NGSETI – Provides a new integer value for an internal parameter of Ngmisc of type INTEGER. See the ngmisc_params man page for a complete list of all the ngmisc internal parameters. Synopsis CALL NGSETI (PNAM, IVAL) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngseti (char *pnam, int ival) Description PNAM (an input constant or variable of type…
NGSETC – Used to set the character value of a specified internal parameter. Synopsis CALL NGSETC (CNP, CVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngsetc (char *cnp, char *cvp) Description CNP (an input expression of type CHARACTER) is the name of an internal parameter of Ngmisc. Only the first two characters will be examined. CVP (an…
NGRITD – Given the coordinates of a point, this routine performs a rotation of that point about a specified axis by a specified angle. Synopsis CALL NGRITD (IAXS,ANGL,UCRD,VCRD,WCRD) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngritd(int iaxs, float angl, float *ucrd, float *ycrd, float *wcrd) Description IAXS (an input expression of type INTEGER) specifies the axis about…
NGREOP – reopen an existing NCAR Graphics metafile for appending. Synopsis CALL NGREOP(WKID, CONID, ITYPE, FNAME, IOPT, IAT, RAT, NCOLRS, NSTART, CTAB) C-Binding Synopsis #include <ncarg/ncargC.h> #include <ncarg/gks.h> void c_ngsrat(int wkid, int conid, int itype, char *fname, int iopt, int *iat, float *rat, int ncolrs, int nstart, Gcolr_rep *ctab) Description WKID (an input variable of type INTEGER) specifying…
NGPSWK – returns the workstation type, suitable for use as the third argument in a call to the NCAR GKS routine GOPWK, for the PostScript workstation whose attributes are specified in the function arguments. Synopsis CALL NGPSWK(PSTYPE, ORIENT, COLOR) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngpswk(char *pstype, char *orient, char *color) Description PSTYPE (an input variable…
NGPICT – Effects a break in the picture drawing sequence in a FORTRAN code using GKS. The actions taken depend on whether the designated workstation is a metafile or an output/input workstation. An option is provided for prompting the user when an output/input workstation is ready and waiting after a pause. Synopsis CALL NGPICT(WKID,ACTION) C-Binding…
Ngmisc_params – This document briefly describes all Ngmisc internal parameters. Description Parameter descriptions, in alphabetical order, of all Ngmisc internal parameters follow. Each entry includes the name of a parameter, its FORTRAN type, its default value, and a short description of the parameter. ‘CA’ – Integer – 1 This parameter controls the type of line…
Ngmisc – A collection of miscellaneous NCAR Graphics routines. Synopsis NGDOTS – Draws filled circular dots at coordinate positions (X(I),Y(I),I=1,NUM) at size SIZE with color given by the color index ICOLOR. NGGCOG – Returns the latitudes and longitudes of a set of points approximating a circle at a given point on the surface of the…
NGMFTC – Temporarily closes a metafile output unit allowing for subsequent reopening. Synopsis CALL NGMFTC(WKID) C-Binding Synopsis #include <ncarg/ncargC.h> void c_ngmftc(int wkid) Description WKID (an input variable of type INTEGER) that specifies the GKS workstation ID to be temporarily closed. C-Binding Description The C binding argument descriptions are the same as the FORTRAN argument descriptions….
NGLOGO – Draws various NCAR and UCAR logos on a specified workstation. SynopsisCALL NGLOGO(IWK,X,Y,SIZE,ITYPE,ICOL1,ICOL2) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nglogo(int iwk, float x, float y, float size, int itype, int icol1, int icol2) Description IWK (an input parameter of type INTEGER) The workstation identifier for the workstation you want the logo plotted to. X,Y (input parameters…
NGGSOG – Returns the latitudes and longitudes of six points defining a five-pointed star at a given point on the surface of the globe. SynopsisCALL NGGSOG (SLAT,SLON,SRAD,ALAT,ALON) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nggsog(float slat, float slon, float srad, float *alat, float *alon) DescriptionSLAT (an input expression of type REAL) is the latitude, in degrees, of a…
NGGETR – Gets the current real value of an internal parameter of Ngmisc of type REAL. See the ngmisc_params man page for a complete list of all the Ngmisc internal parameters. SynopsisCALL NGGETR (PNAM, RVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nggetr (char *pnam, float *rval) DescriptionPNAM (an input constant or variable of type CHARACTER) specifies the…
NGGETI – Gets the current integer value of an internal parameter of Ngmisc of type INTEGER. See the ngmisc_params man page for a complete list of all the Ngmisc internal parameters. SynopsisCALL NGGETI (PNAM,IVAL) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nggeti (char *pnam, int *ival) DescriptionPNAM (an input constant or variable of type CHARACTER) specifies the name…
NGGETC – Used to retrieve the current value of a specified internal parameter. SynopsisCALL NGGETC (CNP,CVP) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nggetc (char *cnp, char *cvp, int len) DescriptionCNP (an input expression of type CHARACTER) is the name of an internal parameter of Ngmisc. Only the first two characters of the string are examined. CVP (an…
NGGCOG – Returns the latitudes and longitudes of a set of points approximating a circle at a given point on the surface of the globe. SynopsisCALL NGGCOG (CLAT,CLON,CRAD,ALAT,ALON,NPTS) C-Binding Synopsis#include <ncarg/ncargC.h> void c_nggcog(float clat, float clon, float crad, float *alat, float *alon, int npts) DescriptionCLAT (an input expression of type REAL) is the latitude, in…
NGEZLOGO – Draws various NCAR and UCAR logos, the default being to draw an NCAR logo of reasonable size in the lower right corner of a plot. SynopsisCALL NGEZLOGO() C-Binding Synopsis#include <ncarg/ncargC.h> void c_ngezlogo() UsageCall this subroutine to produce a logo. By default a call to this subroutine will draw an NCAR logo of reasonable…