vbmDrawTextO

vbmDrawTextO( [address-text], [address-chars], [byte-x], [byte-y], [byte-lineheight]);

• [address-text] - address of a CSTRING, the message to display
• [address-chars] - address of the characterset to use for the font
• [byte-x] - X column (0-19) to display the message
• [byte-y] - Y line (0-183) to display the message
• [byte-lineheight] - Line spacing when text wraps

Description

Draws a text message to the bitmap using the given font. Text will wrap around when the end of a line is reached and move down by the number of pixels specified by the line height parameter. The character font will merge with the bitmap.

There are four ways to draw text:

• vbmDrawText - draws the text message, replacing the pixels at the current position on the bitmap
• vbmDrawTextO - draws the text message and merges it over the current pixels on the bitmap
• vbmDrawTextE - draws the text message and merges it using the EOR operation with the bitmap
• vbmClearText - clears, or 'cuts out' the text message from the pixels on the bitmap

Example

font: incbin("font8x8.bin", $4000); // first 64 PETSCII Screen Codes ... message: cstring = "HELLO WORLD - IN CAPS"; ... // draw text at column 2, line 10 (pixels) with a line height of 14 vbmDrawTextO( message, font, 2, 10, 14 );

See also

• vbmDrawBCD