From 81f6f2552c2bce419f11736195d810201b6fb70e Mon Sep 17 00:00:00 2001 From: Michael Drake Date: Fri, 11 Feb 2011 10:55:46 +0000 Subject: Better documentation of content_redraw svn path=/trunk/netsurf/; revision=11645 --- content/content.c | 15 +++++++++++++-- 1 file 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, -- cgit v1.2.3