/* * gdkscreen.c * * Copyright 2001 Sun Microsystems Inc. * * Erwann Chenede * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library 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. */ #include "gdkscreen.h" #include "gdkcolor.h" GType gdk_screen_get_type (void) { static GType object_type = 0; if (!object_type) { 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); } return object_type; } /** * 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) { g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL); return GDK_SCREEN_GET_CLASS (screen)->get_default_colormap (screen); } /** * 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) { 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); } /** * 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) { g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL); return GDK_SCREEN_GET_CLASS (screen)->get_root_window (screen); } /** * gdk_screen_get_display: * @screen: a #GdkScreen * * Gets the display to which the @screen belongs. * * Returns: the display to which @screen belongs **/ GdkDisplay * gdk_screen_get_display (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL); return GDK_SCREEN_GET_CLASS (screen)->get_display (screen); } /** * gdk_screen_get_number: * @screen: a #GdkScreen * * Gets the index of @screen among the screens in the display * to which it belongs. (See gdk_screen_get_display()) * * Returns: the index **/ gint gdk_screen_get_number (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_screen_num (screen); } /** * 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 * * 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 window under the mouse pointer, or %NULL **/ GdkWindow * gdk_screen_get_window_at_pointer (GdkScreen *screen, gint *win_x, gint *win_y) { 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); } /** * gdk_screen_get_width: * @screen: a #GdkScreen * * Gets the width of @screen in pixels * * Returns: the width of @screen in pixels. **/ gint gdk_screen_get_width (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_width (screen); } /** * gdk_screen_get_height: * @screen: a #GdkScreen * * Gets the height of @screen in pixels * * Returns: the height of @screen in pixels. **/ gint gdk_screen_get_height (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_height (screen); } /** * 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. * * Returns: the width of @screen in pixels. **/ gint gdk_screen_get_width_mm (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_width_mm (screen); } /** * gdk_screen_get_height_mm: * @screen: a #GdkScreen * * 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. **/ gint gdk_screen_get_height_mm (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_height_mm (screen); } /** * gdk_screen_close: * @screen: a #GdkScreen * * Closes the @screen connection and cleanup its resources. * Note that this function is called automatically by gdk_display_close(). **/ void gdk_screen_close (GdkScreen *screen) { g_return_if_fail (GDK_IS_SCREEN (screen)); g_object_run_dispose (G_OBJECT (screen)); } /** * gdk_screen_get_n_monitors: * @screen : a #GdkScreen. * * Returns the number of monitors being part of the virtual screen * * Returns: number of monitors part of the virtual screen or * 0 if @screen is not in virtual screen mode. **/ gint gdk_screen_get_n_monitors (GdkScreen *screen) { g_return_val_if_fail (GDK_IS_SCREEN (screen), 0); return GDK_SCREEN_GET_CLASS (screen)->get_n_monitors (screen); } /** * 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. * * Note that the virtual screen coordinates can be retrieved via * gdk_screen_get_width() and gdk_screen_get_height(). * **/ void gdk_screen_get_monitor_geometry (GdkScreen *screen, gint monitor_num, GdkRectangle *dest) { g_return_if_fail (GDK_IS_SCREEN (screen)); GDK_SCREEN_GET_CLASS (screen)->get_monitor_geometry (screen, monitor_num, dest); } /** * 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) { gint num_monitors, i; g_return_val_if_fail (GDK_IS_SCREEN (screen), -1); num_monitors = gdk_screen_get_n_monitors (screen); for (i=0;i= monitor.x && x < monitor.x + monitor.width && y >= monitor.y && y < (monitor.y + monitor.height)) return i; } return -1; } /** * 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 number of the monitor in which the largest area of the bounding rectangle * of @window resides. **/ gint gdk_screen_get_monitor_at_window (GdkScreen *screen, GdkWindow *window) { 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 sum) { sum = intersect.width * intersect.height; screen_num = i; } } return screen_num; }