Section 3: library functions
SFSETP – Defines a new dot pattern. Synopsis CALL SFSETP (IDP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfsetp (int idp[8][8]) Description IDP (an input array of type INTEGER, dimensioned 8×8) contains 0s and 1s specifying the dot pattern to be transferred to the internal array LDP for use by SFWRLD and SFNORM. When dot fill is…
SFSETI – Used to set the current integer value of a specified internal parameter. Synopsis CALL SFSETI (CNP, IVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfseti (char *cnp, int ivp) Description CNP (an input expression of type CHARACTER) is one of the character strings ‘AN’, ‘CH’, ‘DO’, ‘SP’, or ‘TY’ (or a longer string beginning with…
SFSETC – Used to set the character value of a specified internal parameter. Synopsis CALL SFSETC (CNP, CVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfsetc (char *cnp, char *cvp) Description CNP (an input expression of type CHARACTER) is the name of an internal parameter of SOFTFILL. Currently, the only legal value is ‘CH’ (or any longer…
SFNORM – The subroutines SFWRLD and SFNORM are used to fill that portion of the plotter frame inside the area defined by a given polygonal boundary. Synopsis CALL SFNORM (XRA,YRA,NRA,DST,NST,IND,NND) CALL SFWRLD (XRA,YRA,NRA,DST,NST,IND,NND) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfnorm (float *xra, float *yra, int nra, float *dst, int nst, int *ind, int nnd) void c_sfwrld…
SFLUSH – Flushes polylines, accumulated through calls to the routines PLOTIF and PLOTIT, from the SPPS polyline buffer shared by those routines; updates all open workstations; and flushes all system-level I/O buffers. Status SFLUSH was called FLUSH in previous versions. The name was changed to avoid a naming conflict with a common system routine. Synopsis…
SFGETR – Used to retrieve the current real value of a specified parameter. Synopsis CALL SFGETR (CNP, RVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfgetr (char *cnp, float *rvp) Description CNP (an input expression of type CHARACTER) is one of the character strings ‘AN’, ‘CH’, ‘DO’, ‘SP’, or ‘TY’ (or a longer string beginning with one…
SFGETP – Used to retrieve the current dot pattern. Synopsis CALL SFGETP (IDP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfgetp (int idp[8][8]) Description IDP (an output array of type INTEGER, dimensioned 8×8) contains 0s and 1s specifying the dot pattern currently contained in the internal array LDP. When dot fill is selected, each fill line is…
SFGETI – Used to retrieve the current integer value of a specified parameter. Synopsis CALL SFGETI (CNP, IVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfgeti (char *cnp, int *ivp) Description CNP (an input expression of type CHARACTER) is one of the character strings ‘AN’, ‘CH’, ‘DO’, ‘SP’, or ‘TY’ (or a longer string beginning with one…
SFGETC – Used to retrieve the current value of a specified internal parameter. Synopsis CALL SFGETC (CNP,CVP) C-Binding Synopsis #include <ncarg/ncargC.h> void c_sfgetc (char *cnp, char *cvp, int len) Description CNP (an input expression of type CHARACTER) is the name of an internal parameter of SOFTFILL. Currently, the only legal value is ‘CH’ (or any…
SETUSV – sets the value of one of the internal parameters of SPPS. Synopsis CALL SETUSV (VN,IV) C-Binding Synopsis #include <ncarg/ncargC.h> void c_setusv (char *vn, int iv) Description VN (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…
SETR – Establishes certain constants so that SRFACE produces a picture whose size changes with respect to the viewer’s distance from the object. It can also be used when making a movie of an object evolving in time to keep it positioned properly on the screen, saving computer time in the bargin. Call it with…
SETI – sets the exponents which define the plotting range in the plotter address unit coordinate system. Status Plotter Address Units (PAUs) are no longer used in NCAR Graphics; thus, SETI is considered an obsolete routine. The current recognized coordinate systems are GKS world coordinates, GKS normalized device coordinates, NCAR Graphics fractional coordinates, and NCAR…
SETER – Called by NCAR Graphics routines when errors occur. Synopsis CALL SETER(MESSG,NERRF,ILEVL) C-Binding Synopsis #include <ncarg/ncargC.h> void c_seter(char *messg, int nerrf, int ilevl) Description The FORTRAN statement "CALL SETER (MESSG,NERRF,ILEVL) is used to tell the error-handling package that an error has occurred. Exactly what happens as a result of such a call depends not…
SET3 – Defines the transformation from three dimensions to two dimensions. Synopsis CALL SET3 (XMIN,XMAX,YMIN,YMAX,UMIN,UMAX,VMIN,VMAX,WMIN,WMAX,PEYE) C-Binding Synopsis #include <ncarg/ncargC.h> void c_set3 (float xmin, float xmax, float ymin, float ymax, float umin, float umax, float vmin, float vmax, float wmin, float wmax, float peye[3]) Description XMIN,XMAX,YMIN,YMAX (input expressions of type REAL) are the fractional coordinates (in…
SET – defines the mapping between fractional and user coordinates: sets the values of the SPPS internal parameters ‘LS’ (axis linear/log scaling) and ‘MI’ (axis mirror imaging); defines GKS normalization transformation 1. Synopsis CALL SET(VL,VR,VB,VT,WL,WR,WB,WT,LF) C-Binding Synopsis #include <ncarg/ncargC.h> void c_set(float vl, float vr, float vb, float vt, float wl, float wr, float wb, float…
SEMESS – Called by a user to get a specified portion of the current error message. Synopsis MESSG = SEMESS(ITRIM) C-Binding Synopsis #include <ncarg/ncargC.h> char *c_semess(int itrim) Description In any routine that references SEMESS, it must be declared to be of type CHARACTER*113. If the internal error flag of SETER is non-zero, the value of…
Scrolled_title_params – This document briefly describes all Scrolled_title internal parameters. Description Parameter descriptions, in alphabetical order, of all Scrolled_title internal parameters follow. Each description begins with a line giving the parameter name and its default value. ‘ALN’ – 0 Flag to control whether alignment frames with dots in the corners are produced in non-test mode….
Scrolled_title – Creates movie titles. The titles can be scrolled, faded in, and/or faded out. Foreground and background colors can be specified. Synopsis The package Scrolled_title has eight user entry points, as follows: FTITLE, STITLE, SLGETI, SLGETR, SLOGAP, SLSETI, SLSETR, and SLRSET. FTITLE stands for "fixed titles" and is used when the following conditions are…
RGBYIQ – Converts a color specification given in the RGB Red, Green, Blue, (RGB) color space to a color specification in the YIQ color space. Synopsis CALL RGBYIQ (R, G, B, Y, I, Q) C-Binding Synopsis #include <ncarg/ncargC.h> void c_rgbyiq (float r, float g, float b, float *y, float *i, float *q) Description R (REAL,…
RGBHSV – Converts a color specification given in the Red, Green, Blue (RGB) color space to color values in the Hue, Saturation, and Value (HSV) color space. Synopsis CALL RGBHSV (R, G, B, H, S, V) C-Binding Synopsis #include <ncarg/ncargC.h> void c_rgbhsv (float r, float g, float b, float *h, float *s, float *v) Description…