Search packages:
 Sourcecode: cairo-dock version 1.5.5.3-repack01.6.2.31.6.2.3-0ubuntu11.6.3.11.6.3.1-0ubuntu12.0.32.0.3-0ubuntu12.0.52.0.5-0ubuntu12.0.8.12.0.8.1-0ubuntu12.0.8.22.0.8.2-12.0.92.0.9-0ubuntu12.1.3-10-lucid2.1.3-10-lucid-0ubuntu12.1.3-62.1.3-6-0ubuntu12.1.3.12.1.3.10-12.1.3.10-22.1.3.10-32.1.3.10-42.1.3.52.1.3.5-12.2.0~0beta42.2.0~0beta4-0ubuntu12.2.0~0rc12.2.0~22.2.0~2-0ubuntu12.2.0~42.2.0~4-0ubuntu12.3.0~0rc1-12.3.0~1-0ubuntu12.3.0~3-12.4.0~0beta2-0ubuntu12.4.0~2-0ubuntu12.4.0~2-1

# cairo-dock-struct.h

/*
* This file is a part of the Cairo-Dock project
*
* E-mail    : see the 'copyright' file.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef __CAIRO_DOCK_STRUCT__
#define  __CAIRO_DOCK_STRUCT__

#include <X11/Xlib.h>
#include <glib.h>
#include <gdk/gdk.h>
#include <gtk/gtk.h>
#include <cairo.h>
#include <librsvg/rsvg.h>
#include <librsvg/rsvg-cairo.h>
#include <glib/gi18n.h>
//#include <X11/extensions/Xdamage.h>

#ifdef HAVE_GLITZ
#include <gdk/gdkx.h>
#include <glitz-glx.h>
#include <cairo-glitz.h>
#endif

#include <GL/gl.h>
#include <GL/glx.h>

/*! \mainpage Cairo-Dock's API documentation.
* \ref intro_sec
*
* \ref install_sec
*
* \ref struct_sec
* -  \ref containers
* -  \ref icons
* -  \ref dock
* -  \ref desklet
* -  \ref dialog
* -  \ref flying
*
* \ref applets_sec
* -  \ref module
* -  \ref generate
* -  \ref definition
* -  \ref sections
* -  \ref useful_functions
* -  \ref opengl
* -  \ref animation
* -  \ref sub-icons
*
* -  \ref steal_appli
* -  \ref data_renderer
* -  \ref multi
* -  \ref render_container
*
*
*
* \n
* \section intro_sec Introduction
*
* Cairo-Dock's API can be divided into 3 parts :
* - the definition of the main classes (dock, icon, etc)
* - utilities functions (interaction with X, GUI, etc)
* - plug-ins framework.
*
* Each class is defined in its own header. When a class is complex, it is divided into several files :
* - "factory" define structures/enums and creation/modification/destruction functions
* - "manager" manage all the ressources needed by a class and all the instances of a class
* - "utilities" are a collection of helper functions.
*
* Cairo-Dock has a <b>decentralized conception</b> : it has a minimalistic core, and lets external modules extend its functionnalities.\n
* This is a strong design, because it allows to extend functionnalities easily without having to hack into the core, which makes the project more stable and allows developpers to use high-level functions only, that are very tested and optimized.\n
* Thus, Cairo-Dock itself has no animation, but has a convenient notification system that allows external plug-ins to animate icons when they want.\n
* We will focus on this system and the plug-ins framework in this document. Part 1 will be seen briefly, and part 2 will be let to your curiosity. This should be enough to quickly be able to write a lot of applets.
*
* \n
* \section install_sec Installation
*
* The installation is very easy. In a terminal, copy-paste the following commands :
* \code
*   ### grab the sources
*   svn co http://svn.berlios.de/svnroot/repos/cairo-dock/trunk CD
*   cd CD/cairo-dock
*   ### compil the dock and install it
*   autoreconf -isf && ./configure --prefix=/usr && make
*   sudo make install
*   ### compil the stable plug-ins and install them
*   cd ../plug-ins
*   autoreconf -isf && ./configure --prefix=/usr && make
*   sudo make install
* \endcode
* You can compil and install any plug-in individually by using the same commands in its own folder.
*
*
* \n
* \section struct_sec Main structures
*
* \subsection containers Containers
* See _CairoContainer for the definition of a Container, and cairo-dock-container.h for a complete description of the Container class.
*
* \subsection icons Icons
* See _Icon for the definition of an Icon, and cairo-dock-icons.h for a complete description of the Icon class.
*
* \subsection dock Dock
* See _CairoDock for the definition of a Dock, and cairo-dock-dock-factory.h for a complete description of the Dock class.
*
* \subsection desklet Desklet
* See _CairoDesklet for the definition of a Desklet, and cairo-dock-desklet.h for a complete description of the Desklet class.
*
* \subsection dialog Dialog
* See _CairoDialog for the definition of a Dialog, and cairo-dock-dialogs.h for a complete description of the Dialog class.
*
* \subsection flying Flying Container
* See _CairoFlyingContainer for the definition of a Flying Container, and cairo-dock-flying-container.h for a complete description of the FlyingContainer class.
*
*
*
* \n
* \section applets_sec External Modules
*
* \subsection module First, what is a module ?
*
* Modules are compiled .so files (that is to say, library) that are plugged into the dock at run-time.
* Due to this fact, they can use any function used by the dock, and have a total interaction freedom on the dock.
* The advantage is that applets can do anything, in fact they are extensions of the dock itself.
* The drawback is that a buggy applet can make the dock unstable.
*
* A module has an <b>interface</b> and a <b>visit card</b> :
*  - the visit card allows it to define itself (name, category, default icon, etc)
*  - the interface defines the entry points for init, stop, reload, read config, and reset datas.
*
* Modules can be instanciated several times; each time they are, an <b>instance</b> is created. This instance will hold all the data used by the module's functions : the icon and its container, the config structure and its conf file, the data structure and a slot to plug datas into containers and icons. All these parameters are optionnal; a module that has an icon is also called an <b>applet</b>.
*
* When instanciating a module, CD will check the presence of an "Icon" group in the conf file. If there is one, it will create an icon accordingly and insert it into its container. If there is a "Desklet" group, the module is considered as detachable, and can be placed into a desklet.
* Here we will focus on applets, that is to say, we will have an icon and a container (dock or desklet).
*
*
* \subsection generate Let's start, how do I create an empty applet ?
*
* Easy ! just go to the "plug-ins" folder, and run the <i>generate-applet.sh</i> script. Answer the few questions, and you're done ! Don't forget to install the plug-in each time you modify it (<i>sudo make install</i> in your applet's folder).
* You can see that the script has created for you the architecture of your applet :
* - in the <b>root</b> folder, you have the "configure.ac", where you can set the version number of your applet, the dependencies, etc
* - in the <b>src</b> folder, you have the sources of your applet. It is common to put the init/stop/reload in applet-init.c, the get_config/reset_config/reset_data in applet-config.c, the notifications in applet-notifications.c, and the structures in applet-struct.h. Of course, you can add as many files as you want, just don't forget to specify them in the Makefile.am
* - in the <b>po</b> folder, you have the translation files. Currently the dock is widely translated into French, Japanese, and Italian.
* - in the <b>data</b> folder, you have the config file, the default icon, and a preview. You will have to choose a default icon that fits your applet, and make a preview that makes users want to try it ;-)
* If you have other files to install, it's here you will do it.
* If you change the name of the default icon (for instance you use an SVG file), don't forget to modify the data/Makefile.am and also the src/Makefile.am.
*
*
* \subsection definition Ok I have a generic applet, how do I define it ?
*
* As we saw, a module must fill a visit card and an interface, to be acecpted by the dock.
* This is done very easily by the \ref CD_APPLET_DEFINITION macro. All you have to give is the name of the applet, its category, a brief description/manual (very important !), and your name.
*
* Once have finished your applet, don't forget to make a nice preview (~200x200 pixels) and a nice default icon, and place them in the <i>data</i> folder.
*
*
* \subsection sections Great, I can see my applet in the dock ! Now, where should I continue ?
*
* We saw that when our applet is activated, an instance is created. It is called <b>myApplet</b>, and it will hold the following :
* - <b>myIcon</b> : this is your icon ! It will act as a drawing surface to represent whatever you want.
* - <b>myDrawContext</b> : a cairo context, to draw on your icon with the libcairo.
* - <b>myContainer</b> : the container your icon belongs to (a Dock or a Desklet). For convenience, the following 2 parameters are availale.
* - <b>myDock</b> : if your container is a dock, myDock = myContainer, otherwise it is NULL.
* - <b>myDesklet</b> : if your container is a desklet, myDesklet = myContainer, otherwise it is NULL.
* - <b>myConfig</b> : the structure holding all the parameters you get in your conf file. You have to define it in applet-struct.h.
* - <b>myData</b> : the structure holding all the ressources loaded at run-time. You have to define it in applet-struct.h.
*
* The framework defines different <b>sections</b>, and all you have to do is to fill them :
*
* - First of all you will have to get your config parameters. This is done in the \ref CD_APPLET_GET_CONFIG_BEGIN/\ref CD_APPLET_GET_CONFIG_END section, in applet-config.c.
* - Each time you add a parameter, think of freeing it if it's a dynamic ressource like a string; this is done in the \ref CD_APPLET_RESET_CONFIG_BEGIN/\ref CD_APPLET_RESET_CONFIG_END section.
* - In a similar way, you will free all the ressources you allocated by myData in the \ref CD_APPLET_RESET_DATA_BEGIN/\ref CD_APPLET_RESET_DATA_END section.
* - After the instance is created, the dock lets you start. This is done in the \ref CD_APPLET_INIT_BEGIN/\ref CD_APPLET_INIT_END section. At this point, myApplet is already fully defined, and myConfig has been filled. Therefore you can already draw on your icon, launch timers, register to notifications, etc.
* - Each time the user changes something in its config, or the desklet is resized, your applet is reloaded. This is done in the \ref CD_APPLET_RELOAD_BEGIN/\ref CD_APPLET_RELOAD_END section. The macro \ref CD_APPLET_MY_CONFIG_CHANGED tells you if something has changed in your config or if it's just a resizing.
* - Last, when your applet is stopped, you have to stop everything you set up in the init (timers, notifications, etc) in the \ref CD_APPLET_STOP_BEGIN/\ref CD_APPLET_STOP_END section.
*
*
*
* When something happens, Cairo-Dock notifies everybody about it, including itself. An applet can register to any notification (see \ref cairo-dock-notifications.h) before or after the dock, to be notified of the event of its choice. When you are notified, the function you registered for this event will be called; it must match the notification prototype as defined in \ref cairo-dock-notifications.h.
*
* For instance if you want to know when the user clicks on your icon, you will register to the \ref CAIRO_DOCK_CLICK_ICON notification.
*
* To register to a notification, you have the \ref cairo_dock_register_notification function. Always unregister when your applet is stopped, to avoid being notified when you shouldn't, with the function \ref cairo_dock_remove_notification_func.
*
* For convenience, there are sections dedicated to the most common events; you just have to fill the corresponding sections :
* - \ref CD_APPLET_ON_CLICK_BEGIN/\ref CD_APPLET_ON_CLICK_END for the actions on right click on your icon or one of its sub-dock.
* - \ref CD_APPLET_ON_MIDDLE_CLICK_BEGIN/\ref CD_APPLET_ON_MIDDLE_CLICK_END for the actions on middle click on your icon or one of its sub-dock.
* - \ref CD_APPLET_ON_DOUBLE_CLICK_BEGIN/\ref CD_APPLET_ON_DOUBLE_CLICK_END for the actions on double click on your icon or one of its sub-dock.
* - \ref CD_APPLET_ON_SCROLL_BEGIN/\ref CD_APPLET_ON_SCROLL_END for the actions on scroll on your icon or one of its sub-dock.
*
* To register to these notifications, you can use the convenient macros :
* - \ref CD_APPLET_REGISTER_FOR_CLICK_EVENT
* - \ref CD_APPLET_REGISTER_FOR_MIDDLE_CLICK_EVENT
* - \ref CD_APPLET_REGISTER_FOR_DOUBLE_CLICK_EVENT
* - \ref CD_APPLET_REGISTER_FOR_SCROLL_EVENT
*
*
* \subsection useful_functions Ok now I have several sections of code to fill. Are there any useful functions to do it ?
* A lot of useful macros are provided in cairo-dock-applet-facility.h to make your life easier :
* - To get values contained inside your <b>conf file</b>, you can use the following :\n
* \ref CD_CONFIG_GET_BOOLEAN & cie
*
* - To <b>build your menu</b>, you can use the following :\n
*
* - To <b>create a surface</b> that fits your icon from an image, you can use the following :\n
*
* - To directly <b>set an image on your icon</b>, you can use the following :\n
* \ref CD_APPLET_SET_IMAGE_ON_MY_ICON & cie
*
* - To trigger the <b>refresh</b> of your icon or container after you drew something, you can use the following :\n
* \ref CD_APPLET_REDRAW_MY_ICON & \ref CAIRO_DOCK_REDRAW_MY_CONTAINER
*
* - To modify the <b>label</b> of your icon, you can use the following :\n
* \ref CD_APPLET_SET_NAME_FOR_MY_ICON & cie
*
* - To set a <b>quick-info</b> on your icon, you can use the following :\n
* \ref CD_APPLET_SET_QUICK_INFO_ON_MY_ICON & cie
*
*
* \subsection opengl How can I take advantage of the OpenGL ?
*
* There are 3 cases :
* - your applet just has a static icon; there is nothing to take into account, the common functions to set an image or a surface on an icon already handle the texture mapping.
* - you draw dynamically on your icon with libcairo (using myDrawContext), but you don't want to bother with OpenGL; all you have to do is to call /ref cairo_dock_update_icon_texture to update your icon's texture after you drawn your surface. This can be done for occasional drawings, like Switcher redrawing its icon each time a window is moved.
* - you draw your icon differently whether the dock is in OpenGL mode or not; in this case, you just need to put all the OpenGL commands into a CD_APPLET_START_DRAWING_MY_ICON/CD_APPLET_FINISH_DRAWING_MY_ICON section inside your code.
*
* There are also a lot of convenient functions you can use to draw in OpenGL. See cairo-dock-draw-opengl.h for loading and drawing textures and paths, and cairo-dock-particle-system.h for an easy way to draw particle systems.
*
*
* \subsection animation How can I animate my applet to make it more lively ?
*
* If you want to animate your icon easily, to signal some action (like <i>Music-Player</i> when a new song starts), you can simply <b>request for one of the registered animations</b> with \ref CD_APPLET_ANIMATE_MY_ICON and stop it with \ref CD_APPLET_STOP_ANIMATING_MY_ICON. You just need to specify the name of the animation (like "rotate" or "pulse") and the number of time it will be played.
*
* But you can also make your own animation, like <i>Clock</i> of <i>Cairo-Penguin</i>. You will have to integrate yourself into the rendering loop of your container. Don't panic, here again, Cairo-Dock helps you !
*
* First you will register to the "update container" notification, with a simple call to \ref CD_APPLET_REGISTER_FOR_UPDATE_ICON_SLOW_EVENT or \ref CD_APPLET_REGISTER_FOR_UPDATE_ICON_EVENT, depending on the refresh frequency you need : ~10Hz or ~33Hz. A high frequency needs of course more CPU, and most of the time the slow frequancy is enough.
*
* Then you will just put all your code in a \ref CD_APPLET_ON_UPDATE_ICON_BEGIN/\ref CD_APPLET_ON_UPDATE_ICON_END section. That's all ! In this section, do what you want, like redrawing your icon, possibly incrementing a counter to know until where you went, etc. See \ref opengl "the previous paragraph" to draw on your icon.
* Inside the rendering loop, you can skip an iteration with \ref CD_APPLET_SKIP_UPDATE_ICON, and quit the loop with \ref CD_APPLET_STOP_UPDATE_ICON or \ref CD_APPLET_PAUSE_UPDATE_ICON (don't forget to quit the loop when you're done, otherwise your container may continue to redraw itself, which means a needless CPU load).
*
* To know the size allocated to your icon, use the convenient \ref CD_APPLET_GET_MY_ICON_EXTENT.
*
*
* \subsection tasks I have heavy treatments to do, how can I make them without slowing the dock ?
*
* Say for instance you want to download a file on the Net, it is likely to take some amount of time, during which the dock will be frozen, waiting for you. To avoid such a situation, Cairo-Dock defines \ref _CairoDockTask "Tasks". They are perform their job <b>asynchronously</b>, and can be <b>periodic</b>. See cairo-dock-task.h for a quick explanation on how a Task works.
*
*
*
* \subsection sub-icons I need more than one icon, how can I easily get more ?
*
* In dock mode, your icon can have a sub-dock; in desklet mode, you can load a list of icons into your desklet. Cairo-Dock provides a convenient macro to <b>quickly load a list of icons</b> in both cases : \ref CD_APPLET_LOAD_MY_ICONS_LIST to load a list of icons and \ref CD_APPLET_DELETE_MY_ICONS_LIST to destroy it. Thus you don't need to know in which mode you are, neither to care about loading the icons, freeing them, or anything.
*
* You can get the list of icons with \ref CD_APPLET_MY_ICONS_LIST and to their container with \ref CD_APPLET_MY_ICONS_LIST_CONTAINER.
*
*
* \n
*
* \subsection advanced_config How can I make my own widgets in the config panel ?
*
* Cairo-Dock can build itself the config panel of your applet from the config file. Moreover, it can do the opposite : update the conf file from the config panel. However, it is limited to the widgets it knows, and there are some cases it is not enough.
* Because of that, Cairo-Dock offers 2 hooks in the process of building/reading the config panel :
when defining your applet in the \ref CD_APPLET_DEFINE_BEGIN/\ref CD_APPLET_DEFINE_END section, add to the interface the 2 functions pInterface->load_custom_widget and pInterface->save_custom_widget.
* They will be respectively called when the config panel of your applet is raised, and when it is validated.
*
* If you want to modify the content of an existing widget, you can grab it with \ref cairo_dock_get_widget_from_name.
* To add your custom widgets, insert in the conf file an empty widget (with the prefix '_'), then grab it and pack some GtkWidget inside.
* If you want to dynamically alter the config panel (like having a "new" button that would make appear new widgets on click), you can add in the conf file the new widgets, and then call \ref cairo_dock_reload_current_module_widget to reload the config panel.
* See the AlsaMixer or Weather applets for an easy example, and Clock or Mail for a more advanced example.
*
*
* \subsection steal_appli How can my applet control the window of an application ?
*
* Say your applet launches an external application that has its own window. It is logical to <b>make your applet control this application</b>, rather than letting the Taskbar do.
* All you need to do is to call the macro \ref CD_APPLET_MANAGE_APPLICATION, indicating which application you wish to manage (you need to enter the class of the application, as you can get from "xprop | grep CLASS"). Your applet will then behave like a launcher that has stolen the appli icon.
*
*
* \subsection data_renderer How can I render some numerical values on my icon ?
*
* Cairo-Dock offers a powerful and versatile architecture for this case : \ref _CairoDataRenderer.
* A DataRenderer is a generic way to render a set of values on an icon; there are several implementations of this class : Gauge, CairoDockGraph, Bar, and it is quite easy to implement a new kind of DataRenderer.
*
* Each kind of renderer has a set of attributes that you can use to customize it; you just need to call the \ref CD_APPLET_ADD_DATA_RENDERER_ON_MY_ICON macro with the attributes, and you're done !
* Then, each time you want to render some new values, simply call \ref CD_APPLET_RENDER_NEW_DATA_ON_MY_ICON with the new values.
*
* When your applet is reloaded, you have to reload the DataRenderer as well, using the convenient \ref CD_APPLET_RELOAD_MY_DATA_RENDERER macro. If you don't specify attributes to it, it will simply reload the current DataRenderer, otherwise it will load the new attributes; the previous data are not lost, which is useful in the case of Graph for instance.
*
* You can remove it at any time with \ref CD_APPLET_REMOVE_MY_DATA_RENDERER.
*
*
* \subsection multi How can I make my applet multi-instanciable ?
*
* Applets can be launched several times, an instance will be created each time. To ensure your applet can be instanciated several times, you just need to pass myApplet to any function that uses one of its fields (myData, myIcon, etc). Then, to indicate Cairo-Dock that your applet is multi-instanciable, you'll have to define the macro CD_APPLET_MULTI_INSTANCE in each file. A convenient way to do that is to define it in the Makefile.am, by adding the following line to the CFLAGS : \code -DCD_APPLET_MULTI_INSTANCE=\"1\"\ \endcode.
*
*
* \subsection render_container How can I draw anywhere on the dock, not only on my icon ?
*
* Say you want to draw directly on your container, like <i>CairoPenguin</i> or <i>ShowMouse</i> do. This can be achieved easily by registering to the \ref CAIRO_DOCK_RENDER_DOCK or \ref CAIRO_DOCK_RENDER_DESKLET notifications. You will then be notified eash time a Dock or a Desklet is drawn. Register AFTER so that you will draw after the view.
*
*
* to be continued ...
*/

