DLI Implementation and Reference Guide - Datalogics

Multibyte Text Work 5.5
Creating DLPDFTEXT Areas
A DLPDFTEXT area is a container for multibyte and Unicode text. Text is placed into
the container using the dlpdftext function (or one of the shortcut functions)
described below. This text is converted into Unicode, in UTF-16 format, stored in
host-endian byte order (little-endian for the Win32 and Intel/Linux platforms, bigendian
elsewhere), and automatically shaped and processed through the Unicode
BiDirectional (BiDi) algorithm. This text may then be placed into a DLPDFCONTENT
area for output.
dlpdftext
The dlpdftext method is used to create a DLPDFTEXT area from a buffer of text in a
given encoding.
DLPDFTEXT *dlpdftext(void *, ASUns32, ASAtom)
• The first parameter is passed in as a pointer to a data buffer.
• The second parameter is the number of bytes in this buffer.
• The third parameter is the encoding of the supplied text. An exception will be
raised for invalid parameters, or if the text could not be properly converted from
the input encoding to the platform-endian Unicode representation.
dlpdftextshowencodingnames
There are over 1200 encodings and encoding aliases that may be used as input
encodings, corresponding to the format of the input text for a DLPDFTEXT area. To