#include "evas_common.h" #include "evas_private.h" void evas_object_clip_dirty(Evas_Object *obj) { Eina_List *l; Evas_Object *data; if (obj->cur.cache.clip.dirty) return ; obj->cur.cache.clip.dirty = 1; EINA_LIST_FOREACH(obj->clip.clipees, l, data) evas_object_clip_dirty(data); } void evas_object_recalc_clippees(Evas_Object *obj) { Eina_List *l; Evas_Object *data; if (obj->cur.cache.clip.dirty) { evas_object_clip_recalc(obj); EINA_LIST_FOREACH(obj->clip.clipees, l, data) evas_object_recalc_clippees(data); } } int evas_object_clippers_was_visible(Evas_Object *obj) { if (obj->prev.visible) { if (obj->prev.clipper) return evas_object_clippers_is_visible(obj->prev.clipper); return 1; } return 0; } /* aaaaargh (pirate voice) ... notes! * * we have a big problem until now that's gone undetected... until yesterday. * that problem involves clips and maps and smart objects. hooray! 3 of the * more complex bits of evas - and maps and smart objects being one of the * nastiest ones. * * what is the problem? when a clip crosses a map boundary. that is to say * that when the clipper and clippee are not within the child tree of the * mapped object. in this case "bad stuff" happens. basically as clips are * then used to render objects, but they no longer apply as you'd expect as * the map transfomr the objects to-be-clipped separately from the objects * that clip them and this whole relationship is broken by maps. it somehow * managed to not break with the advent of smart objects. lucky me... but * maps killed it. now... what do we do? that is a good question. detect * such a broken link and "turn off clipping" in that event - sure. but this * isn't going to be cheap as ANY addition or deletion of a map to an object * or any change in clipper of an object or any change in smart object * membership needs to walk the obj tree both up and down from the changed * object and probably walk entire object trees to find these and mark them. * thats silly-expensive and i was about to fix it that way but it has since * dawned on me that that is just going to kill performance in some critical * areas like during object setup and manipulation, as well as teardown. * * aaaaagh! best for now is to document this as a "don't do it damnit!" thing * and have the apps avoid it. but even then - how to do this? this is not * easy. everywhere i turn so far i come up to either expensive operations, * breaks in logic, or nasty re-work of apps or4 the whole concept of clipping, * smart objects and maps... and that will have to wait for evas 2.0 * * the below does clip fixups etc. in the even a clip spans a map boundary. * not pretty, but necessary. */ #define MAP_ACROSS 1 static void evas_object_child_map_across_mark(Evas_Object *obj, Evas_Object *map_obj, Eina_Bool force) { #ifdef MAP_ACROSS if ((obj->cur.map_parent != map_obj) || force) { obj->cur.map_parent = map_obj; obj->cur.cache.clip.dirty = 1; evas_object_clip_recalc(obj); if (obj->smart.smart) { Evas_Object *obj2; EINA_INLIST_FOREACH(evas_object_smart_members_get_direct(obj), obj2) { // if obj has its own map - skip it. already done if ((obj2->cur.map) && (obj2->cur.usemap)) continue; evas_object_child_map_across_mark(obj2, map_obj, force); } } else if (obj->clip.clipees) { Eina_List *l; Evas_Object *obj2; EINA_LIST_FOREACH(obj->clip.clipees, l, obj2) evas_object_child_map_across_mark(obj2, map_obj, force); } } #endif } void evas_object_clip_across_check(Evas_Object *obj) { #ifdef MAP_ACROSS if (!obj->cur.clipper) return; if (obj->cur.clipper->cur.map_parent != obj->cur.map_parent) evas_object_child_map_across_mark(obj, obj->cur.map_parent, 1); #endif } void evas_object_clip_across_clippees_check(Evas_Object *obj) { #ifdef MAP_ACROSS Eina_List *l; Evas_Object *obj2; if (!obj->clip.clipees) return; // schloooooooooooow: // evas_object_child_map_across_mark(obj, obj->cur.map_parent, 1); // buggy: evas_object_child_map_across_mark(obj, obj->cur.map_parent, 0); if (obj->cur.cache.clip.dirty) { EINA_LIST_FOREACH(obj->clip.clipees, l, obj2) evas_object_clip_across_clippees_check(obj2); } #endif } // this function is called on an object when map is enabled or disabled on it // thus creating a "map boundary" at that point. // // FIXME: flip2 test broken in elm - might be show/hide of clips void evas_object_mapped_clip_across_mark(Evas_Object *obj) { #ifdef MAP_ACROSS if ((obj->cur.map) && (obj->cur.usemap)) evas_object_child_map_across_mark(obj, obj, 0); else { if (obj->smart.parent) evas_object_child_map_across_mark (obj, obj->smart.parent->cur.map_parent, 0); else evas_object_child_map_across_mark(obj, NULL, 0); } #endif } /* public functions */ /** * @addtogroup Evas_Object_Group_Basic * @{ */ /** * Clip one object to another. * @param obj The object to be clipped * @param clip The object to clip @p obj by * * This function will clip the object @p obj to the area occupied by the * object @p clipper. This means the object @p obj will only be visible within * the area occupied by the clipping object (@p clip). The color of the object * being clipped will be multiplied by the color of the clipping object, so * the resulting color for the clipped object is * RESULT = (OBJ * CLIP) / (255 * 255) per color element (red, green, blue and * alpha). Clipping is recursive, so clip objects may be clipped by other * objects, and their color will in tern be multiplied. You may NOT set up * circular clipping lists (i.e. object 1 clips object 2 which clips object 1). * The behavior of Evas is undefined in this case. Objects which do not clip * others are visible as normal, those that clip 1 or more objects become * invisible themselves, only affecting what they clip. If an object ceases to * have other objects being clipped by it, it will become visible again. The * visibility of an object affects the objects that are clipped by it, so if * the object clipping others is not shown, the objects clipped will not be * shown either. If the object was being clipped by another object when this * function is called, it is implicitly removed from the clipper it is being * clipped to, and now is made to clip its new clipper. * * At the moment the only objects that can validly be used to clip other * objects are rectangle objects. All other object types are invalid and the * result of using them is undefined. * * The clip object @p clip must be a valid object, but may also be NULL in * which case the effect of this function is the same as calling * evas_object_clip_unset() on the @p obj object. * * Example: * @code * extern Evas *evas; * extern Evas_Object *obj; * Evas_Object *clipper; * * clipper = evas_object_rectangle_add(evas); * evas_object_color_set(clipper, 255, 255, 255, 255); * evas_object_move(clipper, 10, 10); * evas_object_resize(clipper, 20, 50); * evas_object_clip_set(obj, clipper); * evas_object_show(clipper); * @endcode * */ EAPI void evas_object_clip_set(Evas_Object *obj, Evas_Object *clip) { MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ); return; MAGIC_CHECK_END(); if (!clip) { evas_object_clip_unset(obj); return; } MAGIC_CHECK(clip, Evas_Object, MAGIC_OBJ); return; MAGIC_CHECK_END(); if (obj->cur.clipper == clip) return; if (obj == clip) return; if (evas_object_intercept_call_clip_set(obj, clip)) return; if (obj->smart.smart) { if (obj->smart.smart->smart_class->clip_set) obj->smart.smart->smart_class->clip_set(obj, clip); } if (obj->cur.clipper) { /* unclip */ obj->cur.clipper->clip.clipees = eina_list_remove(obj->cur.clipper->clip.clipees, obj); if (!obj->cur.clipper->clip.clipees) { obj->cur.clipper->cur.have_clipees = 0; if (obj->cur.clipper->cur.visible) evas_damage_rectangle_add(obj->cur.clipper->layer->evas, obj->cur.clipper->cur.geometry.x, obj->cur.clipper->cur.geometry.y, obj->cur.clipper->cur.geometry.w, obj->cur.clipper->cur.geometry.h); } evas_object_change(obj->cur.clipper); evas_object_change(obj); obj->cur.clipper = NULL; } /* clip me */ if ((!clip->clip.clipees) && (clip->cur.visible)) { /* Basically it just went invisible */ clip->changed = 1; clip->layer->evas->changed = 1; evas_damage_rectangle_add(clip->layer->evas, clip->cur.geometry.x, clip->cur.geometry.y, clip->cur.geometry.w, clip->cur.geometry.h); } obj->cur.clipper = clip; clip->clip.clipees = eina_list_append(clip->clip.clipees, obj); if (clip->clip.clipees) clip->cur.have_clipees = 1; evas_object_change(clip); evas_object_change(obj); evas_object_clip_dirty(obj); evas_object_recalc_clippees(obj); if ((!obj->smart.smart) && (!((obj->cur.map) && (obj->cur.usemap)))) { if (evas_object_is_in_output_rect(obj, obj->layer->evas->pointer.x, obj->layer->evas->pointer.y, 1, 1)) evas_event_feed_mouse_move(obj->layer->evas, obj->layer->evas->pointer.x, obj->layer->evas->pointer.y, obj->layer->evas->last_timestamp, NULL); } evas_object_clip_across_check(obj); } /** * Get the object clipping this one (if any). * @param obj The object to get the clipper from * * This function returns the the object clipping @p obj. If @p obj not being * clipped, NULL is returned. The object @p obj must be a valid object. * * See also evas_object_clip_set(), evas_object_clip_unset() and * evas_object_clipees_get(). * * Example: * @code * extern Evas_Object *obj; * Evas_Object *clipper; * * clipper = evas_object_clip_get(obj); * if (clipper) evas_object_show(clipper); * @endcode * */ EAPI Evas_Object * evas_object_clip_get(const Evas_Object *obj) { MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ); return NULL; MAGIC_CHECK_END(); return obj->cur.clipper; } /** * Disable clipping for an object. * * @param obj The object to cease clipping on * * This function disables clipping for the object @p obj, if it was already * clipped. If it wasn't, this has no effect. The object @p obj must be a * valid object. * * See also evas_object_clip_set(), evas_object_clipees_get() and * evas_object_clip_get(). * * Example: * @code * extern Evas_Object *obj; * Evas_Object *clipper; * * clipper = evas_object_clip_get(obj); * if (clipper) * { * evas_object_clip_unset(obj); * evas_object_hide(obj); * } * @endcode * */ EAPI void evas_object_clip_unset(Evas_Object *obj) { MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ); return; MAGIC_CHECK_END(); if (!obj->cur.clipper) return; /* unclip */ if (evas_object_intercept_call_clip_unset(obj)) return; if (obj->smart.smart) { if (obj->smart.smart->smart_class->clip_unset) obj->smart.smart->smart_class->clip_unset(obj); } if (obj->cur.clipper) { obj->cur.clipper->clip.clipees = eina_list_remove(obj->cur.clipper->clip.clipees, obj); if (!obj->cur.clipper->clip.clipees) { obj->cur.clipper->cur.have_clipees = 0; if (obj->cur.clipper->cur.visible) evas_damage_rectangle_add(obj->cur.clipper->layer->evas, obj->cur.clipper->cur.geometry.x, obj->cur.clipper->cur.geometry.y, obj->cur.clipper->cur.geometry.w, obj->cur.clipper->cur.geometry.h); } evas_object_change(obj->cur.clipper); } obj->cur.clipper = NULL; evas_object_change(obj); evas_object_clip_dirty(obj); evas_object_recalc_clippees(obj); if ((!obj->smart.smart) && (!((obj->cur.map) && (obj->cur.usemap)))) { if (evas_object_is_in_output_rect(obj, obj->layer->evas->pointer.x, obj->layer->evas->pointer.y, 1, 1)) evas_event_feed_mouse_move(obj->layer->evas, obj->layer->evas->pointer.x, obj->layer->evas->pointer.y, obj->layer->evas->last_timestamp, NULL); } evas_object_clip_across_check(obj); } /** * Return a list of objects currently clipped by a specific object. * * @param obj The object to get a list of clippees from * * This returns the inernal list handle that contains all objects clipped by * the object @p obj. If none are clipped, it returns NULL. This list is only * valid until the clip list is changed and should be fetched again with another * call to evas_object_clipees_get() if any objects being clipped by this object * are unclipped, clipped by a new object, are deleted or the clipper is * deleted. These operations will invalidate the list returned so it should * not be used anymore after that point. Any use of the list after this may have * undefined results, not limited just to strange behavior but possible * segfaults and other strange memory errors. The object @p obj must be a valid * object. * * See also evas_object_clip_set(), evas_object_clip_unset() and * evas_object_clip_get(). * * Example: * @code * extern Evas_Object *obj; * Evas_Object *clipper; * * clipper = evas_object_clip_get(obj); * if (clipper) * { * Eina_List *clippees, *l; * Evas_Object *obj_tmp; * * clippees = evas_object_clipees_get(clipper); * printf("Clipper clips %i objects\n", eina_list_count(clippees)); * EINA_LIST_FOREACH(clippees, l, obj_tmp) * evas_object_show(obj_tmp); * } * @endcode */ EAPI const Eina_List * evas_object_clipees_get(const Evas_Object *obj) { MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ); return NULL; MAGIC_CHECK_END(); return obj->clip.clipees; } /** * @} */