#include "acqio.h"
FUNCTION c_acqhead (fdesc, year, station, dtype, pass)
long *fdesc; long *year; long *dtype; char *station; struct SATPASS *pass;
File descriptor for an AVHRR acquisition image returned from c_acqopen().
Two-digit year in which the image was acquired.
Data type of the image (GAC, HRPT, LAC).
Three character CEOS ID of the receiving station that acquired the image. See ceos;ids in ADAPSTABLES for a list of valid IDs.
A structure describing the image at the start of the pass. This includes the satellite number, data type, CEOS ID, date, time, clock error, and number of lines and samples.
c_acqhead() reads and extracts the information contained in the header of an AVHRR acquisition image. For those receiving stations that do not create a header record, default information will be stored in the SATPASS structure. c_acqhead() also sets the file pointer to the first line of data in the acquisition file.
c_acqhead() returns
E_SUCC (0) --> Successful completion. E_FAIL (-1) --> Operation failed.