draw-text-file

Function

Package: common-graphics

Arguments: stream pathname-or-string &key font left-margin-in-pixels right-margin-in-pixels newline-spacing-in-lines just-return-text-height-p

Draws the contents of the text file identified by pathname-string onto stream, which is typically a graphical window. Drawing begins at the current y position indented left-margin-in-pixels. The total pixel height of the drawn text is returned.

Font specifies the font to use to write the text. Defaults to the font of stream.

Left-margin-in-pixels, measured from the left margin, and right-margin-in-pixels, measured from the right margin, bound the drawing of the string. Both default to 0. Note again that the arguments add space in addition to the current margins of stream.

If newline-spacing-in-lines is specified, it should indicate the number of lines to skip when an explicit newline appears in string. The appearance will then differentiate between newlines caused by wrapping and those caused by explicit newlines. The value can be a floating-point number. Defaults to 0.5.

If just-return-text-height-p is specified true, no drawing is done but the height needed for the drawing is calculated and returned.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.