You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
286 lines
8.9 KiB
286 lines
8.9 KiB
/* Libart_LGPL - library of basic graphic primitives
|
|
* Copyright (C) 1998 Raph Levien
|
|
*
|
|
* This 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.
|
|
*
|
|
* 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library 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 "config.h"
|
|
#include "art_pixbuf.h"
|
|
|
|
#include "art_misc.h"
|
|
#include <string.h>
|
|
|
|
/**
|
|
* art_pixbuf_new_rgb_dnotify: Create a new RGB #ArtPixBuf with explicit destroy notification.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
* @dfunc_data: The private data passed to @dfunc.
|
|
* @dfunc: The destroy notification function.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGB
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* @dfunc is called with @dfunc_data and @pixels as arguments when the
|
|
* #ArtPixBuf is destroyed. Using a destroy notification function
|
|
* allows a wide range of memory management disciplines for the pixel
|
|
* memory. A NULL value for @dfunc is also allowed and means that no
|
|
* special action will be taken on destruction.
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_rgb_dnotify (art_u8 *pixels, int width, int height, int rowstride,
|
|
void *dfunc_data, ArtDestroyNotify dfunc)
|
|
{
|
|
ArtPixBuf *pixbuf;
|
|
|
|
pixbuf = art_new (ArtPixBuf, 1);
|
|
|
|
pixbuf->format = ART_PIX_RGB;
|
|
pixbuf->n_channels = 3;
|
|
pixbuf->has_alpha = 0;
|
|
pixbuf->bits_per_sample = 8;
|
|
|
|
pixbuf->pixels = (art_u8 *) pixels;
|
|
pixbuf->width = width;
|
|
pixbuf->height = height;
|
|
pixbuf->rowstride = rowstride;
|
|
pixbuf->destroy_data = dfunc_data;
|
|
pixbuf->destroy = dfunc;
|
|
|
|
return pixbuf;
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_new_rgba_dnotify: Create a new RGBA #ArtPixBuf with explicit destroy notification.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
* @dfunc_data: The private data passed to @dfunc.
|
|
* @dfunc: The destroy notification function.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGBA
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* @dfunc is called with @dfunc_data and @pixels as arguments when the
|
|
* #ArtPixBuf is destroyed. Using a destroy notification function
|
|
* allows a wide range of memory management disciplines for the pixel
|
|
* memory. A NULL value for @dfunc is also allowed and means that no
|
|
* special action will be taken on destruction.
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_rgba_dnotify (art_u8 *pixels, int width, int height, int rowstride,
|
|
void *dfunc_data, ArtDestroyNotify dfunc)
|
|
{
|
|
ArtPixBuf *pixbuf;
|
|
|
|
pixbuf = art_new (ArtPixBuf, 1);
|
|
|
|
pixbuf->format = ART_PIX_RGB;
|
|
pixbuf->n_channels = 4;
|
|
pixbuf->has_alpha = 1;
|
|
pixbuf->bits_per_sample = 8;
|
|
|
|
pixbuf->pixels = (art_u8 *) pixels;
|
|
pixbuf->width = width;
|
|
pixbuf->height = height;
|
|
pixbuf->rowstride = rowstride;
|
|
pixbuf->destroy_data = dfunc_data;
|
|
pixbuf->destroy = dfunc;
|
|
|
|
return pixbuf;
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_new_const_rgb: Create a new RGB #ArtPixBuf with constant pixel data.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGB
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* No action is taken when the #ArtPixBuf is destroyed. Thus, this
|
|
* function is useful when the pixel data is constant or statically
|
|
* allocated.
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_const_rgb (const art_u8 *pixels, int width, int height, int rowstride)
|
|
{
|
|
return art_pixbuf_new_rgb_dnotify ((art_u8 *) pixels, width, height, rowstride, NULL, NULL);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_new_const_rgba: Create a new RGBA #ArtPixBuf with constant pixel data.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGBA
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* No action is taken when the #ArtPixBuf is destroyed. Thus, this
|
|
* function is suitable when the pixel data is constant or statically
|
|
* allocated.
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_const_rgba (const art_u8 *pixels, int width, int height, int rowstride)
|
|
{
|
|
return art_pixbuf_new_rgba_dnotify ((art_u8 *) pixels, width, height, rowstride, NULL, NULL);
|
|
}
|
|
|
|
static void
|
|
art_pixel_destroy (void *func_data, void *data)
|
|
{
|
|
art_free (data);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_new_rgb: Create a new RGB #ArtPixBuf.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGB
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* The @pixels buffer is freed with art_free() when the #ArtPixBuf is
|
|
* destroyed. Thus, this function is suitable when the pixel data is
|
|
* allocated with art_alloc().
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_rgb (art_u8 *pixels, int width, int height, int rowstride)
|
|
{
|
|
return art_pixbuf_new_rgb_dnotify (pixels, width, height, rowstride, NULL, art_pixel_destroy);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_new_rgba: Create a new RGBA #ArtPixBuf.
|
|
* @pixels: A buffer containing the actual pixel data.
|
|
* @width: The width of the pixbuf.
|
|
* @height: The height of the pixbuf.
|
|
* @rowstride: The rowstride of the pixbuf.
|
|
*
|
|
* Creates a generic data structure for holding a buffer of RGBA
|
|
* pixels. It is possible to think of an #ArtPixBuf as a
|
|
* virtualization over specific pixel buffer formats.
|
|
*
|
|
* The @pixels buffer is freed with art_free() when the #ArtPixBuf is
|
|
* destroyed. Thus, this function is suitable when the pixel data is
|
|
* allocated with art_alloc().
|
|
*
|
|
* Return value: The newly created #ArtPixBuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_new_rgba (art_u8 *pixels, int width, int height, int rowstride)
|
|
{
|
|
return art_pixbuf_new_rgba_dnotify (pixels, width, height, rowstride, NULL, art_pixel_destroy);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_free: Destroy an #ArtPixBuf.
|
|
* @pixbuf: The #ArtPixBuf to be destroyed.
|
|
*
|
|
* Destroys the #ArtPixBuf, calling the destroy notification function
|
|
* (if non-NULL) so that the memory for the pixel buffer can be
|
|
* properly reclaimed.
|
|
**/
|
|
void
|
|
art_pixbuf_free (ArtPixBuf *pixbuf)
|
|
{
|
|
ArtDestroyNotify destroy = pixbuf->destroy;
|
|
void *destroy_data = pixbuf->destroy_data;
|
|
art_u8 *pixels = pixbuf->pixels;
|
|
|
|
pixbuf->pixels = NULL;
|
|
pixbuf->destroy = NULL;
|
|
pixbuf->destroy_data = NULL;
|
|
|
|
if (destroy)
|
|
destroy (destroy_data, pixels);
|
|
|
|
art_free (pixbuf);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_free_shallow:
|
|
* @pixbuf: The #ArtPixBuf to be destroyed.
|
|
*
|
|
* Destroys the #ArtPixBuf without calling the destroy notification function.
|
|
*
|
|
* This function is deprecated. Use the _dnotify variants for
|
|
* allocation instead.
|
|
**/
|
|
void
|
|
art_pixbuf_free_shallow (ArtPixBuf *pixbuf)
|
|
{
|
|
art_free (pixbuf);
|
|
}
|
|
|
|
/**
|
|
* art_pixbuf_duplicate: Duplicate a pixbuf.
|
|
* @pixbuf: The #ArtPixBuf to duplicate.
|
|
*
|
|
* Duplicates a pixbuf, including duplicating the buffer.
|
|
*
|
|
* Return value: The duplicated pixbuf.
|
|
**/
|
|
ArtPixBuf *
|
|
art_pixbuf_duplicate (const ArtPixBuf *pixbuf)
|
|
{
|
|
ArtPixBuf *result;
|
|
int size;
|
|
|
|
result = art_new (ArtPixBuf, 1);
|
|
|
|
result->format = pixbuf->format;
|
|
result->n_channels = pixbuf->n_channels;
|
|
result->has_alpha = pixbuf->has_alpha;
|
|
result->bits_per_sample = pixbuf->bits_per_sample;
|
|
|
|
size = (pixbuf->height - 1) * pixbuf->rowstride +
|
|
pixbuf->width * ((pixbuf->n_channels * pixbuf->bits_per_sample + 7) >> 3);
|
|
result->pixels = art_alloc (size);
|
|
memcpy (result->pixels, pixbuf->pixels, size);
|
|
|
|
result->width = pixbuf->width;
|
|
result->height = pixbuf->height;
|
|
result->rowstride = pixbuf->rowstride;
|
|
result->destroy_data = NULL;
|
|
result->destroy = art_pixel_destroy;
|
|
|
|
return result;
|
|
}
|