Help for C

PURPOSE
  C is a VICAR applications program which converts images between all
  recognized format character types and performs linear transformations
  on images.

EXECUTION

  C  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 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

  C 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.

  C 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
Converted to VAX by: Dan Stanfill    June 1983
Last Revision:  L. W. Kamp,  19 Feb. 1985
Current Cognizant Programmer:  L. W. Kamp


PARAMETERS:


INP

Input file name.

OUT

Output file name.

SIZE

Standard VICAR size field

SL

Starting line

SS

Starting sample

NL

Number of lines

NS

Number of samples

IRANGE

Pair of numbers for performing stretch. ORANGE must also be specified.

OFORM

Output storage format.

ORANGE

Output range values for stretch. (See IRANGE.)

SO

(Slope,offset) for linear transformations.

See Examples:


Cognizant Programmer: