gdk.c 29.4 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4 5 6 7 8 9 10
/* GDK - The GIMP Drawing Kit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library 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
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
Elliot Lee's avatar
Elliot Lee committed
12 13 14
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19
#include "config.h"
Elliot Lee's avatar
Elliot Lee committed
20

21
#include <X11/Xlocale.h>
Elliot Lee's avatar
Elliot Lee committed
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41
#include <ctype.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <limits.h>

#ifdef HAVE_SYS_SELECT_H
#include <sys/select.h>
#endif /* HAVE_SYS_SELECT_H_ */

#define XLIB_ILLEGAL_ACCESS
#include <X11/Xatom.h>
#include <X11/Xlib.h>
#include <X11/Xos.h>
#include <X11/Xutil.h>
#include <X11/Xmu/WinUtil.h>
#include <X11/cursorfont.h>
#include "gdk.h"
#include "gdkprivate.h"
#include "gdkinput.h"
42
#include "gdkx.h"
43
#include "gdki18n.h"
Elliot Lee's avatar
Elliot Lee committed
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60

#ifndef X_GETTIMEOFDAY
#define X_GETTIMEOFDAY(tv)  gettimeofday (tv, NULL)
#endif /* X_GETTIMEOFDAY */


typedef struct _GdkPredicate  GdkPredicate;

struct _GdkPredicate
{
  GdkEventFunc func;
  gpointer data;
};

/* 
 * Private function declarations
 */
61

62
#ifndef HAVE_XCONVERTCASE
63 64 65
static void	 gdkx_XConvertCase	(KeySym	       symbol,
					 KeySym	      *lower,
					 KeySym	      *upper);
66 67 68
#define XConvertCase gdkx_XConvertCase
#endif

69 70
static void	    gdk_exit_func		 (void);
static int	    gdk_x_error			 (Display     *display, 
Elliot Lee's avatar
Elliot Lee committed
71
						  XErrorEvent *error);
72
static int	    gdk_x_io_error		 (Display     *display);
Elliot Lee's avatar
Elliot Lee committed
73

74 75 76 77
GdkFilterReturn gdk_wm_protocols_filter (GdkXEvent *xev,
					 GdkEvent  *event,
					 gpointer   data);

Elliot Lee's avatar
Elliot Lee committed
78 79
/* Private variable declarations
 */
80
static int gdk_initialized = 0;			    /* 1 if the library is initialized,
Elliot Lee's avatar
Elliot Lee committed
81 82 83
						     * 0 otherwise.
						     */

84 85
static struct timeval start;			    /* The time at which the library was
						     *	last initialized.
Elliot Lee's avatar
Elliot Lee committed
86
						     */
87 88 89 90 91
static struct timeval timer;			    /* Timeout interval to use in the call
						     *	to "select". This is used in
						     *	conjunction with "timerp" to create
						     *	a maximum time to wait for an event
						     *	to arrive.
Elliot Lee's avatar
Elliot Lee committed
92
						     */
93 94 95 96
static struct timeval *timerp;			    /* The actual timer passed to "select"
						     *	This may be NULL, in which case
						     *	"select" will block until an event
						     *	arrives.
Elliot Lee's avatar
Elliot Lee committed
97
						     */
98 99
static guint32 timer_val;			    /* The timeout length as specified by
						     *	the user in milliseconds.
Elliot Lee's avatar
Elliot Lee committed
100
						     */
101

Elliot Lee's avatar
Elliot Lee committed
102 103
static gint autorepeat;

104
#ifdef G_ENABLE_DEBUG
105
static const GDebugKey gdk_debug_keys[] = {
106 107 108
  {"events",	    GDK_DEBUG_EVENTS},
  {"misc",	    GDK_DEBUG_MISC},
  {"dnd",	    GDK_DEBUG_DND},
109
  {"color-context", GDK_DEBUG_COLOR_CONTEXT},
110
  {"xim",	    GDK_DEBUG_XIM}
111
};
112 113 114

static const int gdk_ndebug_keys = sizeof(gdk_debug_keys)/sizeof(GDebugKey);

115
#endif /* G_ENABLE_DEBUG */
Elliot Lee's avatar
Elliot Lee committed
116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138

/*
 *--------------------------------------------------------------
 * gdk_init
 *
 *   Initialize the library for use.
 *
 * Arguments:
 *   "argc" is the number of arguments.
 *   "argv" is an array of strings.
 *
 * Results:
 *   "argc" and "argv" are modified to reflect any arguments
 *   which were not handled. (Such arguments should either
 *   be handled by the application or dismissed).
 *
 * Side effects:
 *   The library is initialized.
 *
 *--------------------------------------------------------------
 */

