DL Logo

PDEFont Functions

PDEFontCheckASTextIsRepresentable

Header: DLExtrasProcs.h:340

Description

Routine to check that the entire contents of an ASText are representable in the font. If the index parameter is not NULL and this function returns FALSE, the index will indicate the first character not representable in the font.

An exception will be raised if the supplied font is incompatible with the API. Such may happen, for example, if font is a Type 1 font or if the font is retrieved from an existing PDF document.

Syntax

ASBool PDEFontCheckASTextIsRepresentable(const PDEFont font, const ASText text, ASUns32 *index);

Parameters

font
The PDEFont to check against. Its type must be 'Type0' or 'TrueType'.
text
An ASText containing the text to check
index
The index of the first character in the Unicode representation of the string that could not be represented in the font. May be NULL if the user wants to ignore this information.

Returns

Whether the ASText is representable or not using the font.