Back|Forward

DCL:GRPH2:U[XYZ]PACK: Cartesian Coordinate Axis Routines: Explanation of Subroutines: Lower-Level Applications (LLA)

3.8.4 uxpnum/uypnum

1.

Function

Draws labels specified by numerical values.

2.

Call

NumRu::DCL.uxpnum(cside,islct,ux)
NumRu::DCL.uypnum(cside,islct,uy)

3.

Explanation of Parameters

cside	(C*1)	Specifies the position of the axis on which to draw the labels. (See Section 3.2.)
islct	(I)	Specifies the attributes of the labels to be drawn. (See Section 3.4.)
ux, uy	(R)	An array of length containing the positions of the labels to be drawn (specified in values in UC).
n	(I)	The length of array ux, uy.

4.

Notes

(a)

This routine uses the subroutine CHVAL (see FMTLIB in the user's manual for "MISC1") to convert ux, uy into character-types, and then calls uxplbl/uyplbl. (See uxplbl/uyplbl for label attributes) Since the character-type array to deliver to uxplbl/uyplbl is prepared internally, the length (N) of ux, uy must be less than 40.

(b)

The format to deliver to the subroutine CHVAL for UXPNUM can be changed/inquired using the subroutines

uxsfmt(CFMT) / cfmt = NumRu::DCL.uxqfmt().

For uypnum, the subroutines

uysfmt(CFMT) / cfmt = NumRu::DCL.uyqfmt()

are used to inquire/change the format. The cfmt is a character-type variable with length of less than 16. For example, cfmt is set as '(F6.1)'. The initial value is 'B', which is an option specific to chval. (The value is converted into character-type with a significant digit of 3, and the trailing zeros after the decimal point is removed. If the ones' place is the least significant digit, the decimal point is also removed.) chval automatically left-aligns the characters. Therefore, regardless of whether '(F4.1)' or '(F8.1)' is set to convert the floating-point number 1.2 into a character-type variable, the value returned by chval will be '1.2'.