Function: CFTSI_GETC Purpose: Gets compressed integer data from a FITS tape. Category: FITS File: cfts_io.c Author: Do Kester Use: INTEGER CFTSI_GETC( MTID, Input INTEGER COMPS, Output INTEGER LENGTH, Input INTEGER TID ) Input/Output INTEGER CFTSI_GETC Returns: >0 - number of integers transferred to ARRAY. =<-10 - tape error (see MTIODEV.DC2) -11 - not a FITS file. -12 - found and skipped tape label -13 - double tape mark found, tape skipped back to before second tape mark. -20 - could not get enough memory for internal ftsbuf. -22 - conversion error -30 - Unknown mtid -31 - Only forward skipping allowed. MTID A device unit number as obtained from MTOPEN. COMPS Target array for the data. LENGTH Length of ARRAY TID Tranfer ID from CFTSD_GETH. If non zero on output more data is left on tape, thus subsequent calls of CFTSI_GETI are nessecary. TID=0 ends a series of calls. TID=0 occurs at the end of file mark. After TID=0 the tape is positioned befor end of file. Description: The raw-raw values on the tape are returned i.e. the entries in the difference table. When the fits file is not compressed normal fits integers are returned. Updates: 07 Mar 1991 DK document creation