THPDFPage.UnicodeTextOut

THPDFPage

Shows text represented by a Unicode string or buffer.

This procedure is retained for backward compatibility and shares the current TextOut font pipeline. Use it when existing code already passes WideString or UTF-16 buffers.

Delphi syntax:

procedure UnicodeTextOut( X, Y: Single; Angle: Extended; Text: PWORD; TextLength: Integer ); overload;

procedure UnicodeTextOut( X, Y: Single; Angle: Extended; Text: WideString ); overload;

Description:

This procedure prints a text line represented by a Unicode buffer ( Text: PWORD, TextLength: Integer ) or Unicode string ( Text: WideString ) from point X, Y using orientation Angle in degrees.

For embedded Unicode fonts, HotPDF now refreshes glyph state when the font changes, resolves glyph IDs from the active Windows font, and writes matching ToUnicode data for the generated PDF. This improves cross-viewer rendering for embedded fonts such as Calibri.

Demo\Delphi\FontTest provides a practical comparison sample for TextOut and embedded font validation.

HPDF.FontEmbedding := true;
HPDF.StandardFontEmulation := false;
HPDF.CurrentPage.SetFont( 'Arial Unicode MS', [], 12, 0, False );
HPDF.CurrentPage.UnicodeTextOut( 40, 100, 0, WideString('Unicode output sample') );