DynaPDF Manual - Page 818

Previous Page 817   Index   Next Page 819

Function Reference
Page 818 of 839
UnLockLayer
Syntax:
LBOOL pdfUnLockLayer(
const PPDF* IPDF, // Instance pointer
UI32 Layer)
// Handle of an OCG
The function removes a layer from the list of locked layers. See also LockLayer() for further
information.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
UTF16ToUTF32
Syntax:
UI32* pdfUTF16ToUTF32(
const PPDF* IPDF,
// Instance pointer
const UI16* Source) // Null-terminated UTF-16 Unicode string
The function converts a UTF-16 Unicode string to UTF-32. UTF-32 is the default Unicode format on
Linux and UNIX operating systems. The input string must be defined in the CPU's byte ordering
(little-endian on a little-endian machine and big-endian on a big-endian machine), the output string
is also returned in the CPU's byte ordering.
The return value is a pointer to the original conversion buffer; it must not be freed or changed. The
function can be called multiple times without causing a memory leak. However, if the conversion
buffer is no longer needed it can be released with the function FreeUniBuf(). The buffer is
automatically released when CloseFile() or FreePDF() is called.
The function requires no open PDF file; it can be used at any time. Invalid character sequences are
skipped by the algorithm, they do not break conversion.
Return values:
If the function succeeds the return value is a pointer to the converted UTF-32 Unicode string. If the
function fails the return value is NULL. The only possible error during conversion is out of memory.
UTF16ToUTF32Ex
UI32* pdfUTF16ToUTF32Ex(
const PPDF* IPDF,
// Instance pointer
const UI16* Source, // UTF-16 Unicode string
UI32 ADDR Len)
// String length in characters
The function converts a UTF-16 Unicode string to UTF-32. UTF-32 is the default Unicode format on
Linux and UNIX operating systems. The input string must be defined in the CPU's byte ordering
(little-endian on a little-endian machine and big-endian on a big-endian machine), the output string
is also returned in the CPU's byte ordering.
 

Previous topic: Triangle

Next topic: UTF32ToUTF16