071253c48b
All the macros get used for are to |= (a new flag bit), &= ~(a flag bit) or use the & operator to test if a flag bit is set. I haven't found the code more readable with these macros, but several times now I've felt the need to double check if these macros do anything else behind the hood or I've forgotten what flags are available so I've had to go to the macro definition to see what the full enum names are for the flags (the macros use symbol concatenation) so I can search for the definition of all the flags. It turns out they are defined next to the macro so you don't have to search far, but without the macro that wouldn't have been necessary. The more common use of the _IS_SET macro is actually more concise expanded and imho since it doesn't hide anything in a separate header file the code is more readable without the macro.
482 lines
13 KiB
C
482 lines
13 KiB
C
/*
|
|
* Cogl
|
|
*
|
|
* An object oriented GL/GLES Abstraction/Utility Layer
|
|
*
|
|
* Copyright (C) 2007,2008,2009 Intel Corporation.
|
|
*
|
|
* 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, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include "config.h"
|
|
#endif
|
|
|
|
#include "cogl.h"
|
|
#include "cogl-debug.h"
|
|
#include "cogl-internal.h"
|
|
#include "cogl-bitmap-private.h"
|
|
#include "cogl-buffer-private.h"
|
|
|
|
#include <string.h>
|
|
|
|
struct _CoglBitmap
|
|
{
|
|
CoglHandleObject _parent;
|
|
CoglPixelFormat format;
|
|
int width;
|
|
int height;
|
|
int rowstride;
|
|
|
|
guint8 *data;
|
|
CoglBitmapDestroyNotify destroy_fn;
|
|
void *destroy_fn_data;
|
|
|
|
gboolean mapped;
|
|
gboolean bound;
|
|
|
|
/* If this is non-null then 'data' is ignored and instead it is
|
|
fetched from this shared bitmap. */
|
|
CoglBitmap *shared_bmp;
|
|
|
|
/* If this is non-null then 'data' is treated as an offset into the
|
|
buffer and map will divert to mapping the buffer */
|
|
CoglBuffer *buffer;
|
|
};
|
|
|
|
static void _cogl_bitmap_free (CoglBitmap *bmp);
|
|
|
|
COGL_OBJECT_DEFINE (Bitmap, bitmap);
|
|
|
|
static void
|
|
_cogl_bitmap_free (CoglBitmap *bmp)
|
|
{
|
|
g_assert (!bmp->mapped);
|
|
g_assert (!bmp->bound);
|
|
|
|
if (bmp->destroy_fn)
|
|
bmp->destroy_fn (bmp->data, bmp->destroy_fn_data);
|
|
|
|
if (bmp->shared_bmp)
|
|
cogl_object_unref (bmp->shared_bmp);
|
|
|
|
if (bmp->buffer)
|
|
cogl_object_unref (bmp->buffer);
|
|
|
|
g_slice_free (CoglBitmap, bmp);
|
|
}
|
|
|
|
int
|
|
_cogl_get_format_bpp (CoglPixelFormat format)
|
|
{
|
|
int bpp_lut[] = {
|
|
0, /* invalid */
|
|
1, /* A_8 */
|
|
3, /* 888 */
|
|
4, /* 8888 */
|
|
2, /* 565 */
|
|
2, /* 4444 */
|
|
2, /* 5551 */
|
|
2, /* YUV */
|
|
1 /* G_8 */
|
|
};
|
|
|
|
return bpp_lut [format & COGL_UNORDERED_MASK];
|
|
}
|
|
|
|
gboolean
|
|
_cogl_bitmap_convert_premult_status (CoglBitmap *bmp,
|
|
CoglPixelFormat dst_format)
|
|
{
|
|
/* Do we need to unpremultiply? */
|
|
if ((bmp->format & COGL_PREMULT_BIT) > 0 &&
|
|
(dst_format & COGL_PREMULT_BIT) == 0)
|
|
/* Try unpremultiplying using imaging library */
|
|
return (_cogl_bitmap_unpremult (bmp)
|
|
/* ... or try fallback */
|
|
|| _cogl_bitmap_fallback_unpremult (bmp));
|
|
|
|
/* Do we need to premultiply? */
|
|
if ((bmp->format & COGL_PREMULT_BIT) == 0 &&
|
|
(dst_format & COGL_PREMULT_BIT) > 0)
|
|
/* Try premultiplying using imaging library */
|
|
return (_cogl_bitmap_premult (bmp)
|
|
/* ... or try fallback */
|
|
|| _cogl_bitmap_fallback_premult (bmp));
|
|
|
|
return TRUE;
|
|
}
|
|
|
|
CoglBitmap *
|
|
_cogl_bitmap_convert_format_and_premult (CoglBitmap *bmp,
|
|
CoglPixelFormat dst_format)
|
|
{
|
|
CoglPixelFormat src_format = _cogl_bitmap_get_format (bmp);
|
|
CoglBitmap *dst_bmp;
|
|
|
|
/* Is base format different (not considering premult status)? */
|
|
if ((src_format & COGL_UNPREMULT_MASK) !=
|
|
(dst_format & COGL_UNPREMULT_MASK))
|
|
{
|
|
/* Try converting using imaging library */
|
|
if ((dst_bmp = _cogl_bitmap_convert (bmp, dst_format)) == NULL)
|
|
{
|
|
/* ... or try fallback */
|
|
if ((dst_bmp = _cogl_bitmap_fallback_convert (bmp,
|
|
dst_format)) == NULL)
|
|
return NULL;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
int rowstride = _cogl_bitmap_get_rowstride (bmp);
|
|
int height = _cogl_bitmap_get_height (bmp);
|
|
guint8 *data;
|
|
|
|
/* Copy the bitmap so that we can premultiply in-place */
|
|
|
|
if ((data = _cogl_bitmap_map (bmp, COGL_BUFFER_ACCESS_READ, 0)) == NULL)
|
|
return NULL;
|
|
|
|
dst_bmp = _cogl_bitmap_new_from_data (g_memdup (data, height * rowstride),
|
|
src_format,
|
|
_cogl_bitmap_get_width (bmp),
|
|
height,
|
|
rowstride,
|
|
(CoglBitmapDestroyNotify) g_free,
|
|
NULL);
|
|
|
|
_cogl_bitmap_unmap (bmp);
|
|
}
|
|
|
|
src_format = _cogl_bitmap_get_format (dst_bmp);
|
|
|
|
/* We only need to do a premult conversion if both formats have an
|
|
alpha channel. If we're converting from RGB to RGBA then the
|
|
alpha will have been filled with 255 so the premult won't do
|
|
anything or if we are converting from RGBA to RGB we're losing
|
|
information so either converting or not will be wrong for
|
|
transparent pixels */
|
|
if ((src_format & COGL_A_BIT) == COGL_A_BIT &&
|
|
(dst_format & COGL_A_BIT) == COGL_A_BIT &&
|
|
!_cogl_bitmap_convert_premult_status (dst_bmp, dst_format))
|
|
{
|
|
cogl_object_unref (dst_bmp);
|
|
return NULL;
|
|
}
|
|
|
|
return dst_bmp;
|
|
}
|
|
|
|
void
|
|
_cogl_bitmap_copy_subregion (CoglBitmap *src,
|
|
CoglBitmap *dst,
|
|
int src_x,
|
|
int src_y,
|
|
int dst_x,
|
|
int dst_y,
|
|
int width,
|
|
int height)
|
|
{
|
|
guint8 *srcdata;
|
|
guint8 *dstdata;
|
|
int bpp;
|
|
int line;
|
|
|
|
/* Intended only for fast copies when format is equal! */
|
|
g_assert (src->format == dst->format);
|
|
bpp = _cogl_get_format_bpp (src->format);
|
|
|
|
if ((srcdata = _cogl_bitmap_map (src, COGL_BUFFER_ACCESS_READ, 0)))
|
|
{
|
|
if ((dstdata = _cogl_bitmap_map (dst, COGL_BUFFER_ACCESS_WRITE, 0)))
|
|
{
|
|
srcdata += src_y * src->rowstride + src_x * bpp;
|
|
dstdata += dst_y * dst->rowstride + dst_x * bpp;
|
|
|
|
for (line=0; line<height; ++line)
|
|
{
|
|
memcpy (dstdata, srcdata, width * bpp);
|
|
srcdata += src->rowstride;
|
|
dstdata += dst->rowstride;
|
|
}
|
|
|
|
_cogl_bitmap_unmap (dst);
|
|
}
|
|
|
|
_cogl_bitmap_unmap (src);
|
|
}
|
|
}
|
|
|
|
gboolean
|
|
cogl_bitmap_get_size_from_file (const char *filename,
|
|
int *width,
|
|
int *height)
|
|
{
|
|
return _cogl_bitmap_get_size_from_file (filename, width, height);
|
|
}
|
|
|
|
CoglBitmap *
|
|
_cogl_bitmap_new_from_data (guint8 *data,
|
|
CoglPixelFormat format,
|
|
int width,
|
|
int height,
|
|
int rowstride,
|
|
CoglBitmapDestroyNotify destroy_fn,
|
|
void *destroy_fn_data)
|
|
{
|
|
CoglBitmap *bmp = g_slice_new (CoglBitmap);
|
|
|
|
bmp->format = format;
|
|
bmp->width = width;
|
|
bmp->height = height;
|
|
bmp->rowstride = rowstride;
|
|
bmp->data = data;
|
|
bmp->destroy_fn = destroy_fn;
|
|
bmp->destroy_fn_data = destroy_fn_data;
|
|
bmp->mapped = FALSE;
|
|
bmp->bound = FALSE;
|
|
bmp->shared_bmp = NULL;
|
|
bmp->buffer = NULL;
|
|
|
|
return _cogl_bitmap_object_new (bmp);
|
|
}
|
|
|
|
CoglBitmap *
|
|
_cogl_bitmap_new_shared (CoglBitmap *shared_bmp,
|
|
CoglPixelFormat format,
|
|
int width,
|
|
int height,
|
|
int rowstride)
|
|
{
|
|
CoglBitmap *bmp = _cogl_bitmap_new_from_data (NULL, /* data */
|
|
format,
|
|
width,
|
|
height,
|
|
rowstride,
|
|
NULL, /* destroy_fn */
|
|
NULL /* destroy_fn_data */);
|
|
|
|
bmp->shared_bmp = cogl_object_ref (shared_bmp);
|
|
|
|
return bmp;
|
|
}
|
|
|
|
CoglBitmap *
|
|
cogl_bitmap_new_from_file (const char *filename,
|
|
GError **error)
|
|
{
|
|
CoglBitmap *bmp;
|
|
|
|
g_return_val_if_fail (error == NULL || *error == NULL, COGL_INVALID_HANDLE);
|
|
|
|
if ((bmp = _cogl_bitmap_from_file (filename, error)) == NULL)
|
|
{
|
|
/* Try fallback */
|
|
if ((bmp = _cogl_bitmap_fallback_from_file (filename))
|
|
&& error && *error)
|
|
{
|
|
g_error_free (*error);
|
|
*error = NULL;
|
|
}
|
|
}
|
|
|
|
return bmp;
|
|
}
|
|
|
|
CoglBitmap *
|
|
_cogl_bitmap_new_from_buffer (CoglBuffer *buffer,
|
|
CoglPixelFormat format,
|
|
int width,
|
|
int height,
|
|
int rowstride,
|
|
int offset)
|
|
{
|
|
CoglBitmap *bmp;
|
|
|
|
g_return_val_if_fail (cogl_is_buffer (buffer), NULL);
|
|
|
|
bmp = _cogl_bitmap_new_from_data (NULL, /* data */
|
|
format,
|
|
width,
|
|
height,
|
|
rowstride,
|
|
NULL, /* destroy_fn */
|
|
NULL /* destroy_fn_data */);
|
|
|
|
bmp->buffer = cogl_object_ref (buffer);
|
|
bmp->data = GINT_TO_POINTER (offset);
|
|
|
|
return bmp;
|
|
}
|
|
|
|
CoglPixelFormat
|
|
_cogl_bitmap_get_format (CoglBitmap *bitmap)
|
|
{
|
|
return bitmap->format;
|
|
}
|
|
|
|
void
|
|
_cogl_bitmap_set_format (CoglBitmap *bitmap,
|
|
CoglPixelFormat format)
|
|
{
|
|
bitmap->format = format;
|
|
}
|
|
|
|
int
|
|
_cogl_bitmap_get_width (CoglBitmap *bitmap)
|
|
{
|
|
return bitmap->width;
|
|
}
|
|
|
|
GQuark
|
|
cogl_bitmap_error_quark (void)
|
|
{
|
|
return g_quark_from_static_string ("cogl-bitmap-error-quark");
|
|
}
|
|
|
|
int
|
|
_cogl_bitmap_get_height (CoglBitmap *bitmap)
|
|
{
|
|
return bitmap->height;
|
|
}
|
|
|
|
int
|
|
_cogl_bitmap_get_rowstride (CoglBitmap *bitmap)
|
|
{
|
|
return bitmap->rowstride;
|
|
}
|
|
|
|
guint8 *
|
|
_cogl_bitmap_map (CoglBitmap *bitmap,
|
|
CoglBufferAccess access,
|
|
CoglBufferMapHint hints)
|
|
{
|
|
/* Divert to another bitmap if this data is shared */
|
|
if (bitmap->shared_bmp)
|
|
return _cogl_bitmap_map (bitmap->shared_bmp, access, hints);
|
|
|
|
g_assert (!bitmap->mapped);
|
|
|
|
if (bitmap->buffer)
|
|
{
|
|
guint8 *data = cogl_buffer_map (bitmap->buffer,
|
|
access,
|
|
hints);
|
|
|
|
COGL_NOTE (BITMAP, "A pixel array is being mapped from a bitmap. This "
|
|
"usually means that some conversion on the pixel array is "
|
|
"needed so a sub-optimal format is being used.");
|
|
|
|
if (data)
|
|
{
|
|
bitmap->mapped = TRUE;
|
|
|
|
return data + GPOINTER_TO_INT (bitmap->data);
|
|
}
|
|
else
|
|
return NULL;
|
|
}
|
|
else
|
|
{
|
|
bitmap->mapped = TRUE;
|
|
|
|
return bitmap->data;
|
|
}
|
|
}
|
|
|
|
void
|
|
_cogl_bitmap_unmap (CoglBitmap *bitmap)
|
|
{
|
|
/* Divert to another bitmap if this data is shared */
|
|
if (bitmap->shared_bmp)
|
|
return _cogl_bitmap_unmap (bitmap->shared_bmp);
|
|
|
|
g_assert (bitmap->mapped);
|
|
bitmap->mapped = FALSE;
|
|
|
|
if (bitmap->buffer)
|
|
cogl_buffer_unmap (bitmap->buffer);
|
|
}
|
|
|
|
guint8 *
|
|
_cogl_bitmap_bind (CoglBitmap *bitmap,
|
|
CoglBufferAccess access,
|
|
CoglBufferMapHint hints)
|
|
{
|
|
guint8 *ptr;
|
|
|
|
/* Divert to another bitmap if this data is shared */
|
|
if (bitmap->shared_bmp)
|
|
return _cogl_bitmap_bind (bitmap->shared_bmp, access, hints);
|
|
|
|
g_assert (!bitmap->bound);
|
|
|
|
/* If the bitmap wasn't created from a buffer then the
|
|
implementation of bind is the same as map */
|
|
if (bitmap->buffer == NULL)
|
|
{
|
|
guint8 *data = _cogl_bitmap_map (bitmap, access, hints);
|
|
if (data)
|
|
bitmap->bound = TRUE;
|
|
return data;
|
|
}
|
|
|
|
bitmap->bound = TRUE;
|
|
|
|
/* If buffer is using a malloc fallback then we'll just use the
|
|
pointer directly */
|
|
if (bitmap->buffer->flags & COGL_BUFFER_FLAG_BUFFER_OBJECT)
|
|
{
|
|
ptr = NULL;
|
|
|
|
if (access == COGL_BUFFER_ACCESS_READ)
|
|
_cogl_buffer_bind (bitmap->buffer,
|
|
COGL_BUFFER_BIND_TARGET_PIXEL_UNPACK);
|
|
else if (access == COGL_BUFFER_ACCESS_WRITE)
|
|
_cogl_buffer_bind (bitmap->buffer,
|
|
COGL_BUFFER_BIND_TARGET_PIXEL_PACK);
|
|
else
|
|
g_assert_not_reached ();
|
|
}
|
|
else
|
|
ptr = bitmap->buffer->data;
|
|
|
|
/* The data pointer actually stores the offset */
|
|
return GPOINTER_TO_INT (bitmap->data) + ptr;
|
|
}
|
|
|
|
void
|
|
_cogl_bitmap_unbind (CoglBitmap *bitmap)
|
|
{
|
|
/* Divert to another bitmap if this data is shared */
|
|
if (bitmap->shared_bmp)
|
|
return _cogl_bitmap_unbind (bitmap->shared_bmp);
|
|
|
|
g_assert (bitmap->bound);
|
|
bitmap->bound = FALSE;
|
|
|
|
/* If the bitmap wasn't created from a pixel array then the
|
|
implementation of unbind is the same as unmap */
|
|
if (bitmap->buffer)
|
|
{
|
|
if (bitmap->buffer->flags & COGL_BUFFER_FLAG_BUFFER_OBJECT)
|
|
_cogl_buffer_unbind (bitmap->buffer);
|
|
}
|
|
else
|
|
_cogl_bitmap_unmap (bitmap);
|
|
}
|