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

BIFFWRITE

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

 

NAME

biffwrite - write text on a biff image

 

SYNTAX

 biffwrite [<option>...] <input biff file>
   <output biff file> <textfile>
 biffwrite [<option>...] <input biff file>
   <output biff file> -t "<text>"

 

OPTIONS

-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 -posswitch shallindicate 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. fgdetermines foreground color,bgdetermines background color. Default (0 255).

-font bdf-file

Set the character font. bdf-file(Bitmap Distribution Fomatfile) 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 textto write on the BIFF image.

 

DESCRIPTION

biffwritereads 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 onthe image. Other characters (such as `Tab`) will be ignored.The exception is the `newline` character which advances thewriting point to the beginning of the next line.

textfileis the name of the file where the text iscontained. One must either give the name of a textfile or givethe `-t` switch in a call.

The same effects as the options give, can also be achievedby giving commands in the text file. If a line is startedwith a $, the program will look upon the rest of the line asa 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 formatas the corresponding options, and $ob are just thereverse of $nob. `$$` in the start of a line means thatthe first character to write on the picture is `$`.

 

RESTRICTIONS

Only `Bitmap Distribution Format` font files can be used.

 

AUTHOR

Řyvind Hillesund, NR, Copyright NR

 

DEVELOPED BY

BILD, Norsk Regnesentral, Oslo, Norway

 

EXAMPLES

 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

$Id: biffwrite.c,v 2.8 1997/01/29 10:41:31 svein Exp $

---

 

Index

NAME

SYNTAX

OPTIONS

DESCRIPTION

RESTRICTIONS

AUTHOR

DEVELOPED BY

EXAMPLES

ID

---

This document was created byman2html,using the manual pages.