void
139
gdk_init (int	 *argc,
Elliot Lee's avatar
Elliot Lee committed
140 141 142
	  char ***argv)
{
  XKeyboardState keyboard_state;
143 144
  gint synchronize;
  gint i, j, k;
Elliot Lee's avatar
Elliot Lee committed
145
  XClassHint *class_hint;
146 147
  gchar **argv_orig = NULL;
  gint argc_orig = 0;
148
  
149 150
  if (gdk_initialized)
    return;
151
  
152 153 154 155 156 157 158 159 160
  if (argc && argv)
    {
      argc_orig = *argc;
      
      argv_orig = g_malloc ((argc_orig + 1) * sizeof (char*));
      for (i = 0; i < argc_orig; i++)
	argv_orig[i] = g_strdup ((*argv)[i]);
      argv_orig[argc_orig] = NULL;
    }
161
  
Elliot Lee's avatar
Elliot Lee committed
162
  X_GETTIMEOFDAY (&start);
163
  
Elliot Lee's avatar
Elliot Lee committed
164
  gdk_display_name = NULL;
165
  
Elliot Lee's avatar
Elliot Lee committed
166 167
  XSetErrorHandler (gdk_x_error);
  XSetIOErrorHandler (gdk_x_io_error);
168
  
Elliot Lee's avatar
Elliot Lee committed
169
  synchronize = FALSE;
170
  
171 172 173 174 175 176 177 178 179
#ifdef G_ENABLE_DEBUG
  {
    gchar *debug_string = getenv("GDK_DEBUG");
    if (debug_string != NULL)
      gdk_debug_flags = g_parse_debug_string (debug_string,
					      gdk_debug_keys,
					      gdk_ndebug_keys);
  }
#endif	/* G_ENABLE_DEBUG */
180
  
Elliot Lee's avatar
Elliot Lee committed
181 182 183
  if (argc && argv)
    {
      if (*argc > 0)
184 185
	{
	  gchar *d;
186
	  
187 188
	  d = strrchr((*argv)[0],'/');
	  if (d != NULL)
189
	    g_set_prgname (d + 1);
190
	  else
191
	    g_set_prgname ((*argv)[0]);
192
	}
193
      
Elliot Lee's avatar
Elliot Lee committed
194 195
      for (i = 1; i < *argc;)
	{
196
#ifdef G_ENABLE_DEBUG	  
197 198
	  if ((strcmp ("--gdk-debug", (*argv)[i]) == 0) ||
	      (strncmp ("--gdk-debug=", (*argv)[i], 12) == 0))
Elliot Lee's avatar
Elliot Lee committed
199
	    {
200 201 202 203 204 205 206 207 208
	      gchar *equal_pos = strchr ((*argv)[i], '=');
	      
	      if (equal_pos != NULL)
		{
		  gdk_debug_flags |= g_parse_debug_string (equal_pos+1,
							   gdk_debug_keys,
							   gdk_ndebug_keys);
		}
	      else if ((i + 1) < *argc && (*argv)[i + 1])
Elliot Lee's avatar
Elliot Lee committed
209
		{
210 211 212
		  gdk_debug_flags |= g_parse_debug_string ((*argv)[i+1],
							   gdk_debug_keys,
							   gdk_ndebug_keys);
213
		  (*argv)[i] = NULL;
214 215
		  i += 1;
		}
216
	      (*argv)[i] = NULL;
217
	    }
218 219
	  else if ((strcmp ("--gdk-no-debug", (*argv)[i]) == 0) ||
		   (strncmp ("--gdk-no-debug=", (*argv)[i], 15) == 0))
220
	    {
221
	      gchar *equal_pos = strchr ((*argv)[i], '=');
222
	      
223 224 225 226 227 228 229
	      if (equal_pos != NULL)
		{
		  gdk_debug_flags &= ~g_parse_debug_string (equal_pos+1,
							    gdk_debug_keys,
							    gdk_ndebug_keys);
		}
	      else if ((i + 1) < *argc && (*argv)[i + 1])
230 231 232 233
		{
		  gdk_debug_flags &= ~g_parse_debug_string ((*argv)[i+1],
							    gdk_debug_keys,
							    gdk_ndebug_keys);
234
		  (*argv)[i] = NULL;
Elliot Lee's avatar
Elliot Lee committed
235 236
		  i += 1;
		}
237
	      (*argv)[i] = NULL;
Elliot Lee's avatar
Elliot Lee committed
238
	    }
Owen Taylor's avatar
Owen Taylor committed
239
	  else 
240
#endif /* G_ENABLE_DEBUG */
Owen Taylor's avatar
Owen Taylor committed
241
	    if (strcmp ("--display", (*argv)[i]) == 0)
242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266
	      {
		(*argv)[i] = NULL;
		
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    gdk_display_name = g_strdup ((*argv)[i + 1]);
		    (*argv)[i + 1] = NULL;
		    i += 1;
		  }
	      }
	    else if (strcmp ("--sync", (*argv)[i]) == 0)
	      {
		(*argv)[i] = NULL;
		synchronize = TRUE;
	      }
	    else if (strcmp ("--no-xshm", (*argv)[i]) == 0)
	      {
		(*argv)[i] = NULL;
		gdk_use_xshm = FALSE;
	      }
	    else if (strcmp ("--name", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
267
		    g_set_prgname ((*argv)[i]);
268 269 270 271 272 273 274 275 276 277 278 279
		    (*argv)[i] = NULL;
		  }
	      }
	    else if (strcmp ("--class", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
		    gdk_progclass = (*argv)[i];
		    (*argv)[i] = NULL;
		  }
	      }
Elliot Lee's avatar
Elliot Lee committed
280
#ifdef XINPUT_GXI
281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298
	    else if (strcmp ("--gxid_host", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
		    gdk_input_gxid_host = ((*argv)[i]);
		    (*argv)[i] = NULL;
		  }
	      }
	    else if (strcmp ("--gxid_port", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
		    gdk_input_gxid_port = atoi ((*argv)[i]);
		    (*argv)[i] = NULL;
		  }
	      }
Elliot Lee's avatar
Elliot Lee committed
299
#endif
300
#ifdef USE_XIM
301 302 303 304 305 306
	    else if (strcmp ("--xim-preedit", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
		    if (strcmp ("none", (*argv)[i]) == 0)
307
		      gdk_im_set_best_style (GDK_IM_PREEDIT_NONE);
308
		    else if (strcmp ("nothing", (*argv)[i]) == 0)
309
		      gdk_im_set_best_style (GDK_IM_PREEDIT_NOTHING);
310
		    else if (strcmp ("area", (*argv)[i]) == 0)
311
		      gdk_im_set_best_style (GDK_IM_PREEDIT_AREA);
312
		    else if (strcmp ("position", (*argv)[i]) == 0)
313
		      gdk_im_set_best_style (GDK_IM_PREEDIT_POSITION);
314
		    else if (strcmp ("callbacks", (*argv)[i]) == 0)
315
		      gdk_im_set_best_style (GDK_IM_PREEDIT_CALLBACKS);
316 317 318 319 320 321 322 323
		  }
	      }
	    else if (strcmp ("--xim-status", (*argv)[i]) == 0)
	      {
		if ((i + 1) < *argc && (*argv)[i + 1])
		  {
		    (*argv)[i++] = NULL;
		    if (strcmp ("none", (*argv)[i]) == 0)
324
		      gdk_im_set_best_style (GDK_IM_STATUS_NONE);
325
		    else if (strcmp ("nothing", (*argv)[i]) == 0)
326
		      gdk_im_set_best_style (GDK_IM_STATUS_NOTHING);
327
		    else if (strcmp ("area", (*argv)[i]) == 0)
328
		      gdk_im_set_best_style (GDK_IM_STATUS_AREA);
329
		    else if (strcmp ("callbacks", (*argv)[i]) == 0)
330
		      gdk_im_set_best_style (GDK_IM_STATUS_CALLBACKS);
331 332
		  }
	      }
333
#endif
334
	  
Elliot Lee's avatar
Elliot Lee committed
335 336
	  i += 1;
	}
337
      
Elliot Lee's avatar
Elliot Lee committed
338 339 340 341 342
      for (i = 1; i < *argc; i++)
	{
	  for (k = i; k < *argc; k++)
	    if ((*argv)[k] != NULL)
	      break;
343
	  
Elliot Lee's avatar
Elliot Lee committed
344 345 346 347 348 349 350 351 352 353 354
	  if (k > i)
	    {
	      k -= i;
	      for (j = i + k; j < *argc; j++)
		(*argv)[j-k] = (*argv)[j];
	      *argc -= k;
	    }
	}
    }
  else
    {
355
      g_set_prgname ("<unknown>");
Elliot Lee's avatar
Elliot Lee committed
356
    }
