1 /* 2 * This file is a part of the Cairo-Dock project 3 * 4 * Copyright : (C) see the 'copyright' file. 5 * E-mail : see the 'copyright' file. 6 * 7 * This program is free software; you can redistribute it and/or 8 * modify it under the terms of the GNU General Public License 9 * as published by the Free Software Foundation; either version 3 10 * of the License, or (at your option) any later version. 11 * 12 * This program is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 * GNU General Public License for more details. 16 * You should have received a copy of the GNU General Public License 17 * along with this program. If not, see <http://www.gnu.org/licenses/>. 18 */ 19 20 #ifndef __CAIRO_DOCK_STRUCT__ 21 #define __CAIRO_DOCK_STRUCT__ 22 23 #include <glib.h> 24 #include <gdk/gdk.h> 25 #include <gtk/gtk.h> 26 #include <cairo.h> 27 28 /* 29 * We include rsvg stuff here, because it's such a mess that it's better to not 30 * duplicate that. 31 * We need to include glib.h before because it uses G_BEGIN_DECL without 32 * including glib first! (bug fixed with the version 2.36.2) 33 * Note: with this 2.36.2 version, rsvg-cairo.h and librsvg-features.h are 34 * included in rsvg.h and including these header files directly are now 35 * deprecated. But we need 'librsvg-features.h' to use LIBRSVG_CHECK_VERSION 36 * macro in order to know if we can include (or not) librsvg-cairo.h... 37 * Yeah, a bit strange :) 38 */ 39 #include <librsvg/rsvg.h> 40 #ifndef LIBRSVG_CHECK_VERSION 41 #include <librsvg/librsvg-features.h> 42 #endif 43 #if !LIBRSVG_CHECK_VERSION (2, 36, 2) 44 #include <librsvg/rsvg-cairo.h> 45 #endif 46 47 #include <glib/gi18n.h> 48 49 #include <GL/gl.h> 50 51 /*! \mainpage Cairo-Dock's API documentation. 52 * \ref intro_sec 53 * 54 * \ref install_sec 55 * 56 * \ref struct_sec 57 * - \ref objects 58 * - \ref managers 59 * - \ref containers 60 * - \ref icons 61 * - \ref dock 62 * - \ref desklet 63 * - \ref dialog 64 * - \ref modules 65 * - \ref module-instances 66 * - \ref drawing 67 * - \ref windows 68 * 69 * \ref applets_sec 70 * - \ref creation 71 * - \ref first_steps 72 * - \ref further 73 * - \ref opengl 74 * - \ref animation 75 * - \ref tasks 76 * - \ref key_binding 77 * - \ref sub_icons 78 * 79 * \ref advanced_sec 80 * - \ref advanced_config 81 * - \ref steal_appli 82 * - \ref data_renderer 83 * - \ref multi 84 * - \ref render_container 85 * 86 * 87 * 88 * \n 89 * \section intro_sec Introduction 90 * 91 * This documentation presents the core library of Cairo-Dock: <i>libgldi</i> (GL Desktop Interface). 92 * 93 * It is useful if you want to write a plug-in, add new features in the core, or just love C.\n 94 * Note: to write applets in any language very easily, see http://doc.glx-dock.org. 95 * 96 * It has a <b>decentralized conception</b> and is built of several modules: internal modules (\ref managers) and external modules (\ref modules) that can extend it.\n 97 * It also has an \ref objects architecture. 98 * 99 * \n 100 * \section install_sec Installation 101 * 102 * The installation is very easy and uses <i>cmake</i>. In a terminal, copy-paste the following commands : 103 * \code 104 * ### grab the sources of the core 105 * mkdir CD && cd CD 106 * bzr checkout --lightweight lp:cairo-dock-core 107 * ### compil the dock and install it 108 * cd cairo-dock-core 109 * cmake CMakeLists.txt -DCMAKE_INSTALL_PREFIX=/usr 110 * make 111 * sudo make install 112 * ### grab the sources of the plug-ins 113 * cd .. 114 * bzr checkout --lightweight lp:cairo-dock-plug-ins 115 * ### compil the stable plug-ins and install them 116 * cmake CMakeLists.txt -DCMAKE_INSTALL_PREFIX=/usr 117 * make 118 * sudo make install 119 * \endcode 120 * To install unstable plug-ins, add -Denable-xxx=yes to the cmake command, where xxx is the lower-case name of the applet. 121 * 122 * 123 * \n 124 * \section struct_sec Main structures 125 * 126 * \subsection objects Objects 127 * Any element in <i>libgldi</i> is a _GldiObject.\n 128 * An Object is created by an ObjectManager, which defines the properties and notifications of its children.\n 129 * It has a reference counter, can be deleted from the current theme, and can be reloaded.\n 130 * An Object can cast <b>notifications</b>; notifications are broadcasted on its ObjectManager.\n 131 * An ObjectManager can inherit from another ObjectManager; in this case, all methods of the parent ObjectManagers are called recursively, and likewise all notifications on an Object are casted recursively to all parent ObjectManagers. 132 * 133 * See _GldiObject and cairo-dock-object.h for more details. 134 * 135 * \subsection managers Managers 136 * The core is divided in several internal modules, called Managers.\n 137 * Each Manager manages a set of parameters and objects (for instance, the Dock Manager manages the list of all Docks and their parameters). 138 * 139 * See _GldiManager and cairo-dock-manager.h for more details. 140 * 141 * \subsection containers Containers 142 * Containers are generic animated windows. They can hold Icons and support cairo/OpenGL drawing. 143 * 144 * See _GldiContainer and cairo-dock-container.h for more details. 145 * 146 * \subsection icons Icons 147 * Icons are elements inside a Container on which the user can interact. For instance, a Launcher is an Icon that launches a program on left-click. 148 * 149 * See _Icon and cairo-dock-icon-factory.h for more details. 150 * 151 * \subsection dock Dock 152 * Docks are a kind of Container that sits on a border of the screen. 153 * 154 * See _CairoDock and cairo-dock-dock-factory.h for more details. 155 * 156 * \subsection desklet Desklet 157 * Desklets are a kind of Container that stays on the desktop and holds one or many icons. 158 * 159 * See _CairoDesklet and cairo-dock-desklet-factory.h for more details. 160 * 161 * \subsection dialog Dialog 162 * Dialogs are a kind of Container that holds no icon, but rather point to an icon, and are used to display some information or interact with the user. 163 * 164 * See _CairoDialog and cairo-dock-dialog-factory.h for more details. 165 * 166 * \subsection modules Modules 167 * A Module is an Object representing a plug-in for <i>libgldi</i>.\n 168 * It defines a set of properties and an interface for init/stop/reload.\n 169 * A Module that adds an Icon is called an <i>"applet"</i>. 170 * 171 * See _GldiModule and cairo-dock-module-manager.h for more details. 172 * 173 * Note: the <a href="https://launchpad.net/cairo-dock-plug-ins">cairo-dock-plug-ins</a> project is a set of modules in the form of loadable libraries (.so files).\n 174 * the <a href="https://launchpad.net/cairo-dock-plug-ins-extras">cairo-dock-plug-ins-extra</a> project is a set of modules in the form of scripts (Python or any language) that interact on the core through Dbus. 175 * 176 * \subsection module-instances Module-Instances 177 * A Module-Instance is an actual instance of a Module.\n 178 * It holds a set of parameters and data (amongst them the Applet-Icon if it's an applet).\n 179 * A Module can have several instances. 180 * 181 * See _GldiModuleInstance and cairo-dock-module-instance-manager.h for more details. 182 * 183 * 184 * \subsection drawing Drawing with cairo/opengl 185 * 186 * libgldi defines \ref _CairoDockImageBuffer, a generic Image that works for both cairo and OpenGL.\n 187 * See cairo-dock-image-buffer.h for more details. 188 * 189 * It is possible to add small images above Icons; they are called \ref _CairoOverlay.\n 190 * For instance quick-info and progress-bars are Overlays.\n 191 * See cairo-dock-overlay.h for more details. 192 * 193 * 194 * \subsection windows Windows management 195 * 196 * libgldi keeps track of all the currently existing windows, with all their properties, and notifies everybody of any change. It is used for the Taskbar.\n 197 * Each window has a corresponding \ref _GldiWindowActor object.\n 198 * See cairo-dock-windows-manager.h for more details. 199 * 200 * 201 * \n 202 * \section applets_sec External Modules 203 * 204 * \subsection creation Create a new applet 205 * 206 * Go to the "plug-ins" folder, and run the <i>generate-applet.sh</i> script. Answer the few questions, and you're done!\n 207 * The script creates a <module-name> folder, with <i>src</i> and <i>data</i> sub-folders, which contain the following:\n 208 * - data/icon.png: the default icon of your applet 209 * - data/preview.jpg: a preview of your applet, around 200x200 pixels 210 * - data/<module-name>.conf.in: the config file of your applet 211 * - src/applet-init.c: contains the <i>init</i>, <i>stop</i> and <i>reload</i> methods, as well as the definition of your applet. 212 * - src/applet-config.c: container the <i>get_config</i> and <i>reset_config</i> methods 213 * - src/applet-notifications.c: contains the callbacks of your applet (ie, the code that is called on events, for instance on click on the icon) 214 * - src/applet-struct.h: contains the structures (Config, Data, and any other you may need) 215 * 216 * Note: when adding a new file, don't forget to add it in the CMakeLists.txt.\n 217 * when changing something in the config file, don't forget to update the version number of the applet, in the main CMakeLists.txt.\n 218 * when changing anything, don't forget to install (<i>sudo make install</i>) 219 * 220 * 221 * \subsection first_steps First steps 222 * 223 * Edit the file <i>src/applet-inic.c</i>; the macro \ref CD_APPLET_DEFINITION is a convenient way to define an applet: just fill its name, its category, a brief description, and your name. 224 * 225 * In the section CD_APPLET_INIT_BEGIN/CD_APPLET_INIT_END, write the code that will run on startup. 226 * 227 * In the section CD_APPLET_STOP_BEGIN/CD_APPLET_STOP_END, write the code that will run when the applet is deactivated: remove any timer, destroy any allocated ressources, unregister notifications, etc. 228 * 229 * In the section CD_APPLET_RELOAD_BEGIN/CD_APPLET_RELOAD_END section, write the code that will run when the applet is reloaded; this can happen in 2 cases: 230 * - when the configuration is changed (\ref CD_APPLET_MY_CONFIG_CHANGED is TRUE, for instance when the user edits the applet) 231 * - when something else changed (\ref CD_APPLET_MY_CONFIG_CHANGED is FALSE, for instance when the icon theme is changed, or the icon size is changed); in this case, most of the time you have nothing to do, except if you loaded some ressources yourself. 232 * 233 * Edit the file <i>src/applet-config.c</i>; 234 * In the section CD_APPLET_GET_CONFIG_BEGIN/CD_APPLET_GET_CONFIG_END, get all your config parameters (don't forget to define them in applet-struct.h). 235 * 236 * In the section CD_APPLET_RESET_CONFIG_BEGIN/CD_APPLET_RESET_CONFIG_END, free any config parameter that was allocated (for instance, strings). 237 * 238 * Edit the file <i>src/applet-notifications.c</i>; 239 * 240 * In the section CD_APPLET_ON_CLICK_BEGIN/CD_APPLET_ON_CLICK_END, write the code that will run when the user clicks on the icon (or an icon of the sub-dock). 241 * 242 * There are other similar sections available: 243 * - \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. 244 * - \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. 245 * - \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. 246 * - \ref CD_APPLET_ON_BUILD_MENU_BEGIN/\ref CD_APPLET_ON_BUILD_MENU_END for the building of the menu on left click on your icon or one of its sub-dock. 247 * 248 * To register to an event, use one of the following convenient macro during the init: 249 * - \ref CD_APPLET_REGISTER_FOR_CLICK_EVENT 250 * - \ref CD_APPLET_REGISTER_FOR_MIDDLE_CLICK_EVENT 251 * - \ref CD_APPLET_REGISTER_FOR_DOUBLE_CLICK_EVENT 252 * - \ref CD_APPLET_REGISTER_FOR_SCROLL_EVENT 253 * - \ref CD_APPLET_REGISTER_FOR_BUILD_MENU_EVENT 254 * 255 * Note: don't forget to unregister during the stop. 256 * 257 * 258 * \subsection further Go further 259 * 260 * A lot of useful macros are provided in cairo-dock-applet-facility.h to make your life easier. 261 * 262 * The applet instance is <b>myApplet</b>, and it holds the following: 263 * - <b>myIcon</b> : this is your icon ! 264 * - <b>myContainer</b> : the container your icon belongs to (a Dock or a Desklet). For convenience, the following 2 parameters are available. 265 * - <b>myDock</b> : if your container is a dock, myDock = myContainer, otherwise it is NULL. 266 * - <b>myDesklet</b> : if your container is a desklet, myDesklet = myContainer, otherwise it is NULL. 267 * - <b>myConfig</b> : the structure holding all the parameters you get in your config file. You have to define it in <i>applet-struct.h</i>. 268 * - <b>myData</b> : the structure holding all the ressources loaded at run-time. You have to define it in <i>applet-struct.h</i>. 269 * - <b>myDrawContext</b> : a cairo context, if you need to draw on the icon with the libcairo. 270 * 271 * - To get values contained inside your <b>conf file</b>, you can use the following :\n 272 * \ref CD_CONFIG_GET_BOOLEAN & cie 273 * 274 * - To <b>build your menu</b>, you can use the following :\n 275 * \ref CD_APPLET_ADD_SUB_MENU & cie 276 * 277 * - To directly <b>set an image on your icon</b>, you can use the following :\n 278 * \ref CD_APPLET_SET_IMAGE_ON_MY_ICON & cie 279 * 280 * - To modify the <b>label</b> of your icon, you can use the following :\n 281 * \ref CD_APPLET_SET_NAME_FOR_MY_ICON & cie 282 * 283 * - To set a <b>quick-info</b> on your icon, you can use the following :\n 284 * \ref CD_APPLET_SET_QUICK_INFO_ON_MY_ICON & cie 285 * 286 * - To <b>create a surface</b> that fits your icon from an image, you can use the following :\n 287 * \ref CD_APPLET_LOAD_SURFACE_FOR_MY_APPLET & cie 288 * 289 * - To trigger the <b>refresh</b> of your icon or container after you drew something, you can use the following :\n 290 * \ref CD_APPLET_REDRAW_MY_ICON & \ref CAIRO_DOCK_REDRAW_MY_CONTAINER 291 * 292 * 293 * \subsection opengl How can I take advantage of the OpenGL ? 294 * 295 * There are 3 cases : 296 * - 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. 297 * - 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. 298 * - 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. 299 * 300 * 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. 301 * 302 * 303 * \subsection animation How can I animate my applet to make it more lively ? 304 * 305 * 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. 306 * 307 * 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 ! 308 * 309 * 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. 310 * 311 * 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. 312 * 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). 313 * 314 * To know the size allocated to your icon, use the convenient \ref CD_APPLET_GET_MY_ICON_EXTENT. 315 * 316 * 317 * \subsection tasks I have heavy treatments to do, how can I make them without slowing the dock ? 318 * 319 * 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 _GldiTask "Tasks". They 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. 320 * 321 * You create a Task with \ref cairo_dock_new_task, launch it with \ref cairo_dock_launch_task, and either cancel it with \ref cairo_dock_discard_task or destroy it with \ref cairo_dock_free_task. 322 * 323 * 324 * \subsection key_binding Key binding 325 * 326 * You can bind an action to a shortkey with the following macro: \ref CD_APPLET_BIND_KEY.\n 327 * For instance, the GMenu applet displays the menu on ctrl+F1.\n 328 * You get a GldiShortkey that you simply destroy when the applet stops (with \ref gldi_object_unref). 329 * 330 * See cairo-dock-keybinder.h for more details. 331 * 332 * 333 * \subsection sub_icons I need more than one icon, how can I easily get more ? 334 * 335 * 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. 336 * 337 * 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. 338 * 339 * 340 * \n 341 * \section advanced_sec Advanced functionnalities 342 * 343 * \subsection advanced_config How can I make my own widgets in the config panel ? 344 * 345 * 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. 346 * Because of that, Cairo-Dock offers 2 hooks in the process of building/reading the config panel : 347 * when defining your applet in the CD_APPLET_DEFINE_BEGIN/CD_APPLET_DEFINE_END section, add to the interface the 2 functions pInterface->load_custom_widget and pInterface->save_custom_widget. 348 * They will be respectively called when the config panel of your applet is raised, and when it is validated. 349 * 350 * If you want to modify the content of an existing widget, you can grab it with \ref cairo_dock_gui_find_group_key_widget_in_list. 351 * To add your custom widgets, insert in the conf file an empty widget (with the prefix '_'), then grab it and pack some GtkWidget inside. 352 * 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. 353 * See the AlsaMixer or Weather applets for an easy example, and Clock or Mail for a more advanced example. 354 * 355 * 356 * \subsection steal_appli How can my applet control the window of an application ? 357 * 358 * 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. 359 * 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. 360 * 361 * 362 * \subsection data_renderer How can I render some numerical values on my icon ? 363 * 364 * Cairo-Dock offers a powerful and versatile architecture for this case : \ref _CairoDataRenderer. 365 * 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. 366 * 367 * 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 ! 368 * 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. 369 * 370 * 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. 371 * 372 * You can remove it at any time with \ref CD_APPLET_REMOVE_MY_DATA_RENDERER. 373 * 374 * 375 * \subsection multi How can I make my applet multi-instanciable ? 376 * 377 * 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 CMakeLists.txt by adding the following line: \code add_definitions (-DCD_APPLET_MULTI_INSTANCE="1") \endcode. 378 * 379 * 380 * \subsection render_container How can I draw anywhere on the dock, not only on my icon ? 381 * 382 * 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 NOTIFICATION_RENDER notification. You will then be notified eash time a Dock or a Desklet is drawn. Register AFTER so that you will draw after the view. 383 * 384 * 385 */ 386 387 typedef struct _CairoDockRenderer CairoDockRenderer; 388 typedef struct _CairoDeskletRenderer CairoDeskletRenderer; 389 typedef struct _CairoDeskletDecoration CairoDeskletDecoration; 390 typedef struct _CairoDialogRenderer CairoDialogRenderer; 391 typedef struct _CairoDialogDecorator CairoDialogDecorator; 392 393 typedef struct _IconInterface IconInterface; 394 typedef struct _Icon Icon; 395 typedef struct _GldiContainer GldiContainer; 396 typedef struct _GldiContainerInterface GldiContainerInterface; 397 typedef struct _CairoDock CairoDock; 398 typedef struct _CairoDesklet CairoDesklet; 399 typedef struct _CairoDialog CairoDialog; 400 typedef struct _CairoFlyingContainer CairoFlyingContainer; 401 402 typedef struct _GldiModule GldiModule; 403 typedef struct _GldiModuleInterface GldiModuleInterface; 404 typedef struct _GldiVisitCard GldiVisitCard; 405 typedef struct _GldiModuleInstance GldiModuleInstance; 406 typedef struct _CairoDockMinimalAppletConfig CairoDockMinimalAppletConfig; 407 typedef struct _CairoDockDesktopEnvBackend CairoDockDesktopEnvBackend; 408 typedef struct _CairoDockClassAppli CairoDockClassAppli; 409 typedef struct _CairoDialogAttribute CairoDialogAttribute; 410 typedef struct _CairoDeskletAttribute CairoDeskletAttribute; 411 typedef struct _CairoDialogButton CairoDialogButton; 412 413 typedef struct _CairoDataRenderer CairoDataRenderer; 414 typedef struct _CairoDataRendererAttribute CairoDataRendererAttribute; 415 typedef struct _CairoDataRendererInterface CairoDataRendererInterface; 416 typedef struct _CairoDataToRenderer CairoDataToRenderer; 417 typedef struct _CairoDataRendererEmblemParam CairoDataRendererEmblemParam; 418 typedef struct _CairoDataRendererEmblem CairoDataRendererEmblem; 419 typedef struct _CairoDataRendererTextParam CairoDataRendererTextParam; 420 typedef struct _CairoDataRendererText CairoDataRendererText; 421 typedef struct _CairoDockDataRendererRecord CairoDockDataRendererRecord; 422 423 typedef struct _CairoDockAnimationRecord CairoDockAnimationRecord; 424 425 typedef struct _CairoDockHidingEffect CairoDockHidingEffect; 426 427 typedef struct _CairoIconContainerRenderer CairoIconContainerRenderer; 428 429 typedef struct _CairoDockTransition CairoDockTransition; 430 431 typedef struct _CairoDockPackage CairoDockPackage; 432 433 typedef struct _CairoDockGroupKeyWidget CairoDockGroupKeyWidget; 434 435 typedef struct _CairoDockGLConfig CairoDockGLConfig; 436 437 typedef struct _CairoDockGLFont CairoDockGLFont; 438 439 typedef struct _CairoDockGLPath CairoDockGLPath; 440 441 typedef struct _CairoDockImageBuffer CairoDockImageBuffer; 442 443 typedef struct _CairoOverlay CairoOverlay; 444 445 typedef struct _GldiTask GldiTask; 446 447 typedef struct _GldiShortkey GldiShortkey; 448 449 typedef struct _GldiManager GldiManager; 450 451 typedef struct _GldiObject GldiObject; 452 453 typedef struct _GldiObjectManager GldiObjectManager; 454 455 typedef struct _GldiDesktopGeometry GldiDesktopGeometry; 456 457 typedef struct _GldiDesktopBackground GldiDesktopBackground; 458 459 typedef struct _GldiDesktopManagerBackend GldiDesktopManagerBackend; 460 461 typedef struct _GldiWindowManagerBackend GldiWindowManagerBackend; 462 463 typedef struct _GldiWindowActor GldiWindowActor; 464 465 typedef struct _GldiContainerManagerBackend GldiContainerManagerBackend; 466 467 typedef struct _GldiGLManagerBackend GldiGLManagerBackend; 468 469 typedef void (*_GldiIconFunc) (Icon *icon, gpointer data); 470 typedef _GldiIconFunc GldiIconFunc; 471 typedef gboolean (*_GldiIconRFunc) (Icon *icon, gpointer data); // TRUE to continue 472 typedef _GldiIconRFunc GldiIconRFunc; 473 474 typedef struct _GldiTextDescription GldiTextDescription; 475 typedef struct _GldiColor GldiColor; 476 477 478 #define CAIRO_DOCK_NB_DATA_SLOT 12 479 480 // Nom du fichier de conf principal du theme. 481 #define CAIRO_DOCK_CONF_FILE "cairo-dock.conf" 482 // Nom du fichier de conf d'un dock racine. 483 #define CAIRO_DOCK_MAIN_DOCK_CONF_FILE "main-dock.conf" 484 485 // Nom du dock principal (le 1er cree). 486 #define CAIRO_DOCK_MAIN_DOCK_NAME "_MainDock_" 487 // Nom de la vue par defaut. 488 #define CAIRO_DOCK_DEFAULT_RENDERER_NAME N_("Default") 489 490 491 #define CAIRO_DOCK_LAST_ORDER -1e9 492 #define CAIRO_DOCK_NB_MAX_ITERATIONS 1000 493 494 #endif 495
