Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki SQP-dev
The latest stable release is the *3.4.0* : How to install it here.
Note: We just switched from BZR to Git on Github! (only to host the code and your future pull requests)
Information : The version displayed on this page is not the latest available.
History View code

Glx-Dock / Cairo-Dock

Home

History

Language

en English

Support Us

Flattr this

Cairo-Dockon

SQP-dev

Gauges themes creation or modification is really easy, so don't be afraid to try it.
Besides the few common options, you will have to declare at least one indicator key to handle your applet values.

Indicator : One or many ?
If your theme defines only one indicator, and the applet using the theme have more than one value to display, it will share the available space between values to display. The indicator options you defined will be used for all gauge values. Only the size and position of each gauge area will change according to the multi_display setting you choosed.

If your theme defines more than indicator, then those multi gauges positions will remain stable, and your theme will always display the same number of gauges. So it would be better used with a number of monitored values close to the number of indicators defined. (too few and you will keep empty values, or if many monitors would be dropped)

Display value
There is two way to display values :
  • Images : The theme will use the current value to choose which image to display from the list. An effect can also be applied to this image before display.
  • Needle : The theme will show a needle whose position will depend on current value and theme settings.

The gauge theme keys
Using the XML format, you must provide values between opening and closing XML keys.
The first key is the gauge key which will contain all other options.
  • name : Defines theme name. Will be displayed in theme select list.
  • author : Author name shown with theme details.
  • file : With a parameter key="foreground" or key="background", give the name of an image to add around your gauge image.
  • multi_display : Choose how multi gauges are displayed (for themes with only 1 indicator). (More to come if you have ideas or needs).
    • 0 : scattered (default) - 2/3 size main gauge on top left for first one. 1/3 size for the next three, with position in that order : bottom right, top right, bottom left. Fifth and higher are dropped.
    • 1 : shared - space will be evenly shared between gauges. So if you have 3, each one will have 33.3% width allocated.
  • indicator
    • text_zone : Defines the area used to display text value.
      • x_center : Position of area center on X axis. From -0.5 to 0.5
      • y_center : Position of area center on Y axis. From -0.5 to 0.5
      • width : Area width. From 0 to 1
      • height : Area height. From 0 to 1
      • red : Red part for text color. From 0 to 255
      • green : Green part for text color. From 0 to 255
      • blue : Blue part for text color. From 0 to 255

The indicator also have different keys depending on which display mode you will use.

Indicator Images

You need to provide at least one image to use the image list. The gauge renderer will select which one should be displayed according to the current gauge value.
  • indicator
    • file : With a parameter key="image", you must define at least one image to be displayed.
    • effect : Effect to apply to the current gauge image. (More to come if you have ideas or needs).
      • 0 : no effect (default)
      • 1 : crop - from bottom to top
      • 2 : stretch - from bottom to top
      • 3 : zoom - centered
      • 4 : fade

Indicator Needle


Welcome to SQP developpement report page


This page will give some examples, and a way to test some options I'm working on to improve the dock. First I'd like to say that options showed here are activated on my configuration, and I would be the first affected by big regressions. I'll try to track all possibles drawbacks that would affect original dock behaviour (other than those intended or known issues I could list)

Give Feedback

As all those are still tests, every opinion is more than welcomed. So whether you love or hate them, or want to change something, or suggest new options related, we would be really pleased to know what you think of those ideas. Even better if you test and comment patches listed here.

It is possible on these threads :
Don't worry if thread is in french, just add your comment

Installation
Just a little variation from default bzr install, , you may find dependencies list and answers to common problems on the BZR dedicated page
# download branch
bzr checkout --lightweight lp:~meuarrr/cairo-dock-core/gauge-theme

# prepare cairo-dock-core/build directory
cd cairo-dock-core && mkdir build && cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr

# build and install
make -j $(grep -c ^processor /proc/cpuinfo) && sudo make install ## or use root for the make install if you don't have sudo activated


If all this is ok, you just have to restart the dock

To recompile, go back to cairo-dock-core/build, launch make clean and the build line (the one starting with make)
The build dir can be safely removed (after make install is better) to restart the process

Theme GUI
  • Changed the Theme GUI to flexible behaviour. This remove resizing problems when selecting themes, and a better look/usage when resized