357
  
358
  GDK_NOTE (MISC, g_message ("progname: \"%s\"", g_get_prgname ()));
359
  
Elliot Lee's avatar
Elliot Lee committed
360 361
  gdk_display = XOpenDisplay (gdk_display_name);
  if (!gdk_display)
362 363 364 365
    {
      g_warning ("cannot open display: %s", XDisplayName (gdk_display_name));
      exit(1);
    }
366
  
Elliot Lee's avatar
Elliot Lee committed
367 368
  if (synchronize)
    XSynchronize (gdk_display, True);
369
  
Elliot Lee's avatar
Elliot Lee committed
370 371
  gdk_screen = DefaultScreen (gdk_display);
  gdk_root_window = RootWindow (gdk_display, gdk_screen);
372
  
Elliot Lee's avatar
Elliot Lee committed
373 374 375
  gdk_leader_window = XCreateSimpleWindow(gdk_display, gdk_root_window,
					  10, 10, 10, 10, 0, 0 , 0);
  class_hint = XAllocClassHint();
376
  class_hint->res_name = g_get_prgname ();
377 378
  if (gdk_progclass == NULL)
    {
379
      gdk_progclass = g_strdup (g_get_prgname ());
380 381
      gdk_progclass[0] = toupper (gdk_progclass[0]);
    }
Elliot Lee's avatar
Elliot Lee committed
382 383 384 385
  class_hint->res_class = gdk_progclass;
  XSetClassHint(gdk_display, gdk_leader_window, class_hint);
  XSetCommand(gdk_display, gdk_leader_window, argv_orig, argc_orig);
  XFree (class_hint);
386 387 388 389 390
  
  for (i = 0; i < argc_orig; i++)
    g_free(argv_orig[i]);
  g_free(argv_orig);
  
Elliot Lee's avatar
Elliot Lee committed
391 392 393 394 395 396
  gdk_wm_delete_window = XInternAtom (gdk_display, "WM_DELETE_WINDOW", True);
  gdk_wm_take_focus = XInternAtom (gdk_display, "WM_TAKE_FOCUS", True);
  gdk_wm_protocols = XInternAtom (gdk_display, "WM_PROTOCOLS", True);
  gdk_wm_window_protocols[0] = gdk_wm_delete_window;
  gdk_wm_window_protocols[1] = gdk_wm_take_focus;
  gdk_selection_property = XInternAtom (gdk_display, "GDK_SELECTION", False);
397
  
Elliot Lee's avatar
Elliot Lee committed
398 399
  XGetKeyboardControl (gdk_display, &keyboard_state);
  autorepeat = keyboard_state.global_auto_repeat;
400
  
Elliot Lee's avatar
Elliot Lee committed
401 402 403
  timer.tv_sec = 0;
  timer.tv_usec = 0;
  timerp = NULL;
404
  
Tim Janik's avatar
Tim Janik committed
405
  g_atexit (gdk_exit_func);
406
  
407
  gdk_events_init ();
Elliot Lee's avatar
Elliot Lee committed
408 409 410 411
  gdk_visual_init ();
  gdk_window_init ();
  gdk_image_init ();
  gdk_input_init ();
412 413
  gdk_dnd_init ();

414
#ifdef USE_XIM
415
  gdk_im_open ();
416
#endif
417
  
418
  gdk_initialized = 1;
Elliot Lee's avatar
Elliot Lee committed
419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442
}

/*
 *--------------------------------------------------------------
 * gdk_exit
 *
 *   Restores the library to an un-itialized state and exits
 *   the program using the "exit" system call.
 *
 * Arguments:
 *   "errorcode" is the error value to pass to "exit".
 *
 * Results:
 *   Allocated structures are freed and the program exits
 *   cleanly.
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

void
gdk_exit (int errorcode)
{
443 444 445
  /* de-initialisation is done by the gdk_exit_funct(),
     no need to do this here (Alex J.) */
  exit (errorcode);
