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: