Efl.Gfx.Buffer: Simplify data_get/set

Remove alpha, l, r, t, b and output length. Those are simply
too many parameters, making the function too inconvenient to use.
This commit is contained in:
Jean-Philippe Andre 2016-03-11 16:04:15 +09:00
parent 055ea6445a
commit 97c9ced648
2 changed files with 19 additions and 64 deletions

View File

@ -94,6 +94,8 @@ interface Efl.Gfx.Buffer ()
} }
} }
/* FIXME: not bindable to JS, potentially tricky to bind to Lua */
/* FIXME: split into read-only and writeable methods? */ /* FIXME: split into read-only and writeable methods? */
/* FIXME: This was copy pasta from ector generic buffer. changed a bit. */ /* FIXME: This was copy pasta from ector generic buffer. changed a bit. */
buffer_map { buffer_map {
@ -133,7 +135,7 @@ interface Efl.Gfx.Buffer ()
} }
/* note: not a property because the refcount needs to be explicit /* note: not a property because the refcount needs to be explicit
* between set and get */ * between set and get */
/* FIXME: not bindable to JS, potentially tricky to bind to Lua */ /* FIXME: do we need writable flag? */
buffer_set { buffer_set {
[[Set the pixels for this buffer, or allocate a new memory region. [[Set the pixels for this buffer, or allocate a new memory region.
@ -163,12 +165,6 @@ interface Efl.Gfx.Buffer ()
@in height: int; @in height: int;
@in stride: int @optional; [[If 0, automatically guessed from the $width.]] @in stride: int @optional; [[If 0, automatically guessed from the $width.]]
@in cspace: Efl.Gfx.Colorspace @optional; [[argb8888 by default.]] @in cspace: Efl.Gfx.Colorspace @optional; [[argb8888 by default.]]
@in alpha: bool; [[$true if the alpha channel is used.]]
@in l: uint @optional; [[Left border pixels, usually 0 or 1. Not supported yet!]]
@in r: uint @optional; [[Right border pixels, usually 0 or 1. Not supported yet!]]
@in t: uint @optional; [[Top border pixels, usually 0 or 1. Not supported yet!]]
@in b: uint @optional; [[Bottom border pixels, usually 0 or 1. Not supported yet!]]
/* FIXME: do we need writable flag? */
} }
return: bool @warn_unused; [[This function returns $false in case of failure.]] return: bool @warn_unused; [[This function returns $false in case of failure.]]
} }
@ -201,11 +197,6 @@ interface Efl.Gfx.Buffer ()
@in height: int; @in height: int;
@in stride: int @optional; [[If 0, automatically guessed from the $width.]] @in stride: int @optional; [[If 0, automatically guessed from the $width.]]
@in cspace: Efl.Gfx.Colorspace @optional; [[argb8888 by default.]] @in cspace: Efl.Gfx.Colorspace @optional; [[argb8888 by default.]]
@in alpha: bool; [[$true if the alpha channel is used.]]
@in l: uint @optional; [[Left border pixels, usually 0 or 1. Not supported yet!]]
@in r: uint @optional; [[Right border pixels, usually 0 or 1. Not supported yet!]]
@in t: uint @optional; [[Top border pixels, usually 0 or 1. Not supported yet!]]
@in b: uint @optional; [[Bottom border pixels, usually 0 or 1. Not supported yet!]]
} }
return: bool @warn_unused; [[This function returns $false in case of failure.]] return: bool @warn_unused; [[This function returns $false in case of failure.]]
} }
@ -213,32 +204,24 @@ interface Efl.Gfx.Buffer ()
[[Get a direct pointer to the internal pixel data. [[Get a direct pointer to the internal pixel data.
This will increment an internal reference counter on the internal This will increment an internal reference counter on the internal
buffer. buffer. If $to_write is $true, this may trigger a copy of the
internal pixel data, and return a writable memory block.
If $to_write is $true, this may trigger a copy of the internal Call @.buffer_size.get to know the value of $width and $height.
pixel data, and return a writable memory block. The memory buffer length in bytes is defined as $height x $stride.
Call @.buffer_size.get and @.buffer_borders.get to determine the
value of width, height and l, r, t, b.
Warning: @.buffer_set MUST be called as soon as possible after Warning: @.buffer_set MUST be called as soon as possible after
calling @.buffer_get. @.buffer_update_add should be called after calling @.buffer_get. @.buffer_update_add should be called after
@.buffer_set if $to_write was $true and the pixel data has been @.buffer_set if $to_write was $true and the pixel data has been
modified. Once @.buffer_set is called, the pointer return from modified. Once @.buffer_set is called, the pointer returned by
@.buffer_get is not valid anymore. @.buffer_get is not valid anymore.
]] ]]
params { params {
@in to_write: bool; [[If $true, requests write access]] @in to_write: bool; [[If $true, requests write access]]
@out length: uint @optional; [[Size of the buffer in bytes.]]
@out width: int @optional; @out width: int @optional;
@out height: int @optional; @out height: int @optional;
@out stride: int @optional; [[Returns the length of one row of pixels in bytes.]] @out stride: int @optional; [[Returns the length of one row of pixels in bytes, so that length = $height x $stride.]]
@out cspace: Efl.Gfx.Colorspace @optional; [[Pixel encoding of the returned buffer.]] @out cspace: Efl.Gfx.Colorspace @optional; [[Pixel encoding of the returned buffer.]]
@out alpha: bool; [[$true if the alpha channel is used.]]
@out l: uint @optional; [[Left border pixels, usually 0 or 1. Not supported yet!]]
@out r: uint @optional; [[Right border pixels, usually 0 or 1. Not supported yet!]]
@out t: uint @optional; [[Top border pixels, usually 0 or 1. Not supported yet!]]
@out b: uint @optional; [[Bottom border pixels, usually 0 or 1. Not supported yet!]]
} }
return: void* @warn_unused; return: void* @warn_unused;
} }

