gsvgrn

Purpose

     Sets the valuator granularity.

C Syntax

     int gsvgrn_ (valuators, granularity)

     char *valuators, *granularity;

FORTRAN Syntax

     INTEGER function gsvgrn (valuators, granularity)

     CHARACTER valuators, granularity

Pascal Syntax

     FUNCTION gsvgrn_ (

     VAR valuators, granularity: CHAR
     ): INTEGER [PUBLIC|;

Description

     The gsvgrn subroutine sets the resolution of input events
     generated by the valuators, that is, the number of events
     per turn of the valuator dial.

     Parameters

     valuators         Specifies which valuators to set to the
                       indicated  granularity.   Each  bit  in
                       valuators  corresponds  to one  of  the
                       valuator dials,  with the  most signif-
                       icant bit indicating that valuator 0 is
                       to  be set,  the next  most significant
                       bit indicating that valuator 1 is to be
                       set, and so on.

     granularity       Specifies  the  desired resolution  for
                       the valuators indicated.   It must have
                       a value of 2  through 8 and indicates a
                       resolution of 4, 8, 16, 32, 64, 128, or
                       256  points   per  revolution,  respec-
                       tively.  The default value  is 4, for a
                       resolution of 16.

     An attempt to set the valuator granularity may fail for a
     variety of reasons, the most  likely of which is that the

     device is  not attached.   The problem can  be determined
     with  a specific  ioctl  to the  virtual terminal.   (See
     "hft" for more information.)

Return Value

     GS_SUCC   Successful.
     GS_USUC   Unsuccessful.
     GS_VALG   Invalid granularity.

Related Information

     In this book:  "hft"