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

See also:

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

Fonts chapter of the Photon Programmer's Guide