Blame clutter/gdk/clutter-backend-gdk.c

Packit 31ecd5
/* Clutter.
Packit 31ecd5
 * An OpenGL based 'interactive canvas' library.
Packit 31ecd5
 * Authored By Matthew Allum  <mallum@openedhand.com>
Packit 31ecd5
 * Copyright (C) 2006-2007 OpenedHand
Packit 31ecd5
 *
Packit 31ecd5
 * This library is free software; you can redistribute it and/or
Packit 31ecd5
 * modify it under the terms of the GNU Lesser General Public
Packit 31ecd5
 * License as published by the Free Software Foundation; either
Packit 31ecd5
 * version 2 of the License, or (at your option) any later version.
Packit 31ecd5
 *
Packit 31ecd5
 * This library is distributed in the hope that it will be useful,
Packit 31ecd5
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 31ecd5
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit 31ecd5
 * Lesser General Public License for more details.
Packit 31ecd5
 *
Packit 31ecd5
 * You should have received a copy of the GNU Lesser General Public
Packit 31ecd5
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Packit 31ecd5
 *
Packit 31ecd5
 *
Packit 31ecd5
 */
Packit 31ecd5
Packit 31ecd5
#ifdef HAVE_CONFIG_H
Packit 31ecd5
#include "config.h"
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#define CLUTTER_ENABLE_EXPERIMENTAL_API
Packit 31ecd5
Packit 31ecd5
#include <glib/gi18n-lib.h>
Packit 31ecd5
Packit 31ecd5
#include <string.h>
Packit 31ecd5
#ifdef HAVE_UNISTD_H
Packit 31ecd5
#include <unistd.h>
Packit 31ecd5
#endif
Packit 31ecd5
#include <sys/stat.h>
Packit 31ecd5
#include <sys/types.h>
Packit 31ecd5
#include <fcntl.h>
Packit 31ecd5
#include <errno.h>
Packit 31ecd5
Packit 31ecd5
#include <gdk/gdk.h>
Packit 31ecd5
#include <cogl/cogl.h>
Packit 31ecd5
Packit 31ecd5
#ifndef GDK_WINDOWING_WIN32
Packit 31ecd5
#include <sys/ioctl.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#if defined(GDK_WINDOWING_X11) && defined(COGL_HAS_XLIB_SUPPORT)
Packit 31ecd5
#include <cogl/cogl-xlib.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#if defined(GDK_WINDOWING_WAYLAND) && defined(COGL_HAS_EGL_PLATFORM_WAYLAND_SUPPORT)
Packit 31ecd5
#include <cogl/cogl-wayland-client.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#ifdef GDK_WINDOWING_X11
Packit 31ecd5
#include <gdk/gdkx.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#ifdef GDK_WINDOWING_WAYLAND
Packit 31ecd5
#include <gdk/gdkwayland.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#ifdef GDK_WINDOWING_WIN32
Packit 31ecd5
#include <gdk/gdkwin32.h>
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
#include "clutter-backend-gdk.h"
Packit 31ecd5
#include "clutter-device-manager-gdk.h"
Packit 31ecd5
#include "clutter-settings-gdk.h"
Packit 31ecd5
#include "clutter-stage-gdk.h"
Packit 31ecd5
#include "clutter-gdk.h"
Packit 31ecd5
Packit 31ecd5
#include "clutter-backend.h"
Packit 31ecd5
#include "clutter-debug.h"
Packit 31ecd5
#include "clutter-device-manager-private.h"
Packit 31ecd5
#include "clutter-event-private.h"
Packit 31ecd5
#include "clutter-main.h"
Packit 31ecd5
#include "clutter-private.h"
Packit 31ecd5
#include "clutter-settings-private.h"
Packit 31ecd5
Packit 31ecd5
G_DEFINE_TYPE (ClutterBackendGdk, clutter_backend_gdk, CLUTTER_TYPE_BACKEND);
Packit 31ecd5
Packit 31ecd5
/* global for pre init setup calls */
Packit 31ecd5
static GdkDisplay  *_foreign_dpy = NULL;
Packit 31ecd5
Packit 31ecd5
static gboolean disable_event_retrieval = FALSE;
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
clutter_backend_gdk_init_settings (ClutterBackendGdk *backend_gdk)
Packit 31ecd5
{
Packit 31ecd5
  ClutterSettings *settings = clutter_settings_get_default ();
Packit 31ecd5
  int i;
Packit 31ecd5
Packit 31ecd5
  for (i = 0; i < G_N_ELEMENTS (_clutter_settings_map); i++)
Packit 31ecd5
    {
Packit 31ecd5
      GValue val = G_VALUE_INIT;
Packit 31ecd5
Packit 31ecd5
      g_value_init (&val, CLUTTER_SETTING_TYPE(i));
Packit 31ecd5
      if (gdk_screen_get_setting (backend_gdk->screen,
Packit 31ecd5
                                  CLUTTER_SETTING_GDK_NAME (i),
Packit 31ecd5
                                  &val))
Packit 31ecd5
        {
Packit 31ecd5
          clutter_settings_set_property_internal (settings,
Packit 31ecd5
                                                  CLUTTER_SETTING_PROPERTY (i),
Packit 31ecd5
                                                  &val;;
Packit 31ecd5
        }
Packit 31ecd5
      g_value_unset (&val;;
Packit 31ecd5
    }
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
void
Packit 31ecd5
_clutter_backend_gdk_update_setting (ClutterBackendGdk *backend_gdk,
Packit 31ecd5
				     const gchar       *setting_name)
Packit 31ecd5
{
Packit 31ecd5
  ClutterSettings *settings = clutter_settings_get_default ();
Packit 31ecd5
  int i;
Packit 31ecd5
Packit 31ecd5
  for (i = 0; i < G_N_ELEMENTS (_clutter_settings_map); i++)
Packit 31ecd5
    {
Packit 31ecd5
      if (g_strcmp0 (CLUTTER_SETTING_GDK_NAME (i), setting_name) == 0)
Packit 31ecd5
	{
Packit 31ecd5
	  GValue val = G_VALUE_INIT;
Packit 31ecd5
Packit 31ecd5
	  g_value_init (&val, CLUTTER_SETTING_TYPE (i));
Packit 31ecd5
	  gdk_screen_get_setting (backend_gdk->screen,
Packit 31ecd5
				  CLUTTER_SETTING_GDK_NAME (i),
Packit 31ecd5
				  &val;;
Packit 31ecd5
	  clutter_settings_set_property_internal (settings,
Packit 31ecd5
	  	  	  	  	  	  CLUTTER_SETTING_PROPERTY (i),
Packit 31ecd5
	  	  	  	  	  	  &val;;
Packit 31ecd5
	  g_value_unset (&val;;
Packit 31ecd5
Packit 31ecd5
	  break;
Packit 31ecd5
	}
Packit 31ecd5
    }
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static GdkFilterReturn
Packit 31ecd5
cogl_gdk_filter (GdkXEvent  *xevent,
Packit 31ecd5
		 GdkEvent   *event,
Packit 31ecd5
		 gpointer    data)
Packit 31ecd5
{
Packit 31ecd5
#ifdef GDK_WINDOWING_X11
Packit 31ecd5
  ClutterBackend *backend = data;
Packit 31ecd5
  CoglFilterReturn ret;
Packit 31ecd5
Packit 31ecd5
  ret = cogl_xlib_renderer_handle_event (backend->cogl_renderer, (XEvent *) xevent);
Packit 31ecd5
  switch (ret)
Packit 31ecd5
    {
Packit 31ecd5
    case COGL_FILTER_REMOVE:
Packit 31ecd5
      return GDK_FILTER_REMOVE;
Packit 31ecd5
Packit 31ecd5
    case COGL_FILTER_CONTINUE:
Packit 31ecd5
    default:
Packit 31ecd5
      return GDK_FILTER_CONTINUE;
Packit 31ecd5
    }
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
  return GDK_FILTER_CONTINUE;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static gboolean
Packit 31ecd5
_clutter_backend_gdk_post_parse (ClutterBackend  *backend,
Packit 31ecd5
                                 GError         **error)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendGdk *backend_gdk = CLUTTER_BACKEND_GDK (backend);
Packit 31ecd5
Packit 31ecd5
  if (_foreign_dpy != NULL)
Packit 31ecd5
    backend_gdk->display = _foreign_dpy;
Packit 31ecd5
Packit 31ecd5
  /* Init Gdk, if outside code did not already */
Packit 31ecd5
  if (!gdk_init_check (NULL, NULL))
Packit 31ecd5
    {
Packit 31ecd5
      g_set_error (error, CLUTTER_INIT_ERROR, CLUTTER_INIT_ERROR_BACKEND,
Packit 31ecd5
                   _("Could not initialize Gdk"));
Packit 31ecd5
      return FALSE;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  /*
Packit 31ecd5
   * Only open connection if not already set by prior call to
Packit 31ecd5
   * clutter_gdk_set_display()
Packit 31ecd5
   */
Packit 31ecd5
  if (backend_gdk->display == NULL)
Packit 31ecd5
    backend_gdk->display = g_object_ref (gdk_display_get_default ());
Packit 31ecd5
Packit 31ecd5
  g_assert (backend_gdk->display != NULL);
Packit 31ecd5
Packit 31ecd5
  backend_gdk->screen = gdk_display_get_default_screen (backend_gdk->display);
Packit 31ecd5
Packit 31ecd5
  /* add event filter for Cogl events */
Packit 31ecd5
  gdk_window_add_filter (NULL, cogl_gdk_filter, backend_gdk);
Packit 31ecd5
Packit 31ecd5
  clutter_backend_gdk_init_settings (backend_gdk);
Packit 31ecd5
Packit 31ecd5
  CLUTTER_NOTE (BACKEND,
Packit 31ecd5
                "Gdk Display '%s' opened",
Packit 31ecd5
                gdk_display_get_name (backend_gdk->display));
Packit 31ecd5
Packit 31ecd5
  return TRUE;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
gdk_event_handler (GdkEvent *event,
Packit 31ecd5
		   gpointer  user_data)
Packit 31ecd5
{
Packit 31ecd5
  clutter_gdk_handle_event (event);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
void
Packit 31ecd5
_clutter_backend_gdk_events_init (ClutterBackend *backend)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendGdk *backend_gdk = CLUTTER_BACKEND_GDK (backend);
Packit 31ecd5
Packit 31ecd5
  CLUTTER_NOTE (EVENT, "initialising the event loop");
Packit 31ecd5
Packit 31ecd5
  backend->device_manager =
Packit 31ecd5
    g_object_new (CLUTTER_TYPE_DEVICE_MANAGER_GDK,
Packit 31ecd5
                  "backend", backend,
Packit 31ecd5
                  "gdk-display", backend_gdk->display,
Packit 31ecd5
                  NULL);
Packit 31ecd5
Packit 31ecd5
  if (!disable_event_retrieval)
Packit 31ecd5
    gdk_event_handler_set (gdk_event_handler, NULL, NULL);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
clutter_backend_gdk_finalize (GObject *gobject)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendGdk *backend_gdk = CLUTTER_BACKEND_GDK (gobject);
Packit 31ecd5
Packit 31ecd5
  gdk_window_remove_filter (NULL, cogl_gdk_filter, backend_gdk);
Packit 31ecd5
  g_object_unref (backend_gdk->display);
Packit 31ecd5
Packit 31ecd5
  G_OBJECT_CLASS (clutter_backend_gdk_parent_class)->finalize (gobject);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
clutter_backend_gdk_dispose (GObject *gobject)
Packit 31ecd5
{
Packit 31ecd5
  G_OBJECT_CLASS (clutter_backend_gdk_parent_class)->dispose (gobject);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static ClutterFeatureFlags
Packit 31ecd5
clutter_backend_gdk_get_features (ClutterBackend *backend)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendClass *parent_class;
Packit 31ecd5
Packit 31ecd5
  parent_class = CLUTTER_BACKEND_CLASS (clutter_backend_gdk_parent_class);
Packit 31ecd5
Packit 31ecd5
  return parent_class->get_features (backend)
Packit 31ecd5
        | CLUTTER_FEATURE_STAGE_USER_RESIZE
Packit 31ecd5
        | CLUTTER_FEATURE_STAGE_CURSOR;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static CoglRenderer *
Packit 31ecd5
clutter_backend_gdk_get_renderer (ClutterBackend  *backend,
Packit 31ecd5
                                  GError         **error)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendGdk *backend_gdk = CLUTTER_BACKEND_GDK (backend);
Packit 31ecd5
  CoglRenderer *renderer = cogl_renderer_new ();
Packit 31ecd5
Packit 31ecd5
#if defined(GDK_WINDOWING_X11) && defined(COGL_HAS_XLIB_SUPPORT)
Packit 31ecd5
  if (GDK_IS_X11_DISPLAY (backend_gdk->display))
Packit 31ecd5
    {
Packit 31ecd5
      Display *xdisplay = gdk_x11_display_get_xdisplay (backend_gdk->display);
Packit 31ecd5
Packit 31ecd5
      cogl_xlib_renderer_set_foreign_display (renderer, xdisplay);
Packit 31ecd5
    }
Packit 31ecd5
  else
Packit 31ecd5
#endif
Packit 31ecd5
#if defined(GDK_WINDOWING_WAYLAND) && defined(COGL_HAS_EGL_PLATFORM_WAYLAND_SUPPORT)
Packit 31ecd5
  if (GDK_IS_WAYLAND_DISPLAY (backend_gdk->display))
Packit 31ecd5
    {
Packit 31ecd5
      struct wl_display *display = gdk_wayland_display_get_wl_display (backend_gdk->display);
Packit 31ecd5
Packit 31ecd5
      /* Force a Wayland winsys */
Packit 31ecd5
      cogl_renderer_set_winsys_id (renderer, COGL_WINSYS_ID_EGL_WAYLAND);
Packit 31ecd5
      cogl_wayland_renderer_set_foreign_display (renderer, display);
Packit 31ecd5
      cogl_wayland_renderer_set_event_dispatch_enabled (renderer, !disable_event_retrieval);
Packit 31ecd5
    }
Packit 31ecd5
  else
Packit 31ecd5
#endif
Packit 31ecd5
#if defined(GDK_WINDOWING_WIN32)
Packit 31ecd5
  if (GDK_IS_WIN32_DISPLAY (backend_gdk->display))
Packit 31ecd5
    {
Packit 31ecd5
      /* Force a WGL winsys on windows */
Packit 31ecd5
      cogl_renderer_set_winsys_id (renderer, COGL_WINSYS_ID_WGL);
Packit 31ecd5
      cogl_win32_renderer_set_event_retrieval_enabled (renderer, FALSE);
Packit 31ecd5
    }
Packit 31ecd5
  else
Packit 31ecd5
#endif
Packit 31ecd5
    {
Packit 31ecd5
      g_set_error (error, CLUTTER_INIT_ERROR,
Packit 31ecd5
                   CLUTTER_INIT_ERROR_BACKEND,
Packit 31ecd5
                   _("Could not find a suitable CoglWinsys for a GdkDisplay of type %s"),
Packit 31ecd5
                   G_OBJECT_TYPE_NAME (backend_gdk->display));
Packit 31ecd5
      cogl_object_unref (renderer);
Packit 31ecd5
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  return renderer;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static CoglDisplay *
Packit 31ecd5
clutter_backend_gdk_get_display (ClutterBackend  *backend,
Packit 31ecd5
                                 CoglRenderer    *renderer,
Packit 31ecd5
                                 CoglSwapChain   *swap_chain,
Packit 31ecd5
                                 GError         **error)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackendGdk *backend_gdk = CLUTTER_BACKEND_GDK (backend);
Packit 31ecd5
  CoglOnscreenTemplate *onscreen_template;
Packit 31ecd5
  GError *internal_error = NULL;
Packit 31ecd5
  CoglDisplay *display;
Packit 31ecd5
  gboolean has_rgba_visual;
Packit 31ecd5
  gboolean res;
Packit 31ecd5
Packit 31ecd5
  /* We default to an RGBA visual if there is one */
Packit 31ecd5
  has_rgba_visual = gdk_screen_get_rgba_visual (backend_gdk->screen) != NULL;
Packit 31ecd5
Packit 31ecd5
  CLUTTER_NOTE (BACKEND, "Alpha on Cogl swap chain: %s",
Packit 31ecd5
                has_rgba_visual ? "enabled" : "disabled");
Packit 31ecd5
Packit 31ecd5
  cogl_swap_chain_set_has_alpha (swap_chain, has_rgba_visual);
Packit 31ecd5
Packit 31ecd5
  onscreen_template = cogl_onscreen_template_new (swap_chain);
Packit 31ecd5
Packit 31ecd5
  res = cogl_renderer_check_onscreen_template (renderer,
Packit 31ecd5
                                               onscreen_template,
Packit 31ecd5
                                               &internal_error);
Packit 31ecd5
  if (!res && has_rgba_visual)
Packit 31ecd5
    {
Packit 31ecd5
      CLUTTER_NOTE (BACKEND,
Packit 31ecd5
                    "Creation of a context with a ARGB visual failed: %s",
Packit 31ecd5
                    internal_error != NULL ? internal_error->message
Packit 31ecd5
                                           : "Unknown reason");
Packit 31ecd5
Packit 31ecd5
      g_clear_error (&internal_error);
Packit 31ecd5
Packit 31ecd5
      /* It's possible that the current renderer doesn't support transparency
Packit 31ecd5
       * in a swap_chain so lets see if we can fallback to not having any
Packit 31ecd5
       * transparency...
Packit 31ecd5
       *
Packit 31ecd5
       * XXX: It might be nice to have a CoglRenderer feature we could
Packit 31ecd5
       * explicitly check for ahead of time.
Packit 31ecd5
       */
Packit 31ecd5
      cogl_swap_chain_set_has_alpha (swap_chain, FALSE);
Packit 31ecd5
      res = cogl_renderer_check_onscreen_template (renderer,
Packit 31ecd5
                                                   onscreen_template,
Packit 31ecd5
                                                   &internal_error);
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  if (!res)
Packit 31ecd5
    {
Packit 31ecd5
      g_set_error_literal (error, CLUTTER_INIT_ERROR,
Packit 31ecd5
                           CLUTTER_INIT_ERROR_BACKEND,
Packit 31ecd5
                           internal_error->message);
Packit 31ecd5
Packit 31ecd5
      g_error_free (internal_error);
Packit 31ecd5
      cogl_object_unref (onscreen_template);
Packit 31ecd5
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  display = cogl_display_new (renderer, onscreen_template);
Packit 31ecd5
  cogl_object_unref (onscreen_template);
Packit 31ecd5
Packit 31ecd5
  return display;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
clutter_backend_gdk_class_init (ClutterBackendGdkClass *klass)
Packit 31ecd5
{
Packit 31ecd5
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
Packit 31ecd5
  ClutterBackendClass *backend_class = CLUTTER_BACKEND_CLASS (klass);
Packit 31ecd5
Packit 31ecd5
  gobject_class->dispose = clutter_backend_gdk_dispose;
Packit 31ecd5
  gobject_class->finalize = clutter_backend_gdk_finalize;
Packit 31ecd5
Packit 31ecd5
  backend_class->stage_window_type = CLUTTER_TYPE_STAGE_GDK;
Packit 31ecd5
Packit 31ecd5
  backend_class->post_parse = _clutter_backend_gdk_post_parse;
Packit 31ecd5
Packit 31ecd5
  backend_class->get_features = clutter_backend_gdk_get_features;
Packit 31ecd5
Packit 31ecd5
  backend_class->get_renderer = clutter_backend_gdk_get_renderer;
Packit 31ecd5
  backend_class->get_display = clutter_backend_gdk_get_display;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
static void
Packit 31ecd5
clutter_backend_gdk_init (ClutterBackendGdk *backend_gdk)
Packit 31ecd5
{
Packit 31ecd5
  /* Deactivate sync to vblank since we have the GdkFrameClock to
Packit 31ecd5
   * drive us from the compositor.
Packit 31ecd5
   */
Packit 31ecd5
  _clutter_set_sync_to_vblank (FALSE);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
ClutterBackend *
Packit 31ecd5
clutter_backend_gdk_new (void)
Packit 31ecd5
{
Packit 31ecd5
  return g_object_new (CLUTTER_TYPE_BACKEND_GDK, NULL);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
/**
Packit 31ecd5
 * clutter_gdk_get_default_display:
Packit 31ecd5
 *
Packit 31ecd5
 * Retrieves the pointer to the default display.
Packit 31ecd5
 *
Packit 31ecd5
 * Return value: (transfer none): the default display
Packit 31ecd5
 *
Packit 31ecd5
 * Since: 0.6
Packit 31ecd5
 */
Packit 31ecd5
GdkDisplay *
Packit 31ecd5
clutter_gdk_get_default_display (void)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackend *backend = clutter_get_default_backend ();
Packit 31ecd5
Packit 31ecd5
  if (backend == NULL)
Packit 31ecd5
    {
Packit 31ecd5
      g_critical ("The Clutter backend has not been initialised");
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  if (!CLUTTER_IS_BACKEND_GDK (backend))
Packit 31ecd5
    {
Packit 31ecd5
      g_critical ("The Clutter backend is not a GDK backend");
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  return CLUTTER_BACKEND_GDK (backend)->display;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
/**
Packit 31ecd5
 * clutter_gdk_set_display:
Packit 31ecd5
 * @display: pointer to a GDK display connection.
Packit 31ecd5
 *
Packit 31ecd5
 * Sets the display connection Clutter should use; must be called
Packit 31ecd5
 * before clutter_init(), clutter_init_with_args() or other functions
Packit 31ecd5
 * pertaining Clutter's initialization process.
Packit 31ecd5
 *
Packit 31ecd5
 * If you are parsing the command line arguments by retrieving Clutter's
Packit 31ecd5
 * #GOptionGroup with clutter_get_option_group() and calling
Packit 31ecd5
 * g_option_context_parse() yourself, you should also call
Packit 31ecd5
 * clutter_gdk_set_display() before g_option_context_parse().
Packit 31ecd5
 *
Packit 31ecd5
 * Since: 0.8
Packit 31ecd5
 */
Packit 31ecd5
void
Packit 31ecd5
clutter_gdk_set_display (GdkDisplay *display)
Packit 31ecd5
{
Packit 31ecd5
  if (_clutter_context_is_initialized ())
Packit 31ecd5
    {
Packit 31ecd5
      g_warning ("%s() can only be used before calling clutter_init()",
Packit 31ecd5
                 G_STRFUNC);
Packit 31ecd5
      return;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  _foreign_dpy = g_object_ref (display);
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
/**
Packit 31ecd5
 * clutter_gdk_disable_event_retrieval:
Packit 31ecd5
 *
Packit 31ecd5
 * Disable the event retrieval in Clutter.
Packit 31ecd5
 *
Packit 31ecd5
 * Callers of this function have to set up an event filter using the
Packit 31ecd5
 * GDK API, and call clutter_gdk_handle_event().
Packit 31ecd5
 *
Packit 31ecd5
 * This function should only be used when embedding Clutter into
Packit 31ecd5
 * a GDK based toolkit.
Packit 31ecd5
 *
Packit 31ecd5
 * Since: 1.10
Packit 31ecd5
 */
Packit 31ecd5
void
Packit 31ecd5
clutter_gdk_disable_event_retrieval (void)
Packit 31ecd5
{
Packit 31ecd5
  if (_clutter_context_is_initialized ())
Packit 31ecd5
    {
Packit 31ecd5
      g_warning ("%s() can only be used before calling clutter_init()",
Packit 31ecd5
                 G_STRFUNC);
Packit 31ecd5
      return;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  disable_event_retrieval = TRUE;
Packit 31ecd5
}
Packit 31ecd5
Packit 31ecd5
/**
Packit 31ecd5
 * clutter_gdk_get_visual:
Packit 31ecd5
 *
Packit 31ecd5
 * Retrieves the #GdkVisual used by Clutter.
Packit 31ecd5
 *
Packit 31ecd5
 * This function should be used when embedding Clutter inside GDK-based
Packit 31ecd5
 * foreign toolkits, to ensure that the visual applied to the #GdkWindow
Packit 31ecd5
 * used to render the #ClutterStage is the correct one.
Packit 31ecd5
 *
Packit 31ecd5
 * Returns: (transfer none): a #GdkVisual instance
Packit 31ecd5
 *
Packit 31ecd5
 * Since: 1.22
Packit 31ecd5
 */
Packit 31ecd5
GdkVisual *
Packit 31ecd5
clutter_gdk_get_visual (void)
Packit 31ecd5
{
Packit 31ecd5
  ClutterBackend *backend = clutter_get_default_backend ();
Packit 31ecd5
  GdkScreen *screen;
Packit 31ecd5
Packit 31ecd5
  if (backend == NULL)
Packit 31ecd5
    {
Packit 31ecd5
      g_critical ("The Clutter backend has not been initialised");
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  if (!CLUTTER_IS_BACKEND_GDK (backend))
Packit 31ecd5
    {
Packit 31ecd5
      g_critical ("The Clutter backend is not a GDK backend");
Packit 31ecd5
      return NULL;
Packit 31ecd5
    }
Packit 31ecd5
Packit 31ecd5
  screen = CLUTTER_BACKEND_GDK (backend)->screen;
Packit 31ecd5
  g_assert (screen != NULL);
Packit 31ecd5
Packit 31ecd5
#if defined(GDK_WINDOWING_X11) && defined(COGL_HAS_XLIB_SUPPORT)
Packit 31ecd5
  if (GDK_IS_X11_SCREEN (screen))
Packit 31ecd5
    {
Packit 31ecd5
      XVisualInfo *xvisinfo = cogl_xlib_renderer_get_visual_info (backend->cogl_renderer);
Packit 31ecd5
      if (xvisinfo != NULL)
Packit 31ecd5
        return gdk_x11_screen_lookup_visual (screen, xvisinfo->visualid);
Packit 31ecd5
    }
Packit 31ecd5
#endif
Packit 31ecd5
Packit 31ecd5
  if (gdk_screen_get_rgba_visual (screen) != NULL)
Packit 31ecd5
    return gdk_screen_get_rgba_visual (screen);
Packit 31ecd5
Packit 31ecd5
  return gdk_screen_get_system_visual (screen);
Packit 31ecd5
}