1/*
2    Copyright (C) 2009-2010 Samsung Electronics
3    Copyright (C) 2009-2010 ProFUSION embedded systems
4
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.
9
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.
14
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.
19*/
20
21#ifndef ewk_tiled_backing_store_h
22#define ewk_tiled_backing_store_h
23
24#include "EWebKit.h"
25
26/* Enable accounting of render time in tile statistics */
27// #define TILE_STATS_ACCOUNT_RENDER_TIME
28
29
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
33 */
34#define DEBUG_MEM_LEAKS 1
35
36#define TILE_W (256)
37#define TILE_H (256)
38
39#define ZOOM_STEP_MIN (0.01)
40
41#define TILE_SIZE_AT_ZOOM(SIZE, ZOOM) ((int)roundf((SIZE) * (ZOOM)))
42#define TILE_W_ZOOM_AT_SIZE(SIZE) ((float)SIZE / (float)TILE_W)
43#define TILE_H_ZOOM_AT_SIZE(SIZE) ((float)SIZE / (float)TILE_H)
44
45#ifdef __cplusplus
46extern "C" {
47#endif
48
49#include <Evas.h>
50#include <cairo.h>
51
52typedef struct _Ewk_Tile                     Ewk_Tile;
53typedef struct _Ewk_Tile_Stats               Ewk_Tile_Stats;
54typedef struct _Ewk_Tile_Matrix              Ewk_Tile_Matrix;
55
56struct _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 */
60#endif
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.
64                              */
65    Eina_Bool full_update:1; /**< tile requires full size update */
66};
67
68struct _Ewk_Tile {
69    EINA_INLIST;            /**< sibling tiles at same (i, j) but other zoom */
70    Eina_Tiler *updates;    /**< updated/dirty areas */
71    Ewk_Tile_Stats stats;       /**< tile usage statistics */
72    unsigned long col, row; /**< tile tile position */
73    Evas_Coord x, y;        /**< tile coordinate position */
74
75    /* TODO: does it worth to keep those or create on demand? */
76    cairo_surface_t *surface;
77    cairo_t *cairo;
78
79    /** Never ever change those after tile is created (respect const!) */
80    const Evas_Coord w, h;        /**< tile size (see TILE_SIZE_AT_ZOOM()) */
81    const Evas_Colorspace cspace; /**< colorspace */
82    const float zoom;             /**< zoom level contents were rendered at */
83    const size_t bytes;           /**< bytes used in pixels. keep
84                                   * before pixels to guarantee
85                                   * alignement!
86                                   */
87    int visible;                  /**< visibility counter of this tile */
88    Evas_Object *image;           /**< Evas Image, the tile to be rendered */
89    uint8_t *pixels;
90};
91
92#include "ewk_tiled_matrix.h"
93#include "ewk_tiled_model.h"
94
95/* view */
96EAPI Evas_Object *ewk_tiled_backing_store_add(Evas *e);
97
98EAPI 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
100EAPI Eina_Bool    ewk_tiled_backing_store_scroll_full_offset_set(Evas_Object *o, Evas_Coord x, Evas_Coord y);
101EAPI Eina_Bool    ewk_tiled_backing_store_scroll_full_offset_add(Evas_Object *o, Evas_Coord dx, Evas_Coord dy);
102EAPI 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
104EAPI 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);
105EAPI Eina_Bool    ewk_tiled_backing_store_zoom_weak_set(Evas_Object *o, float zoom, Evas_Coord cx, Evas_Coord cy);
106EAPI void ewk_tiled_backing_store_fix_offsets(Evas_Object *o, Evas_Coord w, Evas_Coord h);
107EAPI void ewk_tiled_backing_store_zoom_weak_smooth_scale_set(Evas_Object *o, Eina_Bool smooth_scale);
108EAPI Eina_Bool    ewk_tiled_backing_store_update(Evas_Object *o, const Eina_Rectangle *update);
109EAPI void ewk_tiled_backing_store_updates_process_pre_set(Evas_Object *o, void *(*cb)(void *data, Evas_Object *o), const void *data);
110EAPI 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);
111EAPI void ewk_tiled_backing_store_process_entire_queue_set(Evas_Object *o, Eina_Bool value);
112EAPI void ewk_tiled_backing_store_updates_process(Evas_Object *o);
113EAPI void ewk_tiled_backing_store_updates_clear(Evas_Object *o);
114EAPI void ewk_tiled_backing_store_contents_resize(Evas_Object *o, Evas_Coord width, Evas_Coord height);
115EAPI void ewk_tiled_backing_store_disabled_update_set(Evas_Object *o, Eina_Bool value);
116EAPI void ewk_tiled_backing_store_flush(Evas_Object *o);
117EAPI void ewk_tiled_backing_store_enable_scale_set(Evas_Object *o, Eina_Bool value);
118
119EAPI Ewk_Tile_Unused_Cache *ewk_tiled_backing_store_tile_unused_cache_get(const Evas_Object *o);
120EAPI void                   ewk_tiled_backing_store_tile_unused_cache_set(Evas_Object *o, Ewk_Tile_Unused_Cache *tuc);
121
122EAPI 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);
123EAPI Eina_Bool ewk_tiled_backing_store_pre_render_relative_radius(Evas_Object *o, unsigned int n, float zoom);
124EAPI void ewk_tiled_backing_store_pre_render_cancel(Evas_Object *o);
125
126EAPI Eina_Bool ewk_tiled_backing_store_disable_render(Evas_Object *o);
127EAPI Eina_Bool ewk_tiled_backing_store_enable_render(Evas_Object *o);
128#ifdef __cplusplus
129}
130#endif
131#endif // ewk_tiled_backing_store_h
132