biffinfo

[ XITE Reference Manual | XITE home ]

Contents


Name

biffinfo - extract information from biff-file

Syntax

 biffinfo [-f] [-t] [-b] [-u] [-h] [-i] [c] [-n <band>] \\
  [<filename>...] [<dirname>...]

Description

biffinfo reads the info block of one or more images or all images in a directory. If no options are given, the info will be written formatted. See example.

Options

If one or more options are specified (exept -i and -c) the output will be unformatted.

-f
Print the filename
-b
Print number of bands
-n band
Print info for band
 band pixtyp xsize ysize xstart ystart xmag ymag
-u
Print info for all bands
-t
Print the image title
-h
Print text (history) block
-i
Print images only
-c
Print colortables only

You may specify more than one options. In unformatted output, the rules are:
-n or -u is specified
Combine -f -b -n -u -t to one output line/band.
    <filename> <bands> <bandinfo> <title>
    Print text (-h)
Otherwise:
Combine -f -b -t to one line/image
    <filename> <bands> <title>
    Print text (-h)

Return value

0 = success, 2 = failure

Author

Tor Lønnestad and Otto Milvang

Examples

1. Type out all info about a biff-file
 >> biffinfo mona.img

 Filename  : mona.img
 Title     : MONA
 Bands     : 3
 Textlen   : 0
 Band      : Pixeltype Xsize Ysize Xstart Ystart Xmag Ymag
    1        uns_byte   512   512    1      1      1    1
    2        uns_byte   512   768    1      1      1    1
    3        uns_byte   256   256    1      1      1    1
 Textfield :
 Fri Jan 11 15:54:05 1991 addw Weight1: 1.00 Weight2: 1.00

2. Print out the nuber of bands in mona.img
 >> biffinfo -b mona.img
 3

3. Print title of 2 images sent as standard input
 cat mona1.img mona2.img | biffinfo -t - -
 MONA 1
 MONA 2

4. Formattet output: filename bands bandinfo
 >> biffinfo -fbu mona.img
 mona.img 3 1 3 512 512 1 1 1 1
 mona.img 3 2 3 512 768 1 1 1 1
 mona.img 3 3 3 256 256 1 1 1 1

5. List all images in a directory
 >> biffinfo -if /local/blab/img
 /local/blab/mona.img
 /local/blab/mona1.img
 /local/blab/mona2.img

Id

$Id: biffinfo.c,v 1.33 1997/07/11 14:18:52 svein Exp $