Elliot Lee's avatar
Elliot Lee committed
446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461
}

/*
 *--------------------------------------------------------------
 * gdk_set_locale
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

gchar*
462
gdk_set_locale (void)
Elliot Lee's avatar
Elliot Lee committed
463 464
{
  if (!setlocale (LC_ALL,""))
465 466
    g_message ("locale not supported by C library");
  
Elliot Lee's avatar
Elliot Lee committed
467 468
  if (!XSupportsLocale ())
    {
469
      g_message ("locale not supported by Xlib, locale set to C");
Elliot Lee's avatar
Elliot Lee committed
470 471
      setlocale (LC_ALL, "C");
    }
472
  
Elliot Lee's avatar
Elliot Lee committed
473 474
  if (!XSetLocaleModifiers (""))
    {
475
      g_message ("can not set locale modifiers");
Elliot Lee's avatar
Elliot Lee committed
476
    }
477
  
Elliot Lee's avatar
Elliot Lee committed
478 479 480
  return setlocale (LC_ALL,NULL);
}

481 482 483 484 485 486 487 488 489 490 491 492
void
gdk_set_use_xshm (gint use_xshm)
{
  gdk_use_xshm = use_xshm;
}

gint
gdk_get_use_xshm (void)
{
  return gdk_use_xshm;
}

Elliot Lee's avatar
Elliot Lee committed
493 494
/*
 *--------------------------------------------------------------
495
 * gdk_time_get
Elliot Lee's avatar
Elliot Lee committed
496
 *
497 498
 *   Get the number of milliseconds since the library was
 *   initialized.
Elliot Lee's avatar
Elliot Lee committed
499 500 501 502
 *
 * Arguments:
 *
 * Results:
503 504 505 506
 *   The time since the library was initialized is returned.
 *   This time value is accurate to milliseconds even though
 *   a more accurate time down to the microsecond could be
 *   returned.
Elliot Lee's avatar
Elliot Lee committed
507 508 509 510 511 512
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

513 514
guint32
gdk_time_get (void)
Elliot Lee's avatar
Elliot Lee committed
515
{
516 517 518
  struct timeval end;
  struct timeval elapsed;
  guint32 milliseconds;
519
  
520
  X_GETTIMEOFDAY (&end);
521
  
522
  if (start.tv_usec > end.tv_usec)
Owen Taylor's avatar
Owen Taylor committed
523
    {
524 525
      end.tv_usec += 1000000;
      end.tv_sec--;
Owen Taylor's avatar
Owen Taylor committed
526
    }
527 528
  elapsed.tv_sec = end.tv_sec - start.tv_sec;
  elapsed.tv_usec = end.tv_usec - start.tv_usec;
Owen Taylor's avatar
Owen Taylor committed
529
  
530 531 532
  milliseconds = (elapsed.tv_sec * 1000) + (elapsed.tv_usec / 1000);
  
  return milliseconds;
Elliot Lee's avatar
Elliot Lee committed
533 534
}

535 536
/*
 *--------------------------------------------------------------
537
 * gdk_timer_get
538
 *
539
 *   Returns the current timer.
540 541 542
 *
 * Arguments:
 *
543 544 545
 * Results:
 *   Returns the current timer interval. This interval is
 *   in units of milliseconds.
546 547 548
 *
 * Side effects:
 *
549
 *--------------------------------------------------------------
550 551
 */

552 553
guint32
gdk_timer_get (void)
554
{
555
  return timer_val;
556 557
}

Elliot Lee's avatar
Elliot Lee committed
558 559
/*
 *--------------------------------------------------------------
560
 * gdk_timer_set
Elliot Lee's avatar
Elliot Lee committed
561
 *
562
 *   Sets the timer interval.
Elliot Lee's avatar
Elliot Lee committed
563 564
 *
 * Arguments:
565
 *   "milliseconds" is the new value for the timer.
Elliot Lee's avatar
Elliot Lee committed
566 567 568 569
 *
 * Results:
 *
 * Side effects:
570 571 572 573
 *   Calls to "gdk_event_get" will last for a maximum
 *   of time of "milliseconds". However, a value of 0
 *   milliseconds will cause "gdk_event_get" to block
 *   indefinately until an event is received.
Elliot Lee's avatar
Elliot Lee committed
574 575 576 577
 *
 *--------------------------------------------------------------
 */

578 579
void
gdk_timer_set (guint32 milliseconds)
Elliot Lee's avatar
Elliot Lee committed
580
{
581 582 583
  timer_val = milliseconds;
  timer.tv_sec = milliseconds / 1000;
  timer.tv_usec = (milliseconds % 1000) * 1000;
584
  
Elliot Lee's avatar
Elliot Lee committed
585 586 587
}

void
588
gdk_timer_enable (void)
Elliot Lee's avatar
Elliot Lee committed
589
{
590 591 592 593 594 595 596
  timerp = &timer;
}

void
gdk_timer_disable (void)
{
  timerp = NULL;
Elliot Lee's avatar
Elliot Lee committed
597 598 599 600
}

