1420eb1d170f3d16270342ebe9b7c0a38ede7d75
[xscreensaver] / local / man / cat.1 / flag.1
1
2
3
4 XScreenSaver(1)                                   XScreenSaver(1)
5
6
7 N\bNA\bAM\bME\bE
8        flag - draws a waving flag, containing text or an image
9
10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
11        f\bfl\bla\bag\bg  [-display  _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn]  [-foreground _\bc_\bo_\bl_\bo_\br]
12        [-background _\bc_\bo_\bl_\bo_\br] [-window] [-root]  [-mono]  [-install]
13        [-visual  _\bv_\bi_\bs_\bu_\ba_\bl] [-ncolors _\bi_\bn_\bt_\be_\bg_\be_\br] [-delay _\bm_\bi_\bc_\br_\bo_\bs_\be_\bc_\bo_\bn_\bd_\bs]
14        [-cycles _\bi_\bn_\bt_\be_\bg_\be_\br] [-size _\bi_\bn_\bt_\be_\bg_\be_\br]  [-text  _\bs_\bt_\br_\bi_\bn_\bg]  [-font
15        _\bf_\bo_\bn_\bt] [-bitmap _\bx_\bb_\bm_\b-_\bf_\bi_\bl_\be]
16
17
18 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
19        The _\bf_\bl_\ba_\bg program draws a waving flag that contains text or
20        a bitmap.
21
22 O\bOP\bPT\bTI\bIO\bON\bNS\bS
23        _\bf_\bl_\ba_\bg accepts the following options:
24
25        -\b-w\bwi\bin\bnd\bdo\bow\bw Draw on  a  newly-created  window.   This  is  the
26                default.
27
28        -\b-r\bro\boo\bot\bt   Draw on the root window.
29
30        -\b-m\bmo\bon\bno\bo   If   on  a  color  display,  pretend  we're  on  a
31                monochrome display.
32
33        -\b-i\bin\bns\bst\bta\bal\bll\bl
34                Install a private colormap for the window.
35
36        -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
37                Specify which visual to use.  Legal values are the
38                name  of a visual class, or the id number (decimal
39                or hex) of a specific visual.
40
41        -\b-n\bnc\bco\bol\blo\bor\brs\bs _\bi_\bn_\bt_\be_\bg_\be_\br
42                How many colors  should  be  used  (if  possible).
43                Default 200.
44
45        -\b-c\bcy\byc\bcl\ble\bes\bs _\bi_\bn_\bt_\be_\bg_\be_\br
46
47
48        -\b-c\bco\bou\bun\bnt\bt _\bi_\bn_\bt_\be_\bg_\be_\br
49
50
51        -\b-s\bsi\biz\bze\be _\bi_\bn_\bt_\be_\bg_\be_\br
52                How large the pixels in the flag should be, from 1
53                to 8.  If this is a  negative  number,  the  pixel
54                size is chosen randomly from the range 1 to -size.
55                Default -7.
56
57        -\b-t\bte\bex\bxt\bt _\bt_\be_\bx_\bt
58                The text to display in the flag.   Multiple  lines
59                of  text  are allowed; the lines will be displayed
60                centered atop one another.  Default: none.  If the
61
62
63
64 X Version 11                24-May-97                           1
65
66
67
68
69
70 XScreenSaver(1)                                   XScreenSaver(1)
71
72
73                text  is  the  magic  string _\b"_\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b)_\b", then the
74                text used will be the local machine name;  a  new-
75                line; and the local OS version.
76
77        -\b-b\bbi\bit\btm\bma\bap\bp _\bx_\bb_\bm_\b-_\bf_\bi_\bl_\be
78                The bitmap to display in the flag; this must be an
79                XBM file (color XPMs are not  allowed.)   Default:
80                none.    If   the   bitmap  is  the  magic  string
81                _\b"_\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b)_\b", then the bitmap used will be a charm-
82                ing little picture of J. R. "Bob" Dobbs.
83
84                If  neither  _\b-_\bt_\be_\bx_\bt nor _\b-_\bb_\bi_\bt_\bm_\ba_\bp are specified, then
85                either the builtin text or the builtin bitmap will
86                be chosen randomly.
87
88        -\b-f\bfo\bon\bnt\bt _\bf_\bo_\bn_\bt
89                The font in which to draw the text; the default is
90                "-*-helvetica-bold-r-*-240-*".
91
92 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
93        D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
94
95        X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
96                to get the name of a resource file that  overrides
97                the  global  resources stored in the RESOURCE_MAN-
98                AGER property.
99
100 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
101        X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), x\bxl\blo\boc\bck\bk(1)
102
103 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
104        Copyright (C) 1996 Charles Vidal.
105
106        Permission to use, copy, modify, and distribute this soft-
107        ware and its documentation for any purpose and without fee
108        is hereby  granted,  provided  that  the  above  copyright
109        notice  appear  in all copies and that both that copyright
110        notice and this permission  notice  appear  in  supporting
111        documentation.
112
113
114 A\bAU\bUT\bTH\bHO\bOR\bR
115        Charles Vidal <vidalc@univ-mlv.fr>, 1996.
116
117        Ability  to  run  standalone or with _\bx_\bs_\bc_\br_\be_\be_\bn_\bs_\ba_\bv_\be_\br, and the
118        -text  and  -bitmap  options,  added  by  Jamie   Zawinski
119        <jwz@jwz.org>, 24-May-97.
120
121
122
123
124
125
126
127
128
129
130 X Version 11                24-May-97                           2
131
132