FUNCTION c_arcread (arcdesc, mnr, samples)
long *arcdesc; short **mnr; short **samples;
The archive file descriptor returned by c_arcopnrd().
Pointer to a buffer containing the HRPT Minor Frame data for the line read from the image.
Pointer to a buffer containing a line of image data.
Read the next line of data from an AVHRR archive image. Each line will be unpacked into a buffer of INTEGER*2 values. The number of pixels returned in the buffer will depend upon the window that was specified in the call to c_arcopnrd().
If an image is opened for updating, each successive call will write the previously accessed line into the internal buffer and return the next line. When a line is accessed that is not within the internal buffer, the buffer is first written to the image to store any user updates and then refilled. To ensure that updates made to the internal buffer are saved, c_arclose() must be called to write the final contents of the internal buffer to the image.
Ascending images will have their lines returned in the order specified in the call to c_arcopnrd(). All ascending images being read in a "North-up" order will have their pixels flipped before they are returned to the user and they are flipped before being written back to the internal buffer when updating.
The c_arcseek() function can be used to reset the next line that will be returned by this function. Successive calls to this function will then continue sequential processing from that line.
c_arcread() returns
E_SUCC (0) --> Successful completion. E_FAIL (-1) --> Operation failed. E_EOF (-2) --> Operation failed. Every line of the window has been read.