dxmfindfontfallback(3x) [osf1 man page]

DXmFindFontFallback(3X) 												   DXmFindFontFallback(3X)

NAME

       DXmFindFontFallback - Associates the given XLFD font name with a new XLFD font name.

SYNOPSIS

       char *DXmFindFontFallback(
	       char *fontname );

PARAMETERS

       A pointer to the XLFD font name.

DESCRIPTION

       The  DXmFindFontFallback  routine associates the given XLFD (X Logical Font Description) font name with a new XLFD font name.  This routine
       does not load the generated font, nor guarantee that it will load successfully.	The application calling the  routine  is  responsible  for
       freeing the returned font name through the Intrinsic routine XtFree when the font name is no longer required.

RETURN VALUES

       A pointer to an XLFD font name string.

SEE ALSO

       DXmFindFontFallback(3X)

															   DXmFindFontFallback(3X)

XmFontListEntryLoad(library call)										 XmFontListEntryLoad(library call)

NAME

       XmFontListEntryLoad -- A font list function that loads a font or creates a font set and creates an accompanying font list entry

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontListEntry XmFontListEntryLoad(
       Display *display,
       char *font_name,
       XmFontType type,
       char *tag);

DESCRIPTION

       XmFontListEntryLoad  loads  a  font or creates a font set based on the value of the type argument. It creates and returns a font list entry
       that contains the font or font set and the specified tag.

       If the value of type is XmFONT_IS_FONT, the function uses the XtCvtStringToFontStruct routine to convert the value of font_name to  a  font
       struct.	 If  the value of type is XmFONT_IS_FONTSET, the function uses the XtCvtStringToFontSet converter to create a font set in the cur-
       rent locale.  XmFontListEntryLoad creates a font list entry that contains the font or font set derived from the converter.  For more infor-
       mation about XtCvtStringToFontStruct and XtCvtStringToFontSet, see X Toolkit Intrinsics--C Language Interface.

       display	 Specifies the display where the font list will be used.

       font_name Specifies an X Logical Font Description (XLFD) string, which is interpreted either as a font name or as a base font name list.  A
		 base font name list is a comma-separated and NULL-terminated string.

       type	 Specifies whether the font_name argument refers to a font name or to a base font name list.  Valid values are XmFONT_IS_FONT  and
		 XmFONT_IS_FONTSET.

       tag	 Specifies  the  tag  of  the font list entry to be created.  The tag may be specified as XmFONTLIST_DEFAULT_TAG, which is used to
		 identify the default font list element in a font list when specified as part of a resource.

RETURN

       If the specified font is not found, or if the specified font set cannot be created, then either	an  implementation-defined  font  will	be
       opened or a font set will be created, and a warning messge will be generated. If no suitable font can be found or a font set cannot be cre-
       ated, then another message will be generated and the function will return NULL; otherwise the function returns a font list entry.   If  the
       function  returns  a font list entry, the function allocates space to hold the font list entry. The application is responsible for managing
       the allocated space. The application can recover the allocated space by calling XmFontListEntryFree.

RELATED

       XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3), XmFontListEntryFree(3),  XmFontListEntryGetFont(3),  XmFontListEntryGet-
       Tag(3), and XmFontListRemoveEntry(3).

														 XmFontListEntryLoad(library call)