mkImg

[ XITE Reference Manual | XITE home ]

Name

mkImg - make an image with specified size, pixel type and value

Syntax

 mkImg [-xsize <xsize>] [-ysize <ysize>] \\
       [-xstart <xstart>] [-ystart <ystart>] \\
       [-nbands <nbands>] [-title <title>] \\
       [-pt <pt>] [-pv <pv>] [-impv <impv>] <outimage>

Description

mkImg creates an image of any size, pixel type and value, specified by the switches. <outimage> is the name of the new image.

   Switches:           Meaning:        Default value:
 -----------------------------------------------------
 -xsize <xsize>     Horizontal size        512
 -ysize <ysize>     Vertical size          512
 -xstart <xstart>   xstart                 1
 -ystart <ystart>   ystart                 1
 -nbands <nbands>   number of bands        1
 -title <title>     image title            "new image"
 -pt <pt>           pixel type             unsigned byte
 -pv <pv>           pixel value            0
 -impv <impv>       imaginary pixel value  0

If the title contains more than one word, surround it with "double quotes". The pixel type may be given as pixel number or short name, according to the following table:

   Pixel number:    Short name:    Pixel type:
 -------------------------------------------------
        3               ub         unsigned byte
        4               sb         signed byte
        5               us         unsigned short
        6               ss         signed short
        7                i         integer
        8           r or f         real (float)
        9                c         complex
       10                d         double
       11               dc         double complex

The -impv switch is only meaningful in case of complex and double complex pixels, where the "-pv" switch is used to specify real part, and "-impv" the imaginary part.

See also

ascii2biff(1), raw2biff(1)

Diagnostics

Usage 1: Bad number of arguments Error 2: Unknown pixel type Error 3: Malloc failed

Return value

0 if ok, otherwise Error number, see diagnostics.

Author

Tor L|nnestad, BLAB, ifi, UiO

Examples

 mkImg black.img
 mkImg -xsize 256 -ysize 256 -pt c -pv 1.0 -impv 1.0 \\
   cmplx.img

Id

$Id: mkImg.c,v 1.28 1997/03/24 10:14:37 svein Exp $