Set active font DLL context options
#include <font_api.h>
int PfSetOptionsDll( fontdll_t dll,
char const * options,
char const * schema );
- 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.
- 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.
font
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.
- 0
- Success
- -1
- An error occurred (errno is
set).
- EINVAL
- Invalid options.
- ENOMEM
- Insufficient resources to process options.
See the example for PfAllocRenderCx().
Photon
Safety: | |
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
No |
Thread |
Yes |
PfAttachLocalDll()
The Fonts chapter
of the Photon Programmer's Guide