summaryrefslogtreecommitdiff
path: root/libnautilus-extensions/nautilus-gdk-extensions.h
blob: 8dbd717aceab3749802677057a2a6e9f12dea937 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
/* -*- 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 <darin@eazel.com>,
            Ramiro Estrugo <ramiro@eazel.com>
*/

#ifndef NAUTILUS_GDK_EXTENSIONS_H
#define NAUTILUS_GDK_EXTENSIONS_H

#include <gdk/gdktypes.h>

#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

#define NAUTILUS_RGBA_COLOR_OPAQUE_RED		0xFFFF0000
#define NAUTILUS_RGBA_COLOR_OPAQUE_GREEN	0xFF00FF00
#define NAUTILUS_RGBA_COLOR_OPAQUE_BLUE		0xFF0000FF
#define NAUTILUS_RGBA_COLOR_OPAQUE_WHITE	0xFFFFFFFF
#define NAUTILUS_RGBA_COLOR_OPAQUE_BLACK	0xFF000000

/* 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)

/* Bits returned by nautilus_gdk_parse_geometry */
typedef enum {
	NAUTILUS_GDK_NO_VALUE     = 0x00,
	NAUTILUS_GDK_X_VALUE      = 0x01,
	NAUTILUS_GDK_Y_VALUE      = 0x02,
	NAUTILUS_GDK_WIDTH_VALUE  = 0x04,
	NAUTILUS_GDK_HEIGHT_VALUE = 0x08,
	NAUTILUS_GDK_ALL_VALUES   = 0x0f,
	NAUTILUS_GDK_X_NEGATIVE   = 0x10,
	NAUTILUS_GDK_Y_NEGATIVE   = 0x20,
} NautilusGdkGeometryFlags;

/* 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);
char *                   nautilus_gradient_parse_one_color_spec      (const char          *spec,
								      int                 *percent,
								      const char         **next_spec);
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_rgb16_to_rgb                       (gushort              r,
								      gushort              g,
								      gushort              b);
guint32                  nautilus_rgb8_to_rgb                        (guchar               r,
								      guchar               g,
								      guchar               b);
guint32                  nautilus_gdk_color_to_rgb                   (const GdkColor      *color);
GdkColor *               nautilus_gdk_rgb_to_color                   (const guint32        color);
char *                   nautilus_gdk_rgb_to_color_spec              (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);

gboolean		nautilus_gdk_color_is_dark		     (GdkColor		  *color);
void			nautilus_gdk_choose_foreground_color	     (GdkColor		  *preferred,
								      GdkColor		  *background);
void			nautilus_gdk_gc_choose_foreground_color	     (GdkGC		  *gc,
								      GdkColor		  *preferred,
								      GdkColor		  *background);

/* 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 GdkWindow helper functions */
void                     nautilus_gdk_window_bring_to_front          (GdkWindow           *window);
void                     nautilus_gdk_window_set_invisible_cursor    (GdkWindow           *window);
void			 nautilus_gdk_window_focus		     (GdkWindow          *window,
								      guint32		  timestamp);
void			 nautilus_gdk_window_set_wm_protocols	     (GdkWindow		 *window,
								      GdkAtom		 *protocols,
								      int		  nprotocols);


/* In GNOME 2.0 this function will be in the libraries */
void                     nautilus_set_mini_icon                      (GdkWindow           *window,
								      GdkPixmap           *pixmap,
								      GdkBitmap           *mask);
void                     nautilus_gdk_window_set_wm_hints_input      (GdkWindow           *w,
								      gboolean             status);

/* Wrapper for XParseGeometry */
NautilusGdkGeometryFlags nautilus_gdk_parse_geometry                 (const char          *string,
								      int                 *x_return,
								      int                 *y_return,
								      guint               *width_return,
								      guint               *height_return);

#endif /* NAUTILUS_GDK_EXTENSIONS_H */