/* 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 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 * License along with this library. If not, see . */ /* * 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 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #include "config.h" #include "gdkversionmacros.h" #include "gdkprofilerprivate.h" #include "gdkinternals.h" #include "gdkintl.h" #include "gdkresources.h" #include "gdk-private.h" #include "gdkconstructor.h" #ifndef HAVE_XCONVERTCASE #include "gdkkeysyms.h" #endif #include #include #include /** * SECTION:general * @Short_description: Library initialization and miscellaneous functions * @Title: General * * This section describes the GDK initialization functions and miscellaneous * utility functions, as well as deprecation facilities. * * The GDK and GTK headers annotate deprecated APIs in a way that produces * compiler warnings if these deprecated APIs are used. The warnings * can be turned off by defining the macro %GDK_DISABLE_DEPRECATION_WARNINGS * before including the glib.h header. * * GDK and GTK also provide support for building applications against * defined subsets of deprecated or new APIs. Define the macro * %GDK_VERSION_MIN_REQUIRED to specify up to what version * you want to receive warnings about deprecated APIs. Define the * macro %GDK_VERSION_MAX_ALLOWED to specify the newest version * whose API you want to use. */ /** * GDK_WINDOWING_X11: * * The #GDK_WINDOWING_X11 macro is defined if the X11 backend * is supported. * * Use this macro to guard code that is specific to the X11 backend. */ /** * GDK_WINDOWING_WIN32: * * The #GDK_WINDOWING_WIN32 macro is defined if the Win32 backend * is supported. * * Use this macro to guard code that is specific to the Win32 backend. */ /** * GDK_WINDOWING_QUARTZ: * * The #GDK_WINDOWING_QUARTZ macro is defined if the Quartz backend * is supported. * * Use this macro to guard code that is specific to the Quartz backend. */ /** * GDK_WINDOWING_WAYLAND: * * The #GDK_WINDOWING_WAYLAND macro is defined if the Wayland backend * is supported. * * Use this macro to guard code that is specific to the Wayland backend. */ /** * GDK_DISABLE_DEPRECATION_WARNINGS: * * A macro that should be defined before including the gdk.h header. * If it is defined, no compiler warnings will be produced for uses * of deprecated GDK APIs. */ typedef struct _GdkThreadsDispatch GdkThreadsDispatch; struct _GdkThreadsDispatch { GSourceFunc func; gpointer data; GDestroyNotify destroy; }; /* Private variable declarations */ static int gdk_initialized = 0; /* 1 if the library is initialized, * 0 otherwise. */ #ifdef G_ENABLE_DEBUG static const GDebugKey gdk_debug_keys[] = { { "misc", GDK_DEBUG_MISC }, { "events", GDK_DEBUG_EVENTS }, { "dnd", GDK_DEBUG_DND }, { "input", GDK_DEBUG_INPUT }, { "eventloop", GDK_DEBUG_EVENTLOOP }, { "frames", GDK_DEBUG_FRAMES }, { "settings", GDK_DEBUG_SETTINGS }, { "opengl", GDK_DEBUG_OPENGL }, { "vulkan", GDK_DEBUG_VULKAN }, { "selection", GDK_DEBUG_SELECTION }, { "clipboard", GDK_DEBUG_CLIPBOARD }, { "nograbs", GDK_DEBUG_NOGRABS }, { "gl-disable", GDK_DEBUG_GL_DISABLE }, { "gl-software", GDK_DEBUG_GL_SOFTWARE }, { "gl-texture-rect", GDK_DEBUG_GL_TEXTURE_RECT }, { "gl-legacy", GDK_DEBUG_GL_LEGACY }, { "gl-gles", GDK_DEBUG_GL_GLES }, { "gl-debug", GDK_DEBUG_GL_DEBUG }, { "vulkan-disable", GDK_DEBUG_VULKAN_DISABLE }, { "vulkan-validate", GDK_DEBUG_VULKAN_VALIDATE }, { "default-settings",GDK_DEBUG_DEFAULT_SETTINGS }, }; #endif #ifdef G_HAS_CONSTRUCTORS #ifdef G_DEFINE_CONSTRUCTOR_NEEDS_PRAGMA #pragma G_DEFINE_CONSTRUCTOR_PRAGMA_ARGS(stash_desktop_startup_notification_id) #endif G_DEFINE_CONSTRUCTOR(stash_desktop_startup_notification_id) #endif static gchar *startup_notification_id = NULL; static void stash_desktop_startup_notification_id (void) { const char *desktop_startup_id; desktop_startup_id = g_getenv ("DESKTOP_STARTUP_ID"); if (desktop_startup_id && *desktop_startup_id != '\0') { if (!g_utf8_validate (desktop_startup_id, -1, NULL)) g_warning ("DESKTOP_STARTUP_ID contains invalid UTF-8"); else startup_notification_id = g_strdup (desktop_startup_id ? desktop_startup_id : ""); } /* Clear the environment variable so it won't be inherited by * child processes and confuse things. */ g_unsetenv ("DESKTOP_STARTUP_ID"); } static gpointer register_resources (gpointer dummy G_GNUC_UNUSED) { _gdk_register_resource (); return NULL; } static void gdk_ensure_resources (void) { static GOnce register_resources_once = G_ONCE_INIT; g_once (®ister_resources_once, register_resources, NULL); } void gdk_pre_parse (void) { gdk_initialized = TRUE; gdk_ensure_resources (); #ifdef G_ENABLE_DEBUG { gchar *debug_string = getenv("GDK_DEBUG"); if (debug_string != NULL) _gdk_debug_flags = g_parse_debug_string (debug_string, (GDebugKey *) gdk_debug_keys, G_N_ELEMENTS (gdk_debug_keys)); } #endif /* G_ENABLE_DEBUG */ if (g_getenv ("GTK_TRACE_FD")) gdk_profiler_start (atoi (g_getenv ("GTK_TRACE_FD"))); else if (g_getenv ("GTK_TRACE")) gdk_profiler_start (-1); #ifndef G_HAS_CONSTRUCTORS stash_desktop_startup_notification_id (); #endif } /*< private > * gdk_display_open_default: * * Opens the default display specified by command line arguments or * environment variables, sets it as the default display, and returns * it. gdk_parse_args() must have been called first. If the default * display has previously been set, simply returns that. An internal * function that should not be used by applications. * * Returns: (nullable) (transfer none): the default display, if it * could be opened, otherwise %NULL. */ GdkDisplay * gdk_display_open_default (void) { GdkDisplay *display; g_return_val_if_fail (gdk_initialized, NULL); display = gdk_display_get_default (); if (display) return display; display = gdk_display_open (NULL); return display; } /*< private > * * gdk_get_startup_notification_id * * Returns the original value of the DESKTOP_STARTUP_ID environment * variable if it was defined and valid, or %NULL otherwise. * * Returns: (nullable) (transfer none): the original value of the * DESKTOP_STARTUP_ID environment variable, or %NULL. */ const gchar * gdk_get_startup_notification_id (void) { return startup_notification_id; } gboolean gdk_running_in_sandbox (void) { return g_file_test ("/.flatpak-info", G_FILE_TEST_EXISTS); } gboolean gdk_should_use_portal (void) { static const char *use_portal = NULL; if (G_UNLIKELY (use_portal == NULL)) { if (gdk_running_in_sandbox ()) use_portal = "1"; else { use_portal = g_getenv ("GTK_USE_PORTAL"); if (!use_portal) use_portal = ""; } } return use_portal[0] == '1'; } PangoDirection gdk_unichar_direction (gunichar ch) { FriBidiCharType fribidi_ch_type; G_STATIC_ASSERT (sizeof (FriBidiChar) == sizeof (gunichar)); fribidi_ch_type = fribidi_get_bidi_type (ch); if (!FRIBIDI_IS_STRONG (fribidi_ch_type)) return PANGO_DIRECTION_NEUTRAL; else if (FRIBIDI_IS_RTL (fribidi_ch_type)) return PANGO_DIRECTION_RTL; else return PANGO_DIRECTION_LTR; } PangoDirection gdk_find_base_dir (const gchar *text, gint length) { PangoDirection dir = PANGO_DIRECTION_NEUTRAL; const gchar *p; g_return_val_if_fail (text != NULL || length == 0, PANGO_DIRECTION_NEUTRAL); p = text; while ((length < 0 || p < text + length) && *p) { gunichar wc = g_utf8_get_char (p); dir = gdk_unichar_direction (wc); if (dir != PANGO_DIRECTION_NEUTRAL) break; p = g_utf8_next_char (p); } return dir; }