updated version and copyright notice
[geeqie.git] / src / image.h
1 /*
2  * Geeqie
3  * (C) 2004 John Ellis
4  * Copyright (C) 2008 - 2012 The Geeqie Team
5  *
6  * Author: John Ellis
7  *
8  * This software is released under the GNU General Public License (GNU GPL).
9  * Please read the included file COPYING for more information.
10  * This software comes with no warranty of any kind, use at your own risk!
11  */
12
13
14 #ifndef IMAGE_H
15 #define IMAGE_H
16
17
18 void image_set_frame(ImageWindow *imd, gboolean frame);
19 ImageWindow *image_new(gboolean frame);
20
21 /* additional setup */
22 void image_attach_window(ImageWindow *imd, GtkWidget *window,
23                          const gchar *title, const gchar *title_right, gboolean show_zoom);
24 void image_set_update_func(ImageWindow *imd,
25                            void (*func)(ImageWindow *imd, gpointer data),
26                            gpointer data);
27 void image_set_button_func(ImageWindow *imd,
28         void (*func)(ImageWindow *, GdkEventButton *event, gpointer),
29         gpointer data);
30 void image_set_drag_func(ImageWindow *imd,
31         void (*func)(ImageWindow *, GdkEventButton *event, gdouble dx, gdouble dy, gpointer),
32         gpointer data);
33 void image_set_scroll_func(ImageWindow *imd,
34         void (*func)(ImageWindow *, GdkEventScroll *event, gpointer),
35         gpointer data);
36 void image_set_focus_in_func(ImageWindow *imd,
37         void (*func)(ImageWindow *, gpointer),
38         gpointer data);
39 void image_set_scroll_notify_func(ImageWindow *imd,
40                                   void (*func)(ImageWindow *imd, gint x, gint y, gint width, gint height, gpointer data),
41                                   gpointer data);
42 void image_set_complete_func(ImageWindow *imd,
43                              void (*func)(ImageWindow *imd, gint preload, gpointer data),
44                              gpointer data);
45 void image_set_state_func(ImageWindow *imd,
46                           void (*func)(ImageWindow *imd, ImageState state, gpointer data),
47                           gpointer data);
48
49 void image_select(ImageWindow *imd, gboolean select);
50 void image_set_selectable(ImageWindow *imd, gboolean selectable);
51
52 void image_grab_focus(ImageWindow *imd);
53 /* path, name */
54 const gchar *image_get_path(ImageWindow *imd);
55 const gchar *image_get_name(ImageWindow *imd);
56 FileData *image_get_fd(ImageWindow *imd);
57
58 /* merely changes path string, does not change the image! */
59 void image_set_fd(ImageWindow *imd, FileData *fd);
60
61 /* load a new image */
62 void image_change_fd(ImageWindow *imd, FileData *fd, gdouble zoom);
63 void image_change_pixbuf(ImageWindow *imd, GdkPixbuf *pixbuf, gdouble zoom, gboolean lazy);
64 void image_change_from_collection(ImageWindow *imd, CollectionData *cd, CollectInfo *info, gdouble zoom);
65 CollectionData *image_get_collection(ImageWindow *imd, CollectInfo **info);
66 void image_change_from_image(ImageWindow *imd, ImageWindow *source);
67
68 gboolean image_get_image_size(ImageWindow *imd, gint *width, gint *height);
69 GdkPixbuf *image_get_pixbuf(ImageWindow *imd);
70
71 /* manipulation */
72 void image_area_changed(ImageWindow *imd, gint x, gint y, gint width, gint height);
73 void image_reload(ImageWindow *imd);
74 void image_scroll(ImageWindow *imd, gint x, gint y);
75 void image_scroll_to_point(ImageWindow *imd, gint x, gint y,
76                            gdouble x_align, gdouble y_align);
77 void image_get_scroll_center(ImageWindow *imd, gdouble *x, gdouble *y);
78 void image_set_scroll_center(ImageWindow *imd, gdouble x, gdouble y);
79 void image_alter_orientation(ImageWindow *imd, AlterType type);
80 void image_set_desaturate(ImageWindow *imd, gboolean desaturate);
81 gboolean image_get_desaturate(ImageWindow *imd);
82
83 /* zoom */
84 void image_zoom_adjust(ImageWindow *imd, gdouble increment);
85 void image_zoom_adjust_at_point(ImageWindow *imd, gdouble increment, gint x, gint y);
86 void image_zoom_set_limits(ImageWindow *imd, gdouble min, gdouble max);
87 void image_zoom_set(ImageWindow *imd, gdouble zoom);
88 void image_zoom_set_fill_geometry(ImageWindow *imd, gboolean vertical);
89 gdouble image_zoom_get(ImageWindow *imd);
90 gdouble image_zoom_get_real(ImageWindow *imd);
91 gchar *image_zoom_get_as_text(ImageWindow *imd);
92 gdouble image_zoom_get_default(ImageWindow *imd);
93
94 /* stereo */
95 gint image_stereo_get(ImageWindow *imd);
96 void image_stereo_set(ImageWindow *imd, gint stereo_mode);
97 void image_stereo_swap(ImageWindow *imd);
98
99 StereoPixbufData image_stereo_pixbuf_get(ImageWindow *imd);
100 void image_stereo_pixbuf_set(ImageWindow *imd, StereoPixbufData stereo_mode);
101
102 /* read ahead, pass NULL to cancel */
103 void image_prebuffer_set(ImageWindow *imd, FileData *fd);
104
105 /* auto refresh */
106 void image_auto_refresh_enable(ImageWindow *imd, gboolean enable);
107
108 /* allow top window to be resized ? */
109 void image_top_window_set_sync(ImageWindow *imd, gboolean allow_sync);
110
111 /* background of image */
112 void image_background_set_color(ImageWindow *imd, GdkColor *color);
113 void image_background_set_color_from_options(ImageWindow *imd, gboolean fullscreen);
114
115 /* color profiles */
116 void image_color_profile_set(ImageWindow *imd,
117                              gint input_type,
118                              gboolean use_image);
119 gboolean image_color_profile_get(ImageWindow *imd,
120                              gint *input_type,
121                              gboolean *use_image);
122 void image_color_profile_set_use(ImageWindow *imd, gboolean enable);
123 gboolean image_color_profile_get_use(ImageWindow *imd);
124 gboolean image_color_profile_get_status(ImageWindow *imd, gchar **image_profile, gchar **screen_profile);
125
126 /* set delayed page flipping */
127 void image_set_delay_flip(ImageWindow *imd, gint delay);
128
129 /* wallpaper util */
130 void image_to_root_window(ImageWindow *imd, gboolean scaled);
131
132
133
134 void image_set_image_as_tiles(ImageWindow *imd, gint width, gint height,
135                               gint tile_width, gint tile_height, gint cache_size,
136                               ImageTileRequestFunc func_tile_request,
137                               ImageTileDisposeFunc func_tile_dispose,
138                               gpointer data,
139                               gdouble zoom);
140
141 /* reset default options */
142 void image_options_sync(void);
143
144
145 #endif
146 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */