#include <nnsys/g2d/g2d_TextCanvas.h>
void NNS_G2dTextCanvasDrawString(
const NNSG2dTextCanvas* pTxn,
int x,
int y,
int cl,
const NNSG2dChar* str,
const NNSG2dChar** pPos
);
pTxn | [IN] Pointer to TextCanvas |
x | [IN] Coordinate of reference point (in CharCanvas coordinate system) for text-string drawing |
y | [IN] Coordinate of reference point (in CharCanvas coordinate system) for text-string drawing |
cl | [IN] Standard color No. to use for text-string drawing |
str | [IN] Text string to draw |
pPos | [OUT] Pointer to buffer for getting the pointer to the start of the next line. (NULL can be specified) |
None.
Draws one line's worth of text, with the point (x, y) defining the upper left corner of the first text character. Specifically, it draws a text string from str to '\n' (0x0A) or '\0'.
If pPos is a non-NULL value, when '\n' is included in text string str, a pointer to the next character after the first '\n' is stored in the buffer indicated by pPos. Otherwise, NULL is stored in the buffer.
When a vertically written font is used, this function will draw a text string with the point given by (x, y) at the upper right corner of the first character.
// Draw overlapping half-lines
const int linefeed = NNS_G2dFontGetLineFeed(NNS_G2dTextCanvasGetFont(&tc)) / 2;
const char* str = "abcdefg\nghijk\nlmn";
int x = 0;
int y = 0;
while( str != NULL )
{
NNS_G2dTextCanvasDrawString(&tc, x, y, color, str, &str);
y += linefeed;
}
2007/03/14 Added support for vertically written/vertically held fonts.
2005/05/25 Initial version.
CONFIDENTIAL