gdkdisplaymanager.c 14.2 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GDK - The GIMP Drawing Kit
Owen Taylor's avatar
Owen Taylor committed
2
3
4
5
6
7
8
9
10
11
12
13
14
 * Copyright (C) 2000 Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Owen Taylor's avatar
Owen Taylor committed
16
17
18
19
20
21
 */

/*
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
22
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
Owen Taylor's avatar
Owen Taylor committed
23
24
 */

25
#include "config.h"
Owen Taylor's avatar
Owen Taylor committed
26

27
#include "gdkconfig.h"
28
#include "gdkdisplaymanagerprivate.h"
29
#include "gdkdisplayprivate.h"
Owen Taylor's avatar
Owen Taylor committed
30
#include "gdkinternals.h"
31
#include "gdkkeysprivate.h"
Owen Taylor's avatar
Owen Taylor committed
32
33
34
#include "gdkmarshalers.h"
#include "gdkintl.h"

35
36
#ifdef GDK_WINDOWING_X11
#include "x11/gdkx.h"
37
#include "x11/gdkprivate-x11.h"
38
39
#endif

40
#ifdef GDK_WINDOWING_QUARTZ
41
#include "quartz/gdkprivate-quartz.h"
42
43
#endif

44
#ifdef GDK_WINDOWING_BROADWAY
45
#include "broadway/gdkprivate-broadway.h"
46
47
#endif

Hans Breuer's avatar
Hans Breuer committed
48
49
#ifdef GDK_WINDOWING_WIN32
#include "win32/gdkwin32.h"
50
#include "win32/gdkprivate-win32.h"
Hans Breuer's avatar
Hans Breuer committed
51
#endif
52

Kristian Høgsberg's avatar
Kristian Høgsberg committed
53
#ifdef GDK_WINDOWING_WAYLAND
54
#include "wayland/gdkprivate-wayland.h"
Kristian Høgsberg's avatar
Kristian Høgsberg committed
55
56
#endif

57
58
59
60
61
62
63
64
/**
 * SECTION:gdkdisplaymanager
 * @Short_description: Maintains a list of all open GdkDisplays
 * @Title: GdkDisplayManager
 *
 * The purpose of the #GdkDisplayManager singleton object is to offer
 * notification when displays appear or disappear or the default display
 * changes.
Matthias Clasen's avatar
Matthias Clasen committed
65
 *
66
 * You can use gdk_display_manager_get() to obtain the #GdkDisplayManager
Matthias Clasen's avatar
Matthias Clasen committed
67
68
 * singleton, but that should be rarely necessary. Typically, initializing
 * GTK+ opens a display that you can work with without ever accessing the
69
 * #GdkDisplayManager.
Matthias Clasen's avatar
Matthias Clasen committed
70
71
 *
 * The GDK library can be built with support for multiple backends.
72
 * The #GdkDisplayManager object determines which backend is used
Matthias Clasen's avatar
Matthias Clasen committed
73
74
75
76
77
78
79
80
81
 * at runtime.
 *
 * When writing backend-specific code that is supposed to work with
 * multiple GDK backends, you have to consider both compile time and
 * runtime. At compile time, use the #GDK_WINDOWING_X11, #GDK_WINDOWING_WIN32
 * macros, etc. to find out which backends are present in the GDK library
 * you are building your application against. At runtime, use type-check
 * macros like GDK_IS_X11_DISPLAY() to find out which backend is in use:
 *
82
83
 * ## Backend-specific code ## {#backend-specific}
 *
84
 * |[<!-- language="C" -->
Matthias Clasen's avatar
Matthias Clasen committed
85
86
87
 * #ifdef GDK_WINDOWING_X11
 *   if (GDK_IS_X11_DISPLAY (display))
 *     {
88
 *       // make X11-specific calls here
Matthias Clasen's avatar
Matthias Clasen committed
89
90
91
92
93
94
 *     }
 *   else
 * #endif
 * #ifdef GDK_WINDOWING_QUARTZ
 *   if (GDK_IS_QUARTZ_DISPLAY (display))
 *     {
95
 *       // make Quartz-specific calls here
Matthias Clasen's avatar
Matthias Clasen committed
96
97
98
99
*     }
 *   else
 * #endif
 *   g_error ("Unsupported GDK backend");
100
 * ]|
101
102
 */

