FUNCTION c_acqinfo (station, img_typ, skip_head, rec_line, byte_line, mnr_ptr, mnr_siz, tip_ptr, tip_siz, img_ptr, img_siz, img_fmt, swap_flg, flip_flg, sta_name)
char *station; long *img_typ; long *skip_head; long *rec_line; long *byte_line; long *mnr_ptr; long *mnr_siz; long *tip_ptr; long *tip_siz; long *img_ptr; long *img_siz; long *img_fmt; long *swap_flg; long *flip_flg; char *sta_name;
Three character CEOS ID of the desired receiving station. For a list of valid CEOS IDs see ceos;ids in ADAPSTABLES.
Data type of the image (GAC, HRPT, LAC).
The number of header records in the acquisition image.
The number of records per line. A positive value indicates there are rec_line lines contained in a single record of byte_line bytes. A negative value indicates a single line is contained in abs(rec_line) records, each of which is byte_line bytes long.
Total number of bytes used to store a single record. This includes the HRPT Minor Frame, TIP data, and the image data.
Offset in bytes from the beginning of the image line to the start of the HRPT Minor Frame.
Size of the HRPT Minor Frame, in bytes. There are 103 values in the Minor Frame, so a value of 103 indicates that each word of the data is eight bits long, 206 indicates that each ten bit word of data is stored in 16 bits, and 140 indicates that each set of three ten-bit words is packed into 32 bits.
Offset in bytes from the beginning of the image line to the start of the TIP data.
Size of the TIP data, in bytes. There are 520 values in the TIP data, so a value of 520 indicates that each word of the data is eight bits long, 1040 indicates that each ten bit word of data is stored in 16 bits, and 449 indicates that each group of three ten-bit words is packed into 32 bits.
Offset in bytes from the beginning of the image line to the start of the image data.
Size of the image data, in bytes. Each scan line contains 2045 pixel values for GAC data and 10240 pixel values for HRPT and LAC data. For GAC data, a value of 2045 indicates that each word of the data is eight bits long, 4090 indicates that each ten bit word of data is stored in 16 bits, and 2728 indicates that each group of three ten-bit words is packed into 32 bits. For HRPT or LAC data, values of 10240, 20480, and 13656 imply the data is eight bit, unpacked, and packed respectively.
Format of the image.
= BIL (1): Band interleaved by line = BIP (2): Band interleaved by pixel = BSQ (3): Band sequential
Flag indicating if the data needs to be byte swapped before being processed. A value of one indicates the data is in VAX_VMS byte order while a value of zero indicates UNIX byte order.
Flag indicating if ascending passes have been flipped into a "North-up" orientation. A value of one indicates that the receiving station flips all ascending passes while a value of zero indicates that they do not.
Character string containing the name of the receiving station for the specified CEOS ID.
The c_acqinfo() routine retrieves the format of an acquisition image generated by a specified receiving station. The descriptions are located in the station identification file station;ids in ADAPSTABLES.
c_acqinfo() returns
E_SUCC (0) --> Successful completion. E_FAIL (-1) --> Operation failed.