]> Pileus Git - ~andy/gtk/blobdiff - gdk/gdkscreen.c
Typo
[~andy/gtk] / gdk / gdkscreen.c
index e822d6466fbd351590a61431dd98e5dfc8394889..4a6e11b65776c7ddb69dc2943c6b035b9801f809 100644 (file)
  * Boston, MA 02111-1307, USA.
  */
 
+#include "config.h"
 #include "gdk.h"               /* For gdk_rectangle_intersect() */
 #include "gdkcolor.h"
-#include "gdkinternals.h"
 #include "gdkwindow.h"
 #include "gdkscreen.h"
+#include "gdkintl.h"
+#include "gdkalias.h"
 
-GType
-gdk_screen_get_type (void)
+static void gdk_screen_dispose      (GObject        *object);
+static void gdk_screen_finalize     (GObject        *object);
+static void gdk_screen_set_property (GObject        *object,
+                                    guint           prop_id,
+                                    const GValue   *value,
+                                    GParamSpec     *pspec);
+static void gdk_screen_get_property (GObject        *object,
+                                    guint           prop_id,
+                                    GValue         *value,
+                                    GParamSpec     *pspec);
+
+enum
+{
+  PROP_0,
+  PROP_FONT_OPTIONS,
+  PROP_RESOLUTION
+};
+
+enum
+{
+  SIZE_CHANGED,
+  COMPOSITED_CHANGED,
+  MONITORS_CHANGED,
+  LAST_SIGNAL
+};
+
+static guint signals[LAST_SIGNAL] = { 0 };
+
+G_DEFINE_TYPE (GdkScreen, gdk_screen, G_TYPE_OBJECT)
+
+static void
+gdk_screen_class_init (GdkScreenClass *klass)
 {
-  static GType object_type = 0;
+  GObjectClass *object_class = G_OBJECT_CLASS (klass);
 
-  if (!object_type)
+  object_class->dispose = gdk_screen_dispose;
+  object_class->finalize = gdk_screen_finalize;
+  object_class->set_property = gdk_screen_set_property;
+  object_class->get_property = gdk_screen_get_property;
+  
+  g_object_class_install_property (object_class,
+                                  PROP_FONT_OPTIONS,
+                                  g_param_spec_pointer ("font-options",
+                                                        P_("Font options"),
+                                                        P_("The default font options for the screen"),
+                                                        G_PARAM_READWRITE|G_PARAM_STATIC_NAME|
+                                                       G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+  g_object_class_install_property (object_class,
+                                  PROP_RESOLUTION,
+                                  g_param_spec_double ("resolution",
+                                                       P_("Font resolution"),
+                                                       P_("The resolution for fonts on the screen"),
+                                                       -G_MAXDOUBLE,
+                                                       G_MAXDOUBLE,
+                                                       -1.0,
+                                                       G_PARAM_READWRITE|G_PARAM_STATIC_NAME|
+                                                       G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
+
+  /**
+   * GdkScreen::size-changed:
+   * @screen: the object on which the signal is emitted
+   * 
+   * The ::size-changed signal is emitted when the pixel width or 
+   * height of a screen changes.
+   *
+   * Since: 2.2
+   */
+  signals[SIZE_CHANGED] =
+    g_signal_new (g_intern_static_string ("size-changed"),
+                  G_OBJECT_CLASS_TYPE (klass),
+                  G_SIGNAL_RUN_LAST,
+                  G_STRUCT_OFFSET (GdkScreenClass, size_changed),
+                  NULL, NULL,
+                  g_cclosure_marshal_VOID__VOID,
+                  G_TYPE_NONE,
+                  0);
+
+  /**
+   * GdkScreen::composited-changed:
+   * @screen: the object on which the signal is emitted
+   *
+   * The ::composited-changed signal is emitted when the composited
+   * status of the screen changes
+   *
+   * Since: 2.10
+   */
+  signals[COMPOSITED_CHANGED] =
+    g_signal_new (g_intern_static_string ("composited-changed"),
+                 G_OBJECT_CLASS_TYPE (klass),
+                 G_SIGNAL_RUN_LAST,
+                 G_STRUCT_OFFSET (GdkScreenClass, composited_changed),
+                 NULL, NULL,
+                 g_cclosure_marshal_VOID__VOID,
+                 G_TYPE_NONE,
+                 0);
+       
+  /**
+   * GdkScreen::monitors-changed:
+   * @screen: the object on which the signal is emitted
+   *
+   * The ::monitors-changed signal is emitted when the number, size
+   * or position of the monitors attached to the screen change. 
+   *
+   * Only for X11 and OS X for now. A future implementation for Win32
+   * may be a possibility.
+   *
+   * Since: 2.14
+   */
+  signals[MONITORS_CHANGED] =
+    g_signal_new (g_intern_static_string ("monitors-changed"),
+                 G_OBJECT_CLASS_TYPE (klass),
+                 G_SIGNAL_RUN_LAST,
+                 G_STRUCT_OFFSET (GdkScreenClass, monitors_changed),
+                 NULL, NULL,
+                 g_cclosure_marshal_VOID__VOID,
+                 G_TYPE_NONE,
+                 0);
+}
+
+static void
+gdk_screen_init (GdkScreen *screen)
+{
+  screen->resolution = -1.;
+}
+
+static void
+gdk_screen_dispose (GObject *object)
+{
+  GdkScreen *screen = GDK_SCREEN (object);
+  gint i;
+
+  for (i = 0; i < 32; ++i)
     {
-      static const GTypeInfo object_info =
-       {
-         sizeof (GdkScreenClass),
-         (GBaseInitFunc) NULL,
-         (GBaseFinalizeFunc) NULL,
-         NULL,                 /* class_init */
-         NULL,                 /* class_finalize */
-         NULL,                 /* class_data */
-         sizeof (GdkScreen),
-         0,                    /* n_preallocs */
-         (GInstanceInitFunc) NULL,
-       };
-      
-      object_type = g_type_register_static (G_TYPE_OBJECT,
-                                           "GdkScreen", &object_info, 0);
+      if (screen->exposure_gcs[i])
+        {
+          g_object_unref (screen->exposure_gcs[i]);
+          screen->exposure_gcs[i] = NULL;
+        }
+
+      if (screen->normal_gcs[i])
+        {
+          g_object_unref (screen->normal_gcs[i]);
+          screen->normal_gcs[i] = NULL;
+        }
     }
 
-  return object_type;
+  G_OBJECT_CLASS (gdk_screen_parent_class)->dispose (object);
+}
+
+static void
+gdk_screen_finalize (GObject *object)
+{
+  GdkScreen *screen = GDK_SCREEN (object);
+
+  if (screen->font_options)
+      cairo_font_options_destroy (screen->font_options);
+
+  G_OBJECT_CLASS (gdk_screen_parent_class)->finalize (object);
 }
 
 void 
@@ -66,16 +202,66 @@ _gdk_screen_close (GdkScreen *screen)
     }
 }
 
+/* Fallback used when the monitor "at" a point or window
+ * doesn't exist.
+ */
+static gint
+get_nearest_monitor (GdkScreen *screen,
+                    gint       x,
+                    gint       y)
+{
+  gint num_monitors, i;
+  gint nearest_dist = G_MAXINT;
+  gint nearest_monitor = 0;
+
+  g_return_val_if_fail (GDK_IS_SCREEN (screen), -1);
+
+  num_monitors = gdk_screen_get_n_monitors (screen);
+  
+  for (i = 0; i < num_monitors; i++)
+    {
+      GdkRectangle monitor;
+      gint dist_x, dist_y, dist;
+      
+      gdk_screen_get_monitor_geometry (screen, i, &monitor);
+
+      if (x < monitor.x)
+       dist_x = monitor.x - x;
+      else if (x >= monitor.x + monitor.width)
+       dist_x = x - (monitor.x + monitor.width) + 1;
+      else
+       dist_x = 0;
+
+      if (y < monitor.y)
+       dist_y = monitor.y - y;
+      else if (y >= monitor.y + monitor.height)
+       dist_y = y - (monitor.y + monitor.height) + 1;
+      else
+       dist_y = 0;
+
+      dist = dist_x + dist_y;
+      if (dist < nearest_dist)
+       {
+         nearest_dist = dist;
+         nearest_monitor = i;
+       }
+    }
+
+  return nearest_monitor;
+}
+
 /**
  * gdk_screen_get_monitor_at_point:
- * @screen : a #GdkScreen.
- * @x : the x coordinate in the virtual screen.
- * @y : the y coordinate in the virtual screen.
+ * @screen: a #GdkScreen.
+ * @x: the x coordinate in the virtual screen.
+ * @y: the y coordinate in the virtual screen.
  *
  * Returns the monitor number in which the point (@x,@y) is located.
  *
- * Returns: the monitor number in which the point (@x,@y) belong, or
- *   -1 if the point is not in any monitor.
+ * Returns: the monitor number in which the point (@x,@y) lies, or
+ *   a monitor close to (@x,@y) if the point is not in any monitor.
+ *
+ * Since: 2.2
  **/
 gint 
 gdk_screen_get_monitor_at_point (GdkScreen *screen,
@@ -101,26 +287,31 @@ gdk_screen_get_monitor_at_point (GdkScreen *screen,
         return i;
     }
 
-  return -1;
+  return get_nearest_monitor (screen, x, y);
 }
 
 /**
  * gdk_screen_get_monitor_at_window:
  * @screen: a #GdkScreen.
  * @window: a #GdkWindow
- * @returns: the monitor number in which most of @window is located.
+ * @returns: the monitor number in which most of @window is located,
+ *           or if @window does not intersect any monitors, a monitor,
+ *           close to @window.
+ *
+ * Returns the number of the monitor in which the largest area of the 
+ * bounding rectangle of @window resides.
  *
- * Returns the number of the monitor in which the largest area of the bounding rectangle
- * of @window resides. 
+ * Since: 2.2
  **/
 gint 
 gdk_screen_get_monitor_at_window (GdkScreen      *screen,
                                  GdkWindow      *window)
 {
-  gint num_monitors, i, sum = 0, screen_num = 0;
+  gint num_monitors, i, area = 0, screen_num = -1;
   GdkRectangle win_rect;
+
   g_return_val_if_fail (GDK_IS_SCREEN (screen), -1);
-  
+
   gdk_window_get_geometry (window, &win_rect.x, &win_rect.y, &win_rect.width,
                           &win_rect.height, NULL);
   gdk_window_get_origin (window, &win_rect.x, &win_rect.y);
@@ -133,13 +324,18 @@ gdk_screen_get_monitor_at_window (GdkScreen      *screen,
       gdk_screen_get_monitor_geometry (screen, i, &tmp_monitor);
       gdk_rectangle_intersect (&win_rect, &tmp_monitor, &intersect);
       
-      if (intersect.width * intersect.height > sum)
+      if (intersect.width * intersect.height > area)
        { 
-         sum = intersect.width * intersect.height;
+         area = intersect.width * intersect.height;
          screen_num = i;
        }
     }
-  return screen_num;
+  if (screen_num >= 0)
+    return screen_num;
+  else
+    return get_nearest_monitor (screen,
+                               win_rect.x + win_rect.width / 2,
+                               win_rect.y + win_rect.height / 2);
 }
 
 /**
@@ -147,12 +343,12 @@ gdk_screen_get_monitor_at_window (GdkScreen      *screen,
  * 
  * Returns the width of the default screen in pixels.
  * 
- * Return value:  the width of the default screen in pixels.
+ * Return value: the width of the default screen in pixels.
  **/
 gint
 gdk_screen_width (void)
 {
-  return gdk_screen_get_width (gdk_screen_get_default());
+  return gdk_screen_get_width (gdk_screen_get_default ());
 }
 
 /**
@@ -165,7 +361,7 @@ gdk_screen_width (void)
 gint
 gdk_screen_height (void)
 {
-  return gdk_screen_get_height (gdk_screen_get_default());
+  return gdk_screen_get_height (gdk_screen_get_default ());
 }
 
 /**
@@ -180,7 +376,7 @@ gdk_screen_height (void)
 gint
 gdk_screen_width_mm (void)
 {
-  return gdk_screen_get_width_mm (gdk_screen_get_default());
+  return gdk_screen_get_width_mm (gdk_screen_get_default ());
 }
 
 /**
@@ -199,22 +395,151 @@ gdk_screen_height_mm (void)
 }
 
 /**
- * gdk_screen_get_window_at_pointer:
+ * gdk_screen_set_font_options:
+ * @screen: a #GdkScreen
+ * @options: (allow-none): a #cairo_font_options_t, or %NULL to unset any
+ *   previously set default font options.
+ *
+ * Sets the default font options for the screen. These
+ * options will be set on any #PangoContext's newly created
+ * with gdk_pango_context_get_for_screen(). Changing the
+ * default set of font options does not affect contexts that
+ * have already been created.
+ *
+ * Since: 2.10
+ **/
+void
+gdk_screen_set_font_options (GdkScreen                  *screen,
+                            const cairo_font_options_t *options)
+{
+  g_return_if_fail (GDK_IS_SCREEN (screen));
+
+  if (screen->font_options != options)
+    {
+      if (screen->font_options)
+        cairo_font_options_destroy (screen->font_options);
+
+      if (options)
+        screen->font_options = cairo_font_options_copy (options);
+      else
+        screen->font_options = NULL;
+
+      g_object_notify (G_OBJECT (screen), "font-options");
+    }
+}
+
+/**
+ * gdk_screen_get_font_options:
+ * @screen: a #GdkScreen
+ * 
+ * Gets any options previously set with gdk_screen_set_font_options().
+ * 
+ * Return value: the current font options, or %NULL if no default
+ *  font options have been set.
+ *
+ * Since: 2.10
+ **/
+const cairo_font_options_t *
+gdk_screen_get_font_options (GdkScreen *screen)
+{
+  g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
+
+  return screen->font_options;
+}
+
+/**
+ * gdk_screen_set_resolution:
+ * @screen: a #GdkScreen
+ * @dpi: the resolution in "dots per inch". (Physical inches aren't actually
+ *   involved; the terminology is conventional.)
+ * Sets the resolution for font handling on the screen. This is a
+ * scale factor between points specified in a #PangoFontDescription
+ * and cairo units. The default value is 96, meaning that a 10 point
+ * font will be 13 units high. (10 * 96. / 72. = 13.3).
+ *
+ * Since: 2.10
+ **/
+void
+gdk_screen_set_resolution (GdkScreen *screen,
+                          gdouble    dpi)
+{
+  g_return_if_fail (GDK_IS_SCREEN (screen));
+
+  if (dpi < 0)
+    dpi = -1.0;
+
+  if (screen->resolution != dpi)
+    {
+      screen->resolution = dpi;
+
+      g_object_notify (G_OBJECT (screen), "resolution");
+    }
+}
+
+/**
+ * gdk_screen_get_resolution:
  * @screen: a #GdkScreen
- * @win_x: return location for origin of the window under the pointer
- * @win_y: return location for origin of the window under the pointer
  * 
- * Obtains the window underneath the mouse pointer, returning the location
- * of that window in @win_x, @win_y for @screen. Returns %NULL if the window 
- * under the mouse pointer is not known to GDK (for example, belongs to
- * another application).
+ * Gets the resolution for font handling on the screen; see
+ * gdk_screen_set_resolution() for full details.
  * 
- * Returns: the window under the mouse pointer, or %NULL
+ * Return value: the current resolution, or -1 if no resolution
+ * has been set.
+ *
+ * Since: 2.10
  **/
-GdkWindow *
-gdk_screen_get_window_at_pointer (GdkScreen *screen,
-                                 gint      *win_x,
-                                 gint      *win_y)
+gdouble
+gdk_screen_get_resolution (GdkScreen *screen)
+{
+  g_return_val_if_fail (GDK_IS_SCREEN (screen), -1.0);
+
+  return screen->resolution;
+}
+
+static void
+gdk_screen_get_property (GObject      *object,
+                        guint         prop_id,
+                        GValue       *value,
+                        GParamSpec   *pspec)
 {
-  return _gdk_current_pointer_hooks->window_at_pointer (screen, win_x, win_y);
+  GdkScreen *screen = GDK_SCREEN (object);
+
+  switch (prop_id)
+    {
+    case PROP_FONT_OPTIONS:
+      g_value_set_pointer (value, (gpointer) gdk_screen_get_font_options (screen));
+      break;
+    case PROP_RESOLUTION:
+      g_value_set_double (value, gdk_screen_get_resolution (screen));
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+    }
 }
+
+static void
+gdk_screen_set_property (GObject      *object,
+                        guint         prop_id,
+                        const GValue *value,
+                        GParamSpec   *pspec)
+{
+  GdkScreen *screen = GDK_SCREEN (object);
+
+  switch (prop_id)
+    {
+    case PROP_FONT_OPTIONS:
+      gdk_screen_set_font_options (screen, g_value_get_pointer (value));
+      break;
+    case PROP_RESOLUTION:
+      gdk_screen_set_resolution (screen, g_value_get_double (value));
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+      break;
+    }
+}
+
+#define __GDK_SCREEN_C__
+#include "gdkaliasdef.c"