Pileus Git - ~andy/gtk/blob - gdk/x11/gdkdisplay-x11.c

   1 /* GDK - The GIMP Drawing Kit
   2  * gdkdisplay-x11.c
   3  *
   4  * Copyright 2001 Sun Microsystems Inc.
   5  * Copyright (C) 2004 Nokia Corporation
   6  *
   7  * Erwann Chenede <erwann.chenede@sun.com>
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Library General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Library General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Library General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  22  * Boston, MA 02111-1307, USA.
  23  */
  24
  25 #include "config.h"
  26
  27 #include <stdlib.h>
  28 #include <string.h>
  29 #include <errno.h>
  30 #include <unistd.h>
  31
  32 #include <glib.h>
  33 #include "gdkx.h"
  34 #include "gdkdisplay.h"
  35 #include "gdkdisplay-x11.h"
  36 #include "gdkscreen.h"
  37 #include "gdkscreen-x11.h"
  38 #include "gdkinternals.h"
  39 #include "gdkinputprivate.h"
  40 #include "xsettings-client.h"
  41 #include "gdkalias.h"
  42
  43 #include <X11/Xatom.h>
  44
  45 #ifdef HAVE_XKB
  46 #include <X11/XKBlib.h>
  47 #endif
  48
  49 #ifdef HAVE_XFIXES
  50 #include <X11/extensions/Xfixes.h>
  51 #endif
  52
  53 #ifdef HAVE_SHAPE_EXT
  54 #include <X11/extensions/shape.h>
  55 #endif
  56
  57 #ifdef HAVE_XCOMPOSITE
  58 #include <X11/extensions/Xcomposite.h>
  59 #endif
  60
  61 #ifdef HAVE_XDAMAGE
  62 #include <X11/extensions/Xdamage.h>
  63 #endif
  64
  65 #ifdef HAVE_RANDR
  66 #include <X11/extensions/Xrandr.h>
  67 #endif
  68
  69
  70 static void   gdk_display_x11_dispose            (GObject            *object);
  71 static void   gdk_display_x11_finalize           (GObject            *object);
  72
  73 #ifdef HAVE_X11R6
  74 static void gdk_internal_connection_watch (Display  *display,
  75                                            XPointer  arg,
  76                                            gint      fd,
  77                                            gboolean  opening,
  78                                            XPointer *watch_data);
  79 #endif /* HAVE_X11R6 */
  80
  81 /* Note that we never *directly* use WM_LOCALE_NAME, WM_PROTOCOLS,
  82  * but including them here has the side-effect of getting them
  83  * into the internal Xlib cache
  84  */
  85 static const char *const precache_atoms[] = {
  86   "UTF8_STRING",
  87   "WM_CLIENT_LEADER",
  88   "WM_DELETE_WINDOW",
  89   "WM_ICON_NAME",
  90   "WM_LOCALE_NAME",
  91   "WM_NAME",
  92   "WM_PROTOCOLS",
  93   "WM_TAKE_FOCUS",
  94   "WM_WINDOW_ROLE",
  95   "_NET_ACTIVE_WINDOW",
  96   "_NET_CURRENT_DESKTOP",
  97   "_NET_FRAME_EXTENTS",
  98   "_NET_STARTUP_ID",
  99   "_NET_WM_CM_S0",
 100   "_NET_WM_DESKTOP",
 101   "_NET_WM_ICON",
 102   "_NET_WM_ICON_NAME",
 103   "_NET_WM_NAME",
 104   "_NET_WM_PID",
 105   "_NET_WM_PING",
 106   "_NET_WM_STATE",
 107   "_NET_WM_STATE_ABOVE",
 108   "_NET_WM_STATE_BELOW",
 109   "_NET_WM_STATE_FULLSCREEN",
 110   "_NET_WM_STATE_MODAL",
 111   "_NET_WM_STATE_MAXIMIZED_VERT",
 112   "_NET_WM_STATE_MAXIMIZED_HORZ",
 113   "_NET_WM_STATE_SKIP_TASKBAR",
 114   "_NET_WM_STATE_SKIP_PAGER",
 115   "_NET_WM_STATE_STICKY",
 116   "_NET_WM_SYNC_REQUEST",
 117   "_NET_WM_SYNC_REQUEST_COUNTER",
 118   "_NET_WM_WINDOW_TYPE",
 119   "_NET_WM_WINDOW_TYPE_NORMAL",
 120   "_NET_WM_USER_TIME",
 121   "_NET_VIRTUAL_ROOTS"
 122 };
 123
 124 G_DEFINE_TYPE (GdkDisplayX11, _gdk_display_x11, GDK_TYPE_DISPLAY)
 125
 126 static void
 127 _gdk_display_x11_class_init (GdkDisplayX11Class * class)
 128 {
 129   GObjectClass *object_class = G_OBJECT_CLASS (class);
 130
 131   object_class->dispose = gdk_display_x11_dispose;
 132   object_class->finalize = gdk_display_x11_finalize;
 133 }
 134
 135 static void
 136 _gdk_display_x11_init (GdkDisplayX11 *display)
 137 {
 138 }
 139
 140 /**
 141  * gdk_display_open:
 142  * @display_name: the name of the display to open
 143  * @returns: a #GdkDisplay, or %NULL if the display
 144  *  could not be opened.
 145  *
 146  * Opens a display.
 147  *
 148  * Since: 2.2
 149  */
 150 GdkDisplay *
 151 gdk_display_open (const gchar *display_name)
 152 {
 153   Display *xdisplay;
 154   GdkDisplay *display;
 155   GdkDisplayX11 *display_x11;
 156   GdkWindowAttr attr;
 157   gint argc;
 158   gchar *argv[1];
 159   const char *sm_client_id;
 160
 161   XClassHint *class_hint;
 162   gulong pid;
 163   gint i;
 164 #if defined(HAVE_XFIXES) || defined(HAVE_SHAPE_EXT)
 165   gint ignore;
 166   gint maj, min;
 167 #endif
 168
 169   xdisplay = XOpenDisplay (display_name);
 170   if (!xdisplay)
 171     return NULL;
 172
 173   display = g_object_new (GDK_TYPE_DISPLAY_X11, NULL);
 174   display_x11 = GDK_DISPLAY_X11 (display);
 175
 176   display_x11->use_xshm = TRUE;
 177   display_x11->xdisplay = xdisplay;
 178
 179 #ifdef HAVE_X11R6
 180   /* Set up handlers for Xlib internal connections */
 181   XAddConnectionWatch (xdisplay, gdk_internal_connection_watch, NULL);
 182 #endif /* HAVE_X11R6 */
 183
 184   _gdk_x11_precache_atoms (display, precache_atoms, G_N_ELEMENTS (precache_atoms));
 185
 186   /* RandR must be initialized before we initialize the screens */
 187   display_x11->have_randr13 = FALSE;
 188 #ifdef HAVE_RANDR
 189   if (XRRQueryExtension (display_x11->xdisplay,
 190                          &display_x11->xrandr_event_base, &ignore))
 191   {
 192       int major, minor;
 193
 194       XRRQueryVersion (display_x11->xdisplay, &major, &minor);
 195
 196       if ((major == 1 && minor >= 3) || major > 1)
 197           display_x11->have_randr13 = TRUE;
 198
 199        gdk_x11_register_standard_event_type (display, display_x11->xrandr_event_base, RRNumberEvents);
 200   }
 201 #endif
 202
 203   /* initialize the display's screens */
 204   display_x11->screens = g_new (GdkScreen *, ScreenCount (display_x11->xdisplay));
 205   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 206     display_x11->screens[i] = _gdk_x11_screen_new (display, i);
 207
 208   /* We need to initialize events after we have the screen
 209    * structures in places
 210    */
 211   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 212     _gdk_x11_events_init_screen (display_x11->screens[i]);
 213
 214   /*set the default screen */
 215   display_x11->default_screen = display_x11->screens[DefaultScreen (display_x11->xdisplay)];
 216
 217   attr.window_type = GDK_WINDOW_TOPLEVEL;
 218   attr.wclass = GDK_INPUT_OUTPUT;
 219   attr.x = 10;
 220   attr.y = 10;
 221   attr.width = 10;
 222   attr.height = 10;
 223   attr.event_mask = 0;
 224
 225   display_x11->leader_gdk_window = gdk_window_new (GDK_SCREEN_X11 (display_x11->default_screen)->root_window,
 226                                                    &attr, GDK_WA_X | GDK_WA_Y);
 227   (_gdk_x11_window_get_toplevel (display_x11->leader_gdk_window))->is_leader = TRUE;
 228
 229   display_x11->leader_window = GDK_WINDOW_XID (display_x11->leader_gdk_window);
 230
 231   display_x11->leader_window_title_set = FALSE;
 232
 233   display_x11->have_render = GDK_UNKNOWN;
 234
 235 #ifdef HAVE_XFIXES
 236   if (XFixesQueryExtension (display_x11->xdisplay,
 237                             &display_x11->xfixes_event_base,
 238                             &ignore))
 239     {
 240       display_x11->have_xfixes = TRUE;
 241
 242       gdk_x11_register_standard_event_type (display,
 243                                             display_x11->xfixes_event_base,
 244                                             XFixesNumberEvents);
 245     }
 246   else
 247 #endif
 248     display_x11->have_xfixes = FALSE;
 249
 250 #ifdef HAVE_XCOMPOSITE
 251   if (XCompositeQueryExtension (display_x11->xdisplay,
 252                                 &ignore, &ignore))
 253     {
 254       int major, minor;
 255
 256       XCompositeQueryVersion (display_x11->xdisplay, &major, &minor);
 257
 258       /* Prior to Composite version 0.4, composited windows clipped their
 259        * parents, so you had to use IncludeInferiors to draw to the parent
 260        * This isn't useful for our purposes, so require 0.4
 261        */
 262       display_x11->have_xcomposite = major > 0 || (major == 0 && minor >= 4);
 263     }
 264   else
 265 #endif
 266     display_x11->have_xcomposite = FALSE;
 267
 268 #ifdef HAVE_XDAMAGE
 269   if (XDamageQueryExtension (display_x11->xdisplay,
 270                              &display_x11->xdamage_event_base,
 271                              &ignore))
 272     {
 273       display_x11->have_xdamage = TRUE;
 274
 275       gdk_x11_register_standard_event_type (display,
 276                                             display_x11->xdamage_event_base,
 277                                             XDamageNumberEvents);
 278     }
 279   else
 280 #endif
 281     display_x11->have_xdamage = FALSE;
 282
 283   display_x11->have_shapes = FALSE;
 284   display_x11->have_input_shapes = FALSE;
 285 #ifdef HAVE_SHAPE_EXT
 286   if (XShapeQueryExtension (GDK_DISPLAY_XDISPLAY (display), &ignore, &ignore))
 287     {
 288       display_x11->have_shapes = TRUE;
 289 #ifdef ShapeInput
 290       if (XShapeQueryVersion (GDK_DISPLAY_XDISPLAY (display), &maj, &min))
 291         display_x11->have_input_shapes = (maj == 1 && min >= 1);
 292 #endif
 293     }
 294 #endif
 295
 296   display_x11->trusted_client = TRUE;
 297   {
 298     Window root, child;
 299     int rootx, rooty, winx, winy;
 300     unsigned int xmask;
 301
 302     gdk_error_trap_push ();
 303     XQueryPointer (display_x11->xdisplay,
 304                    GDK_SCREEN_X11 (display_x11->default_screen)->xroot_window,
 305                    &root, &child, &rootx, &rooty, &winx, &winy, &xmask);
 306     gdk_flush ();
 307     if (G_UNLIKELY (gdk_error_trap_pop () == BadWindow))
 308       {
 309         g_warning ("Connection to display %s appears to be untrusted. Pointer and keyboard grabs and inter-client communication may not work as expected.", gdk_display_get_name (display));
 310         display_x11->trusted_client = FALSE;
 311       }
 312   }
 313
 314   if (_gdk_synchronize)
 315     XSynchronize (display_x11->xdisplay, True);
 316
 317   class_hint = XAllocClassHint();
 318   class_hint->res_name = g_get_prgname ();
 319
 320   class_hint->res_class = (char *)gdk_get_program_class ();
 321
 322   /* XmbSetWMProperties sets the RESOURCE_NAME environment variable
 323    * from argv[0], so we just synthesize an argument array here.
 324    */
 325   argc = 1;
 326   argv[0] = g_get_prgname ();
 327
 328   XmbSetWMProperties (display_x11->xdisplay,
 329                       display_x11->leader_window,
 330                       NULL, NULL, argv, argc, NULL, NULL,
 331                       class_hint);
 332   XFree (class_hint);
 333
 334   sm_client_id = _gdk_get_sm_client_id ();
 335   if (sm_client_id)
 336     _gdk_windowing_display_set_sm_client_id (display, sm_client_id);
 337
 338   pid = getpid ();
 339   XChangeProperty (display_x11->xdisplay,
 340                    display_x11->leader_window,
 341                    gdk_x11_get_xatom_by_name_for_display (display, "_NET_WM_PID"),
 342                    XA_CARDINAL, 32, PropModeReplace, (guchar *) & pid, 1);
 343
 344   /* We don't yet know a valid time. */
 345   display_x11->user_time = 0;
 346
 347 #ifdef HAVE_XKB
 348   {
 349     gint xkb_major = XkbMajorVersion;
 350     gint xkb_minor = XkbMinorVersion;
 351     if (XkbLibraryVersion (&xkb_major, &xkb_minor))
 352       {
 353         xkb_major = XkbMajorVersion;
 354         xkb_minor = XkbMinorVersion;
 355
 356         if (XkbQueryExtension (display_x11->xdisplay,
 357                                NULL, &display_x11->xkb_event_type, NULL,
 358                                &xkb_major, &xkb_minor))
 359           {
 360             Bool detectable_autorepeat_supported;
 361
 362             display_x11->use_xkb = TRUE;
 363
 364             XkbSelectEvents (display_x11->xdisplay,
 365                              XkbUseCoreKbd,
 366                              XkbNewKeyboardNotifyMask | XkbMapNotifyMask | XkbStateNotifyMask,
 367                              XkbNewKeyboardNotifyMask | XkbMapNotifyMask | XkbStateNotifyMask);
 368
 369             /* keep this in sync with _gdk_keymap_state_changed() */
 370             XkbSelectEventDetails (display_x11->xdisplay,
 371                                    XkbUseCoreKbd, XkbStateNotify,
 372                                    XkbAllStateComponentsMask,
 373                                    XkbGroupLockMask|XkbModifierLockMask);
 374
 375             XkbSetDetectableAutoRepeat (display_x11->xdisplay,
 376                                         True,
 377                                         &detectable_autorepeat_supported);
 378
 379             GDK_NOTE (MISC, g_message ("Detectable autorepeat %s.",
 380                                        detectable_autorepeat_supported ?
 381                                        "supported" : "not supported"));
 382
 383             display_x11->have_xkb_autorepeat = detectable_autorepeat_supported;
 384           }
 385       }
 386   }
 387 #endif
 388
 389   display_x11->use_sync = FALSE;
 390 #ifdef HAVE_XSYNC
 391   {
 392     int major, minor;
 393     int error_base, event_base;
 394
 395     if (XSyncQueryExtension (display_x11->xdisplay,
 396                              &event_base, &error_base) &&
 397         XSyncInitialize (display_x11->xdisplay,
 398                          &major, &minor))
 399       display_x11->use_sync = TRUE;
 400   }
 401 #endif
 402
 403   _gdk_windowing_image_init (display);
 404   _gdk_events_init (display);
 405   _gdk_input_init (display);
 406   _gdk_dnd_init (display);
 407
 408   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 409     gdk_display_request_selection_notification (display,
 410                                                 GDK_SCREEN_X11 (display_x11->screens[i])->cm_selection_atom);
 411
 412   g_signal_emit_by_name (gdk_display_manager_get(),
 413                          "display_opened", display);
 414
 415   return display;
 416 }
 417
 418 #ifdef HAVE_X11R6
 419 /*
 420  * XLib internal connection handling
 421  */
 422 typedef struct _GdkInternalConnection GdkInternalConnection;
 423
 424 struct _GdkInternalConnection
 425 {
 426   gint           fd;
 427   GSource       *source;
 428   Display       *display;
 429 };
 430
 431 static gboolean
 432 process_internal_connection (GIOChannel  *gioc,
 433                              GIOCondition cond,
 434                              gpointer     data)
 435 {
 436   GdkInternalConnection *connection = (GdkInternalConnection *)data;
 437
 438   GDK_THREADS_ENTER ();
 439
 440   XProcessInternalConnection ((Display*)connection->display, connection->fd);
 441
 442   GDK_THREADS_LEAVE ();
 443
 444   return TRUE;
 445 }
 446
 447 static GdkInternalConnection *
 448 gdk_add_connection_handler (Display *display,
 449                             guint    fd)
 450 {
 451   GIOChannel *io_channel;
 452   GdkInternalConnection *connection;
 453
 454   connection = g_new (GdkInternalConnection, 1);
 455
 456   connection->fd = fd;
 457   connection->display = display;
 458
 459   io_channel = g_io_channel_unix_new (fd);
 460
 461   connection->source = g_io_create_watch (io_channel, G_IO_IN);
 462   g_source_set_callback (connection->source,
 463                          (GSourceFunc)process_internal_connection, connection, NULL);
 464   g_source_attach (connection->source, NULL);
 465
 466   g_io_channel_unref (io_channel);
 467
 468   return connection;
 469 }
 470
 471 static void
 472 gdk_remove_connection_handler (GdkInternalConnection *connection)
 473 {
 474   g_source_destroy (connection->source);
 475   g_free (connection);
 476 }
 477
 478 static void
 479 gdk_internal_connection_watch (Display  *display,
 480                                XPointer  arg,
 481                                gint      fd,
 482                                gboolean  opening,
 483                                XPointer *watch_data)
 484 {
 485   if (opening)
 486     *watch_data = (XPointer)gdk_add_connection_handler (display, fd);
 487   else
 488     gdk_remove_connection_handler ((GdkInternalConnection *)*watch_data);
 489 }
 490 #endif /* HAVE_X11R6 */
 491
 492 /**
 493  * gdk_display_get_name:
 494  * @display: a #GdkDisplay
 495  *
 496  * Gets the name of the display.
 497  *
 498  * Returns: a string representing the display name. This string is owned
 499  * by GDK and should not be modified or freed.
 500  *
 501  * Since: 2.2
 502  */
 503 G_CONST_RETURN gchar *
 504 gdk_display_get_name (GdkDisplay *display)
 505 {
 506   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 507
 508   return (gchar *) DisplayString (GDK_DISPLAY_X11 (display)->xdisplay);
 509 }
 510
 511 /**
 512  * gdk_display_get_n_screens:
 513  * @display: a #GdkDisplay
 514  *
 515  * Gets the number of screen managed by the @display.
 516  *
 517  * Returns: number of screens.
 518  *
 519  * Since: 2.2
 520  */
 521 gint
 522 gdk_display_get_n_screens (GdkDisplay *display)
 523 {
 524   g_return_val_if_fail (GDK_IS_DISPLAY (display), 0);
 525
 526   return ScreenCount (GDK_DISPLAY_X11 (display)->xdisplay);
 527 }
 528
 529 /**
 530  * gdk_display_get_screen:
 531  * @display: a #GdkDisplay
 532  * @screen_num: the screen number
 533  *
 534  * Returns a screen object for one of the screens of the display.
 535  *
 536  * Returns: the #GdkScreen object
 537  *
 538  * Since: 2.2
 539  */
 540 GdkScreen *
 541 gdk_display_get_screen (GdkDisplay *display,
 542                         gint        screen_num)
 543 {
 544   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 545   g_return_val_if_fail (ScreenCount (GDK_DISPLAY_X11 (display)->xdisplay) > screen_num, NULL);
 546
 547   return GDK_DISPLAY_X11 (display)->screens[screen_num];
 548 }
 549
 550 /**
 551  * gdk_display_get_default_screen:
 552  * @display: a #GdkDisplay
 553  *
 554  * Get the default #GdkScreen for @display.
 555  *
 556  * Returns: the default #GdkScreen object for @display
 557  *
 558  * Since: 2.2
 559  */
 560 GdkScreen *
 561 gdk_display_get_default_screen (GdkDisplay *display)
 562 {
 563   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 564
 565   return GDK_DISPLAY_X11 (display)->default_screen;
 566 }
 567
 568 gboolean
 569 _gdk_x11_display_is_root_window (GdkDisplay *display,
 570                                  Window      xroot_window)
 571 {
 572   GdkDisplayX11 *display_x11;
 573   gint i;
 574
 575   g_return_val_if_fail (GDK_IS_DISPLAY (display), FALSE);
 576
 577   display_x11 = GDK_DISPLAY_X11 (display);
 578
 579   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 580     {
 581       if (GDK_SCREEN_XROOTWIN (display_x11->screens[i]) == xroot_window)
 582         return TRUE;
 583     }
 584   return FALSE;
 585 }
 586
 587 #define XSERVER_TIME_IS_LATER(time1, time2)                        \
 588   ( (( time1 > time2 ) && ( time1 - time2 < ((guint32)-1)/2 )) ||  \
 589     (( time1 < time2 ) && ( time2 - time1 > ((guint32)-1)/2 ))     \
 590   )
 591
 592 /**
 593  * gdk_display_pointer_ungrab:
 594  * @display: a #GdkDisplay.
 595  * @time_: a timestap (e.g. %GDK_CURRENT_TIME).
 596  *
 597  * Release any pointer grab.
 598  *
 599  * Since: 2.2
 600  */
 601 void
 602 gdk_display_pointer_ungrab (GdkDisplay *display,
 603                             guint32     time_)
 604 {
 605   Display *xdisplay;
 606   GdkDisplayX11 *display_x11;
 607
 608   g_return_if_fail (GDK_IS_DISPLAY (display));
 609
 610   display_x11 = GDK_DISPLAY_X11 (display);
 611   xdisplay = GDK_DISPLAY_XDISPLAY (display);
 612
 613   _gdk_input_ungrab_pointer (display, time_);
 614   XUngrabPointer (xdisplay, time_);
 615   XFlush (xdisplay);
 616
 617   if (time_ == GDK_CURRENT_TIME ||
 618       display->pointer_grab.time == GDK_CURRENT_TIME ||
 619       !XSERVER_TIME_IS_LATER (display->pointer_grab.time, time_))
 620     {
 621       _gdk_display_unset_has_pointer_grab (display,
 622                                            FALSE,
 623                                            FALSE,
 624                                            time_);
 625     }
 626 }
 627
 628 /**
 629  * gdk_display_keyboard_ungrab:
 630  * @display: a #GdkDisplay.
 631  * @time_: a timestap (e.g #GDK_CURRENT_TIME).
 632  *
 633  * Release any keyboard grab
 634  *
 635  * Since: 2.2
 636  */
 637 void
 638 gdk_display_keyboard_ungrab (GdkDisplay *display,
 639                              guint32     time)
 640 {
 641   Display *xdisplay;
 642   GdkDisplayX11 *display_x11;
 643
 644   g_return_if_fail (GDK_IS_DISPLAY (display));
 645
 646   display_x11 = GDK_DISPLAY_X11 (display);
 647   xdisplay = GDK_DISPLAY_XDISPLAY (display);
 648
 649   XUngrabKeyboard (xdisplay, time);
 650   XFlush (xdisplay);
 651
 652   if (time == GDK_CURRENT_TIME ||
 653       display->keyboard_grab.time == GDK_CURRENT_TIME ||
 654       !XSERVER_TIME_IS_LATER (display->keyboard_grab.time, time))
 655     display->keyboard_grab.window = NULL;
 656 }
 657
 658 /**
 659  * gdk_display_beep:
 660  * @display: a #GdkDisplay
 661  *
 662  * Emits a short beep on @display
 663  *
 664  * Since: 2.2
 665  */
 666 void
 667 gdk_display_beep (GdkDisplay *display)
 668 {
 669   g_return_if_fail (GDK_IS_DISPLAY (display));
 670
 671   XBell (GDK_DISPLAY_XDISPLAY (display), 0);
 672 }
 673
 674 /**
 675  * gdk_display_sync:
 676  * @display: a #GdkDisplay
 677  *
 678  * Flushes any requests queued for the windowing system and waits until all
 679  * requests have been handled. This is often used for making sure that the
 680  * display is synchronized with the current state of the program. Calling
 681  * gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors
 682  * generated from earlier requests are handled before the error trap is
 683  * removed.
 684  *
 685  * This is most useful for X11. On windowing systems where requests are
 686  * handled synchronously, this function will do nothing.
 687  *
 688  * Since: 2.2
 689  */
 690 void
 691 gdk_display_sync (GdkDisplay *display)
 692 {
 693   g_return_if_fail (GDK_IS_DISPLAY (display));
 694
 695   XSync (GDK_DISPLAY_XDISPLAY (display), False);
 696 }
 697
 698 /**
 699  * gdk_display_flush:
 700  * @display: a #GdkDisplay
 701  *
 702  * Flushes any requests queued for the windowing system; this happens automatically
 703  * when the main loop blocks waiting for new events, but if your application
 704  * is drawing without returning control to the main loop, you may need
 705  * to call this function explicitely. A common case where this function
 706  * needs to be called is when an application is executing drawing commands
 707  * from a thread other than the thread where the main loop is running.
 708  *
 709  * This is most useful for X11. On windowing systems where requests are
 710  * handled synchronously, this function will do nothing.
 711  *
 712  * Since: 2.4
 713  */
 714 void
 715 gdk_display_flush (GdkDisplay *display)
 716 {
 717   g_return_if_fail (GDK_IS_DISPLAY (display));
 718
 719   if (!display->closed)
 720     XFlush (GDK_DISPLAY_XDISPLAY (display));
 721 }
 722
 723 /**
 724  * gdk_display_get_default_group:
 725  * @display: a #GdkDisplay
 726  *
 727  * Returns the default group leader window for all toplevel windows
 728  * on @display. This window is implicitly created by GDK.
 729  * See gdk_window_set_group().
 730  *
 731  * Return value: The default group leader window for @display
 732  *
 733  * Since: 2.4
 734  **/
 735 GdkWindow *
 736 gdk_display_get_default_group (GdkDisplay *display)
 737 {
 738   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 739
 740   return GDK_DISPLAY_X11 (display)->leader_gdk_window;
 741 }
 742
 743 /**
 744  * gdk_x11_display_grab:
 745  * @display: a #GdkDisplay
 746  *
 747  * Call XGrabServer() on @display.
 748  * To ungrab the display again, use gdk_x11_display_ungrab().
 749  *
 750  * gdk_x11_display_grab()/gdk_x11_display_ungrab() calls can be nested.
 751  *
 752  * Since: 2.2
 753  **/
 754 void
 755 gdk_x11_display_grab (GdkDisplay *display)
 756 {
 757   GdkDisplayX11 *display_x11;
 758
 759   g_return_if_fail (GDK_IS_DISPLAY (display));
 760
 761   display_x11 = GDK_DISPLAY_X11 (display);
 762
 763   if (display_x11->grab_count == 0)
 764     XGrabServer (display_x11->xdisplay);
 765   display_x11->grab_count++;
 766 }
 767
 768 /**
 769  * gdk_x11_display_ungrab:
 770  * @display: a #GdkDisplay
 771  *
 772  * Ungrab @display after it has been grabbed with
 773  * gdk_x11_display_grab().
 774  *
 775  * Since: 2.2
 776  **/
 777 void
 778 gdk_x11_display_ungrab (GdkDisplay *display)
 779 {
 780   GdkDisplayX11 *display_x11;
 781
 782   g_return_if_fail (GDK_IS_DISPLAY (display));
 783
 784   display_x11 = GDK_DISPLAY_X11 (display);;
 785   g_return_if_fail (display_x11->grab_count > 0);
 786
 787   display_x11->grab_count--;
 788   if (display_x11->grab_count == 0)
 789     {
 790       XUngrabServer (display_x11->xdisplay);
 791       XFlush (display_x11->xdisplay);
 792     }
 793 }
 794
 795 static void
 796 gdk_display_x11_dispose (GObject *object)
 797 {
 798   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (object);
 799   gint           i;
 800
 801   g_list_foreach (display_x11->input_devices, (GFunc) g_object_run_dispose, NULL);
 802
 803   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 804     _gdk_screen_close (display_x11->screens[i]);
 805
 806   _gdk_events_uninit (GDK_DISPLAY_OBJECT (object));
 807
 808   G_OBJECT_CLASS (_gdk_display_x11_parent_class)->dispose (object);
 809 }
 810
 811 static void
 812 gdk_display_x11_finalize (GObject *object)
 813 {
 814   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (object);
 815   gint           i;
 816
 817   /* Keymap */
 818   if (display_x11->keymap)
 819     g_object_unref (display_x11->keymap);
 820
 821   /* Free motif Dnd */
 822   if (display_x11->motif_target_lists)
 823     {
 824       for (i = 0; i < display_x11->motif_n_target_lists; i++)
 825         g_list_free (display_x11->motif_target_lists[i]);
 826       g_free (display_x11->motif_target_lists);
 827     }
 828
 829   _gdk_x11_cursor_display_finalize (GDK_DISPLAY_OBJECT(display_x11));
 830
 831   /* Atom Hashtable */
 832   g_hash_table_destroy (display_x11->atom_from_virtual);
 833   g_hash_table_destroy (display_x11->atom_to_virtual);
 834
 835   /* Leader Window */
 836   XDestroyWindow (display_x11->xdisplay, display_x11->leader_window);
 837
 838   /* list of filters for client messages */
 839   g_list_foreach (display_x11->client_filters, (GFunc) g_free, NULL);
 840   g_list_free (display_x11->client_filters);
 841
 842   /* List of event window extraction functions */
 843   g_slist_foreach (display_x11->event_types, (GFunc)g_free, NULL);
 844   g_slist_free (display_x11->event_types);
 845
 846   /* input GdkDevice list */
 847   g_list_foreach (display_x11->input_devices, (GFunc) g_object_unref, NULL);
 848   g_list_free (display_x11->input_devices);
 849
 850   /* input GdkWindow list */
 851   g_list_foreach (display_x11->input_windows, (GFunc) g_free, NULL);
 852   g_list_free (display_x11->input_windows);
 853
 854   /* Free all GdkScreens */
 855   for (i = 0; i < ScreenCount (display_x11->xdisplay); i++)
 856     g_object_unref (display_x11->screens[i]);
 857   g_free (display_x11->screens);
 858
 859   g_free (display_x11->startup_notification_id);
 860
 861   /* X ID hashtable */
 862   g_hash_table_destroy (display_x11->xid_ht);
 863
 864   XCloseDisplay (display_x11->xdisplay);
 865
 866   G_OBJECT_CLASS (_gdk_display_x11_parent_class)->finalize (object);
 867 }
 868
 869 /**
 870  * gdk_x11_lookup_xdisplay:
 871  * @xdisplay: a pointer to an X Display
 872  *
 873  * Find the #GdkDisplay corresponding to @display, if any exists.
 874  *
 875  * Return value: the #GdkDisplay, if found, otherwise %NULL.
 876  *
 877  * Since: 2.2
 878  **/
 879 GdkDisplay *
 880 gdk_x11_lookup_xdisplay (Display *xdisplay)
 881 {
 882   GSList *tmp_list;
 883
 884   for (tmp_list = _gdk_displays; tmp_list; tmp_list = tmp_list->next)
 885     {
 886       if (GDK_DISPLAY_XDISPLAY (tmp_list->data) == xdisplay)
 887         return tmp_list->data;
 888     }
 889
 890   return NULL;
 891 }
 892
 893 /**
 894  * _gdk_x11_display_screen_for_xrootwin:
 895  * @display: a #GdkDisplay
 896  * @xrootwin: window ID for one of of the screen's of the display.
 897  *
 898  * Given the root window ID of one of the screen's of a #GdkDisplay,
 899  * finds the screen.
 900  *
 901  * Return value: the #GdkScreen corresponding to @xrootwin, or %NULL.
 902  **/
 903 GdkScreen *
 904 _gdk_x11_display_screen_for_xrootwin (GdkDisplay *display,
 905                                       Window      xrootwin)
 906 {
 907   gint i;
 908
 909   for (i = 0; i < ScreenCount (GDK_DISPLAY_X11 (display)->xdisplay); i++)
 910     {
 911       GdkScreen *screen = gdk_display_get_screen (display, i);
 912       if (GDK_SCREEN_XROOTWIN (screen) == xrootwin)
 913         return screen;
 914     }
 915
 916   return NULL;
 917 }
 918
 919 /**
 920  * gdk_x11_display_get_xdisplay:
 921  * @display: a #GdkDisplay
 922  * @returns: an X display.
 923  *
 924  * Returns the X display of a #GdkDisplay.
 925  *
 926  * Since: 2.2
 927  */
 928 Display *
 929 gdk_x11_display_get_xdisplay (GdkDisplay *display)
 930 {
 931   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 932   return GDK_DISPLAY_X11 (display)->xdisplay;
 933 }
 934
 935 void
 936 _gdk_windowing_set_default_display (GdkDisplay *display)
 937 {
 938   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
 939   const gchar *startup_id;
 940
 941   if (!display)
 942     {
 943       gdk_display = NULL;
 944       return;
 945     }
 946
 947   gdk_display = GDK_DISPLAY_XDISPLAY (display);
 948
 949   g_free (display_x11->startup_notification_id);
 950   display_x11->startup_notification_id = NULL;
 951
 952   startup_id = g_getenv ("DESKTOP_STARTUP_ID");
 953   if (startup_id && *startup_id != '\0')
 954     {
 955       gchar *time_str;
 956
 957       if (!g_utf8_validate (startup_id, -1, NULL))
 958         g_warning ("DESKTOP_STARTUP_ID contains invalid UTF-8");
 959       else
 960         display_x11->startup_notification_id = g_strdup (startup_id);
 961
 962       /* Find the launch time from the startup_id, if it's there.  Newer spec
 963        * states that the startup_id is of the form <unique>_TIME<timestamp>
 964        */
 965       time_str = g_strrstr (startup_id, "_TIME");
 966       if (time_str != NULL)
 967         {
 968           gulong retval;
 969           gchar *end;
 970           errno = 0;
 971
 972           /* Skip past the "_TIME" part */
 973           time_str += 5;
 974
 975           retval = strtoul (time_str, &end, 0);
 976           if (end != time_str && errno == 0)
 977             display_x11->user_time = retval;
 978         }
 979
 980       /* Clear the environment variable so it won't be inherited by
 981        * child processes and confuse things.
 982        */
 983       g_unsetenv ("DESKTOP_STARTUP_ID");
 984
 985       /* Set the startup id on the leader window so it
 986        * applies to all windows we create on this display
 987        */
 988       XChangeProperty (display_x11->xdisplay,
 989                        display_x11->leader_window,
 990                        gdk_x11_get_xatom_by_name_for_display (display, "_NET_STARTUP_ID"),
 991                        gdk_x11_get_xatom_by_name_for_display (display, "UTF8_STRING"), 8,
 992                        PropModeReplace,
 993                        (guchar *)startup_id, strlen (startup_id));
 994     }
 995 }
 996
 997 static void
 998 broadcast_xmessage (GdkDisplay *display,
 999                     const char *message_type,
1000                     const char *message_type_begin,
1001                     const char *message)
1002 {
1003   Display *xdisplay = GDK_DISPLAY_XDISPLAY (display);
1004   GdkScreen *screen = gdk_display_get_default_screen (display);
1005   GdkWindow *root_window = gdk_screen_get_root_window (screen);
1006   Window xroot_window = GDK_WINDOW_XID (root_window);
1007
1008   Atom type_atom;
1009   Atom type_atom_begin;
1010   Window xwindow;
1011
1012   if (!G_LIKELY (GDK_DISPLAY_X11 (display)->trusted_client))
1013     return;
1014
1015   {
1016     XSetWindowAttributes attrs;
1017
1018     attrs.override_redirect = True;
1019     attrs.event_mask = PropertyChangeMask | StructureNotifyMask;
1020
1021     xwindow =
1022       XCreateWindow (xdisplay,
1023                      xroot_window,
1024                      -100, -100, 1, 1,
1025                      0,
1026                      CopyFromParent,
1027                      CopyFromParent,
1028                      (Visual *)CopyFromParent,
1029                      CWOverrideRedirect | CWEventMask,
1030                      &attrs);
1031   }
1032
1033   type_atom = gdk_x11_get_xatom_by_name_for_display (display,
1034                                                      message_type);
1035   type_atom_begin = gdk_x11_get_xatom_by_name_for_display (display,
1036                                                            message_type_begin);
1037
1038   {
1039     XClientMessageEvent xclient;
1040     const char *src;
1041     const char *src_end;
1042     char *dest;
1043     char *dest_end;
1044
1045                 memset(&xclient, 0, sizeof (xclient));
1046     xclient.type = ClientMessage;
1047     xclient.message_type = type_atom_begin;
1048     xclient.display =xdisplay;
1049     xclient.window = xwindow;
1050     xclient.format = 8;
1051
1052     src = message;
1053     src_end = message + strlen (message) + 1; /* +1 to include nul byte */
1054
1055     while (src != src_end)
1056       {
1057         dest = &xclient.data.b[0];
1058         dest_end = dest + 20;
1059
1060         while (dest != dest_end &&
1061                src != src_end)
1062           {
1063             *dest = *src;
1064             ++dest;
1065             ++src;
1066           }
1067
1068         while (dest != dest_end)
1069           {
1070             *dest = 0;
1071             ++dest;
1072           }
1073
1074         XSendEvent (xdisplay,
1075                     xroot_window,
1076                     False,
1077                     PropertyChangeMask,
1078                     (XEvent *)&xclient);
1079
1080         xclient.message_type = type_atom;
1081       }
1082   }
1083
1084   XDestroyWindow (xdisplay, xwindow);
1085   XFlush (xdisplay);
1086 }
1087
1088 /**
1089  * gdk_x11_display_broadcast_startup_message:
1090  * @display: a #GdkDisplay
1091  * @message_type: startup notification message type ("new", "change",
1092  * or "remove")
1093  * @...: a list of key/value pairs (as strings), terminated by a
1094  * %NULL key. (A %NULL value for a key will cause that key to be
1095  * skipped in the output.)
1096  *
1097  * Sends a startup notification message of type @message_type to
1098  * @display.
1099  *
1100  * This is a convenience function for use by code that implements the
1101  * freedesktop startup notification specification. Applications should
1102  * not normally need to call it directly. See the <ulink
1103  * url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup
1104  * Notification Protocol specification</ulink> for
1105  * definitions of the message types and keys that can be used.
1106  *
1107  * Since: 2.12
1108  **/
1109 void
1110 gdk_x11_display_broadcast_startup_message (GdkDisplay *display,
1111                                            const char *message_type,
1112                                            ...)
1113 {
1114   GString *message;
1115   va_list ap;
1116   const char *key, *value, *p;
1117
1118   message = g_string_new (message_type);
1119   g_string_append_c (message, ':');
1120
1121   va_start (ap, message_type);
1122   while ((key = va_arg (ap, const char *)))
1123     {
1124       value = va_arg (ap, const char *);
1125       if (!value)
1126         continue;
1127
1128       g_string_append_printf (message, " %s=\"", key);
1129       for (p = value; *p; p++)
1130         {
1131           switch (*p)
1132             {
1133             case ' ':
1134             case '"':
1135             case '\\':
1136               g_string_append_c (message, '\\');
1137               break;
1138             }
1139
1140           g_string_append_c (message, *p);
1141         }
1142       g_string_append_c (message, '\"');
1143     }
1144   va_end (ap);
1145
1146   broadcast_xmessage (display,
1147                       "_NET_STARTUP_INFO",
1148                       "_NET_STARTUP_INFO_BEGIN",
1149                       message->str);
1150
1151   g_string_free (message, TRUE);
1152 }
1153
1154 /**
1155  * gdk_notify_startup_complete:
1156  *
1157  * Indicates to the GUI environment that the application has finished
1158  * loading. If the applications opens windows, this function is
1159  * normally called after opening the application's initial set of
1160  * windows.
1161  *
1162  * GTK+ will call this function automatically after opening the first
1163  * #GtkWindow unless gtk_window_set_auto_startup_notification() is called
1164  * to disable that feature.
1165  *
1166  * Since: 2.2
1167  **/
1168 void
1169 gdk_notify_startup_complete (void)
1170 {
1171   GdkDisplay *display;
1172   GdkDisplayX11 *display_x11;
1173
1174   display = gdk_display_get_default ();
1175   if (!display)
1176     return;
1177
1178   display_x11 = GDK_DISPLAY_X11 (display);
1179
1180   if (display_x11->startup_notification_id == NULL)
1181     return;
1182
1183   gdk_notify_startup_complete_with_id (display_x11->startup_notification_id);
1184 }
1185
1186 /**
1187  * gdk_notify_startup_complete_with_id:
1188  * @startup_id: a startup-notification identifier, for which notification
1189  *              process should be completed
1190  *
1191  * Indicates to the GUI environment that the application has finished
1192  * loading, using a given identifier.
1193  *
1194  * GTK+ will call this function automatically for #GtkWindow with custom
1195  * startup-notification identifier unless
1196  * gtk_window_set_auto_startup_notification() is called to disable
1197  * that feature.
1198  *
1199  * Since: 2.12
1200  **/
1201 void
1202 gdk_notify_startup_complete_with_id (const gchar* startup_id)
1203 {
1204   GdkDisplay *display;
1205
1206   display = gdk_display_get_default ();
1207   if (!display)
1208     return;
1209
1210   gdk_x11_display_broadcast_startup_message (display, "remove",
1211                                              "ID", startup_id,
1212                                              NULL);
1213 }
1214
1215 /**
1216  * gdk_display_supports_selection_notification:
1217  * @display: a #GdkDisplay
1218  *
1219  * Returns whether #GdkEventOwnerChange events will be
1220  * sent when the owner of a selection changes.
1221  *
1222  * Return value: whether #GdkEventOwnerChange events will
1223  *               be sent.
1224  *
1225  * Since: 2.6
1226  **/
1227 gboolean
1228 gdk_display_supports_selection_notification (GdkDisplay *display)
1229 {
1230   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
1231
1232   return display_x11->have_xfixes;
1233 }
1234
1235 /**
1236  * gdk_display_request_selection_notification:
1237  * @display: a #GdkDisplay
1238  * @selection: the #GdkAtom naming the selection for which
1239  *             ownership change notification is requested
1240  *
1241  * Request #GdkEventOwnerChange events for ownership changes
1242  * of the selection named by the given atom.
1243  *
1244  * Return value: whether #GdkEventOwnerChange events will
1245  *               be sent.
1246  *
1247  * Since: 2.6
1248  **/
1249 gboolean
1250 gdk_display_request_selection_notification (GdkDisplay *display,
1251                                             GdkAtom     selection)
1252
1253 {
1254 #ifdef HAVE_XFIXES
1255   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
1256   Atom atom;
1257
1258   if (display_x11->have_xfixes)
1259     {
1260       atom = gdk_x11_atom_to_xatom_for_display (display,
1261                                                 selection);
1262       XFixesSelectSelectionInput (display_x11->xdisplay,
1263                                   display_x11->leader_window,
1264                                   atom,
1265                                   XFixesSetSelectionOwnerNotifyMask |
1266                                   XFixesSelectionWindowDestroyNotifyMask |
1267                                   XFixesSelectionClientCloseNotifyMask);
1268       return TRUE;
1269     }
1270   else
1271 #endif
1272     return FALSE;
1273 }
1274
1275 /**
1276  * gdk_display_supports_clipboard_persistence
1277  * @display: a #GdkDisplay
1278  *
1279  * Returns whether the speicifed display supports clipboard
1280  * persistance; i.e. if it's possible to store the clipboard data after an
1281  * application has quit. On X11 this checks if a clipboard daemon is
1282  * running.
1283  *
1284  * Returns: %TRUE if the display supports clipboard persistance.
1285  *
1286  * Since: 2.6
1287  */
1288 gboolean
1289 gdk_display_supports_clipboard_persistence (GdkDisplay *display)
1290 {
1291   Atom clipboard_manager;
1292
1293   /* It might make sense to cache this */
1294   clipboard_manager = gdk_x11_get_xatom_by_name_for_display (display, "CLIPBOARD_MANAGER");
1295   return XGetSelectionOwner (GDK_DISPLAY_X11 (display)->xdisplay, clipboard_manager) != None;
1296 }
1297
1298 /**
1299  * gdk_display_store_clipboard
1300  * @display:          a #GdkDisplay
1301  * @clipboard_window: a #GdkWindow belonging to the clipboard owner
1302  * @time_:            a timestamp
1303  * @targets:          an array of targets that should be saved, or %NULL
1304  *                    if all available targets should be saved.
1305  * @n_targets:        length of the @targets array
1306  *
1307  * Issues a request to the clipboard manager to store the
1308  * clipboard data. On X11, this is a special program that works
1309  * according to the freedesktop clipboard specification, available at
1310  * <ulink url="http://www.freedesktop.org/Standards/clipboard-manager-spec">
1311  * http://www.freedesktop.org/Standards/clipboard-manager-spec</ulink>.
1312  *
1313  * Since: 2.6
1314  */
1315 void
1316 gdk_display_store_clipboard (GdkDisplay    *display,
1317                              GdkWindow     *clipboard_window,
1318                              guint32        time_,
1319                              const GdkAtom *targets,
1320                              gint           n_targets)
1321 {
1322   GdkDisplayX11 *display_x11 = GDK_DISPLAY_X11 (display);
1323   Atom clipboard_manager, save_targets;
1324
1325   g_return_if_fail (GDK_WINDOW_IS_X11 (clipboard_window));
1326
1327   clipboard_manager = gdk_x11_get_xatom_by_name_for_display (display, "CLIPBOARD_MANAGER");
1328   save_targets = gdk_x11_get_xatom_by_name_for_display (display, "SAVE_TARGETS");
1329
1330   gdk_error_trap_push ();
1331
1332   if (XGetSelectionOwner (display_x11->xdisplay, clipboard_manager) != None)
1333     {
1334       Atom property_name = None;
1335       Atom *xatoms;
1336       int i;
1337
1338       if (n_targets > 0)
1339         {
1340           property_name = gdk_x11_atom_to_xatom_for_display (display, _gdk_selection_property);
1341
1342           xatoms = g_new (Atom, n_targets);
1343           for (i = 0; i < n_targets; i++)
1344             xatoms[i] = gdk_x11_atom_to_xatom_for_display (display, targets[i]);
1345
1346           XChangeProperty (display_x11->xdisplay, GDK_WINDOW_XID (clipboard_window),
1347                            property_name, XA_ATOM,
1348                            32, PropModeReplace, (guchar *)xatoms, n_targets);
1349           g_free (xatoms);
1350
1351         }
1352
1353       XConvertSelection (display_x11->xdisplay,
1354                          clipboard_manager, save_targets, property_name,
1355                          GDK_WINDOW_XID (clipboard_window), time_);
1356
1357     }
1358   gdk_error_trap_pop ();
1359
1360 }
1361
1362 /**
1363  * gdk_x11_display_get_user_time:
1364  * @display: a #GdkDisplay
1365  *
1366  * Returns the timestamp of the last user interaction on
1367  * @display. The timestamp is taken from events caused
1368  * by user interaction such as key presses or pointer
1369  * movements. See gdk_x11_window_set_user_time().
1370  *
1371  * Returns: the timestamp of the last user interaction
1372  *
1373  * Since: 2.8
1374  */
1375 guint32
1376 gdk_x11_display_get_user_time (GdkDisplay *display)
1377 {
1378   return GDK_DISPLAY_X11 (display)->user_time;
1379 }
1380
1381 /**
1382  * gdk_display_supports_shapes:
1383  * @display: a #GdkDisplay
1384  *
1385  * Returns %TRUE if gdk_window_shape_combine_mask() can
1386  * be used to create shaped windows on @display.
1387  *
1388  * Returns: %TRUE if shaped windows are supported
1389  *
1390  * Since: 2.10
1391  */
1392 gboolean
1393 gdk_display_supports_shapes (GdkDisplay *display)
1394 {
1395   return GDK_DISPLAY_X11 (display)->have_shapes;
1396 }
1397
1398 /**
1399  * gdk_display_supports_input_shapes:
1400  * @display: a #GdkDisplay
1401  *
1402  * Returns %TRUE if gdk_window_input_shape_combine_mask() can
1403  * be used to modify the input shape of windows on @display.
1404  *
1405  * Returns: %TRUE if windows with modified input shape are supported
1406  *
1407  * Since: 2.10
1408  */
1409 gboolean
1410 gdk_display_supports_input_shapes (GdkDisplay *display)
1411 {
1412   return GDK_DISPLAY_X11 (display)->have_input_shapes;
1413 }
1414
1415
1416 /**
1417  * gdk_x11_display_get_startup_notification_id:
1418  * @display: a #GdkDisplay
1419  *
1420  * Gets the startup notification ID for a display.
1421  *
1422  * Returns: the startup notification ID for @display
1423  *
1424  * Since: 2.12
1425  */
1426 G_CONST_RETURN gchar *
1427 gdk_x11_display_get_startup_notification_id (GdkDisplay *display)
1428 {
1429   return GDK_DISPLAY_X11 (display)->startup_notification_id;
1430 }
1431
1432 /**
1433  * gdk_display_supports_composite:
1434  * @display: a #GdkDisplay
1435  *
1436  * Returns %TRUE if gdk_window_set_composited() can be used
1437  * to redirect drawing on the window using compositing.
1438  *
1439  * Currently this only works on X11 with XComposite and
1440  * XDamage extensions available.
1441  *
1442  * Returns: %TRUE if windows may be composited.
1443  *
1444  * Since: 2.12
1445  */
1446 gboolean
1447 gdk_display_supports_composite (GdkDisplay *display)
1448 {
1449   GdkDisplayX11 *x11_display = GDK_DISPLAY_X11 (display);
1450
1451   return x11_display->have_xcomposite &&
1452          x11_display->have_xdamage &&
1453          x11_display->have_xfixes;
1454 }
1455
1456
1457 #define __GDK_DISPLAY_X11_C__
1458 #include "gdkaliasdef.c"