TAP_Osd_PutString

Topfield Documentation

int TAP_Osd_PutString(word rgn, dword x, dword y, dword maxX, const char *str, word fcolor, word bcolor, byte fntType, byte fntSize, byte nextLine);

It prints the string on the screen. This function is used to display the special characters.

• maxX : the maximum value in X coordinate of output area. width = maxX - X + 1
• fcolor : character color. If 0xff, it will be transparent.
• bcolor : background color. If 0xff, it will be transparent.
• fntType : font type. It SHOULD be 0.
• fntSize : font size. FNT_Size_1419, FNT_Size_1622 or FNT_Size_1926
• nextLine : It decides to print the new line character('\n').

Additional Documentation

The nextLine parameter, if set to 1, should interpret newline characters in the string as a break in the line, and render the remaining text on a new line. However, if doesn't responsd to them at all. It uses the hexadecimal character 0x8A (or octal 212) as a line break. Even then, it doesn't provide enough of a "line feed", so you need to use two. Example of the kind of string you need to pass :-

sprintf (buffer, "This is one line\212This one overlaps it" );

sprintf (buffer, "This is one line\212\212This is below it" );

sprintf (buffer, "Or split it this way%c%cInto two lines", 0x8A, 0x8A);