PfDynamicUnload(), PfDynamicUnloadCx()

Unload a dynamically loaded font

Synopsis:

#include <photon/Pf.h>
long PfDynamicUnload( long lDynamicFontID );

#include <font_api.h>
long PfDynamicUnloadCx( struct _Pf_ctrl * context,
                        long lDynamicFontID );

Arguments:

context
(PfDynamicUnloadCx() only) A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
lDynamicFontID
The font ID, returned by PfDynamicLoad(), of the font that you want to unload.

Library:

PfDynamicUnload()
ph
PfDynamicUnloadCx()
font

Description:

This function unloads a dynamically loaded font.

Returns:

0L on success, or -1L if an error occurred (errno is set).

Errors:

PfDynamicUnload():

ESRCH
The function couldn't locate the given dynamic font ID or font file entry.
EBADF
An error occurred when attempting to close and remove the font file from the affected library.
ENOMEM
Not enough memory was available to proceed with the unload.
EINVAL
An invalid condition was encountered, possibly due to an invalid font file.

PfDynamicUnloadCx():

ERANGE
Provided ID is less than zero.
EBADF
Connection has gone stale, or a device error occurred.
ENETUNREACH
Bad message buffer.
ELIBACC
Unable to locate render plugin for specified font.
ESRCH
Unable to locate render plugin type for specified id.

Examples:

PfDynamicUnload(): See PfDynamicLoad().

PfDynamicUnloadCx(): See the example for PfDynamicLoadCx().

Classification:

Photon

PfDynamicUnload()

Safety:
Interrupt handler No
Signal handler No
Thread No

PfDynamicUnloadCx()

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

PfDynamicLoad(), PfDynamicLoadCx()

Fonts chapter of the Photon Programmer's Guide