FBLABEL 1 BRL-CAD BRL-CAD
fblabel display a text string on a framebuffer
`fblabel` -dca -F framebuffer -f fontname -{sS} squaresize -{wW} width -{nN} height -C r/g/b x_position y_position text_string

## DESCRIPTION

`fblabel` writes a text string to the image on the currently selected framebuffer. The text string will be filtered to the image currently displayed. Use fbpoint 1 to determine where to position the text string. The lower left corner of the text string starts displaying at the x and y position given. The environment variable FB_FILE specifies the current framebuffer; see brlcad 1. Alternatively, the framebuffer may be explicitly specified by using the `-F` flag.

By default, the requested framebuffer size is assumed to be 512x512 pixels.

The `-d` flag is for debugging.

The `-c` flag causes the screen to be cleared before the text string is displayed. The default behavior is to label the current image without clearing the screen.

The `-a` flag causes the text not to be filtered against the frame buffer image.

The `-C` r/g/b option specifies red, green, and blue (r/g/b) values [0..255] for the text. The default color is white.

The `-f` fontname option will change the current default font from nonie.r.12 to "/usr/lib/vfont/fontname".

The `-S` (or `-s`) flag sets the width and the height to the same value; the `-W` (or `-w`) and `-N` (or `-n`) flags are used for setting them individually.

## FONTS

`fblabel` expects the Berkeley fonts in the directory /usr/lib/vfont. The fonts are expected to be in Vax byte order, even if that is not the natural byte order of the machine, to avoid having to create a font converter.

## EXAMPLE

fblabel -f "oldenglish.14" `fbpoint -H` "Hello"

## SEE ALSO

brlcad 1, fbpoint 1, libfb 3, pix 5

## AUTHOR

BRL-CAD Team

## COPYRIGHT

This software is Copyright (c) 1989-2024 by the United States Government as represented by U.S. Army Research Laboratory.

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org