7.7. tsCharOutW

Syntax

Pascal

procedure tsCharOutW(CharCode: WideChar);

C/C++

void tsCharOutW(WideChar CharCode);

Description

This function simple draws an single char. You can use this to print text by yourself. In combination with this function you may need the function tsFontGetCharParameter to query some informations of the chars. Like advance, baseline, glyph position or something else.

[Note] Note

Notice. If you print text by yourself it's highly possible that it will be slower than if you are using functions like tsTextOut.

Parameters

CharCode

This is charcode of the char you want to draw.

Error Codes

TS_NO_ACTIVE_CONTEXT

There is no active context. See also tsContextBind.

TS_NO_ACTIVE_RENDERER

There was no renderer set. See the parameter TS_RENDERER.

TS_NO_ACTIVE_FONT

There was no font bound to the actual context. See also tsFontBind.

TS_INVALID_OPERATION

It isn't possible to call this function inside the blockmode. You only cann call it outside.

TS_INVALID_VALUE

You have passed an charcode from an not existing char to this function. Before you are able to draw char you must create it with tsFontAddChar.