Web pages can render to any desired width, but in general have variable height. The WebRenderer Server Edition allows configuration of the size of generated images, but if necessary this size is dynamically increased (both horizontally and/or vertically) as required during the rendering process. For any given document, the wider the target image, the shorter the generated image will be - and conversely, the narrower the target image, the deeper the generated image.

If no size is otherwise specified, the WebRenderer Server Edition will use a default size of 800 pixels wide by 768 pixels deep.

If, during rendering of a page, the size of the image is increased dynamically, the portion of the page rendered up until the resizing will be rendered to the original width and/or depth, and the remainder is rendered to the new width/depth. This behaviour is consistent with how Industry Standard browsers render the same pages.

As pages are rendered, their dimensions are dynamically adjusted to best fit the contents to the page. It is not usually necessary or desirable to hardwire these dimensions. Thumbnails may be resized arbitrarially when generated.

If hardwired page sizing is required, the following function will preset the page size...

// Located in IBrowserCanvas
setSize(int width, int height)

The setSize method sets the dimensions of the render buffer for all subsequent rendering. Pages that exceed the dimensions of the render buffer will render with one or more scrollbars, as required. This size restriction is turned off by calling the function...

// Located in IBrowserCanvas
setMinimumWidth(int width)

Web page rendering typically renders pages to a minimum width (the width of the visible window) and to arbitrary depth. With a browser, you see your page formatted such that it fits the entire visible width and a vertical scroll bar is added as required to allow you to view the whole length of the page. WebRenderer Server Edition does not have a 'window' or screen to which it renders, but it does have the concept of a rendering width -- and this defaults to 800 pixels. Use the setMinimumWidth function to adjust this, and to disable the hardwired buffer size if setSize has been called.

Note: setSize and setMinimumWidth must be called before a page is loaded. If these methods are called after a page is loaded then the page must be reloaded for these settings to take affect.

 Copyright © JadeLiquid Software - www.jadeliquid.com