impim - Imports to Terascan Dataset from png, ppm, jpeg, or tiff formats

SYNOPSIS

impim  [ parameter=value ]  [ inputfile outputfile ]
impim  [ parameter=value ]  [ inputfile ... directory ]

Parameters are: var_name, image_format, var_units

DESCRIPTION

impim converts to a Terascan Dataset (TDF) from PNG, JPEG, PPM, or TIFF formats. This command is useful for automatic generation of images in different formats.

impim takes an input image in one of the formats mentioned above and produces a displayable 2-D Terascan dataset. The output variable is byte data.

PARAMETERS

image_format

Specifies the format of the input image. PNG JPEG, PPM, or TIFF are supported now. Valid responses are [ png, ppm, jpeg, tiff]. The default is tiff.

var_name

Specifies the name of the destination variable to be imported to. PPM images, being 24 bit, are always imported to variable datasets named "red", "green", "blue", which override a specified var_name.

var_units

OPTIONAL. Specifies the units associated with the image data. The default is none ("-").

EXAMPLES

In this example a TIFF image is converted to a Terascan dataset, with var_name "image" applied to the output variable. Units "unitname" are specified.

%  impim var_units=unitname /home/exp/tifftestout .
var_name       : char( 31) ? image
image_format   : char(  4) ? [tiff]

% contents tifftestout
printout       : char(  3) ? [no]
Contents of File: tifftestout    Page 1

Dimension       Size            Coord           Scale      Offset
 line            1111            y                  1           0
 sample          1144            x                  1           0

Attribute       Type            Units           Value
 history         byte

Variable        Type            Units
 image           byte            unitname

Variable        Dimension       Size
 image           line            1111
 image           sample          1144

Variable            BadValue    ValidMin    ValidMax       Scale      Offset
 image                   255           0         255           1           0

In this example a PPM image is converted to a Terascan dataset. Notice that var_name "image" is not applied, as ppm images are always imported to "red", "green", "blue" variables. No units are specified.

% impim
in/out files   : char(255) ? /home/exp/ppmtestout .
var_name       : char( 31) ? image
image_format   : char(  4) ? [tiff] ppm

% contents ppmtestout
printout       : char(  3) ? [no]
Contents of File: ppmtestout    Page 1

Dimension       Size            Coord           Scale      Offset
 line            1111            y                  1           0
 sample          1144            x                  1           0

Attribute       Type            Units           Value
 history         byte

Variable        Type            Units
 red             byte            -
 green           byte            -
 blue            byte            -

Variable        Dimension       Size
 red             line            1111
 red             sample          1144
 green           line            1111
 green           sample          1144
 blue            line            1111
 blue            sample          1144

Variable            BadValue    ValidMin    ValidMax       Scale      Offset
 red                     255           0         255           1           0
 green                   255           0         255           1           0
 blue                    255           0         255           1           0

Last Update: $Date: 1999/05/10 20:14:24 $