Previous: x/ zvtrans_inb Up: Translation Routines Next: x/ zvtrans_out

x/ zvtrans_inu

call xvtrans_inu(buf, stype, dtype, unit, status)
status = zvtrans_inu(buf, stype, dtype, unit);

Set up a translation buffe for input from a file. This routine is exactly like x/ zvtrans_in except that the SIHOST and SRHOST values are obtained from the file specified by UNIT, which must be open. It is provided merely as a shortcut for the common case of reading image data from a labeled file.

Arguments:

• BUF: integer-array(12), output

  BUF is the translation buffer that this routine will set up, describing the translation to be performed.

• STYPE: string, input

  STYPE is the source data type. It corresponds to the FORMAT label item in a file. It may be one of the standard VICAR data types: ``BYTE'', ``HALF'', ``FULL'', ``REAL'', ``DOUB'', or ``COMP''. The types ``WORD'', ``LONG'', and ``COMPLEX'' are also accepted, but are obsolete and should not be used.

• DTYPE: string, input

  DTYPE is the desired destination data type. It corresponds to the FORMAT label item in a file. It may be one of the standard VICAR data types: ``BYTE'', ``HALF'', ``FULL'', ``REAL'', ``DOUB'', or ``COMP''. The types ``WORD'', ``LONG'', and ``COMPLEX'' are also accepted, but are obsolete and should not be used.

• UNIT: integer, input

  UNIT is the unit number of an open file, which is used to obtain the source INTFMT and REALFMT. The values obtained from the file are used exactly like the x/ zvtrans_in SIHOST and SRHOST.

• STATUS: integer, output

  The returned status value. It is an argument in Fortran and the function return value in C. Any value other than SUCCESS indicates that the translation is invalid for some reason, and the translation buffer should not be used.