TAP_Osd_PutS

Topfield Documentation

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

It prints the string on the screen.

• 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
• bDot : It decides to print '...' in case that the string is over the maxX.
• align : align method. ALIGN_LEFT, ALIGN_CENTER or ALIGN_RIGHT

Additional Documentation

The 'align' affects only if the string area (maxX - x) is greater than the width of the string.

EMJB: If (maxX - x) is less than the (first) character width nothing at all is displayed - not even part of the character nor the relevant background. Thus if you set maxX = x + 12 with the medium sized font most characters will appear, but not Q, M, or m.