/*
 *--------------------------------------------------------------
601
 * gdk_pointer_grab
Elliot Lee's avatar
Elliot Lee committed
602
 *
603
 *   Grabs the pointer to a specific window
Elliot Lee's avatar
Elliot Lee committed
604 605
 *
 * Arguments:
606 607 608 609 610 611 612
 *   "window" is the window which will receive the grab
 *   "owner_events" specifies whether events will be reported as is,
 *     or relative to "window"
 *   "event_mask" masks only interesting events
 *   "confine_to" limits the cursor movement to the specified window
 *   "cursor" changes the cursor for the duration of the grab
 *   "time" specifies the time
Elliot Lee's avatar
Elliot Lee committed
613 614 615 616
 *
 * Results:
 *
 * Side effects:
617
 *   requires a corresponding call to gdk_pointer_ungrab
Elliot Lee's avatar
Elliot Lee committed
618 619 620 621
 *
 *--------------------------------------------------------------
 */

622 623 624 625 626 627 628
gint
gdk_pointer_grab (GdkWindow *	  window,
		  gint		  owner_events,
		  GdkEventMask	  event_mask,
		  GdkWindow *	  confine_to,
		  GdkCursor *	  cursor,
		  guint32	  time)
Elliot Lee's avatar
Elliot Lee committed
629
{
630 631 632 633 634 635 636 637 638 639
  /*  From gdkwindow.c	*/
  gint return_val;
  GdkWindowPrivate *window_private;
  GdkWindowPrivate *confine_to_private;
  GdkCursorPrivate *cursor_private;
  guint xevent_mask;
  Window xwindow;
  Window xconfine_to;
  Cursor xcursor;
  int i;
Elliot Lee's avatar
Elliot Lee committed
640
  
641
  g_return_val_if_fail (window != NULL, 0);
642
  
643 644 645
  window_private = (GdkWindowPrivate*) window;
  confine_to_private = (GdkWindowPrivate*) confine_to;
  cursor_private = (GdkCursorPrivate*) cursor;
646
  
647
  xwindow = window_private->xwindow;
648
  
649 650 651 652
  if (!confine_to || confine_to_private->destroyed)
    xconfine_to = None;
  else
    xconfine_to = confine_to_private->xwindow;
653
  
654 655 656 657
  if (!cursor)
    xcursor = None;
  else
    xcursor = cursor_private->xcursor;
658 659
  
  
660 661
  xevent_mask = 0;
  for (i = 0; i < gdk_nevent_masks; i++)
Owen Taylor's avatar
Owen Taylor committed
662
    {
663 664
      if (event_mask & (1 << (i + 1)))
	xevent_mask |= gdk_event_mask_table[i];
Owen Taylor's avatar
Owen Taylor committed
665
    }
666
  
667 668 669 670 671 672
  if (gdk_input_vtable.grab_pointer)
    return_val = gdk_input_vtable.grab_pointer (window,
						owner_events,
						event_mask,
						confine_to,
						time);
673
  else
674
    return_val = Success;
675
  
676
  if (return_val == Success)
Elliot Lee's avatar
Elliot Lee committed
677
    {
678 679 680 681 682 683 684 685 686 687 688
      if (!window_private->destroyed)
	return_val = XGrabPointer (window_private->xdisplay,
				   xwindow,
				   owner_events,
				   xevent_mask,
				   GrabModeAsync, GrabModeAsync,
				   xconfine_to,
				   xcursor,
				   time);
      else
	return_val = AlreadyGrabbed;
Elliot Lee's avatar
Elliot Lee committed
689
    }
690
  
691 692
  if (return_val == GrabSuccess)
    gdk_xgrab_window = window_private;
693
  
694
  return return_val;
Elliot Lee's avatar
Elliot Lee committed
695 696 697 698
}

/*
 *--------------------------------------------------------------
699
 * gdk_pointer_ungrab
Elliot Lee's avatar
Elliot Lee committed
700
 *
701
 *   Releases any pointer grab
Elliot Lee's avatar
Elliot Lee committed
702 703 704 705 706 707 708 709 710 711
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

712 713
void
gdk_pointer_ungrab (guint32 time)
Elliot Lee's avatar
Elliot Lee committed
714
{
715 716 717 718 719
  if (gdk_input_vtable.ungrab_pointer)
    gdk_input_vtable.ungrab_pointer (time);
  
  XUngrabPointer (gdk_display, time);
  gdk_xgrab_window = NULL;
Elliot Lee's avatar
Elliot Lee committed
720 721 722 723
}

/*
 *--------------------------------------------------------------
724
 * gdk_pointer_is_grabbed
Elliot Lee's avatar
Elliot Lee committed
725
 *
726
 *   Tell wether there is an active x pointer grab in effect
Elliot Lee's avatar
Elliot Lee committed
727 728 729 730 731 732 733 734 735 736
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

737
gint
738
gdk_pointer_is_grabbed (void)
Elliot Lee's avatar
Elliot Lee committed
739
{
740
  return gdk_xgrab_window != NULL;
Elliot Lee's avatar
Elliot Lee committed
741 742 743 744
}

/*
 *--------------------------------------------------------------
745
 * gdk_keyboard_grab
Elliot Lee's avatar
Elliot Lee committed
746
 *
747
 *   Grabs the keyboard to a specific window
Elliot Lee's avatar
Elliot Lee committed
748 749 750 751 752 753 754 755 756 757
 *
 * Arguments:
 *   "window" is the window which will receive the grab
 *   "owner_events" specifies whether events will be reported as is,
 *     or relative to "window"
 *   "time" specifies the time
 *
 * Results:
 *
 * Side effects:
758
 *   requires a corresponding call to gdk_keyboard_ungrab
Elliot Lee's avatar
Elliot Lee committed
759
 *
760 761
 *--------------------------------------------------------------
 */
762

