1XOSD(1xosd)                                                        XOSD(1xosd)
2
3
4

NAME

6       osd_cat - X on-screen file displayer
7

SYNOPSIS

9       osd_cat [OPTION] [FILE]...
10       osd_cat -b percentage|slider [OPTION]
11

DESCRIPTION

13       Display FILE, or standard input, on X screen.
14
15       -p, --pos=POS
16              This  option tells osd_cat where to display the text. POS can be
17              top, middle, or bottom. The default is top.
18
19       -o, --offset=OFFSET
20              This option specifies the offset  from  the  top  or  bottom  of
21              screen the text is displayed. The default is 0.
22
23       -A, --align=ALIGN
24              This  option  tells osd_cat where to display the text. ALIGN can
25              be left, right or center. The default is left.
26
27       -i, --indent=OFFSET
28              This option specifies the INDENT from the  left  of  screen  the
29              text is displayed. The default is 0.
30
31       -f, --font=FONT
32              This  option  specifies  the  FONT to be used for displaying the
33              text. The default is fixed.
34
35       -c, --color=COLOR
36              This option specifies the COLOR to be used  for  displaying  the
37              text. The default is red.
38
39       -d, --delay=TIME
40              This  option  specifies  the  number of seconds the text is dis‐
41              played. The default is 5 seconds.
42
43       -l, --lines=LINES
44              This option specifies the number of LINES to scroll the  display
45              over. The default is 5.
46
47       -s, --shadow=OFFSET
48              This option specifies the OFFSET of the text shadow. The default
49              is 0, which means no text shadow is created.
50
51       -a, --age[=SCROLL_AGE]
52              This option affects screen redrawing. If SCROLL_AGE seconds pass
53              before  a  new line is ready (for example, you're reading from a
54              pipe), all lines are cleared at once instead of  being  scrolled
55              off as new lines replace old lines. The default is 0.
56              When  no  SCROLL_AGE is explicitly given, the current value from
57              DELAY is used.
58
59       -w, --wait
60              This option also affects screen redrawing. When  there  is  data
61              ready  to  be  put  on screen, this option will cause osd_cat to
62              wait until the display is clear. An alternative to scrolling.
63
64       -b, --barmode=TYPE
65              Lets you display a percentage or  slider  bar  instead  of  just
66              text.   TYPE  may be percentage or slider.  In this mode no text
67              is read from any file, but the following options can be used:
68
69       -P, --percentage=PERCENTAGE
70              This option specified the position of the  percentage  /  slider
71              bar.   PERCENTAGE may be in the range from 0 to 100, the default
72              is 50.
73
74       -T, --text=TEXT
75              This option specifies an  optional  TEXT  which  gets  displayed
76              above  the  percentage  bar.   The default is empty, so no addi‐
77              tional text is displayed.
78
79       -h, --help
80              display help (which is often more up to date) and exit
81
82       With no FILE, or when FILE is -, read standard input.
83

AUTHOR

85       Martijn van de Streek <martijn@foodfight.org>, Some  patching  done  by
86       Malcolm    Valentine    <farkit@iprimus.com.au>    and    Tim    Wright
87       <tim@ignavus.net>.
88       xosd was written by Andre Renaud <andre@ignavus.net> and is  maintained
89       by Tim Wright <tim@ignavus.net>
90

SEE ALSO

92       More  information  on  the X OSD Library and its author can be found on
93       http://www.ignavus.net/software.html
94       ⟨http://www.ignavus.net/software.html⟩
95

97       It is distributed under the GNU General Public License.
98
99
100
101X OSD cat                        January 2001                      XOSD(1xosd)
Impressum