fg_aspect(3)                        CLIX                        fg_aspect(3)



  NAME

    fg_aspect - Determines the aspect ratio of a frame grabber

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    #include <sys/xio/xfg.h>

    int fg_aspect(
      int fgno ,
      int *aspect );

  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.

    aspect   Points to an integer location updated with a value corresponding
             to the aspect ratio.  Current values for aspect, defined in
             <sys/xio/xfg.h> are:

             Value            Aspect Ratio

             FG_ASPECT_1TO1   1 to 1

             FG_ASPECT_4TO3   4 to 3 (NTSC), and 4 to 2.667 (PAL)

  DESCRIPTION

    The fg_aspect() function returns a value corresponding to the aspect ratio
    of the frame grabber in the integer location pointed to by aspect.

  EXAMPLES

    To determine the aspect ratio for frame grabber 0:

    void exit(), perror(), printf();
    if (fg_aspect(0,aspect) != NULL) {
         perror("fg_aspect -- getting aspect ratio");
         exit(2);
    }
    /*
     *   The *aspect parameter now contains a value
     *    corresponding to the aspect ratio.



  2/94 - Intergraph Corporation                                              1

  fg_aspect(3)                        CLIX                        fg_aspect(3)



     */


  RETURN VALUES

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

  ERRORS

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

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

    [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