View File

@ -4036,13 +4036,12 @@ _evas_object_image_surface_get(Evas_Object *eo, Evas_Object_Protected_Data *obj)
EOLIAN static void * EOLIAN static void *
_evas_image_efl_gfx_buffer_buffer_get(Eo *eo_obj, Evas_Image_Data *o, _evas_image_efl_gfx_buffer_buffer_get(Eo *eo_obj, Evas_Image_Data *o,
Eina_Bool to_write, unsigned int *length_out, Eina_Bool to_write,
int *width, int *height, int *stride_out, int *width, int *height, int *stride_out,
Efl_Gfx_Colorspace *cspace, Eina_Bool *alpha, Efl_Gfx_Colorspace *cspace)
unsigned int *l, unsigned int *r, unsigned int *t, unsigned int *b)
{ {
Evas_Object_Protected_Data *obj = eo_data_scope_get(eo_obj, EVAS_OBJECT_CLASS); Evas_Object_Protected_Data *obj = eo_data_scope_get(eo_obj, EVAS_OBJECT_CLASS);
int stride = 0, length = 0; int stride = 0;
void *data; void *data;
// use the old api - same behaviour with more return info // use the old api - same behaviour with more return info
@ -4052,25 +4051,13 @@ _evas_image_efl_gfx_buffer_buffer_get(Eo *eo_obj, Evas_Image_Data *o,
// FIXME: length needs to be properly checked with the engine // FIXME: length needs to be properly checked with the engine
// as we just ignore l,r,t,b here // as we just ignore l,r,t,b here
ENFN->image_stride_get(ENDT, o->engine_data, &stride); ENFN->image_stride_get(ENDT, o->engine_data, &stride);
if (stride) if (!stride)
length = stride * o->cur->image.h; stride = _evas_common_rgba_image_surface_size(o->cur->image.w, 1, o->cur->cspace, NULL, NULL, NULL, NULL);
else
{
length = _evas_common_rgba_image_surface_size(o->cur->image.w, o->cur->image.h, o->cur->cspace, NULL, NULL, NULL, NULL);
stride = _evas_common_rgba_image_surface_size(o->cur->image.w, 1, o->cur->cspace, NULL, NULL, NULL, NULL);
}
end: end:
// TODO: support duplicated borders
if (l) *l = 0;
if (r) *r = 0;
if (t) *t = 0;
if (b) *b = 0;
if (alpha) *alpha = o->cur->has_alpha;
if (width) *width = o->cur->image.w; if (width) *width = o->cur->image.w;
if (height) *height = o->cur->image.h; if (height) *height = o->cur->image.h;
if (cspace) *cspace = (Efl_Gfx_Colorspace) o->cur->cspace; if (cspace) *cspace = (Efl_Gfx_Colorspace) o->cur->cspace;
if (length_out) *length_out = length;
if (stride_out) *stride_out = stride; if (stride_out) *stride_out = stride;
return data; return data;
} }
@ -4078,20 +4065,11 @@ end:
static Eina_Bool static Eina_Bool
_evas_image_buffer_set_common(Eo *obj, Evas_Image_Data *o, void *pixels, _evas_image_buffer_set_common(Eo *obj, Evas_Image_Data *o, void *pixels,
int width, int height, int stride, int width, int height, int stride,
Efl_Gfx_Colorspace cspace, Eina_Bool alpha, Efl_Gfx_Colorspace cspace, Eina_Bool copy)
unsigned int l, unsigned int r, unsigned int t, unsigned int b,
Eina_Bool copy)
{ {
Evas_Colorspace cs = (Evas_Colorspace) cspace; Evas_Colorspace cs = (Evas_Colorspace) cspace;
int stride_min; int stride_min;
if (l || r || t || b)
{
// TODO
ERR("Buffer borders are not supported yet!");
return EINA_FALSE;
}
stride_min = _evas_common_rgba_image_surface_size(width, 1, cs, NULL, NULL, NULL, NULL); stride_min = _evas_common_rgba_image_surface_size(width, 1, cs, NULL, NULL, NULL, NULL);
if (!stride) stride = stride_min; if (!stride) stride = stride_min;
if (stride < stride_min) if (stride < stride_min)
@ -4111,10 +4089,6 @@ _evas_image_buffer_set_common(Eo *obj, Evas_Image_Data *o, void *pixels,
if ((width != o->cur->image.w) || (height != o->cur->image.h)) if ((width != o->cur->image.w) || (height != o->cur->image.h))
evas_object_image_size_set(obj, width, height); evas_object_image_size_set(obj, width, height);
alpha = !!alpha;
if (alpha != o->cur->has_alpha)
evas_object_image_alpha_set(obj, alpha);
if (!pixels) if (!pixels)
evas_object_image_data_set(obj, NULL); evas_object_image_data_set(obj, NULL);
else if (!copy) else if (!copy)
@ -4128,19 +4102,17 @@ _evas_image_buffer_set_common(Eo *obj, Evas_Image_Data *o, void *pixels,
EOLIAN static Eina_Bool EOLIAN static Eina_Bool
_evas_image_efl_gfx_buffer_buffer_set(Eo *obj, Evas_Image_Data *o, void *pixels, _evas_image_efl_gfx_buffer_buffer_set(Eo *obj, Evas_Image_Data *o, void *pixels,
int width, int height, int stride, int width, int height, int stride,
Efl_Gfx_Colorspace cspace, Eina_Bool alpha, Efl_Gfx_Colorspace cspace)
unsigned int l, unsigned int r, unsigned int t, unsigned int b)
{ {
return _evas_image_buffer_set_common(obj, o, pixels, width, height, stride, cspace, alpha, l, r, t, b, EINA_FALSE); return _evas_image_buffer_set_common(obj, o, pixels, width, height, stride, cspace, EINA_FALSE);
} }
EOLIAN static Eina_Bool EOLIAN static Eina_Bool
_evas_image_efl_gfx_buffer_buffer_copy_set(Eo *obj, Evas_Image_Data *o, const void *pixels, _evas_image_efl_gfx_buffer_buffer_copy_set(Eo *obj, Evas_Image_Data *o, const void *pixels,
int width, int height, int stride, int width, int height, int stride,
Efl_Gfx_Colorspace cspace, Eina_Bool alpha, Efl_Gfx_Colorspace cspace)
unsigned int l, unsigned int r, unsigned int t, unsigned int b)
{ {
return _evas_image_buffer_set_common(obj, o, (void *) pixels, width, height, stride, cspace, alpha, l, r, t, b, EINA_TRUE); return _evas_image_buffer_set_common(obj, o, (void *) pixels, width, height, stride, cspace, EINA_TRUE);
} }
/* Legacy deprecated functions */ /* Legacy deprecated functions */