/* GdkPixbuf library - Image creation from in-memory buffers * * Copyright (C) 1999 The Free Software Foundation * * Author: Federico Mena-Quintero * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This 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 * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #include #include "gdk-pixbuf.h" #include "gdk-pixbuf-private.h" #include "gdk-pixbuf-i18n.h" #include #include /** * gdk_pixbuf_new_from_data: * @data: Image data in 8-bit/sample packed format. * @colorspace: Colorspace for the image data. * @has_alpha: Whether the data has an opacity channel. * @bits_per_sample: Number of bits per sample. * @width: Width of the image in pixels. * @height: Height of the image in pixels. * @rowstride: Distance in bytes between rows. * @destroy_fn: Function used to free the data when the pixbuf's reference count * drops to zero, or %NULL if the data should not be freed. * @destroy_fn_data: Closure data to pass to the destroy notification function. * * Creates a new #GdkPixbuf out of in-memory image data. Currently only RGB * images with 8 bits per sample are supported. * * Return value: A newly-created #GdkPixbuf structure with a reference count of * 1. **/ GdkPixbuf * gdk_pixbuf_new_from_data (const guchar *data, GdkColorspace colorspace, gboolean has_alpha, int bits_per_sample, int width, int height, int rowstride, GdkPixbufDestroyNotify destroy_fn, gpointer destroy_fn_data) { GdkPixbuf *pixbuf; /* Only 8-bit/sample RGB buffers are supported for now */ g_return_val_if_fail (data != NULL, NULL); g_return_val_if_fail (colorspace == GDK_COLORSPACE_RGB, NULL); g_return_val_if_fail (bits_per_sample == 8, NULL); g_return_val_if_fail (width > 0, NULL); g_return_val_if_fail (height > 0, NULL); pixbuf = g_object_new (GDK_TYPE_PIXBUF, NULL); pixbuf->colorspace = colorspace; pixbuf->n_channels = has_alpha ? 4 : 3; pixbuf->bits_per_sample = bits_per_sample; pixbuf->has_alpha = has_alpha ? TRUE : FALSE; pixbuf->width = width; pixbuf->height = height; pixbuf->rowstride = rowstride; pixbuf->pixels = (guchar *) data; pixbuf->destroy_fn = destroy_fn; pixbuf->destroy_fn_data = destroy_fn_data; return pixbuf; }