summaryrefslogtreecommitdiff
path: root/content/content.c
diff options
context:
space:
mode:
authorMichael Drake <tlsa@netsurf-browser.org>2011-02-11 10:55:46 +0000
committerMichael Drake <tlsa@netsurf-browser.org>2011-02-11 10:55:46 +0000
commit81f6f2552c2bce419f11736195d810201b6fb70e (patch)
tree0a6b7cf6c122e18242c20a3f34a1fd24883b7da6 /content/content.c
parent18a4d2deec2dc839c90fe4c0fa65f438be3437f7 (diff)
downloadnetsurf-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.c15
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,