![]() |
Welcome to ftp.nluug.nl Current directory: /ftp/os/Linux/distr/pub/linux/distributions/amigolinux/distro/kiss-4.0/SOURCE/ui/afx-taskbar/Resources/ |
|
Contents of README:----------------- Overview ----------------- taskbar is a small utility that displays a Win95 type taskbar. Having ditched Windows in favor of Linux, I found that I missed the functionality of the taskbar and set off to emulate it. I tried some alternatives (fspanel is what I based most of my work from) but found that there were things I wanted to add or tweaks here and there. So in the essence of learning, I reinvented the wheel. taskbar requires a fairly new window manager. It must support EWMH (enhanced window manager hints). See http://www.freedesktop.org/Standards/wm-spec for the spec and a list of compliant window managers. taskbar also makes use of the Imlib imaging library. taskbar has the ability to load a set of plugins which will be displayed on the right side of the bar (i.e. the 'tray'). I have included some simple plugins such as a clock display as well as an icon that controls my background application for easily switching background images. Custom plugins can obviously be made by using the plugin.h header file. taskbar can optionally be built to support Xft anti-aliased fonts. Use the --enable-xft option to enable it (it defaults to disabled). taskbar was written with speed in mind and is written solely in C and uses low level X calls. I don't have the project on sourceforge yet, but time permitting I'll put it on there. ----------------- Usage ----------------- Usage: ../src/taskbar [OPTION]... Displays a Win95 style taskbar in X -t, --top puts the toolbar on the top of the screen -x, --xft enable the use of Xft antialiased fonts -d, --daemon run as a daemon -f, --font NAME sets the font used -m, --enable-menu enables the start menu -a, --fancy-menu enables Office 2000 style fancy menus -s, --disable-tooltips disables tooltips in the module window -b, --disable-module-border does not draw a rectangular module border -i, --disable-menu-icons do not use icons in the start menu -h, --help displays this help ----------------- .taskbar <EDITED> See Amigo.README for changes to what follows. ----------------- The .taskbar initialization file is read when the application first starts. The only options that the program uses are the start_menu and plugins entries. You can put anything you like in the file (as long as it follows the syntax) but the program will ignore everything except start_menu and plugins. The start_menu section is used when you specify -m on the command line to enable the start menu. plugins are used regardless of the mode. If you make changes to the start_menu section, you can send a SIGHUP to taskbar and the menu will change accordingly. The syntax of the .taskbar file is very simple. You specify a item and a value. A value can be a group of other items and values. The entries underneath the start menu are pretty self-explanatory. Each subitem becomes a submenu. You can specify items by using item = value or by using item = { icon = ...; cmd = ...;}; This lets you specify an icon for each menu item if you so desire. If you included Imlib support, you can use any image file Imlib knows about (jpgs, pngs, gifs, etc). If not, you can try using xpm files. Most X implementations support the loading of these files. If you use 'default' as your icon value it will show a basic window icon. You can use the special item of 'separator' to include a separator where you wish. Here is a short example describing the start_menu entry start_menu = { Programs = { Emacs = "emacs &"; Gtali = "gtali &"; Mozilla = { icon = /usr/share/pixmaps/mozilla.xpm; cmd = "MozillaFirebird &"; }; separator = "dummy"; Editors = { Abiword = "abiword &"; Gnumeric = { cmd = "gnumeric &"; icon = /usr/share/pixmaps/gnumeric.xpm; }; }; }; Here is a short example describing the plugin entry plugins = { clock = { path = /usr/share/taskbar/libclock.la; }; custom = { path = /usr/share/taskbar/custom.la; }; }; ----------------- Plugin options ----------------- Plugins can take options from the .taskbar file. They are listed under the "options" entry on the same level as the "path" parameter. The options are obviously plugin specific. Here is an example plugins = { my_plugin = { path = /usr/plugin.so; options = { custom_option1 = "45"; custom_option2 = { one = "two"; two = "one"; }; }; }; } --------------------- clock plugin options --------------------- The clock plugin supports the following options: timeFormat = <string> dateFormat = <string> tooltipFormat = <string> The strings are all parameters used in the strftime function (e.g. a simple time format is "%I:%M %p"). Please see the strftime man page for more information. --------------------------- background plugin options --------------------------- The background plugin supports the following options: socket = <string> timeout = <integer> The socket is a path to the background controlling socket (it defaults to /tmp/background). The timeout is the time in milliseconds that it will wait on a query before returning. It defaults to 1000 which is one second. |
Name Last modified Size
Parent Directory -
minipix/ 22-Jan-2006 05:13 -
Amigo.README 27-Apr-2006 19:25 497
README 28-Feb-2011 21:53 5.2K
amigo.taskbar.example 17-May-2005 22:35 866
example_taskbar 05-Dec-2003 00:29 830
taskbar-freetype-includes.diff 03-Nov-2009 19:22 1.4K
taskbar.conf 25-Mar-2009 13:01 1.8K
taskbar.current 12-Jun-2005 19:53 1.3K
NLUUG - Open Systems. Open Standards
Become a member
and get discounts on conferences and more, see the NLUUG website!