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
|
/* gnome-bg.h -
Copyright 2007, Red Hat, Inc.
This file is part of the Gnome Library.
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.
Author: Soren Sandmann <sandmann@redhat.com>
*/
#ifndef __GNOME_BG_H__
#define __GNOME_BG_H__
#ifndef GNOME_DESKTOP_USE_UNSTABLE_API
#error GnomeBG is unstable API. You must define GNOME_DESKTOP_USE_UNSTABLE_API before including gnome-bg.h
#endif
#include <gdk/gdk.h>
#include <cairo.h>
#include <gconf/gconf-client.h>
#include <libgnomeui/gnome-desktop-thumbnail.h>
#include <libgnomeui/gnome-bg-crossfade.h>
G_BEGIN_DECLS
#define GNOME_TYPE_BG (gnome_bg_get_type ())
#define GNOME_BG(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GNOME_TYPE_BG, GnomeBG))
#define GNOME_BG_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GNOME_TYPE_BG, GnomeBGClass))
#define GNOME_IS_BG(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GNOME_TYPE_BG))
#define GNOME_IS_BG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GNOME_TYPE_BG))
#define GNOME_BG_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GNOME_TYPE_BG, GnomeBGClass))
#define GNOME_BG_KEY_DIR "/desktop/gnome/background"
typedef struct _GnomeBG GnomeBG;
typedef struct _GnomeBGClass GnomeBGClass;
typedef enum {
GNOME_BG_COLOR_SOLID,
GNOME_BG_COLOR_H_GRADIENT,
GNOME_BG_COLOR_V_GRADIENT
} GnomeBGColorType;
typedef enum {
GNOME_BG_PLACEMENT_TILED,
GNOME_BG_PLACEMENT_ZOOMED,
GNOME_BG_PLACEMENT_CENTERED,
GNOME_BG_PLACEMENT_SCALED,
GNOME_BG_PLACEMENT_FILL_SCREEN,
GNOME_BG_PLACEMENT_SPANNED
} GnomeBGPlacement;
GType gnome_bg_get_type (void);
GnomeBG * gnome_bg_new (void);
void gnome_bg_load_from_preferences (GnomeBG *bg,
GConfClient *client);
void gnome_bg_save_to_preferences (GnomeBG *bg,
GConfClient *client);
/* Setters */
void gnome_bg_set_filename (GnomeBG *bg,
const char *filename);
void gnome_bg_set_placement (GnomeBG *bg,
GnomeBGPlacement placement);
void gnome_bg_set_color (GnomeBG *bg,
GnomeBGColorType type,
const GdkColor *primary,
const GdkColor *secondary);
/* Getters */
GnomeBGPlacement gnome_bg_get_placement (GnomeBG *bg);
void gnome_bg_get_color (GnomeBG *bg,
GnomeBGColorType *type,
GdkColor *primary,
GdkColor *secondary);
const gchar * gnome_bg_get_filename (GnomeBG *bg);
/* Drawing and thumbnailing */
void gnome_bg_draw (GnomeBG *bg,
GdkPixbuf *dest,
GdkScreen *screen,
gboolean is_root);
void gnome_bg_draw_cairo (GnomeBG *bg,
cairo_t *cr,
int width,
int height,
GdkScreen *screen,
gboolean is_root);
cairo_surface_t *gnome_bg_create_surface (GnomeBG *bg,
GdkWindow *window,
int width,
int height,
gboolean root);
gboolean gnome_bg_get_image_size (GnomeBG *bg,
GnomeDesktopThumbnailFactory *factory,
int best_width,
int best_height,
int *width,
int *height);
GdkPixbuf * gnome_bg_create_thumbnail (GnomeBG *bg,
GnomeDesktopThumbnailFactory *factory,
GdkScreen *screen,
int dest_width,
int dest_height);
gboolean gnome_bg_is_dark (GnomeBG *bg,
int dest_width,
int dest_height);
gboolean gnome_bg_has_multiple_sizes (GnomeBG *bg);
gboolean gnome_bg_changes_with_time (GnomeBG *bg);
GdkPixbuf * gnome_bg_create_frame_thumbnail (GnomeBG *bg,
GnomeDesktopThumbnailFactory *factory,
GdkScreen *screen,
int dest_width,
int dest_height,
int frame_num);
/* Set a surface as root - not a GnomeBG method. At some point
* if we decide to stabilize the API then we may want to make
* these object methods, drop gnome_bg_create_surface, etc.
*/
void gnome_bg_set_surface_as_root (GdkScreen *screen,
cairo_surface_t *surface);
GnomeBGCrossfade *gnome_bg_set_surface_as_root_with_crossfade (GdkScreen *screen,
cairo_surface_t *surface);
cairo_surface_t * gnome_bg_get_surface_from_root (GdkScreen *screen);
G_END_DECLS
#endif
|