typedef struct _CairoDockRenderer CairoDockRenderer;
typedef struct _CairoDeskletRenderer CairoDeskletRenderer;
typedef struct _CairoDeskletDecoration CairoDeskletDecoration;
typedef struct _CairoDialogRenderer CairoDialogRenderer;
typedef struct _CairoDialogDecorator CairoDialogDecorator;

typedef struct _Icon Icon;
typedef struct _CairoContainer CairoContainer;
typedef struct _CairoDock CairoDock;
typedef struct _CairoDesklet CairoDesklet;
typedef struct _CairoDialog CairoDialog;
typedef struct _CairoFlyingContainer CairoFlyingContainer;

typedef struct _CairoDockModule CairoDockModule;
typedef struct _CairoDockModuleInterface CairoDockModuleInterface;
typedef struct _CairoDockModuleInstance CairoDockModuleInstance;
typedef struct _CairoDockVisitCard CairoDockVisitCard;
typedef struct _CairoDockInternalModule CairoDockInternalModule;
typedef struct _CairoDockMinimalAppletConfig CairoDockMinimalAppletConfig;
typedef struct _CairoDockDesktopEnvBackend CairoDockDesktopEnvBackend;
typedef struct _CairoDockClassAppli CairoDockClassAppli;
typedef struct _CairoDockLabelDescription CairoDockLabelDescription;
typedef struct _CairoDialogAttribute CairoDialogAttribute;
typedef struct _CairoDeskletAttribute CairoDeskletAttribute;
typedef struct _CairoDialogButton CairoDialogButton;

