diff options
author | gotmor <gotmor@f2baff5b-bf2c-0410-a398-912abdc3d8b2> | 2007-07-26 18:03:11 +0000 |
---|---|---|
committer | gotmor <gotmor@f2baff5b-bf2c-0410-a398-912abdc3d8b2> | 2007-07-26 18:03:11 +0000 |
commit | 01b1340983b8f04022e5d90260509542cd67e339 (patch) | |
tree | 7f45d4f1a74f340c77a7aa90f4f9d25683994c80 /README | |
parent | 1fa1ebd11ca31c993937f59020dd8f5e4fbb842e (diff) | |
download | dzen-01b1340983b8f04022e5d90260509542cd67e339.tar.gz dzen-01b1340983b8f04022e5d90260509542cd67e339.zip |
fixed X*DrawString handling
added support to the in-text parser for rectangle drawing
ready for release
0.7.0
git-svn-id: http://dzen.googlecode.com/svn/trunk@146 f2baff5b-bf2c-0410-a398-912abdc3d8b2
Diffstat (limited to 'README')
-rw-r--r-- | README | 83 |
1 files changed, 54 insertions, 29 deletions
@@ -1,5 +1,5 @@ ================================== - dzen, (c) 2007 by Robert Manea + dzen, (c) 2007 by Robert Manea ================================== A general purpose messaging, notification and menu program @@ -9,7 +9,7 @@ The "gadgets" subdirectory contains some tools that you can use in combination with dzen. Script archive with a collection of interesting ideas: - http://gotmor.googlepages.com/dzenscriptarchive +^fg(lightblue) http://gotmor.googlepages.com/dzenscriptarchive @@ -26,6 +26,8 @@ Features * menu functionality + * in-text formating language + * flexible event/action mechanism * hideable, collapsable @@ -77,10 +79,10 @@ dzen accepts a couple of options: -tw title window width -sa alignment of slave window, see "-ta" -l lines, see (1) - -e events and actions, see (2) - -m menu mode, see (3) + -e events and actions, ^fg(green)see (2) + -m menu mode, ^fg(green)see (3) -u update contents of title and - slave window simultaneously, see (4) + slave window simultaneously, ^fg(green)see (4) -p persist EOF (optional timeout in seconds) -x x position -y y position @@ -88,12 +90,12 @@ dzen accepts a couple of options: -xs number of Xinerama screen -v version information - For dynamic color support see (5). + see (5) for the in-text formating language. Window layout ------------- +------------- Dzen's window layout is as follows: @@ -146,8 +148,8 @@ A4: Sure, see "(4) Simultaneous updates". Q5: Can i chnage color of my input at runtime? -A5: Yes, you can change both background and foreground colors. - See "(5) Dynamic color support" +A5: Yes, you can change both background and foreground colors and + much more See "(5) In-Text formating language" Q6: Can I use dzen as a menu? @@ -156,11 +158,6 @@ A6: Yes, both vertical and horizontal menus are supported. See "(3) Menu" for further details. -Q7; What is the expected format to the '-fn' option? - -A7: Run 'xfontsel' or 'xlsfonts'. These should come with your X - distribution by default. - Termination: @@ -204,7 +201,7 @@ and down if the content exceeds the window height (default action). (2) Option '-e': Events and actions ----------------------------------- +----------------------------------- dzen allows the user to associate actions to events. @@ -222,7 +219,7 @@ An example: button1=exec:xterm:firefox; on Button1 event (Button1 press on the mouse) execute xterm and firefox. - (Note: xterm and firefox are options to the exec action) + Note: xterm and firefox are options to the exec action entertitle=uncollapse,unhide; on entertitle (mouse pointer enters the title window) uncollapse @@ -374,32 +371,60 @@ of lines to the slave window as defined by the parameter to '-l'. -(5) Dynamic color support: --------------------------- +(5) In-text formating language: +------------------------------- -This feature allows to dynamically (at runtime) set foreground and -background colors for dzen's input (colored text) working in all -modes (title only, slave window and menu mode). +This feature allows to dynamically (at runtime) format the text dzen +displays. -Syntax: +Currently the following commands are supported: -Foreground color: ^fg(color) -Background color: ^bg(color) + ^fg(color) set foreground color + ^bg(color) set background color + ^i(path) draw icon specified by path + ^r(WIDTHxHEIGHT) draw a rectangle with the dimensions + WIDTH and HEIGHT These commands can appear anywhere and in any combination in dzen's -input. The color can be specified either as symbolic name (e.g. red, +input. + +The color can be specified either as symbolic name (e.g. red, darkgreen, etc.) or as #rrggbb hex-value (e.g. #ffffaa). -Doubling the '^' character removes the special meaning from it. +Icons must be in the XBM format, see the "bitmaps" directory for some +sample icons. With the standard "bitmap" application you can easily draw +your own icons, though there are lots floating around on your harddisk +or on the web. + +Rectangles will be truncated to the maximum possible size if you specify +a size bigger than dzen's window. + +Doubling the '^^' character removes the special meaning from it. + Some examples: - ^fg(red)I'm red text ^fg(blue)I am blue + Input: + ^fg(red)I'm red text ^fg(blue)I am blue + + + Input: + ^bg(#ffaaaa)The ^fg(yellow)text to ^bg(blue)^fg(orange)colorize + + + Input: + ^fg(grey70)Some text containing ^^ characters + + + Input for icons: + ^i(bitmaps/envelope.xbm) I am an envelope ^fg(yellow)and ^i(bitmaps/battery.xbm) I'm a baterry. + + + Input for rectangles: + 6x4 rectangle ^r(6x4) ^fg(red)12x8 ^r(12x8) ^fg(yellow)and finally 100x15 ^r(100x15) - ^bg(#ffaaaa)The ^fg(yellow)text to ^bg(blue)^fg(orange)colorize - ^fg(grey70)Some text containing ^^ characters |