Back|Forward

DCL:GRPH2:UEPACK :Tone Fill Routines: Explanation of Subroutines

9.2.8 uepget/uepset(uepstx)

1.

Functions

Inquires/changes an internal variable used by the UEPACK subroutine package. (uepstx permits changes with a runtime option.)

2.

Call

lpara = NumRu::DCL.uepget(cp)
NumRu::DCL.uepset(cp,lpara)
NumRu::DCL.uepstx(cp,lpara)

3.

Explanation of Parameters

cp	(C*8)	The name of an internal standard.
ipara	(I,R,L)	The value of an internal standard.

Below is a list of names that can be used to specify as cp.

'LTONE'	(L)	This specifies whether the uegtlb will be used to generate a tone level and pattern when the tone level for the fill pattern is not specified by the user. When .true., uegtlb is used; when .false., tone level with value below 'RLEV' (see below) will be filled. (The initial value is .false..)
'RLEV'	(R)	The value of the boundary level when 'LTONE' is .false.. (The initial value is 0.0.) The area with value below the value specified here will be filled.
'IPAT'	(I)	The tone pattern to fill an area with tone level below the internal variable 'RLEV' when 'LTONE' is .false.. (The initial value is 1201: right-up hatch pattern)
'ICOLOR1'	(I)	The lower limit of the value for color index when 'LTONE' is .true.. (The initial value is 15.)
'ICOLOR2'	(I)	The upper limit of the value for color index when 'LTONE' is .TRUE.. (The initial value is 94.)
'ITPAT'	(I)	The tone pattern index used when 'LTONE' is .true.. (The initial value is 999; solid fill)

4.

Notes

(a)

The following are the subroutines that handle internal variables.

ncp = NumRu::DCL.uepqnp()	Counts the total number (ncp) of internal variables.
idx = NumRu::DCL.uepqid(cp)	Determines the position (IDX) of the internal variable cp.
cp = NumRu::DCL.uepqcp(idx)	Inquires the name (CP) of the internal variable at position idx.
ipara = NumRu::DCL.uepqvl(idx)	Inquires the value (IPARA) of the internal variable at position idx.
NumRu::DCL.uepsvl(idx,ipara)	Changes the value (IPARA) of the internal variable at position idx

(b)

UEpGET calls the above-mentioned UEPQID to determine the position of an internal variable, and inquires the value by uepqvl; uepset calls uepqid to determine the position of an internal variable and changes the value using uepsvl Therefore, when the specified internal variable is not found, an error message will be printed by uepqid.

(c)

Besides those listed above, there are internal variables in the UEPACK that are equivalent to the internal variables 'NLEV' and 'ICYCLE' in the UDPACK for maintaining the equivalence of an algorithm with udgcla and udgclb  When the values of these internal variables are changed in the UDPACK, they must also be changed in the UEPACK.

(d)

An appropriate type of constant or variable should be specified for itype.