PfFontTypeCx()

Retrieve the font type description

Synopsis:

#include <font_api.h>
int PfFontTypeCx( struct _Pf_ctrl * context,
                  char const * font,
                  char * pcBuffer,
                  int iBufferLen );

Arguments:

context
A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
font
A string that contains the base font stem. You should create this argument by calling PfGenerateFontNameCx().
pcBuffer
A pointer to a buffer in which the function can store the font type.
iBufferLen
Length, in bytes, of pcBuffer.

Library:

font

Description:

This function retrieves a string from the font server describing what type of font technology is used to process the provided font. For example, Adobe Type 1, TrueType/T2K, and Bitstream(FFS).

Returns:

0
Success
-1
An error occurred (errno is set).

Errors:

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.
ENOENT
Unable to locate suitable base font entry.
EINVAL
Failure to load resources for specified font.
ENOMEM
Insufficient memory to allocate scaling resources.
EFAULT
Provided font, or buffer is NULL, or buffer len is <= zero.
EFAULT
Unable to locate satisfactory base font.
EINVAL
Render plugin unable to satisfy request.

Classification:

Photon

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

See also:

PfAttachCx(), PfAttachDllCx(), PfGenerateFontNameCx().

Fonts chapter of the Photon Programmer's Guide