flag(1)

flag1

Draws a waving flag, containing text or an image

Usage

flag [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-delay microseconds] [-cycles integer] [-size integer] [-text string] [-font font] [-bitmap xbm-file]

Overview

The flag program draws a waving flag that contains text or a bitmap.

Options

flag accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-install

Install a private colormap for the window.

-visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

-ncolors integer

How many colors should be used (if possible). Default 200.

-cycles integer
-count integer
-size integer

How large the pixels in the flag should be, from 1 to 8. If this is a negative number, the pixel size is chosen randomly from the range 1 to -size. Default -7.

-text text

The text to display in the flag. Multiple lines of text are allowed; the lines will be displayed centered atop one another. Default: none. If the text is the magic string "(default)", then the text used will be the local machine name; a newline; and the local OS version.

-bitmap xbm-file

The bitmap to display in the flag; this must be an XBM file (color XPMs are not allowed.) Default: none. If the bitmap is the magic string "(default)", then the bitmap used will be a charming little picture of J. R. "Bob" Dobbs.

If neither -text nor -bitmap are specified, then either the builtin text or the builtin bitmap will be chosen randomly.

-font font

The font in which to draw the text; the default is "-*-helvetica-bold-r-*-240-*".

Environment

DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

Releases

4 releases since Debian 2.0 (Hamm); the text changed 1 time.

  1. 2.0
  2. 2.1–3.0

Author

Charles Vidal <[email protected]>, 1996.

Ability to run standalone or with xscreensaver, and the -text and -bitmap options, added by Jamie Zawinski <[email protected]>, 24-May-97.

From xscreensaver 3.34-3 in Debian 3.0 (Woody). Parsed by carta from the page's man source.