diff options
author | Michael Drake <tlsa@netsurf-browser.org> | 2011-02-11 10:55:46 +0000 |
---|---|---|
committer | Michael Drake <tlsa@netsurf-browser.org> | 2011-02-11 10:55:46 +0000 |
commit | 81f6f2552c2bce419f11736195d810201b6fb70e (patch) | |
tree | 0a6b7cf6c122e18242c20a3f34a1fd24883b7da6 /content/content.c | |
parent | 18a4d2deec2dc839c90fe4c0fa65f438be3437f7 (diff) | |
download | netsurf-81f6f2552c2bce419f11736195d810201b6fb70e.tar.gz netsurf-81f6f2552c2bce419f11736195d810201b6fb70e.tar.bz2 |
Better documentation of content_redraw
svn path=/trunk/netsurf/; revision=11645
Diffstat (limited to 'content/content.c')
-rw-r--r-- | content/content.c | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/content/content.c b/content/content.c index e314e2314..99102fb1c 100644 --- a/content/content.c +++ b/content/content.c @@ -877,8 +877,8 @@ void content_request_redraw(struct hlcache_handle *h, * \param h content * \param x coordinate for top-left of redraw * \param y coordinate for top-left of redraw - * \param width available width (not used for HTML redraw) - * \param height available height (not used for HTML redraw) + * \param width render width (not used for HTML redraw) + * \param height render height (not used for HTML redraw) * \param clip_x0 clip rectangle left * \param clip_y0 clip rectangle top * \param clip_x1 clip rectangle right @@ -892,6 +892,17 @@ void content_request_redraw(struct hlcache_handle *h, * The top left corner of the clip rectangle is (clip_x0, clip_y0) and * the bottom right corner of the clip rectangle is (clip_x1, clip_y1). * Units for x, y and clip_* are pixels. + * + * Content scaling is handled differently for contents with and without + * intrinsic dimensions. + * + * Content without intrinsic dimensions, e.g. HTML: + * The scale value is applied (the content having been reformatted + * appropriately beforehand). The width and height are not used. + * + * Content with intrinsic dimensions, e.g. images: + * The scale value is not used. The content is scaled from its own + * intrinsic dimensions to the passed render width and height. */ bool content_redraw(hlcache_handle *h, int x, int y, |