MAN page from RedHat Other XITE-3.3-3.i386.rpm

ASCII2BIFF

Section: User Commands (1)
Updated: 16 Mar 1998
Index

NAME

ascii2biff - convert an ascii file to BIFF format

SYNTAX

ascii2biff [-title title] [-pt pixel_type]
<ascii-file> <BIFF-file>

DESCRIPTION

Converts an ascii file to BIFF format.

OPTIONS

pixel_type

One of

ub, uns_byteUnsigned byte, default.

us, uns_shortUnsigned short, 16 bits.

ss, sign_shortSigned short, 16 bits.

i, integerSigned integer, 32 bits.

r, realFloat, 32 bits.

title

Set the output image title to title

ascii-file

Name of input file, "-" for stdin.

BIFF-file

Name of output file, "-" for stdout.

FILE FORMAT

The file is an ordinary ascii file. Comments start with a#or a ;and stop at end of line. Blank lines or commentlines are ignored. Lines with $ in coloumn 1 are treated asspecial arguments. The format is

$<keyword> <1 or 2 arguments>

where <keyword> is one of "type", "size", "xsize", "ysize","start", "xstart", "ystart", "mag", "xmag" or "ymag".

The format for each <keyword> is:
$type   <uns_byte, uns_short, sign_short, integer, real>
$size   <xsize> <ysize>
$xsize  <xsize>
$ysize  <ysize>
$start  <xstart> <ystart>
$xstart <xstart>
$ystart <ystart>
$mag    <xmag> <ymag>
$xmag   <xmag>
$ymag   <ymag>

The keywords will be used as image band arguments. If the sizearguments are omitted, the size is calculated from theorganization of the file. Default start arguments are-(size/2), and default mag arguments are 1.

Pixels inside a line are separated by blanks or tabs. Linesare separated by newline. If pixel type is uns_byte,uns_short, sign_short or integer, the special value -meanslowest legal value, and +means largest legal value.

Example 1

#
$ size 4 3 ; xsize = 4, ysize = 3
3 5 6 4 3 2
7 5 3 2 1 3

The resulting image:
#
# 3 5 6 4
# 3 2 7 5
# 3 2 1 3
#

Example 2

#
3 5 6 4
3 2 7 5
3 2 1 3

The resulting image:
#
# 3 5 6 4
# 3 2 7 5
# 3 2 1 3

RESTRICTIONS

Accepts one band images only.

AUTHOR

Otto Milvang, BLAB, Ifi, UiO

EXAMPLES

1. Convert a formatted text file
ascii2biff -v -pt ss mona.txt mona.img

2. Convert an unformatted text file without write access.
    First create a file, for example mona.def, containing:
    # Definition file for mona.txt
    $type  sign_short  # set pixeltype
    $size 1666 1230    # set xsize ysize
    # ----------------------------------
    Then convert the file with:
    cat mona.def mona.txt | ascii2biff  -pt ss - mona.img

This document was created byman2html,using the manual pages.