Launchers GUI
  • Add group desktop with desklets in treeview
  • Use applets full config panel
  • Cosmetic upgrade
    • Increased size : 1100x600 instead of 1000x500.
    • Set left pane min size to 180, no automatic resize.
    • Icons first, size 24.
    • Renamed separators to ------.
    • Use close button.
    • Disabled status bar.
  • Changed orders of options in launcher, separator and subdock pages to be more consistant :
    • First group name is icon type, with position and name (+exec).
    • Second group is for display options

Dock Menu
  • Main Menu : Move Add group after Move group, removed "Add a" texts
  • Main Menu : Use Launchers GUI for applet config
  • Submenu : Switch configure before configure subdock to keep it at first place

Options below are for OpenGL mode only atm
Need more tests and comments before activating them for cairo renderer too


Gauge Theme Effects
Description
This minor patch enhance gauge thème abilities. Actually, besides the common part for fore/background images and text, there is only two way to show values : give a needle svg and settings, or a image list and let the dock display one in the range. This patch just add the ability to apply an effect to that displayed image. Effects currently available are crop, stretch, zoom and fade.

My first idea was to have a small fluid gauge bar. The fluid part was almost impossible with current svg implementation : a 20 images theme was painfull to make for me, and would only have give a 5% step precision (100/nb images). So I tracked a way to add a crop effect to a gradient svg image, and found way more.

Benefits
    • Accurate display : every little variation can be displayed and is animated
    • New unexplored resizables themes with ratio independant textures.
    • The gauges bar looks really cool and integrates really well in the dock
    • Combine those two options to get a 10 ou 15px large applet that give you instant information
    • Multiply it with the ability to still give a list of images, and combine effect with different images.
    • And all this is easier to use than ever : get an image, add a background, set effect and text options in a theme file, and you've got your own theme. You can even submit it so others can enjoy it too !
    • Current themes aren't affected (unless you want to activate effect by editing them, the wifi square looks cool with zoom or fade effect)

Examples

Themes
Only two test themes are available at the moment. Based on crop effect to have a fluid gauge bar, the first only have one simple svg gradient, and the second is the same with 2 more images to change bar base color for high values.


<gauge>
    <name>Fluid Reggae</name>
    <author>SQP</author>
    <file key="foreground">foreground.svg</file>
    <file key="background">background.svg</file>
    <multi_display>1</multi_display>
    <indicator>
        <effect>1</effect>
        <file key="image">bar.svg</file>
        <file key="image">bar.svg</file>
        <file key="image">bar.svg</file>
        <file key="image">bar_yellow.svg</file>
        <file key="image">bar_red.svg</file>
        <text_zone>
            <x_center>-0</x_center>
            <y_center>-0,1</y_center>
            <width>0,8</width>
            <height>0,8</height>
            <red>0</red>
            <green>0</green>
            <blue>0</blue>
        </text_zone>
    </indicator>
</gauge>

Gauge theme : Theme rotation
Using new renderer option, activated for gauges only (opengl only atm) with user settings.
  • 0 : no (default) - don't do anything.
  • 1 : with dock oritentation - rotate only if the dock is in vertical position. Allow easy swapping.
  • 2 : yes - applet is always rotated. This give more orientation option when enabling multi gauges and resizing. Usefull for docklet too.


This last patch has no effect until you update the two tweaked modules : system monitor and netspeed
# download branch
bzr checkout --lightweight lp:~meuarrr/cairo-dock-plug-ins/gauge-theme

# prepare cairo-dock-plug-ins/build directory
cd cairo-dock-plug-ins && mkdir build && cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr

# build and install
make -j $(grep -c ^processor /proc/cpuinfo) && sudo make install ## or use root for the make install if you don't have sudo activated


Glx-Dock / Cairo-Dock Wiki SQP-dev Top

Online users :

Powered by ElementSpeak © 2007 Adrien Pilleboue, 2009-2013 Matthieu Baerts.
Dock based on CSS Dock Menu (Ndesign) with jQuery. Icons by zgegball
Cairo-Dock is a free software under GNU-GPL3 licence. First stable version created by Fabounet.
Many thanks to TuxFamily for the web Hosting and Mav for the domain name.