---

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

Safety:
Interrupt handler	No
Signal handler	No
Thread	No

See also:

PfDynamicLoad(), PfDynamicLoadCx()

Fonts chapter of the Photon Programmer's Guide

---