fg_genlock(3)                       CLIX                       fg_genlock(3)



  NAME

    fg_genlock - Gen-locks the output video with the input reference on the
    frame grabber

  LIBRARY

    Intergraph Device Library ((libix.a))

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int fg_genlock(
      int fgno ,
      int enable );

  PARAMETERS

    fgno     Specifies the frame grabber's location on the Shared Resource
             (SR) Bus.  The frame grabber in the lowest SR Bus slot will be
             addressed by 0.

    enable   Indicates whether gen-locking will be enabled or disabled, and if
             nonzero, gen-locking will be enabled.

  DESCRIPTION

    The fg_genlock() function enables or disables the frame grabber's gen-
    locking function.  Gen-locking synchronizes the frame grabber's output
    video to an input source-either the RGB input, or the composite input
    (NTSC or PAL).  This allows switching to occur between the input source
    and the frame grabber's output video without loss of signal when video
    recordings are being made.

  EXAMPLES

    To synchronize the input source and output video on frame grabber 0:

    void exit(), perror();
    if (fg_genlock(0, 1) != NULL)
         perror("fg_genlock -- gen-locking video");
         exit(2);
    }


  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, either
    XIO_FAILURE, NO_SUCH_FUNCTION, FG_NOT_PRESENT, or FG_NOT_OWNER is
    returned.



  2/94 - Intergraph Corporation                                              1

  fg_genlock(3)                       CLIX                       fg_genlock(3)



  ERRORS

    The fg_genlock() function fails if one of the following is true:

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

    [NO_SUCH_FUNCTION]
           The specified frame grabber does not support this function.

    [FG_NOT_PRESENT]
           The specified frame grabber is not available.

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

  RELATED INFORMATION

    Miscellany:  intro(3)

































  2                                              Intergraph Corporation - 2/94