763 764 765 766 767 768 769
gint
gdk_keyboard_grab (GdkWindow *	   window,
		   gint		   owner_events,
		   guint32	   time)
{
  GdkWindowPrivate *window_private;
  Window xwindow;
770
  
771
  g_return_val_if_fail (window != NULL, 0);
772
  
773 774
  window_private = (GdkWindowPrivate*) window;
  xwindow = window_private->xwindow;
775
  
776 777 778 779 780 781 782 783
  if (!window_private->destroyed)
    return XGrabKeyboard (window_private->xdisplay,
			  xwindow,
			  owner_events,
			  GrabModeAsync, GrabModeAsync,
			  time);
  else
    return AlreadyGrabbed;
Elliot Lee's avatar
Elliot Lee committed
784 785
}

786 787 788 789 790 791 792 793 794 795 796 797 798 799
/*
 *--------------------------------------------------------------
 * gdk_keyboard_ungrab
 *
 *   Releases any keyboard grab
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */
800

801 802 803 804 805
void
gdk_keyboard_ungrab (guint32 time)
{
  XUngrabKeyboard (gdk_display, time);
}
806

807 808 809 810 811 812 813 814 815 816 817 818 819 820
/*
 *--------------------------------------------------------------
 * gdk_screen_width
 *
 *   Return the width of the screen.
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */
821

822 823 824 825 826 827 828 829
gint
gdk_screen_width (void)
{
  gint return_val;
  
  return_val = DisplayWidth (gdk_display, gdk_screen);
  
  return return_val;
830 831
}

832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848
/*
 *--------------------------------------------------------------
 * gdk_screen_height
 *
 *   Return the height of the screen.
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

gint
gdk_screen_height (void)
Elliot Lee's avatar
Elliot Lee committed
849
{
850
  gint return_val;
851
  
852
  return_val = DisplayHeight (gdk_display, gdk_screen);
853
  
854
  return return_val;
Elliot Lee's avatar
Elliot Lee committed
855 856
}

857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873
/*
 *--------------------------------------------------------------
 * gdk_screen_width_mm
 *
 *   Return the width of the screen in millimeters.
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

gint
gdk_screen_width_mm (void)
Elliot Lee's avatar
Elliot Lee committed
874
{
875 876 877
  gint return_val;
  
  return_val = DisplayWidthMM (gdk_display, gdk_screen);
878
  
879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900
  return return_val;
}

/*
 *--------------------------------------------------------------
 * gdk_screen_height
 *
 *   Return the height of the screen in millimeters.
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

gint
gdk_screen_height_mm (void)
{
  gint return_val;
901
  
902
  return_val = DisplayHeightMM (gdk_display, gdk_screen);
903
  
904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926
  return return_val;
}

void
gdk_key_repeat_disable (void)
{
  XAutoRepeatOff (gdk_display);
}

void
gdk_key_repeat_restore (void)
{
  if (autorepeat)
    XAutoRepeatOn (gdk_display);
  else
    XAutoRepeatOff (gdk_display);
}


void
gdk_beep (void)
{
  XBell(gdk_display, 100);
Elliot Lee's avatar
Elliot Lee committed
927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946
}

/*
 *--------------------------------------------------------------
 * gdk_exit_func
 *
 *   This is the "atexit" function that makes sure the
 *   library gets a chance to cleanup.
 *
 * Arguments:
 *
 * Results:
 *
 * Side effects:
 *   The library is un-initialized and the program exits.
 *
 *--------------------------------------------------------------
 */

static void
947
gdk_exit_func (void)
Elliot Lee's avatar
Elliot Lee committed
948
{
949
  static gboolean in_gdk_exit_func = FALSE;
950
  
951 952
  /* This is to avoid an infinite loop if a program segfaults in
     an atexit() handler (and yes, it does happen, especially if a program
953
     has trounced over memory too badly for even g_message to work) */
954 955
  if (in_gdk_exit_func == TRUE)
    return;
956
  in_gdk_exit_func = TRUE;
957
  
958
  if (gdk_initialized)
Elliot Lee's avatar
Elliot Lee committed
959
    {
960 961 962 963 964 965
#ifdef USE_XIM
      /* cleanup IC */
      gdk_ic_cleanup ();
      /* close IM */
      gdk_im_close ();
#endif
Elliot Lee's avatar
Elliot Lee committed
966 967 968
      gdk_image_exit ();
      gdk_input_exit ();
      gdk_key_repeat_restore ();
969
      
Elliot Lee's avatar
Elliot Lee committed
970
      XCloseDisplay (gdk_display);
971
      gdk_initialized = 0;
Elliot Lee's avatar
Elliot Lee committed
972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997
    }
}

/*
 *--------------------------------------------------------------
 * gdk_x_error
 *
 *   The X error handling routine.
 *
 * Arguments:
 *   "display" is the X display the error orignated from.
 *   "error" is the XErrorEvent that we are handling.
 *
 * Results:
 *   Either we were expecting some sort of error to occur,
 *   in which case we set the "gdk_error_code" flag, or this
 *   error was unexpected, in which case we will print an
 *   error message and exit. (Since trying to continue will
 *   most likely simply lead to more errors).
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

static int
998
gdk_x_error (Display	 *display,
Elliot Lee's avatar
Elliot Lee committed
999 1000 1001
	     XErrorEvent *error)
{
  char buf[64];
1002
  
Elliot Lee's avatar
Elliot Lee committed
1003 1004 1005
  if (gdk_error_warnings)
    {
      XGetErrorText (display, error->error_code, buf, 63);
Owen Taylor's avatar
Owen Taylor committed
1006 1007 1008 1009 1010 1011
      g_error ("%s\n  serial %ld error_code %d request_code %d minor_code %d\n", 
	       buf, 
	       error->serial, 
	       error->error_code, 
	       error->request_code,
	       error->minor_code);
Elliot Lee's avatar
Elliot Lee committed
1012
    }
1013
  
Elliot Lee's avatar
Elliot Lee committed
1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
  gdk_error_code = -1;
  return 0;
}

/*
 *--------------------------------------------------------------
 * gdk_x_io_error
 *
 *   The X I/O error handling routine.
 *
 * Arguments:
 *   "display" is the X display the error orignated from.
 *
 * Results:
 *   An X I/O error basically means we lost our connection
 *   to the X server. There is not much we can do to
 *   continue, so simply print an error message and exit.
 *
 * Side effects:
 *
 *--------------------------------------------------------------
 */

