fgfbmode(3)                        CLIX                        fgfbmode(3)



  NAME

    fg_fbmode - Sets the mode of a frame buffer

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    #include <sys/xio/xfg.h>

    int fg_fbmode(
      int fgno ,
      int fbno ,
      int mode

  PARAMETERS

    fgno   The location of the frame grabber on the Shared Resource (SR) Bus.

    fbno   An integer representing a frame buffer number

    mode   An integer representing a frame buffer mode

  DESCRIPTION

    The fg_fbmode() function sets the mode of a frame buffer to FG_DISPLAY,
    FG_GRAB, or FG_SNAP.  If fbno is zero, the mode is set for frame buffer 0.
    Otherwise, the mode is set for frame buffer 1.

    The fgno parameter specifies the location of the frame grabber on the
    Shared Resource (SR) Bus.  The frame grabber in the lowest SR Bus slot
    will be addressed by 0.

    Mode FG_DISPLAY forces the specified frame buffer to continuously provide
    the output video in the selected format.  If both frame buffers are in
    FG_DISPLAY_MODE, the frame buffer specified by fg_priority() is displayed.

    Mode FG_GRAB forces the digitized video signal to be continuously stored
    in the specified frame buffer.

    Mode FG_SNAP will force the specified frame buffer into FG_GRAB mode for
    one frame of video; it will then change the mode for that frame buffer to
    FG_DISPLAY.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of



  2/94 - Intergraph Corporation                                              1

  fgfbmode(3)                        CLIX                        fgfbmode(3)



    the following failure codes is returned.

  ERRORS

    The fg_fbmode() function will fail if one of the following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request.

    [FG_NOT_OWNER]
           The specified frame grabber was not allocated by the calling
           process.

    [FG_INVALID_MODE]
           The value of mode was not specified as FG_DISPLAY, FG_GRAB, or
           FG_SNAP.

  RELATED INFORMATION

    Functions:  fg_priority(3), fg_fbstat(3)

































  2                                              Intergraph Corporation - 2/94