/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */ /* nautilus-gdk-extensions.h: Graphics routines to augment what's in gdk. Copyright (C) 1999, 2000 Eazel, Inc. The Gnome 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. The Gnome 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 the Gnome Library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. Authors: Darin Adler , Ramiro Estrugo */ #ifndef NAUTILUS_GDK_EXTENSIONS_H #define NAUTILUS_GDK_EXTENSIONS_H #include #define NAUTILUS_RGB_COLOR_RED 0xFF0000 #define NAUTILUS_RGB_COLOR_GREEN 0x00FF00 #define NAUTILUS_RGB_COLOR_BLUE 0x0000FF #define NAUTILUS_RGB_COLOR_WHITE 0xFFFFFF #define NAUTILUS_RGB_COLOR_BLACK 0x000000 /* Pack RGBA values into a 32 bits */ #define NAUTILUS_RGBA_COLOR_PACK(_r, _g, _b, _a) \ ( ((_a) << 24) | \ ((_r) << 16) | \ ((_g) << 8) | \ ((_b) << 0) ) /* Access the individual RGBA components */ #define NAUTILUS_RGBA_COLOR_GET_R(_color) (((_color) >> 16) & 0xff) #define NAUTILUS_RGBA_COLOR_GET_G(_color) (((_color) >> 8) & 0xff) #define NAUTILUS_RGBA_COLOR_GET_B(_color) (((_color) >> 0) & 0xff) #define NAUTILUS_RGBA_COLOR_GET_A(_color) (((_color) >> 24) & 0xff) /* A gradient spec. is a string that contains a specifier for either a color or a gradient. If the string has a "-" in it, then it's a gradient. The gradient is vertical by default and the spec. can end with ":v" to indicate that. If the gradient ends with ":h", the gradient is horizontal. */ char * nautilus_gradient_new (const char *start_color, const char *end_color, gboolean is_horizontal); gboolean nautilus_gradient_is_gradient (const char *gradient_spec); char * nautilus_gradient_get_start_color_spec (const char *gradient_spec); char * nautilus_gradient_get_end_color_spec (const char *gradient_spec); gboolean nautilus_gradient_is_horizontal (const char *gradient_spec); char * nautilus_gradient_set_left_color_spec (const char *gradient_spec, const char *left_color); char * nautilus_gradient_set_top_color_spec (const char *gradient_spec, const char *top_color); char * nautilus_gradient_set_right_color_spec (const char *gradient_spec, const char *right_color); char * nautilus_gradient_set_bottom_color_spec (const char *gradient_spec, const char *bottom_color); /* A version of parse_color that substitutes a default color instead of returning a boolean to indicate it cannot be parsed. */ void nautilus_gdk_coolor_parse_with_default (const char *color_spec, const GdkColor *default_color, GdkColor *parsed_color); void nautilus_gdk_color_parse_with_white_default (const char *color_spec, GdkColor *parsed_color); guint32 nautilus_parse_rgb_with_default (const char *color_spec, guint32 default_rgb); guint32 nautilus_parse_rgb_with_white_default (const char *color_spec); guint32 nautilus_rgb_shift_color (guint32 color, float shift_by); guint32 nautilus_gdk_color_to_rgb (const GdkColor *color); GdkColor * nautilus_gdk_rgb_to_color (const guint32 color); /* Fill routines that take GdkRectangle parameters instead of four integers. */ void nautilus_fill_rectangle (GdkDrawable *drawable, GdkGC *gc, const GdkRectangle *rectangle); void nautilus_fill_rectangle_with_color (GdkDrawable *drawable, GdkGC *gc, const GdkRectangle *rectangle, guint32 rgb); void nautilus_fill_rectangle_with_gradient (GdkDrawable *drawable, GdkGC *gc, const GdkRectangle *rectangle, guint32 start_rgb, guint32 end_rgb, gboolean horizontal_gradient); /* A routine to get a 50% gray stippled bitmap for use in some types of highlighting. */ GdkBitmap *nautilus_stipple_bitmap (void); /* Misc GdkRectangle helper functions */ gboolean nautilus_rectangle_contains (const GdkRectangle *rectangle, int x, int y); void nautilus_rectangle_inset (GdkRectangle *rectangle, int x, int y); /* A basic operation we use for drawing gradients is interpolating two colors.*/ guint32 nautilus_interpolate_color (gdouble ratio, guint32 start_rgb, guint32 end_rgb); /* Misc GdkFont helper functions */ gboolean nautilus_gdk_font_equal (GdkFont *font_a_null_allowed, GdkFont *font_b_null_allowed); GdkFont * nautilus_get_largest_fitting_font (const char *text_to_format, int width, const char *font_format); GdkFont * nautilus_gdk_font_get_bold (const GdkFont *plain); /* Misc GdkWindow helper functions */ void nautilus_gdk_window_bring_to_front (GdkWindow *window); /* In GNOME 2.0 this function will be in the libraries */ void nautilus_set_mini_icon (GdkWindow *window, GdkPixmap *pixmap, GdkBitmap *mask); GdkGC * nautilus_gdk_create_copy_area_gc (GdkWindow *window); void nautilus_gdk_gc_ref_if_not_null (GdkGC *gc_or_null); void nautilus_gdk_gc_unref_if_not_null (GdkGC *gc_or_null); #endif /* NAUTILUS_GDK_EXTENSIONS_H */