This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

See also:

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

Fonts chapter of the Photon Programmer's Guide