Xojo Conferences

DynaPDF Manual - Page 177

Previous Page 176   Index   Next Page 178

Function Reference
Page 177 of 766
We can assume that it doesn't make sense to create dozens of fonts due to the idiotic definition of the
Type3 font format. This function creates exactly one Type3 counterpart for a standard font with the
graphics state parameters when the font is first used. If the font will be used with another draw
mode later then the function returns immediatly with an error and no PDF file will be produced.
If a stroked version of a font was created then it does not check whether the line cap style, line join
style, line dash pattern or line width will be changed if the font is used with the same text draw
mode later.
PDF/A conversion and normalization with enabled font embedding depends strongly on the
availability of fonts. The ability to convert standard fonts to Type3 was mainly added for the font
ZapfDingbats because this font is not available on most systems.
Return values
If the PDF file is compatible to PDF/A 1b the function returns one of the following values:
0 -> The PDF file is fully compatible to PDF/A 1b. Close the file with CloseFile(), finished.
1 -> A RGB ICC profile must be added to the document with AddOutputIntent().
2 -> A CMYK ICC profile must be added to the document with AddOutputIntent().
3 -> A Gray, RGB, or CMYK ICC profile must be added to the document with
AddOutputIntent() or AddOutputIntentEx(). DeviceGray compatible ICC profiles are rarely
available since this is mostly just a gamma table. However, you can use a RGB or CMYK
profile instead (a sRGB profile is preferred due to the smaller size).
< 0 -> A negative return value indicates that an error occurred during conversion to PDF/A.
Note that the function raises always fatal exceptions, there is no PDF file in memory if the
conversion fails.
The return value of the function must not be ignored. If a required ICC profile will not be added to
the file, the resulting PDF file will not be compatible to PDF/A! The PDF file must be closed with
CloseFile(). The usage of CloseFileEx() is prohibited because PDF/A files must not be encrypted.
CheckConformance() can be called after the entire document was fully created. You must not call the
function multiple times on the same document in memory!

Previous topic: Type3 font conversion

Next topic: CheckFieldNames