summaryrefslogtreecommitdiff
path: root/libnautilus-extensions/nautilus-gdk-extensions.h
blob: 594f740fd59226b37bd319de0a7f2fabf155173e (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
/* -*- 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>
*/

#ifndef NAUTILUS_GDK_EXTENSIONS_H
#define NAUTILUS_GDK_EXTENSIONS_H

#include <gdk/gdktypes.h>

/* 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_color_parse_with_default       (const char         *color_spec,
						      const GdkColor     *default_color,
						      GdkColor           *color);
void     nautilus_gdk_color_parse_with_white_default (const char         *color_spec,
						      GdkColor           *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,
						      const GdkColor     *color);
void     nautilus_fill_rectangle_with_gradient       (GdkDrawable        *drawable,
						      GdkGC              *gc,
						      GdkColormap        *colormap,
						      const GdkRectangle *rectangle,
						      const GdkColor     *start_color,
						      const GdkColor     *end_color,
						      gboolean            horizontal_gradient);

/* A basic operation we use for drawing gradients is interpolating two colors.*/
void     nautilus_interpolate_color                  (gdouble             ratio,
						      const GdkColor     *start_color,
						      const GdkColor     *end_color,
						      GdkColor           *interpolated_color);

gboolean nautilus_gdk_font_equal                     (GdkFont            *font_a_null_allowed,
						      GdkFont            *font_b_null_allowed);

/* Convenience functions for lists of GdkPixbuf objects. */
void     nautilus_gdk_pixbuf_list_ref                (GList              *pixbuf_list);
void     nautilus_gdk_pixbuf_list_unref              (GList              *pixbuf_list);
void     nautilus_gdk_pixbuf_list_free               (GList              *pixbuf_list);

#endif /* NAUTILUS_GDK_EXTENSIONS_H */