gsulns(3) — AIX/RT 2.2.1

gsulns

Purpose

     Sets the user line pattern.

C Syntax

     int gsulns_ (pattern, length, begin)

     int *pattern, *length, *begin;

FORTRAN Syntax

     INTEGER function gsulns (pattern, length, begin)

     INTEGER pattern, length, begin

Pascal Syntax

     FUNCTION gsulns_ (

     VAR pattern, length, begin: INTEGER
     ): INTEGER [PUBLIC|;

Description

     The gsulns subroutine establishes the user line style.

     Parameters

     pattern           Defines the pixel  pattern used for the
                       line style. A 1  bit indicates that the
                       GSL draws  a pixel; a 0  bit means that
                       it does not.

     length            Defines  the number  of bits  (starting
                       with the  most significant)  of pattern
                       used  for line  drawing.  The bits  are
                       repeated for the length of the line.

                       The  length parameter  is  a value  not
                       less than  2 or greater than  32.  When
                       using  the 5081  display, the  value of
                       length must be 16.

     begin             Indicates  the length  of the  starting
                       run of  bits set  to 1 in  the pattern.
                       It is used to  adjust the beginning and
                       ending runs of  the non-continuous line
                       styles.  The 5081  display does not use
                       the begin parameter.

     For  proper  appearance,  the  application-supplied  line
     pattern should begin with a run  of bits set to 1 and end
     with a run of bits set to 0.

Return Value

     GS_SUCC   Successful.
     GS_LENG   Invalid length.
Museum
