PfFreeFont(), PfFreeFontCx()

Release resources associated with a font

Synopsis:

#include <photon/Pf.h>
long PfFreeFont( FontID *ptsID );

#include <font_api.h>
long PfFreeFontCx( struct _Pf_ctrl * context,
                   FontID * ptsID );

Arguments:

context: (PfFreeFontCx() only) A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
ptsID: A pointer to a font ID, as returned by PfFindFont() or PfFindFontCx().

Library:

PfFreeFont(): ph
PfFreeFontCx(): font

Description:

These functions release all resources bound to the font ID pointed to by ptsID.

Returns:

0L: Success.
-1L: An error occurred; errno is set.

Errors:

EFAULT: The ptsID argument is NULL.

Examples:

PfFreeFontCx(): See the examples for PfConvertFontIDCx(), PfGetGlyphIndexCx(), and PfRenderCx().

PfFreeFont(): See PfFindFont().

Classification:

Photon

PfFreeFont()

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

PfFreeFontCx()

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes

See also:

PfConvertFontID(), PfConvertFontIDCx(), PfDecomposeStemToID(), PfDecomposeStemToIDCx(), PfFindFont(), PfFindFontCx(), PfFontDescription(), PfFontDescriptionCx(), PfFontFlags(), PfFontFlagsCx(), PfFontSize(), PfFontSizeCx(), PfGenerateFontName(), PfGenerateFontNameCx(),

Fonts chapter of the Photon Programmer's Guide