pdi_setup(3)                        CLIX                        pdi_setup(3)



  NAME

    pdi_setup - Establishes parameters for a Processed Data Interface port

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int pdi_setup(
      int channel ,
      int resolution ,
      int linewidth ,
      int write_valid );

  PARAMETERS

    channel       An integer representing a Processed Data Interface port

    resolution    An integer used to determine rejected data (see below)

    linewidth     An integer used to determine rejected data (see below)

    write_valid   An external hardware flag

  DESCRIPTION

    The pdi_setup() function establishes transfer parameters for the Processed
    Data Interface (PDI) port on the Image System Interface (ISI) board
    referenced by channel.  The channel parameter must have been opened with
    pdi_open().

    The resolution and linewidth parameters are used together to determine
    what data is rejected by hardware on a pdi_read().  This should reduce
    memory and time requirements.  The accepted data consists of the first
    linewidth bytes from each consecutive set of resolution bytes.  All other
    data is rejected.  If the concepts of resolution and linewidth do not
    apply, both should be set to 1.  Possible values are 1, 32, 64, 128, 256,
    512, and 1024.  The value of linewidth must always be less than or equal
    to resolution.  The default value for both parameters is 1.

    The write_valid flag asserts a hardware signal to be interpreted by the
    external hardware.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the following failure codes is returned.



  2/94 - Intergraph Corporation                                              1

  pdi_setup(3)                        CLIX                        pdi_setup(3)



  ERRORS

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

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

    [ISI_CHANNEL_NOT_OPEN]
           The specified channel is not open for this process.

    [ISI_INVALID_PARMS]
           The values for resolution and linewidth do not meet the stated
           requirements.

  RELATED INFORMATION

    Functions:  pdi_open(3)

    Files:  xpdi(7)


































  2                                              Intergraph Corporation - 2/94