[Previous] [Contents] [Index] [Next]

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

PfSetOptionsDll()

Set active font DLL context options

Synopsis:

#include <font_api.h>
int PfSetOptionsDll( fontdll_t dll,
                     char const * options,
                     char const * schema );

Arguments:

dll
A font DLL context, returned by PfAttachLocalDll().
options
A pointer to a string that contains the options you want to set for the font DLL. The options must be separated by commas, for example, -A,-d=/usr/photon/font_repository. This string may be NULL.
schema
The name of a schema, a configuration file used to override the default settings for a local font server. A schema file is created using the fontadmin utility.
Use the DLL_FONT_SERVER schema for processes that need to allocate sufficient resources to act as a default font server. This schema loads a local server instance that can be used as an external server by other applications (that is, it appears in /def/phfont). Use NULL to load a local server instance that cannot be used by other applications.
The string referenced by schema may not exceed DLL_MAX_OPTION_NAME bytes, including the terminating NULL.

Library:

font

Description:

This function applies options to an instantiated DLL context. Since this font instance is active, all options changes may not be permitted. Legal options are identical to those support by the font server. Some options may not be relevant to a DLL instance of the font server. If this function is invoked on a DLL context, with an active font instance, it is up to the font instance as to whether or not an option should be applied.

Returns:

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

Errors:

EINVAL
Invalid options.
ENOMEM
Insufficient resources to process options.

Examples:

See the example for PfAllocRenderCx().

Classification:

Photon

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

See also:

PfAttachLocalDll(), fontadmin.

Fonts chapter of the Photon Programmer's Guide


[Previous] [Contents] [Index] [Next]