f1a1399927
Add clutter_backend_get_n_screens(), which returns the number of screens manager by the ClutterBackend, and change clutter_backend_get_screen_number() to return the screen number of the currently used screen; this is semantically equivalent to clutter_glx_get_default_screen(), but leaves the door open for a "screen" abstraction in Clutter, handled by the backend. Update the GLX and EGL backends to retrieve and set the screen_num and n_screens members of ClutterBackend using Xlib calls.
428 lines
9.3 KiB
C
428 lines
9.3 KiB
C
/*
|
|
* Clutter.
|
|
*
|
|
* An OpenGL based 'interactive canvas' library.
|
|
*
|
|
* Authored By Matthew Allum <mallum@openedhand.com>
|
|
*
|
|
* Copyright (C) 2006 OpenedHand
|
|
*
|
|
* 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, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include "clutter-backend.h"
|
|
#include "clutter-private.h"
|
|
|
|
G_DEFINE_ABSTRACT_TYPE (ClutterBackend,
|
|
clutter_backend,
|
|
G_TYPE_OBJECT);
|
|
|
|
static void
|
|
clutter_backend_dispose (GObject *gobject)
|
|
{
|
|
ClutterBackend *backend = CLUTTER_BACKEND (gobject);
|
|
|
|
if (backend->events_queue)
|
|
{
|
|
g_queue_foreach (backend->events_queue, (GFunc) clutter_event_free, NULL);
|
|
g_queue_free (backend->events_queue);
|
|
backend->events_queue = NULL;
|
|
}
|
|
|
|
G_OBJECT_CLASS (clutter_backend_parent_class)->dispose (gobject);
|
|
}
|
|
|
|
static void
|
|
clutter_backend_class_init (ClutterBackendClass *klass)
|
|
{
|
|
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
|
|
|
|
gobject_class->dispose = clutter_backend_dispose;
|
|
}
|
|
|
|
static void
|
|
clutter_backend_init (ClutterBackend *backend)
|
|
{
|
|
|
|
}
|
|
|
|
ClutterActor *
|
|
_clutter_backend_get_stage (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), NULL);
|
|
|
|
return CLUTTER_BACKEND_GET_CLASS (backend)->get_stage (backend);
|
|
}
|
|
|
|
void
|
|
_clutter_backend_add_options (ClutterBackend *backend,
|
|
GOptionGroup *group)
|
|
{
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
|
|
CLUTTER_BACKEND_GET_CLASS (backend)->add_options (backend, group);
|
|
}
|
|
|
|
gboolean
|
|
_clutter_backend_pre_parse (ClutterBackend *backend,
|
|
GError **error)
|
|
{
|
|
ClutterBackendClass *klass;
|
|
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), FALSE);
|
|
|
|
klass = CLUTTER_BACKEND_GET_CLASS (backend);
|
|
if (klass->pre_parse)
|
|
return klass->pre_parse (backend, error);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
gboolean
|
|
_clutter_backend_post_parse (ClutterBackend *backend,
|
|
GError **error)
|
|
{
|
|
ClutterBackendClass *klass;
|
|
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), FALSE);
|
|
|
|
klass = CLUTTER_BACKEND_GET_CLASS (backend);
|
|
if (klass->post_parse)
|
|
return klass->post_parse (backend, error);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
gboolean
|
|
_clutter_backend_init_stage (ClutterBackend *backend,
|
|
GError **error)
|
|
{
|
|
ClutterBackendClass *klass;
|
|
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), FALSE);
|
|
|
|
klass = CLUTTER_BACKEND_GET_CLASS (backend);
|
|
if (klass->init_stage)
|
|
return klass->init_stage (backend, error);
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
void
|
|
_clutter_backend_init_events (ClutterBackend *backend)
|
|
{
|
|
ClutterBackendClass *klass;
|
|
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
|
|
klass = CLUTTER_BACKEND_GET_CLASS (backend);
|
|
if (klass->init_events)
|
|
klass->init_events (backend);
|
|
}
|
|
|
|
void
|
|
_clutter_backend_init_features (ClutterBackend *backend)
|
|
{
|
|
ClutterBackendClass *klass;
|
|
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
|
|
klass = CLUTTER_BACKEND_GET_CLASS (backend);
|
|
if (klass->init_features)
|
|
klass->init_features (backend);
|
|
}
|
|
|
|
/**
|
|
* clutter_get_default_backend:
|
|
*
|
|
* FIXME
|
|
*
|
|
* Return value: the default backend. You should not ref or
|
|
* unref the returned object
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
ClutterBackend *
|
|
clutter_get_default_backend (void)
|
|
{
|
|
ClutterMainContext *clutter_context;
|
|
|
|
clutter_context = clutter_context_get_default ();
|
|
|
|
return clutter_context->backend;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_event:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* FIXME
|
|
*
|
|
* Return value: the #ClutterEvent removed from the queue
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
ClutterEvent *
|
|
clutter_backend_get_event (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), NULL);
|
|
|
|
_clutter_events_queue (backend);
|
|
return _clutter_event_queue_pop (backend);
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_peek_event:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* FIXME
|
|
*
|
|
* Return value: a copy of the first #ClutterEvent in the queue
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
ClutterEvent *
|
|
clutter_backend_peek_event (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), NULL);
|
|
|
|
return _clutter_event_queue_peek (backend);
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_put_event:
|
|
* @backend: a #ClutterBackend
|
|
* @event: a #ClutterEvent
|
|
*
|
|
* FIXME
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
void
|
|
clutter_backend_put_event (ClutterBackend *backend,
|
|
ClutterEvent *event)
|
|
{
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
g_return_if_fail (event != NULL);
|
|
|
|
_clutter_event_queue_push (backend, clutter_event_copy (event));
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_width:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the width of the screen used by @backend in pixels.
|
|
*
|
|
* Return value: the width of the screen
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_width (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), -1);
|
|
|
|
return backend->res_width;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_height:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the height of the screen used by @backend in pixels.
|
|
*
|
|
* Return value: the height of the screen
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_height (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), -1);
|
|
|
|
return backend->res_height;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_width_mm:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the width of the screen used by @backend in millimiters.
|
|
*
|
|
* Return value: the width of the screen
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_width_mm (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), -1);
|
|
|
|
return backend->mm_width;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_height_mm:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the height of the screen used by @backend in millimiters.
|
|
*
|
|
* Return value: the height of the screen
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_height_mm (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), -1);
|
|
|
|
return backend->mm_height;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_screen_number:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the number of screens available for @backend.
|
|
*
|
|
* Return value: the number of screens.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_screen_number (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), -1);
|
|
|
|
return backend->screen_num;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_n_screens:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the number of screens managed by @backend.
|
|
*
|
|
* Return value: the number of screens
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gint
|
|
clutter_backend_get_n_screens (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), 0);
|
|
|
|
return backend->n_screens;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_resolution:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the resolution of the screen used by @backend.
|
|
*
|
|
* Return value: the resolution of the screen
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
gdouble
|
|
clutter_backend_get_resolution (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), 0.0);
|
|
|
|
return (((gdouble) backend->res_height * 25.4) /
|
|
(gdouble) backend->mm_height);
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_set_double_click_time:
|
|
* @backend: a #ClutterBackend
|
|
* @msec: milliseconds between two button press events
|
|
*
|
|
* Sets the maximum time between two button press events, used to
|
|
* verify whether it's a double click event or not.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
void
|
|
clutter_backend_set_double_click_time (ClutterBackend *backend,
|
|
guint msec)
|
|
{
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
|
|
backend->double_click_time = msec;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_double_click_time:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Gets the maximum time between two button press events, as set
|
|
* by clutter_backend_set_double_click_time().
|
|
*
|
|
* Return value: a time in milliseconds
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
guint
|
|
clutter_backend_get_double_click_time (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), 0);
|
|
|
|
return backend->double_click_time;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_set_double_click_distance:
|
|
* @backend: a #ClutterBackend
|
|
* @distance: a distance, in pixels
|
|
*
|
|
* Sets the maximum distance used to verify a double click event.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
void
|
|
clutter_backend_set_double_click_distance (ClutterBackend *backend,
|
|
guint distance)
|
|
{
|
|
g_return_if_fail (CLUTTER_IS_BACKEND (backend));
|
|
|
|
backend->double_click_distance = distance;
|
|
}
|
|
|
|
/**
|
|
* clutter_backend_get_double_click_distance:
|
|
* @backend: a #ClutterBackend
|
|
*
|
|
* Retrieves the distance used to verify a double click event
|
|
*
|
|
* Return value: a distance, in pixels.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
guint
|
|
clutter_backend_get_double_click_distance (ClutterBackend *backend)
|
|
{
|
|
g_return_val_if_fail (CLUTTER_IS_BACKEND (backend), 0);
|
|
|
|
return backend->double_click_distance;
|
|
}
|