CanvasDrawText

CanvasDrawText( canvas, text, x, y, font, fontSize, color, bold, italic, hAlign, vAlign )

Draws text on a canvas.

• «canvas» is a canvas obtained from calling the Canvas() function, or a canvas context obtained by calling the CanvasContext() function.
• «text» is the text to draw.
• «x», «y»: The location where the text will display.
• «font»: (optional) the textual TrueType font name, such as 'Arial', 'Comic Sans MS', 'Times New Roman'.
• «color»: (Optional) Either a textual color name or a color integer. See Color parameters for an enumeration of textual color names and a description of color integers. Defaults to 'Black'.
• «bold», «italic»: (Optional) When true, the text is draw in bold or italic font respectively.
• «hAlign»: (Optional) Horizontal alignment relative to «x», either 'Left', 'Center' or 'Right'. Default is 'Left'.
• «vAlign»: (Optional) Vertical alignment relative to «y», either 'Top', 'Middle' or 'Bottom'. Default is 'Top'.
• «measureOnly»: (Optional) When true, text is not drawn. Use this to measure the bounding box without actually drawing.

When drawn to a context where the coordinate frame as been scaled, the text (and the interpretation of «fontSize» is scaled as well. When the x- and y-axes are scaled differently, the text will be squashed or stretched. When one logical unit along x corresponds to two device pixels, then text will be twice as wide as it would be if rendered at the same «fontSize» without scaling.

Return value

New to Analytica 5.2

{{{3}}}

See also

• Drawing images
• Canvas
• CanvasContext
• CanvasDrawLine, CanvasDrawRectangle, CanvasDrawEllipse, CanvasDrawImage, CanvasDrawPolygon