* Boston, MA 02111-1307, USA.
*/
-#include "gdkscreen.h"
+#include "config.h"
+#include "gdk.h" /* For gdk_rectangle_intersect() */
#include "gdkcolor.h"
+#include "gdkwindow.h"
+#include "gdkscreen.h"
+#include "gdkintl.h"
+
+
+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)
+{
+ GObjectClass *object_class = G_OBJECT_CLASS (klass);
+
+ 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));
-GType
-gdk_screen_get_type (void)
+ /**
+ * 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)
{
- static GType object_type = 0;
+ screen->resolution = -1.;
+}
- if (!object_type)
+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);
}
-/**
- * gdk_screen_get_default_colormap:
- * @screen: a #GdkScreen
- *
- * Gets the default colormap for @screen.
- *
- * Returns: the default #GdkColormap.
- **/
-GdkColormap *
-gdk_screen_get_default_colormap (GdkScreen *screen)
+static void
+gdk_screen_finalize (GObject *object)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_default_colormap (screen);
+ 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);
}
-/**
- * gdk_screen_set_default_colormap:
- * @screen: a #GdkScreen
- * @colormap: a #GdkColormap
- *
- * Sets the default @colormap for @screen.
- **/
-void
-gdk_screen_set_default_colormap (GdkScreen *screen,
- GdkColormap *colormap)
+void
+_gdk_screen_close (GdkScreen *screen)
{
g_return_if_fail (GDK_IS_SCREEN (screen));
- g_return_if_fail (GDK_IS_COLORMAP (colormap));
-
- GDK_SCREEN_GET_CLASS (screen)->set_default_colormap (screen, colormap);
+
+ if (!screen->closed)
+ {
+ screen->closed = TRUE;
+ g_object_run_dispose (G_OBJECT (screen));
+ }
}
-/**
- * gdk_screen_get_root_window:
- * @screen: a #GdkScreen
- *
- * Gets the root window of @screen.
- *
- * Returns: the root window
- **/
-GdkWindow *
-gdk_screen_get_root_window (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)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
+ 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);
- return GDK_SCREEN_GET_CLASS (screen)->get_root_window (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_display:
- * @screen: a #GdkScreen
+ * 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.
*
- * Gets the display to which the @screen belongs.
- *
- * Returns: the display to which @screen belongs
+ * Returns the monitor number in which the point (@x,@y) is located.
+ *
+ * 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
**/
-GdkDisplay *
-gdk_screen_get_display (GdkScreen *screen)
+gint
+gdk_screen_get_monitor_at_point (GdkScreen *screen,
+ gint x,
+ gint y)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
+ gint num_monitors, i;
+
+ g_return_val_if_fail (GDK_IS_SCREEN (screen), -1);
+
+ num_monitors = gdk_screen_get_n_monitors (screen);
- return GDK_SCREEN_GET_CLASS (screen)->get_display (screen);
+ for (i=0;i<num_monitors;i++)
+ {
+ GdkRectangle monitor;
+
+ gdk_screen_get_monitor_geometry (screen, i, &monitor);
+
+ if (x >= monitor.x &&
+ x < monitor.x + monitor.width &&
+ y >= monitor.y &&
+ y < (monitor.y + monitor.height))
+ return i;
+ }
+
+ return get_nearest_monitor (screen, x, y);
}
/**
- * gdk_screen_get_number:
- * @screen: a #GdkScreen
+ * gdk_screen_get_monitor_at_window:
+ * @screen: a #GdkScreen.
+ * @window: a #GdkWindow
+ * @returns: the monitor number in which most of @window is located,
+ * or if @window does not intersect any monitors, a monitor,
+ * close to @window.
*
- * Gets the index of @screen among the screens in the display
- * to which it belongs. (See gdk_screen_get_display())
- *
- * Returns: the index
+ * 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_number (GdkScreen *screen)
+gint
+gdk_screen_get_monitor_at_window (GdkScreen *screen,
+ GdkWindow *window)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 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);
+ num_monitors = gdk_screen_get_n_monitors (screen);
- return GDK_SCREEN_GET_CLASS (screen)->get_screen_num (screen);
+ for (i=0;i<num_monitors;i++)
+ {
+ GdkRectangle tmp_monitor, intersect;
+
+ gdk_screen_get_monitor_geometry (screen, i, &tmp_monitor);
+ gdk_rectangle_intersect (&win_rect, &tmp_monitor, &intersect);
+
+ if (intersect.width * intersect.height > area)
+ {
+ area = intersect.width * intersect.height;
+ screen_num = i;
+ }
+ }
+ 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);
}
/**
- * gdk_screen_get_window_at_pointer:
- * @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
+ * gdk_screen_width:
*
- * 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).
+ * Returns the width of the default screen in pixels.
*
- * Returns: the window under the mouse pointer, or %NULL
+ * Return value: the width of the default screen in pixels.
**/
-GdkWindow *
-gdk_screen_get_window_at_pointer (GdkScreen *screen,
- gint *win_x,
- gint *win_y)
+gint
+gdk_screen_width (void)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_window_at_pointer (screen, win_x, win_y);
+ return gdk_screen_get_width (gdk_screen_get_default ());
}
/**
- * gdk_screen_get_width:
- * @screen: a #GdkScreen
- *
- * Gets the width of @screen in pixels
+ * gdk_screen_height:
*
- * Returns: the width of @screen in pixels.
+ * Returns the height of the default screen in pixels.
+ *
+ * Return value: the height of the default screen in pixels.
**/
gint
-gdk_screen_get_width (GdkScreen *screen)
+gdk_screen_height (void)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 0);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_width (screen);
+ return gdk_screen_get_height (gdk_screen_get_default ());
}
/**
- * gdk_screen_get_height:
- * @screen: a #GdkScreen
- *
- * Gets the height of @screen in pixels
+ * gdk_screen_width_mm:
+ *
+ * Returns the width of the default screen in millimeters.
+ * Note that on many X servers this value will not be correct.
*
- * Returns: the height of @screen in pixels.
+ * Return value: the width of the default screen in millimeters,
+ * though it is not always correct.
**/
gint
-gdk_screen_get_height (GdkScreen *screen)
+gdk_screen_width_mm (void)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 0);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_height (screen);
+ return gdk_screen_get_width_mm (gdk_screen_get_default ());
}
/**
- * gdk_screen_get_width_mm:
- * @screen: a #GdkScreen
- *
- * Gets the width of @screen in millimeters.
- * Note that on some X servers this value will not be correct.
+ * gdk_screen_height_mm:
*
- * Returns: the width of @screen in pixels.
+ * Returns the height of the default screen in millimeters.
+ * Note that on many X servers this value will not be correct.
+ *
+ * Return value: the height of the default screen in millimeters,
+ * though it is not always correct.
**/
gint
-gdk_screen_get_width_mm (GdkScreen *screen)
+gdk_screen_height_mm (void)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 0);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_width_mm (screen);
+ return gdk_screen_get_height_mm (gdk_screen_get_default ());
}
/**
- * gdk_screen_get_height_mm:
+ * 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.
*
- * Returns the height of @screen in millimeters.
- * Note that on some X servers this value will not be correct.
- *
- * Returns: the heigth of @screen in pixels.
+ * 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
**/
-gint
-gdk_screen_get_height_mm (GdkScreen *screen)
+void
+gdk_screen_set_font_options (GdkScreen *screen,
+ const cairo_font_options_t *options)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 0);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_height_mm (screen);
+ 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_close:
+ * 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.
*
- * Closes the @screen connection and cleanup its resources.
- * Note that this function is called automatically by gdk_display_close().
+ * Since: 2.10
**/
-void
-gdk_screen_close (GdkScreen *screen)
+const cairo_font_options_t *
+gdk_screen_get_font_options (GdkScreen *screen)
{
- g_return_if_fail (GDK_IS_SCREEN (screen));
-
- g_object_run_dispose (G_OBJECT (screen));
+ g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
+
+ return screen->font_options;
}
/**
- * gdk_screen_get_n_monitors:
- * @screen : a #GdkScreen.
- *
- * Returns the number of monitors being part of the virtual screen
+ * 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).
*
- * Returns: number of monitors part of the virtual screen or
- * 0 if @screen is not in virtual screen mode.
+ * Since: 2.10
**/
-gint
-gdk_screen_get_n_monitors (GdkScreen *screen)
+void
+gdk_screen_set_resolution (GdkScreen *screen,
+ gdouble dpi)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), 0);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_n_monitors (screen);
+ 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_monitor_geometry:
- * @screen : a #GdkScreen.
- * @monitor_num: the monitor number.
- * @dest : a #GdkRectangle to be filled with the monitor geometry
- *
- * Retrieves the #GdkRectangle representing the size and start
- * coordinates of the individual monitor within the the entire virtual
- * screen.
+ * gdk_screen_get_resolution:
+ * @screen: a #GdkScreen
+ *
+ * Gets the resolution for font handling on the screen; see
+ * gdk_screen_set_resolution() for full details.
*
- * Note that the virtual screen coordinates can be retrieved via
- * gdk_screen_get_width() and gdk_screen_get_height().
+ * Return value: the current resolution, or -1 if no resolution
+ * has been set.
*
+ * Since: 2.10
**/
-void
-gdk_screen_get_monitor_geometry (GdkScreen *screen,
- gint monitor_num,
- GdkRectangle *dest)
+gdouble
+gdk_screen_get_resolution (GdkScreen *screen)
{
- g_return_if_fail (GDK_IS_SCREEN (screen));
-
- GDK_SCREEN_GET_CLASS (screen)->get_monitor_geometry (screen, monitor_num, dest);
+ g_return_val_if_fail (GDK_IS_SCREEN (screen), -1.0);
+
+ return screen->resolution;
}
-/**
- * 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.
- *
- * 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.
- **/
-gint
-gdk_screen_get_monitor_at_point (GdkScreen *screen,
- gint x,
- gint y)
+static void
+gdk_screen_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
{
- g_return_val_if_fail (GDK_IS_SCREEN (screen), -1);
-
- return GDK_SCREEN_GET_CLASS (screen)->get_monitor_at_point (screen, x,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;
+ }
}
-/**
- * gdk_screen_get_monitor_num_at_window:
- * @screen : a #GdkScreen.
- * @anid : a #GdkDrawable ID.
- *
- * Returns the monitor number in which the largest area of the bounding rectangle
- * of @anid resides.
- *
- * Returns: the monitor number in which most of @anid is located.
- **/
-gint
-gdk_screen_get_monitor_at_window (GdkScreen *screen,
- GdkWindow *window)
+static void
+gdk_screen_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
{
- gint num_monitors, i, sum = 0, screen_num = 0;
- 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);
- num_monitors = gdk_screen_get_n_monitors (screen);
-
- for (i=0;i<num_monitors;i++)
+ GdkScreen *screen = GDK_SCREEN (object);
+
+ switch (prop_id)
{
- GdkRectangle tmp_monitor, intersect;
-
- gdk_screen_get_monitor_geometry (screen, i, &tmp_monitor);
- gdk_rectangle_intersect (&win_rect, &tmp_monitor, &intersect);
-
- if (intersect.width * intersect.height > sum)
- {
- sum = intersect.width * intersect.height;
- screen_num = i;
- }
+ 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;
}
- return screen_num;
}