diff options
Diffstat (limited to 'eel/eel-gdk-pixbuf-extensions.h')
| -rw-r--r-- | eel/eel-gdk-pixbuf-extensions.h | 162 |
1 files changed, 162 insertions, 0 deletions
diff --git a/eel/eel-gdk-pixbuf-extensions.h b/eel/eel-gdk-pixbuf-extensions.h new file mode 100644 index 00000000..cb66348c --- /dev/null +++ b/eel/eel-gdk-pixbuf-extensions.h @@ -0,0 +1,162 @@ +/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */ + +/* eel-gdk-pixbuf-extensions.h: Routines to augment what's in gdk-pixbuf. + + Copyright (C) 2000 Eazel, Inc. + + The Mate 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 Mate 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 Mate 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 <[email protected]> + Ramiro Estrugo <[email protected]> +*/ + +#ifndef EEL_GDK_PIXBUF_EXTENSIONS_H +#define EEL_GDK_PIXBUF_EXTENSIONS_H + +#include <eel/eel-art-extensions.h> +#include <gdk-pixbuf/gdk-pixbuf.h> +#include <gdk/gdk.h> +#include <gio/gio.h> + +#define EEL_STANDARD_ALPHA_THRESHHOLD 128 +#define EEL_OPACITY_FULLY_TRANSPARENT 0 +#define EEL_OPACITY_FULLY_OPAQUE 255 + +extern const EelIRect eel_gdk_pixbuf_whole_pixbuf; + +typedef struct EelPixbufLoadHandle EelPixbufLoadHandle; +typedef void (* EelPixbufLoadCallback) (GError *error, + GdkPixbuf *pixbuf, + gpointer callback_data); + +/* Convenience functions for lists of GdkPixbuf objects. */ +void eel_gdk_pixbuf_list_ref (GList *pixbuf_list); +void eel_gdk_pixbuf_list_unref (GList *pixbuf_list); +void eel_gdk_pixbuf_list_free (GList *pixbuf_list); + + +/* Loading a GdkPixbuf with a URI. */ +GdkPixbuf * eel_gdk_pixbuf_load (const char *uri); +GdkPixbuf * eel_gdk_pixbuf_load_from_stream (GInputStream *stream); +GdkPixbuf * eel_gdk_pixbuf_load_from_stream_at_size (GInputStream *stream, + int size); + + +/* Same thing async. */ +EelPixbufLoadHandle *eel_gdk_pixbuf_load_async (const char *uri, + int priority, + EelPixbufLoadCallback callback, + gpointer callback_data); +void eel_cancel_gdk_pixbuf_load (EelPixbufLoadHandle *handle); +GdkPixbuf * eel_gdk_pixbuf_scale_down_to_fit (GdkPixbuf *pixbuf, + int max_width, + int max_height); +GdkPixbuf * eel_gdk_pixbuf_scale_to_fit (GdkPixbuf *pixbuf, + int max_width, + int max_height); +double eel_gdk_scale_to_fit_factor (int width, + int height, + int max_width, + int max_height, + int *scaled_width, + int *scaled_height); +GdkPixbuf * eel_gdk_pixbuf_scale_to_min (GdkPixbuf *pixbuf, + int min_width, + int min_height); +double eel_gdk_scale_to_min_factor (int width, + int height, + int min_width, + int min_height, + int *scaled_width, + int *scaled_height); + +/* return average color values for each component (argb) */ +guint32 eel_gdk_pixbuf_average_value (GdkPixbuf *pixbuf); +void eel_gdk_pixbuf_fill_rectangle_with_color (GdkPixbuf *pixbuf, + EelIRect area, + guint32 color); + + +/* Save a pixbuf to a png file. Return value indicates succss/TRUE or failure/FALSE */ +gboolean eel_gdk_pixbuf_save_to_file (const GdkPixbuf *pixbuf, + const char *file_name); +void eel_gdk_pixbuf_ref_if_not_null (GdkPixbuf *pixbuf_or_null); +void eel_gdk_pixbuf_unref_if_not_null (GdkPixbuf *pixbuf_or_null); + + +/* Copy a pixbuf to an area of a GdkDrawable */ +void eel_gdk_pixbuf_draw_to_drawable (const GdkPixbuf *pixbuf, + GdkDrawable *drawable, + GdkGC *gc, + int source_x, + int source_y, + EelIRect destination_area, + GdkRgbDither dither, + GdkPixbufAlphaMode alpha_compositing_mode, + int alpha_threshold); + +/* Copy a pixbuf to an area of another pixbuf */ +void eel_gdk_pixbuf_draw_to_pixbuf (const GdkPixbuf *pixbuf, + GdkPixbuf *destination_pixbuf, + int source_x, + int source_y, + EelIRect destination_area); + + +/* Composite one pixbuf over another with the given opacity */ +void eel_gdk_pixbuf_draw_to_pixbuf_alpha (const GdkPixbuf *pixbuf, + GdkPixbuf *destination_pixbuf, + int source_x, + int source_y, + EelIRect destination_area, + int opacity, + GdkInterpType interpolation_mode); + + +/* Create a pixbuf from a sub area of another pixbuf */ +GdkPixbuf * eel_gdk_pixbuf_new_from_pixbuf_sub_area (GdkPixbuf *pixbuf, + EelIRect area); +/* Create a pixbuf from an existing buffer. */ +GdkPixbuf * eel_gdk_pixbuf_new_from_existing_buffer (guchar *buffer, + int buffer_rowstride, + gboolean buffer_has_alpha, + EelIRect area); + +/* Determine whether a pixbuf is valid or not */ +gboolean eel_gdk_pixbuf_is_valid (const GdkPixbuf *pixbuf); + +/* Access the dimensions of a pixbuf. */ +EelDimensions eel_gdk_pixbuf_get_dimensions (const GdkPixbuf *pixbuf); + +/* Return the intersection of the pixbuf with the given rectangle. */ +EelIRect eel_gdk_pixbuf_intersect (const GdkPixbuf *pixbuf, + int pixbuf_x, + int pixbuf_y, + EelIRect rectangle); + +/* Scales large pixbufs down fast */ +GdkPixbuf * eel_gdk_pixbuf_scale_down (GdkPixbuf *pixbuf, + int dest_width, + int dest_height); + +GdkPixbuf * eel_gdk_pixbuf_render (GdkPixbuf *pixbuf, + guint render_mode, + guint saturation, + guint brightness, + guint lighten_value, + guint color); + +#endif /* EEL_GDK_PIXBUF_EXTENSIONS_H */ |