Owen Taylor's avatar
Owen Taylor committed
103
104
105
106
107
108
109
110
111
112
113
114
115

enum {
  PROP_0,
  PROP_DEFAULT_DISPLAY
};

enum {
  DISPLAY_OPENED,
  LAST_SIGNAL
};

static void gdk_display_manager_class_init   (GdkDisplayManagerClass *klass);
static void gdk_display_manager_set_property (GObject                *object,
116
117
118
                                              guint                   prop_id,
                                              const GValue           *value,
                                              GParamSpec             *pspec);
Owen Taylor's avatar
Owen Taylor committed
119
static void gdk_display_manager_get_property (GObject                *object,
120
121
122
                                              guint                   prop_id,
                                              GValue                 *value,
                                              GParamSpec             *pspec);
Owen Taylor's avatar
Owen Taylor committed
123
124
125

static guint signals[LAST_SIGNAL] = { 0 };

126
G_DEFINE_TYPE (GdkDisplayManager, gdk_display_manager, G_TYPE_OBJECT)
Owen Taylor's avatar
Owen Taylor committed
127
128
129
130
131
132
133
134
135

static void
gdk_display_manager_class_init (GdkDisplayManagerClass *klass)
{
  GObjectClass *object_class = G_OBJECT_CLASS (klass);

  object_class->set_property = gdk_display_manager_set_property;
  object_class->get_property = gdk_display_manager_get_property;

136
137
  /**
   * GdkDisplayManager::display-opened:
138
   * @manager: the object on which the signal is emitted
139
140
   * @display: the opened display
   *
141
   * The ::display-opened signal is emitted when a display is opened.
142
143
144
   *
   * Since: 2.2
   */
Owen Taylor's avatar
Owen Taylor committed
145
  signals[DISPLAY_OPENED] =
146
    g_signal_new (g_intern_static_string ("display-opened"),
147
148
149
150
151
152
153
154
                  G_OBJECT_CLASS_TYPE (object_class),
                  G_SIGNAL_RUN_LAST,
                  G_STRUCT_OFFSET (GdkDisplayManagerClass, display_opened),
                  NULL, NULL,
                  _gdk_marshal_VOID__OBJECT,
                  G_TYPE_NONE,
                  1,
                  GDK_TYPE_DISPLAY);
155
156
157
  g_signal_set_va_marshaller (signals[DISPLAY_OPENED],
                              G_TYPE_FROM_CLASS (klass),
                              _gdk_marshal_VOID__OBJECTv);
Owen Taylor's avatar
Owen Taylor committed
158
159

  g_object_class_install_property (object_class,
160
161
162
163
164
165
166
                                   PROP_DEFAULT_DISPLAY,
                                   g_param_spec_object ("default-display",
                                                        P_("Default Display"),
                                                        P_("The default display for GDK"),
                                                        GDK_TYPE_DISPLAY,
                                                        G_PARAM_READWRITE|G_PARAM_STATIC_NAME|
                                                        G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
Owen Taylor's avatar
Owen Taylor committed
167
168
}

Matthias Clasen's avatar
Matthias Clasen committed
169
170
171
172
173
static void
gdk_display_manager_init (GdkDisplayManager *manager)
{
}

Owen Taylor's avatar
Owen Taylor committed
174
175
static void
gdk_display_manager_set_property (GObject      *object,
176
177
178
                                  guint         prop_id,
                                  const GValue *value,
                                  GParamSpec   *pspec)
Owen Taylor's avatar
Owen Taylor committed
179
180
181
182
{
  switch (prop_id)
    {
    case PROP_DEFAULT_DISPLAY:
183
      gdk_display_manager_set_default_display (GDK_DISPLAY_MANAGER (object),
184
                                               g_value_get_object (value));
Owen Taylor's avatar
Owen Taylor committed
185
186
187
188
189
190
191
192
193
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

static void
gdk_display_manager_get_property (GObject      *object,
194
195
196
                                  guint         prop_id,
                                  GValue       *value,
                                  GParamSpec   *pspec)
Owen Taylor's avatar
Owen Taylor committed
197
198
199
200
{
  switch (prop_id)
    {
    case PROP_DEFAULT_DISPLAY:
201
202
      g_value_set_object (value,
                          gdk_display_manager_get_default_display (GDK_DISPLAY_MANAGER (object)));
Owen Taylor's avatar
Owen Taylor committed
203
204
205
206
207
208
209
      break;
    default:
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
      break;
    }
}

Matthias Clasen's avatar
Matthias Clasen committed
210
211
212
213
214
215
216
217
218
219
220
221
222
223
static const gchar *allowed_backends;

/**
 * gdk_set_allowed_backends:
 * @backends: a comma-separated list of backends
 *
 * Sets a list of backends that GDK should try to use.
 *
 * This can be be useful if your application does not
 * work with certain GDK backends.
 *
 * By default, GDK tries all included backends.
 *
 * For example,
224
 * |[<!-- language="C" -->
Matthias Clasen's avatar
Matthias Clasen committed
225
 * gdk_set_allowed_backends ("wayland,quartz,*");
226
 * ]|
Matthias Clasen's avatar
Matthias Clasen committed
227
228
229
230
 * instructs GDK to try the Wayland backend first,
 * followed by the Quartz backend, and then all
 * others.
 *
231
 * If the `GDK_BACKEND` environment variable
Matthias Clasen's avatar
Matthias Clasen committed
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
 * is set, it determines what backends are tried in what
 * order, while still respecting the set of allowed backends
 * that are specified by this function.
 *
 * The possible backend names are x11, win32, quartz,
 * broadway, wayland. You can also include a * in the
 * list to try all remaining backends.
 *
 * This call must happen prior to gdk_display_open(),
 * gtk_init(), gtk_init_with_args() or gtk_init_check()
 * in order to take effect.
 *
 * Since: 3.10
 */
void
gdk_set_allowed_backends (const gchar *backends)
{
  allowed_backends = g_strdup (backends);
}

Benjamin Otte's avatar
Benjamin Otte committed
252
253
254
255
typedef struct _GdkBackend GdkBackend;

struct _GdkBackend {
  const char *name;
256
  GdkDisplay * (* open_display) (const char *name);
Benjamin Otte's avatar
Benjamin Otte committed
257
258
};

Matthias Clasen's avatar
Matthias Clasen committed
259
static GdkBackend gdk_backends[] = {
Benjamin Otte's avatar
Benjamin Otte committed
260
#ifdef GDK_WINDOWING_QUARTZ
261
  { "quartz",   _gdk_quartz_display_open },
Benjamin Otte's avatar
Benjamin Otte committed
262
263
#endif
#ifdef GDK_WINDOWING_WIN32
264
  { "win32",    _gdk_win32_display_open },
Benjamin Otte's avatar
Benjamin Otte committed
265
#endif
266
267
268
#ifdef GDK_WINDOWING_WAYLAND
  { "wayland",  _gdk_wayland_display_open },
#endif
Matthias Clasen's avatar
Matthias Clasen committed
269
270
271
#ifdef GDK_WINDOWING_X11
  { "x11",      _gdk_x11_display_open },
#endif
Benjamin Otte's avatar
Benjamin Otte committed
272
#ifdef GDK_WINDOWING_BROADWAY
273
  { "broadway", _gdk_broadway_display_open },
Benjamin Otte's avatar
Benjamin Otte committed
274
275
276
277
278
#endif
  /* NULL-terminating this array so we can use commas above */
  { NULL, NULL }
};

Matthias Clasen's avatar
Matthias Clasen committed
279
/**
280
 * gdk_display_manager_get:
Matthias Clasen's avatar
Matthias Clasen committed
281
 *
282
283
284
 * Gets the singleton #GdkDisplayManager object.
 *
 * When called for the first time, this function consults the
285
 * `GDK_BACKEND` environment variable to find out which
286
287
288
 * of the supported GDK backends to use (in case GDK has been compiled
 * with multiple backends). Applications can use gdk_set_allowed_backends()
 * to limit what backends can be used.
Matthias Clasen's avatar
Matthias Clasen committed
289
 *
290
291
292
 * Returns: (transfer none): The global #GdkDisplayManager singleton;
 *     gdk_parse_args(), gdk_init(), or gdk_init_check() must have
 *     been called first.
Matthias Clasen's avatar
Matthias Clasen committed
293
 *
294
295
296
297
 * Since: 2.2
 **/
GdkDisplayManager*
gdk_display_manager_get (void)
Owen Taylor's avatar
Owen Taylor committed
298
{
299
300
  static GdkDisplayManager *manager = NULL;

Matthias Clasen's avatar
Matthias Clasen committed
301
  if (manager == NULL)
302
303
    manager = g_object_new (GDK_TYPE_DISPLAY_MANAGER, NULL);
  
304
  return manager;
Owen Taylor's avatar
Owen Taylor committed
305
306
307
308
}

/**
 * gdk_display_manager_get_default_display:
309
 * @manager: a #GdkDisplayManager
Owen Taylor's avatar
Owen Taylor committed
310
 *
311
312
 * Gets the default #GdkDisplay.
 *
313
314
 * Returns: (nullable) (transfer none): a #GdkDisplay, or %NULL if
 *     there is no default display.
Matthias Clasen's avatar
Matthias Clasen committed
315
316
 *
 * Since: 2.2
Owen Taylor's avatar
Owen Taylor committed
317
318
 */
GdkDisplay *
319
gdk_display_manager_get_default_display (GdkDisplayManager *manager)
Owen Taylor's avatar
Owen Taylor committed
320
{
321
  return manager->default_display;
Owen Taylor's avatar
Owen Taylor committed
322
323
324
325
326
327
}

/**
 * gdk_display_get_default:
 *
 * Gets the default #GdkDisplay. This is a convenience
328
329
 * function for:
 * `gdk_display_manager_get_default_display (gdk_display_manager_get ())`.
330
 *
331
332
 * Returns: (nullable) (transfer none): a #GdkDisplay, or %NULL if
 *   there is no default display.
Matthias Clasen's avatar
Matthias Clasen committed
333
334
 *
 * Since: 2.2
Owen Taylor's avatar
Owen Taylor committed
335
336
337
338
 */
GdkDisplay *
gdk_display_get_default (void)
{
339
  return gdk_display_manager_get_default_display (gdk_display_manager_get ());
Owen Taylor's avatar
Owen Taylor committed
340
341
342
343
344
345
346
}

/**
 * gdk_screen_get_default:
 *
 * Gets the default screen for the default display. (See
 * gdk_display_get_default ()).
347
 *
348
349
 * Returns: (nullable) (transfer none): a #GdkScreen, or %NULL if
 *     there is no default display.
Matthias Clasen's avatar
Matthias Clasen committed
350
351
 *
 * Since: 2.2
Owen Taylor's avatar
Owen Taylor committed
352
353
354
355
 */
GdkScreen *
gdk_screen_get_default (void)
{
356
  GdkDisplay *display;
357

358
  display = gdk_display_get_default ();
359

360
361
  if (display)
    return GDK_DISPLAY_GET_CLASS (display)->get_default_screen (display);
362
363
  else
    return NULL;
Owen Taylor's avatar
Owen Taylor committed
364
365
366
367
}

/**
 * gdk_display_manager_set_default_display:
368
 * @manager: a #GdkDisplayManager
Owen Taylor's avatar
Owen Taylor committed
369
370
371
 * @display: a #GdkDisplay
 * 
 * Sets @display as the default display.
Matthias Clasen's avatar
Matthias Clasen committed
372
373
 *
 * Since: 2.2
Owen Taylor's avatar
Owen Taylor committed
374
375
 **/
void
376
377
gdk_display_manager_set_default_display (GdkDisplayManager *manager,
                                         GdkDisplay        *display)
Owen Taylor's avatar
Owen Taylor committed
378
{
379
380
  manager->default_display = display;

381
382
  if (display)
    GDK_DISPLAY_GET_CLASS (display)->make_default (display);
Owen Taylor's avatar
Owen Taylor committed
383

384
  g_object_notify (G_OBJECT (manager), "default-display");
Owen Taylor's avatar
Owen Taylor committed
385
386
387
388
}

/**
 * gdk_display_manager_list_displays:
389
 * @manager: a #GdkDisplayManager
Owen Taylor's avatar
Owen Taylor committed
390
391
 *
 * List all currently open displays.
392
 *
393
 * Returns: (transfer container) (element-type GdkDisplay): a newly
394
395
 *     allocated #GSList of #GdkDisplay objects. Free with g_slist_free()
 *     when you are done with it.
Matthias Clasen's avatar
Matthias Clasen committed
396
397
 *
 * Since: 2.2
Owen Taylor's avatar
Owen Taylor committed
398
399
 **/
GSList *
400
401
gdk_display_manager_list_displays (GdkDisplayManager *manager)
{
402
  return g_slist_copy (manager->displays);
403
404
}

Matthias Clasen's avatar
Matthias Clasen committed
405
406
407
408
409
410
411
/**
 * gdk_display_manager_open_display:
 * @manager: a #GdkDisplayManager
 * @name: the name of the display to open
 *
 * Opens a display.
 *
412
413
 * Returns: (nullable) (transfer none): a #GdkDisplay, or %NULL if the
 *     display could not be opened
Matthias Clasen's avatar
Matthias Clasen committed
414
415
416
 *
 * Since: 3.0
 */
417
418
419
GdkDisplay *
gdk_display_manager_open_display (GdkDisplayManager *manager,
                                  const gchar       *name)
Owen Taylor's avatar
Owen Taylor committed
420
{
421
422
423
424
425
  const gchar *backend_list;
  GdkDisplay *display;
  gchar **backends;
  gint i, j;
  gboolean allow_any;
426

427
428
429
430
431
432
433
  if (allowed_backends == NULL)
    allowed_backends = "*";
  allow_any = strstr (allowed_backends, "*") != NULL;

  backend_list = g_getenv ("GDK_BACKEND");
  if (backend_list == NULL)
    backend_list = allowed_backends;
434
435
436
437
438
439
440
441
442
  else if (g_strcmp0 (backend_list, "help") == 0)
    {
      fprintf (stderr, "Supported GDK backends:");
      for (i = 0; gdk_backends[i].name != NULL; i++)
        fprintf (stderr, " %s", gdk_backends[i].name);
      fprintf (stderr, "\n");

      backend_list = allowed_backends;
    }
443
444
445
446
447
  backends = g_strsplit (backend_list, ",", 0);

  display = NULL;

  for (i = 0; display == NULL && backends[i] != NULL; i++)
448
    {
449
450
451
452
453
454
455
      const gchar *backend = backends[i];
      gboolean any = g_str_equal (backend, "*");

      if (!allow_any && !any && !strstr (allowed_backends, backend))
        continue;

      for (j = 0; gdk_backends[j].name != NULL; j++)
456
        {
457
458
459
460
461
462
463
464
465
          if ((any && allow_any) ||
              (any && strstr (allowed_backends, gdk_backends[j].name)) ||
              g_str_equal (backend, gdk_backends[j].name))
            {
              GDK_NOTE (MISC, g_message ("Trying %s backend", gdk_backends[j].name));
              display = gdk_backends[j].open_display (name);
              if (display)
                break;
            }
466
467
468
        }
    }

469
  g_strfreev (backends);
470

471
  return display;
Owen Taylor's avatar
Owen Taylor committed
472
}
Matthias Clasen's avatar
Matthias Clasen committed
473

474
475
476
477
478
479
480
481
void
_gdk_display_manager_add_display (GdkDisplayManager *manager,
                                  GdkDisplay        *display)
{
  if (manager->displays == NULL)
    gdk_display_manager_set_default_display (manager, display);

  manager->displays = g_slist_prepend (manager->displays, display);
482
483

  g_signal_emit (manager, signals[DISPLAY_OPENED], 0, display);
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
}

/* NB: This function can be called multiple times per display. */
void
_gdk_display_manager_remove_display (GdkDisplayManager *manager,
                                     GdkDisplay        *display)
{
  manager->displays = g_slist_remove (manager->displays, display);

  if (manager->default_display == display)
    {
      if (manager->displays)
        gdk_display_manager_set_default_display (manager, manager->displays->data);
      else
        gdk_display_manager_set_default_display (manager, NULL);
    }
}