static int
gdk_x_io_error (Display *display)
{
  g_error ("an x io error occurred");
  return 0;
}

Manish Singh's avatar
Manish Singh committed
1044 1045 1046 1047 1048
gchar *
gdk_get_display(void)
{
  return (gchar *)XDisplayName (gdk_display_name);
}
1049 1050 1051 1052 1053 1054

gint 
gdk_send_xevent (Window window, gboolean propagate, glong event_mask,
		 XEvent *event_send)
{
  Status result;
1055
  gint old_warnings = gdk_error_warnings;
1056 1057 1058 1059 1060 1061
  
  gdk_error_code = 0;
  
  gdk_error_warnings = 0;
  result = XSendEvent (gdk_display, window, propagate, event_mask, event_send);
  XSync (gdk_display, False);
1062
  gdk_error_warnings = old_warnings;
1063
  
1064 1065
  return result && (gdk_error_code != -1);
}
Tim Janik's avatar
Tim Janik committed
1066

1067
#ifndef HAVE_XCONVERTCASE
1068 1069 1070 1071 1072 1073 1074 1075 1076
/* compatibility function from X11R6.3, since XConvertCase is not
 * supplied by X11R5.
 */
static void
gdkx_XConvertCase (KeySym symbol,
		   KeySym *lower,
		   KeySym *upper)
{
  register KeySym sym = symbol;
1077
  
1078 1079
  g_return_if_fail (lower != NULL);
  g_return_if_fail (upper != NULL);
1080
  
1081 1082
  *lower = sym;
  *upper = sym;
1083
  
1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177
  switch (sym >> 8)
    {
#if	defined (GDK_A) && defined (GDK_Ooblique)
    case 0: /* Latin 1 */
      if ((sym >= GDK_A) && (sym <= GDK_Z))
	*lower += (GDK_a - GDK_A);
      else if ((sym >= GDK_a) && (sym <= GDK_z))
	*upper -= (GDK_a - GDK_A);
      else if ((sym >= GDK_Agrave) && (sym <= GDK_Odiaeresis))
	*lower += (GDK_agrave - GDK_Agrave);
      else if ((sym >= GDK_agrave) && (sym <= GDK_odiaeresis))
	*upper -= (GDK_agrave - GDK_Agrave);
      else if ((sym >= GDK_Ooblique) && (sym <= GDK_Thorn))
	*lower += (GDK_oslash - GDK_Ooblique);
      else if ((sym >= GDK_oslash) && (sym <= GDK_thorn))
	*upper -= (GDK_oslash - GDK_Ooblique);
      break;
#endif	/* LATIN1 */
      
#if	defined (GDK_Aogonek) && defined (GDK_tcedilla)
    case 1: /* Latin 2 */
      /* Assume the KeySym is a legal value (ignore discontinuities) */
      if (sym == GDK_Aogonek)
	*lower = GDK_aogonek;
      else if (sym >= GDK_Lstroke && sym <= GDK_Sacute)
	*lower += (GDK_lstroke - GDK_Lstroke);
      else if (sym >= GDK_Scaron && sym <= GDK_Zacute)
	*lower += (GDK_scaron - GDK_Scaron);
      else if (sym >= GDK_Zcaron && sym <= GDK_Zabovedot)
	*lower += (GDK_zcaron - GDK_Zcaron);
      else if (sym == GDK_aogonek)
	*upper = GDK_Aogonek;
      else if (sym >= GDK_lstroke && sym <= GDK_sacute)
	*upper -= (GDK_lstroke - GDK_Lstroke);
      else if (sym >= GDK_scaron && sym <= GDK_zacute)
	*upper -= (GDK_scaron - GDK_Scaron);
      else if (sym >= GDK_zcaron && sym <= GDK_zabovedot)
	*upper -= (GDK_zcaron - GDK_Zcaron);
      else if (sym >= GDK_Racute && sym <= GDK_Tcedilla)
	*lower += (GDK_racute - GDK_Racute);
      else if (sym >= GDK_racute && sym <= GDK_tcedilla)
	*upper -= (GDK_racute - GDK_Racute);
      break;
#endif	/* LATIN2 */
      
#if	defined (GDK_Hstroke) && defined (GDK_Cabovedot)
    case 2: /* Latin 3 */
      /* Assume the KeySym is a legal value (ignore discontinuities) */
      if (sym >= GDK_Hstroke && sym <= GDK_Hcircumflex)
	*lower += (GDK_hstroke - GDK_Hstroke);
      else if (sym >= GDK_Gbreve && sym <= GDK_Jcircumflex)
	*lower += (GDK_gbreve - GDK_Gbreve);
      else if (sym >= GDK_hstroke && sym <= GDK_hcircumflex)
	*upper -= (GDK_hstroke - GDK_Hstroke);
      else if (sym >= GDK_gbreve && sym <= GDK_jcircumflex)
	*upper -= (GDK_gbreve - GDK_Gbreve);
      else if (sym >= GDK_Cabovedot && sym <= GDK_Scircumflex)
	*lower += (GDK_cabovedot - GDK_Cabovedot);
      else if (sym >= GDK_cabovedot && sym <= GDK_scircumflex)
	*upper -= (GDK_cabovedot - GDK_Cabovedot);
      break;
#endif	/* LATIN3 */
      
#if	defined (GDK_Rcedilla) && defined (GDK_Amacron)
    case 3: /* Latin 4 */
      /* Assume the KeySym is a legal value (ignore discontinuities) */
      if (sym >= GDK_Rcedilla && sym <= GDK_Tslash)
	*lower += (GDK_rcedilla - GDK_Rcedilla);
      else if (sym >= GDK_rcedilla && sym <= GDK_tslash)
	*upper -= (GDK_rcedilla - GDK_Rcedilla);
      else if (sym == GDK_ENG)
	*lower = GDK_eng;
      else if (sym == GDK_eng)
	*upper = GDK_ENG;
      else if (sym >= GDK_Amacron && sym <= GDK_Umacron)
	*lower += (GDK_amacron - GDK_Amacron);
      else if (sym >= GDK_amacron && sym <= GDK_umacron)
	*upper -= (GDK_amacron - GDK_Amacron);
      break;
#endif	/* LATIN4 */
      
#if	defined (GDK_Serbian_DJE) && defined (GDK_Cyrillic_yu)
    case 6: /* Cyrillic */
      /* Assume the KeySym is a legal value (ignore discontinuities) */
      if (sym >= GDK_Serbian_DJE && sym <= GDK_Serbian_DZE)
	*lower -= (GDK_Serbian_DJE - GDK_Serbian_dje);
      else if (sym >= GDK_Serbian_dje && sym <= GDK_Serbian_dze)
	*upper += (GDK_Serbian_DJE - GDK_Serbian_dje);
      else if (sym >= GDK_Cyrillic_YU && sym <= GDK_Cyrillic_HARDSIGN)
	*lower -= (GDK_Cyrillic_YU - GDK_Cyrillic_yu);
      else if (sym >= GDK_Cyrillic_yu && sym <= GDK_Cyrillic_hardsign)
	*upper += (GDK_Cyrillic_YU - GDK_Cyrillic_yu);
      break;
#endif	/* CYRILLIC */
1178
      
1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196
#if	defined (GDK_Greek_ALPHAaccent) && defined (GDK_Greek_finalsmallsigma)
    case 7: /* Greek */
      /* Assume the KeySym is a legal value (ignore discontinuities) */
      if (sym >= GDK_Greek_ALPHAaccent && sym <= GDK_Greek_OMEGAaccent)
	*lower += (GDK_Greek_alphaaccent - GDK_Greek_ALPHAaccent);
      else if (sym >= GDK_Greek_alphaaccent && sym <= GDK_Greek_omegaaccent &&
	       sym != GDK_Greek_iotaaccentdieresis &&
	       sym != GDK_Greek_upsilonaccentdieresis)
	*upper -= (GDK_Greek_alphaaccent - GDK_Greek_ALPHAaccent);
      else if (sym >= GDK_Greek_ALPHA && sym <= GDK_Greek_OMEGA)
	*lower += (GDK_Greek_alpha - GDK_Greek_ALPHA);
      else if (sym >= GDK_Greek_alpha && sym <= GDK_Greek_omega &&
	       sym != GDK_Greek_finalsmallsigma)
	*upper -= (GDK_Greek_alpha - GDK_Greek_ALPHA);
      break;
#endif	/* GREEK */
    }
}
1197
#endif
1198

