FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)



     NAME
     NAME
     NAME
     NAME
          fainit, faterminate - open and close display device

     SYNOPSIS
     SYNOPSIS
     SYNOPSIS
     SYNOPSIS
          #include <fa.h>
          #include <fa.h>
          #include <fa.h>
          #include <fa.h>

          int
          int
          int
          int
          fainit( fd, driver ) ;
          fainit( fd, driver ) ;
          fainit( fd, driver ) ;
          fainit( fd, driver ) ;
          int fd;
          int fd;
          int fd;
          int fd;
          char *driver;
          char *driver;
          char *driver;
          char *driver;

          int
          int
          int
          int
          faterminate(fd);
          faterminate(fd);
          faterminate(fd);
          faterminate(fd);
          int fd;
          int fd;
          int fd;
          int fd;

     DESCRIPTION
     DESCRIPTION
     DESCRIPTION
     DESCRIPTION
          ______ is used to initialize a display device.  Driver is
          Fainit                                          Driver
                                                          Driver
                                                          Driver
          usually the value of the TERM environment variable and is
          used to determine which device-dependent software to use to
          drive the display.  For specific driver values, see the
                                           driver
                                           driver
                                           driver
          device-dependent manual entries.

          Fd is a file descriptor associated with the desired device.
          Fd
          Fd
          Fd
          It should be open for reading and writing.  Since many
          programs just want to use the "standard" display associated
          with stdout, ______ should provide a method for accessing
                       fainit
          the correct display given the file descriptor associated
          with stdout.  For example, the following two fragments ought
          to work:


               fd = open("/dev/tty",O_RDWR);
               fafd = fainit(fd,driver);
                       OR
               fafd = fainit(fileno(stdout),driver);

          In some architectures where stdout is not the same as the
          desired fastalpha device, a suitable mapping should be
          performed in ______.  There should be no device dependence
                       fainit
          outside of the FastAlpha functions.

          The return value  is -1 if ______ fails otherwise a file
                                     fainit
          descriptor is returned which must be used in subsequent fast
          alpha calls.

          After calling ______, the display (or window) may be
                        fainit
          accessed immediately - calls to set colors and/or fonts are
          not needed.  Suitable defaults are chosen where appropriate
          - see the device-dependent manual entries.

          The value of driver should always be proper - even when the
                       driver
                       driver
                       driver
          target display is known and the device-dependent FastAlpha



     Hewlett-Packard               - 1 -            (printed 12/14/84)






     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)
     FAINIT(3D)          HP Integral PC (Proposed)          FAINIT(3D)



          libraries are used.  driver may contain information
                               driver
                               driver
                               driver
          important to device-dependent driver configuration.

          ___________ is the opposite of ______.  The passed fd must
          faterminate                    fainit              fd
                                                             fd
                                                             fd
          be one obtained from a successful call to ______.
                                                    fainit

     DIAGNOSTICS
     DIAGNOSTICS
     DIAGNOSTICS
     DIAGNOSTICS
          ______ normally returns a positive file descriptor but
          fainit
          returns -1 if an error occurs.

     FILES
     FILES
     FILES
     FILES
          /usr/include/fa.h
          /usr/lib/libfa.a

     SEE ALSO
     SEE ALSO
     SEE ALSO
     SEE ALSO
          facursor(3D), fagetinfo(3D), fainit(3D), faintro(3D),
          farectwrite(3D), faroll(3D), fawrite(3D)






































     Hewlett-Packard               - 2 -            (printed 12/14/84)