biffwrite
[ XITE Reference Manual | XITE home ]
Contents
Name
biffwrite - write text on a biff image
biffwrite [<option>...] <input biff file>
<output biff file> <textfile>
biffwrite [<option>...] <input biff file>
<output biff file> -t "<text>"
-
-band band-number
- What image band to write the text to. Default 1.
-
-pos xstart ystart
- The position of the text window in the image. Default: `1 1`,
the upper left corner of the image.
-
-relx char
- Chooses if the x coordinate given by the -pos switch shall
indicate the leftmost pixel of the text window (-relx l),
the rightmost (-relx r), or the center pixel (-relx c).
Default: -relx l.
-
-fb fg bg
- Set the color of the text. fg determines foreground color,
bg determines background color. Default (0 255).
-
-font bdf-file
- Set the character font. bdf-file (Bitmap Distribution Fomat
file) is the full filename of some .bdf font. Default:
helvB12.bdf (Helvetica bold 12pt).
-
-nob
- Don't write the background pixels of the text on the image.
-
-t text
- The text to write on the BIFF image.
biffwrite reads from a textfile or from the text after the
`-t` switch, and writes the characters on a biff image band.
Only the ASCII numbers defined in the font will be written on
the image. Other characters (such as `Tab`) will be ignored.
The exception is the `newline` character which advances the
writing point to the beginning of the next line.
textfile is the name of the file where the text is
contained. One must either give the name of a textfile or give
the `-t` switch in a call.
The same effects as the options give, can also be achieved
by giving commands in the text file. If a line is started
with a $, the program will look upon the rest of the line as
a command. The following commands can be used:
$band <band_nr>
$pos <xstart> <ystart>
$relx <l/c/r>
$font <name of a Bitmap distribution font file>
$fb <foreground colour> <background colour>
$nob
$ob
The first six commands have the same meaning and format
as the corresponding options, and $ob are just the
reverse of $nob. `$$` in the start of a line means that
the first character to write on the picture is `$`.
Only `Bitmap Distribution Format` font files can be used.
Øyvind Hillesund, NR, Copyright NR
BILD, Norsk Regnesentral, Oslo, Norway
biffwrite image.biff newimage.biff textfile.txt
biffwrite image.biff newimage.biff textfile.txt
-font /local/X11R5/mit/fonts/bdf/75dpi/courB10.bdf
-pos 23 30 -band 3 -fb 255 0 -nob
zcat pant.2.biff.Z | biffwrite - - -t "HEADING" \
-relx c |xshow
$Id: biffwrite.c,v 2.8 1997/01/29 10:41:31 svein Exp $