Tim Janik's avatar
Tim Janik committed
1199
gchar*
1200
gdk_keyval_name (guint	      keyval)
Tim Janik's avatar
Tim Janik committed
1201 1202 1203 1204 1205 1206 1207 1208
{
  return XKeysymToString (keyval);
}

guint
gdk_keyval_from_name (const gchar *keyval_name)
{
  g_return_val_if_fail (keyval_name != NULL, 0);
1209
  
Tim Janik's avatar
Tim Janik committed
1210 1211 1212 1213
  return XStringToKeysym (keyval_name);
}

guint
1214
gdk_keyval_to_upper (guint	  keyval)
Tim Janik's avatar
Tim Janik committed
1215 1216 1217 1218 1219
{
  if (keyval)
    {
      KeySym lower_val = 0;
      KeySym upper_val = 0;
1220
      
1221
      XConvertCase (keyval, &lower_val, &upper_val);
Tim Janik's avatar
Tim Janik committed
1222 1223 1224 1225 1226 1227
      return upper_val;
    }
  return 0;
}

guint
1228
gdk_keyval_to_lower (guint	  keyval)
Tim Janik's avatar
Tim Janik committed
1229 1230 1231 1232 1233
{
  if (keyval)
    {
      KeySym lower_val = 0;
      KeySym upper_val = 0;
1234
      
1235
      XConvertCase (keyval, &lower_val, &upper_val);
Tim Janik's avatar
Tim Janik committed
1236 1237 1238 1239 1240 1241
      return lower_val;
    }
  return 0;
}

gboolean
1242
gdk_keyval_is_upper (guint	  keyval)
Tim Janik's avatar
Tim Janik committed
1243 1244 1245 1246 1247
{
  if (keyval)
    {
      KeySym lower_val = 0;
      KeySym upper_val = 0;
1248
      
1249
      XConvertCase (keyval, &lower_val, &upper_val);
Tim Janik's avatar
Tim Janik committed
1250 1251 1252 1253 1254 1255
      return upper_val == keyval;
    }
  return TRUE;
}

gboolean
1256
gdk_keyval_is_lower (guint	  keyval)
Tim Janik's avatar
Tim Janik committed
1257 1258 1259 1260 1261
{
  if (keyval)
    {
      KeySym lower_val = 0;
      KeySym upper_val = 0;
1262
      
1263
      XConvertCase (keyval, &lower_val, &upper_val);
Tim Janik's avatar
Tim Janik committed
1264 1265 1266 1267
      return lower_val == keyval;
    }
  return TRUE;
}