DrawChar

Draws a text character to the display window.

Synopsis

Err DrawChar (GrafCon *gcon,Item bitmapItem,uint32 character)

Description

This call plots the specified text character to the window of the display. The pen position in the GrafCon is updated based on the width or height of the rendered character.

The fonts flag, FONT_VERTICAL, controls whether the height or width of the rendered character is modified. If the current FONT_VERTICAL fonts flag is set, then the height is modified; if the flag is clear, then the width is modified.

Arguments

gcon: A pointer to a GrafCon structure for pen position information.

bitmapItem: An item number for the bitmap to receive the rendering.

character: The text character to be printed to the display's window. The character argument is an unsigned 32-bit to allow for international character sets.

Return Value

The call returns 0 if successful or an error code (a negative value) if an error occurs.

Implementation

Folio call implemented in Graphics folio V20.

Associated Files

graphics.h, graphics.lib