%N xyread %F $MIR/src/subs/xyio.c
%D Read a row from an image.
%: image-i/o
%B
FORTRAN call sequence:
        subroutine xyread(tno,index,array)
        integer tno,index
        real array(*)

  This reads a single row from an image. This accesses the plane given
  by the last call to xysetpl.

  Input:
    tno         The image file handle, returned by xyopen.
    index       The row number to read. This varies from 1 to NAXIS2.
  Output:
    array       The read row. NAXIS1 elements are returned.             
