2 Copyright (C) 2009-2010 Samsung Electronics
3 Copyright (C) 2009-2010 ProFUSION embedded systems
5 This library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Library General Public
7 License as published by the Free Software Foundation; either
8 version 2 of the License, or (at your option) any later version.
10 This library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Library General Public License for more details.
15 You should have received a copy of the GNU Library General Public License
16 along with this library; see the file COPYING.LIB. If not, write to
17 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
21 #ifndef ewk_tiled_backing_store_h
22 #define ewk_tiled_backing_store_h
26 /* Enable accounting of render time in tile statistics */
27 // #define TILE_STATS_ACCOUNT_RENDER_TIME
30 /* If define ewk will do more accounting to check for memory leaks
31 * try "kill -USR1 $PID" to get instantaneous debug
32 * try "kill -USR2 $PID" to get instantaneous debug and force flush of cache
34 #undef DEBUG_MEM_LEAKS
36 #define DEFAULT_TILE_W (256)
37 #define DEFAULT_TILE_H (256)
39 #define ZOOM_STEP_MIN (0.01)
41 #define TILE_SIZE_AT_ZOOM(SIZE, ZOOM) ((int)roundf((SIZE) * (ZOOM)))
42 #define TILE_ZOOM_AT_SIZE(SIZE, ORIG_TILE) ((float)(SIZE) / (float)(ORIG_TILE))
43 #define ROUNDED_ZOOM(SIZE, ZOOM) ((float)(SIZE) / (float)(((int)roundf((SIZE) / (ZOOM)))))
52 typedef struct _Ewk_Tile Ewk_Tile;
53 typedef struct _Ewk_Tile_Stats Ewk_Tile_Stats;
54 typedef struct _Ewk_Tile_Matrix Ewk_Tile_Matrix;
56 struct _Ewk_Tile_Stats {
57 double last_used; /**< time of last use */
58 #ifdef TILE_STATS_ACCOUNT_RENDER_TIME
59 double render_time; /**< amount of time this tile took to render */
61 unsigned int area; /**< cache for (w * h) */
62 unsigned int misses; /**< number of times it became dirty but not
63 * repainted at all since it was not visible.
65 Eina_Bool full_update:1; /**< tile requires full size update */
69 Eina_Tiler *updates; /**< updated/dirty areas */
70 Ewk_Tile_Stats stats; /**< tile usage statistics */
71 unsigned long col, row; /**< tile tile position */
72 Evas_Coord x, y; /**< tile coordinate position */
74 /* TODO: does it worth to keep those or create on demand? */
75 cairo_surface_t *surface;
78 /** Never ever change those after tile is created (respect const!) */
79 const Evas_Coord w, h; /**< tile size (see TILE_SIZE_AT_ZOOM()) */
80 const Evas_Colorspace cspace; /**< colorspace */
81 const float zoom; /**< zoom level contents were rendered at */
82 const size_t bytes; /**< bytes used in pixels. keep
83 * before pixels to guarantee
86 int visible; /**< visibility counter of this tile */
87 Evas_Object *image; /**< Evas Image, the tile to be rendered */
91 #include "ewk_tiled_matrix.h"
92 #include "ewk_tiled_model.h"
95 Evas_Object *ewk_tiled_backing_store_add(Evas *e);
97 void ewk_tiled_backing_store_render_cb_set(Evas_Object *o, Eina_Bool (*cb)(void *data, Ewk_Tile *t, const Eina_Rectangle *area), const void *data);
99 Eina_Bool ewk_tiled_backing_store_scroll_full_offset_set(Evas_Object *o, Evas_Coord x, Evas_Coord y);
100 Eina_Bool ewk_tiled_backing_store_scroll_full_offset_add(Evas_Object *o, Evas_Coord dx, Evas_Coord dy);
101 Eina_Bool ewk_tiled_backing_store_scroll_inner_offset_add(Evas_Object *o, Evas_Coord dx, Evas_Coord dy, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h);
103 Eina_Bool ewk_tiled_backing_store_zoom_set(Evas_Object *o, float *zoom, Evas_Coord cx, Evas_Coord cy, Evas_Coord *offx, Evas_Coord *offy);
104 Eina_Bool ewk_tiled_backing_store_zoom_weak_set(Evas_Object *o, float zoom, Evas_Coord cx, Evas_Coord cy);
105 void ewk_tiled_backing_store_fix_offsets(Evas_Object *o, Evas_Coord w, Evas_Coord h);
106 void ewk_tiled_backing_store_zoom_weak_smooth_scale_set(Evas_Object *o, Eina_Bool smooth_scale);
107 Eina_Bool ewk_tiled_backing_store_update(Evas_Object *o, const Eina_Rectangle *update);
108 void ewk_tiled_backing_store_updates_process_pre_set(Evas_Object *o, void *(*cb)(void *data, Evas_Object *o), const void *data);
109 void ewk_tiled_backing_store_updates_process_post_set(Evas_Object *o, void *(*cb)(void *data, void *pre_data, Evas_Object *o), const void *data);
110 void ewk_tiled_backing_store_updates_process(Evas_Object *o);
111 void ewk_tiled_backing_store_updates_clear(Evas_Object *o);
112 void ewk_tiled_backing_store_contents_resize(Evas_Object *o, Evas_Coord width, Evas_Coord height);
113 void ewk_tiled_backing_store_disabled_update_set(Evas_Object *o, Eina_Bool value);
114 void ewk_tiled_backing_store_flush(Evas_Object *o);
115 void ewk_tiled_backing_store_enable_scale_set(Evas_Object *o, Eina_Bool value);
117 Ewk_Tile_Unused_Cache *ewk_tiled_backing_store_tile_unused_cache_get(const Evas_Object *o);
118 void ewk_tiled_backing_store_tile_unused_cache_set(Evas_Object *o, Ewk_Tile_Unused_Cache *tuc);
120 Eina_Bool ewk_tiled_backing_store_pre_render_region(Evas_Object *o, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, float zoom);
121 Eina_Bool ewk_tiled_backing_store_pre_render_relative_radius(Evas_Object *o, unsigned int n, float zoom);
122 void ewk_tiled_backing_store_pre_render_cancel(Evas_Object *o);
124 Eina_Bool ewk_tiled_backing_store_disable_render(Evas_Object *o);
125 Eina_Bool ewk_tiled_backing_store_enable_render(Evas_Object *o);
129 #endif // ewk_tiled_backing_store_h