typedef struct _CairoDataRenderer CairoDataRenderer;
typedef struct _CairoDataRendererAttribute CairoDataRendererAttribute;
typedef struct _CairoDataRendererInterface CairoDataRendererInterface;
typedef struct _CairoDataToRenderer CairoDataToRenderer;
typedef struct _CairoDataRendererEmblem CairoDataRendererEmblem;
typedef struct _CairoDataRendererTextZone CairoDataRendererTextZone;

typedef struct _CairoDockAnimationRecord CairoDockAnimationRecord;

typedef struct _CairoDockTransition CairoDockTransition;

typedef struct _CairoDockTheme CairoDockTheme;

typedef struct _CairoDockGLFont CairoDockGLFont;

typedef struct _CairoDockDesktopBackground CairoDockDesktopBackground;

typedef struct _CairoEmblem CairoEmblem;

typedef struct _CairoDockGLConfig CairoDockGLConfig;

#define CAIRO_DOCK_NB_DATA_SLOT 12

/// Nom du repertoire de travail de cairo-dock.
#define CAIRO_DOCK_DATA_DIR "cairo-dock"
/// Nom du repertoire des themes additionnels (jauges, clock, weather, etc).
#define CAIRO_DOCK_EXTRAS_DIR "extras"
/// Nom du repertoire des jauges utilisateur/themes.
#define CAIRO_DOCK_GAUGES_DIR "gauges"
/// Nom du repertoire du theme courant.
#define CAIRO_DOCK_CURRENT_THEME_NAME "current_theme"
/// Nom du repertoire des lanceurs.
#define CAIRO_DOCK_LAUNCHERS_DIR "launchers"
/// Nom du repertoire des icones locales.
#define CAIRO_DOCK_LOCAL_ICONS_DIR "icons"
/// Nom du dock principal (le 1er cree).
#define CAIRO_DOCK_MAIN_DOCK_NAME "_MainDock_"
/// Nom de la vue par defaut.
#define CAIRO_DOCK_DEFAULT_RENDERER_NAME N_("default")

#define CAIRO_DOCK_LAST_ORDER -1e9
#define CAIRO_DOCK_NB_MAX_ITERATIONS 1000