Rendering

These methods help to find out the size of text and images without inserting them into a document. The methods compute the size of text and pictures. The text or image is not inserted into the document.

Italic fonts are a bit higher than non-italic fonts. This is caused by the Windows System GDI. The consequence is, that italic text needs more height, which might result in clipped (not drawn) text, in case the height returned by a text-render method for a non-italic font is used for an italic font.

Remarks:

For framed objects (also FormFields with Bottom-Line / (Alt-)Subdivider) the center of the pen is used a sbasis for computations. For example if RenderWriteBox() returned as computed position / dimensions (1, 1, 2, 2) and the box of the text object has a PenSize (= frame thickness) of 1cm, then the true surrounding rectangle of the box has the coordinates (0.5, 0.5, 2.5, 2.5).
In order to compute the true outer borders you need to inflate the rectangle by ½ of the PenSize.

See also: "Important Note About Pens, Lines, Frames, Circles and Ellipses" in the Programmer's Manual.

Pictures:

Because parameters width and height can be of any value, you can for example compute the width of an undistorted image at a given height. In most cases you will set width = VFREE and height = VFREE (see "Pictures" in the Programmer's Manual).