XFT(3)                                                     XFT(3)



NAME
        Xft - X FreeType interface library


DESCRIPTION
       Xft is a simple library designed to interface the FreeType
       rasterizer with the X Rendering  Extension.   This  manual
       page barely scratches the surface of this library.


DATATYPES
       XftPattern  holds  a  set  of  names with associated value
       lists; each name refers to a property of a font.   XftPat-
       terns  are  used as inputs to the matching code as well as
       holding information about specific fonts.

       XftFont contains general font metrics  and  a  pointer  to
       either  the  core  XFontStruct data or a structure holding
       FreeType and X Render Extension data.

       XftFontStruct contains information  about  FreeType  fonts
       used with the X Render Extension.

       XftFontSet contains a list of XftPatterns.  Internally Xft
       uses this data structure to hold sets  of  fonts.   Exter-
       nally,  Xft  returns  the results of listing fonts in this
       format.

       XftObjectSet holds a set of names and is used  to  specify
       which  fields  from  fonts  are  placed in the the list of
       returned patterns when listing fonts.

       XftDraw is an opaque object which holds  information  used
       to  render  to an X drawable using either core protocol or
       the X Rendering extension.


FUNCTIONS
       XftFont *
       XftFontOpen (Display *dpy, int screen, ...);
       XftFontOpen takes a list of pattern elements of  the  form
       (field,  type, value) terminated with a NULL, matches that
       pattern against the available fonts and opens the matching
       font.

       Example:
            font   =   XftFontOpen   (dpy,  scr,
       XFT_FAMILY,  XftTypeString,   "charter",
       XFT_SIZE, XftTypeDouble, 12.0,                    NULL);

       This  opens the charter font at 12 points.  The point size
       is automatically converted to the correct pixel size based
       on the resolution of the monitor.

       void
       XftTextExtents8 (Display *dpy,
                  XftFont  *font,
                  unsigned char  *string,
                  int      len,
                  XGlyphInfo    *extents);
       XftTextExtents8  computes  the  pixel  extents of "string"
       when drawn with "font".

       XftDraw *
       XftDrawCreate (Display   *dpy,
                   Drawable  drawable,
                   Visual    *visual,
                   Colormap  colormap);
       XftDrawCreate creates a structure that can be used to ren-
       der text and rectangles to the screen.

       void
       XftDrawString8 (XftDraw       *d,
                 XRenderColor   *color,
                 XftFont        *font,
                 int       x,
                 int       y,
                 unsigned char  *string,
                 int       len);
       XftDrawString8  draws  "string" using "font" in "color" at
       "x, y".

       void
       XftDrawRect (XftDraw         *d,
                 XRenderColor   *color,
                 int      x,
                 int      y,
                 unsigned int   width,
                 unsigned int   height);
       XftDrawRect fills  a  solid  rectangle  in  the  specified
       color.


COMPATIBILITY
       As  of  version 2, Xft has become relatively stable and is
       expected to retain  source  and  binary  compatibility  in
       future releases.


AUTHOR
       Keith Packard, member of the XFree86 Project, Inc.



Xft                       Version 2.1.2                    XFT(3)