Help for CFORM

PURPOSE
  CFORM is a VICAR applications program which converts images between any
  of the recognized data formats and performs linear transformations
  on images.

EXECUTION

  CFORM  INP  OUT  PARAMS

  where INP and OUT are input and output file parameters and PARAMS are
  other parameter that are described in Tutor mode.

METHOD

  The program reads each image line into a buffer and treats the contents
  of the buffer as data of type implied by the label.  Byte data are read
  in as halfwords.  A simple linear function (stretch) is then applied to 
  these data and they are written out in the output format specified.

  If no format code is specified for OUT the following action is taken:
    1.  If input format is BYTE, then output format is HALF.
    2.  If input format is not BYTE, then output format is BYTE.
 COMPLEX DATA:

  The linear relation between IN and OUT must be qualified for complex
  data according to the following table:

       INPUT        OUTPUT       Transformation Type
      Format        Format

      non-complex   complex       OUT = (IN*SL+OF) + 0.0i
      complex       non-complex   OUT = |IN| * SL + OF
      complex       complex       OUT = IN * SL + OF
EXAMPLES

  CFORM A B (1,1,10,20) IRANGE=(10,20) ORANGE=(-20,2000) OFORM=FULL
    Data set B is fullword integer where the values have been scaled
    linearly such that 10 -> -20 and 20 -> 2000.  Only the first 10
    lines and 20 samples of A are passed to B.

  CFORM A B OFORM=HALF SO=(2,0)
    Data set B's format is a halfword integer, with each input value
    multiplied by 2.
RESTRICTIONS

 The maximum permitted line length (bytes per line) is 60,000 for BYTE
 format and 120,000 otherwise.
COGNIZANT PROGRAMMER

Written by: J. J. Lorre    18 April 1980

REVISION:

Converted to VAX by: Dan Stanfill                          June 1983

Deleted FORMAT parameter, check for overflow in 
real-to-integer conversion, fixed test file
by: L. W. Kamp                                             Feb  1985

Put conversion factors into the label by: Florance Moss    Jan  1988

Current Cognizant Programmer:  L. W. Kamp