PfDynamicFontIDCx()

Retrieve a dynamic font ID

Synopsis:

#include <font_api.h>
long PfDynamicFontIDCx( struct _Pf_ctrl * context,
                        char const * path );

Arguments:

context: A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
path: The full path and font name for the font file from which to locate the dynamic ID.

Library:

font

Description:

This function retrieves the assigned dynamic load ID for the given font file, if it has been loaded by PfDynamicLoadCx().

Returns:

A dynamic font ID: Success
-1: Failure

Errors:

EFAULT: Font context or path is NULL.
ESRCH: Unable to locate device.
EBADF: Connection has gone stale, or device error occurred.
ENETUNREACH: Bad message buffer.
ELIBACC: Unable to locate render plugin for specified font.
ENOTSUP: Provided font file is not supported by any render plugin.
EPERM: Permission denied to process request.

Examples:

See the example for PfDynamicLoadCx().

Classification:

Photon

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes

See also:

PfAttachCx(), PfAttachDllCx(), PfDynamicLoadCx().

Fonts chapter of the Photon Programmer's Guide