Upon reviewing the elm_glview, I've realized a few issues and mistakes that i've
authorraster <raster@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Mon, 20 Jun 2011 10:55:02 +0000 (10:55 +0000)
committerraster <raster@7cbeb6ba-43b4-40fd-8cce-4c39aea84d33>
Mon, 20 Jun 2011 10:55:02 +0000 (10:55 +0000)
commitaa52e8b26a672b8b7177c8e88a7b92518c01d942
treed633eee0c3d0e09e881de8b47141e1f4c8f00b17
parent975406b12cf57f8bedfa2e08a422b62ed3d474e7
Upon reviewing the elm_glview, I've realized a few issues and mistakes that i've
made originally so I've made some changes/ updates to elm_glview

1.)  GL Resource Deletion in ELM_GLView

In order to delete GL resources, the current approach simply registered a
delete callback to the GLView object and handled resource deletion there.
Unfortunately, using the delete callback did not guarantee the glview context to be
current.  In order to guarantee that the current context was the glview context,
the make_current call needs to be called explicitly.  Since we were hiding all the
make current details in elm_glview, i've decided to add an API that registers a
delete callback function. I know that this may seem redundant since there is already
a delete callback that you can register with glview objects. Unfortunately, this is the
only option that we have apart from exposing make_current, which is something that
went again what we are trying to do with elm_glview.

Since adding delete callback alone seemed a little out of place, i've taken the liberty
to add other callback functions to make it seem consistent.

void elm_glview_init_func_set(Evas_Object *obj, Elm_GLView_Func func);
void elm_glview_del_func_set(Evas_Object *obj, Elm_GLView_Func func);
void elm_glview_resize_func_set(Evas_Object *obj, Elm_GLView_Func func);

resize callback can be controversial as well but I want to argue that adding this callback
makes the render function a lot cleaner.  To handle resize differently, the user in
render function needs to manually compare and see if the size has changed, and
then handle the cases.  Doing all of this internally once makes the developers life
a lot easier in my opinion.

these callback functions do make the render function a lot cleaner. You can check
out the updated test_glview.c or newly added test_glview_simple.

2.) Minor bug fixes/changes

elm_glview_scale_policy_set() was supposed to be elm_glview_resize_policy_set()
but it somehow evaded our reviews.  That has been fixed.

Also, in _glview_resize, after updating the surface, it was explicitly calling the
render function.  It is actually unnecessary here and calling it here will cause
problems if resize gets called before everything else is setup properly.  So that has
been commented out.

3.) test_glview & test_glview_simple

elementary_test case for glview has been updated to reflect the api changes.
when you run the elmentary_test, you need to make sure that you set
ELM_ENGINE=gl as glview currently only runs on gl backend.

test_glview runs the gears example.  For testing purposes I've included a simple
glview test case that renders a triangle and changing background color.

git-svn-id: https://svn.enlightenment.org/svn/e/trunk/elementary@60517 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33
src/bin/Makefile.am
src/bin/test.c
src/bin/test_glview.c
src/bin/test_glview_simple.c [new file with mode: 0644]
src/lib/Elementary.h.in
src/lib/elm_glview.c