2014-05-18 04:33:03 -06:00
|
|
|
|
Fontconfig Developers Reference, Version 2.11.1
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
Copyright © 2002 Keith Packard
|
|
|
|
|
|
|
|
|
|
Permission to use, copy, modify, distribute, and sell this software and
|
|
|
|
|
its documentation for any purpose is hereby granted without fee, provided
|
|
|
|
|
that the above copyright notice appear in all copies and that both that
|
|
|
|
|
copyright notice and this permission notice appear in supporting
|
|
|
|
|
documentation, and that the name of the author(s) not be used in
|
|
|
|
|
advertising or publicity pertaining to distribution of the software
|
|
|
|
|
without specific, written prior permission. The authors make no
|
|
|
|
|
representations about the suitability of this software for any purpose. It
|
|
|
|
|
is provided "as is" without express or implied warranty.
|
|
|
|
|
|
|
|
|
|
THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
|
|
|
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
|
|
|
EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
|
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
|
|
|
|
|
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
|
|
|
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
|
|
|
PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
|
|
|
|
|
|
-------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[1]DESCRIPTION
|
|
|
|
|
|
|
|
|
|
[2]FUNCTIONAL OVERVIEW
|
|
|
|
|
|
|
|
|
|
[3]Datatypes
|
|
|
|
|
|
|
|
|
|
[4]FUNCTIONS
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
|
|
|
|
|
Fontconfig is a library designed to provide system-wide font
|
|
|
|
|
configuration, customization and application access.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FUNCTIONAL OVERVIEW
|
|
|
|
|
|
|
|
|
|
Fontconfig contains two essential modules, the configuration module which
|
|
|
|
|
builds an internal configuration from XML files and the matching module
|
|
|
|
|
which accepts font patterns and returns the nearest matching font.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FONT CONFIGURATION
|
|
|
|
|
|
|
|
|
|
The configuration module consists of the FcConfig datatype, libexpat and
|
|
|
|
|
FcConfigParse which walks over an XML tree and amends a configuration with
|
|
|
|
|
data found within. From an external perspective, configuration of the
|
|
|
|
|
library consists of generating a valid XML tree and feeding that to
|
|
|
|
|
FcConfigParse. The only other mechanism provided to applications for
|
|
|
|
|
changing the running configuration is to add fonts and directories to the
|
|
|
|
|
list of application-provided font files.
|
|
|
|
|
|
|
|
|
|
The intent is to make font configurations relatively static, and shared by
|
|
|
|
|
as many applications as possible. It is hoped that this will lead to more
|
|
|
|
|
stable font selection when passing names from one application to another.
|
|
|
|
|
XML was chosen as a configuration file format because it provides a format
|
|
|
|
|
which is easy for external agents to edit while retaining the correct
|
|
|
|
|
structure and syntax.
|
|
|
|
|
|
|
|
|
|
Font configuration is separate from font matching; applications needing to
|
|
|
|
|
do their own matching can access the available fonts from the library and
|
|
|
|
|
perform private matching. The intent is to permit applications to pick and
|
|
|
|
|
choose appropriate functionality from the library instead of forcing them
|
|
|
|
|
to choose between this library and a private configuration mechanism. The
|
|
|
|
|
hope is that this will ensure that configuration of fonts for all
|
|
|
|
|
applications can be centralized in one place. Centralizing font
|
|
|
|
|
configuration will simplify and regularize font installation and
|
|
|
|
|
customization.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FONT PROPERTIES
|
|
|
|
|
|
|
|
|
|
While font patterns may contain essentially any properties, there are some
|
|
|
|
|
well known properties with associated types. Fontconfig uses some of these
|
|
|
|
|
properties for font matching and font completion. Others are provided as a
|
|
|
|
|
convenience for the application's rendering mechanism.
|
|
|
|
|
|
|
|
|
|
Property Definitions
|
|
|
|
|
|
|
|
|
|
Property C Preprocessor Symbol Type Description
|
|
|
|
|
----------------------------------------------------
|
|
|
|
|
family FC_FAMILY String Font family names
|
|
|
|
|
familylang FC_FAMILYLANG String Language corresponding to
|
|
|
|
|
each family name
|
|
|
|
|
style FC_STYLE String Font style. Overrides weight
|
|
|
|
|
and slant
|
|
|
|
|
stylelang FC_STYLELANG String Language corresponding to
|
|
|
|
|
each style name
|
|
|
|
|
fullname FC_FULLNAME String Font face full name where
|
|
|
|
|
different from family and
|
|
|
|
|
family + style
|
|
|
|
|
fullnamelang FC_FULLNAMELANG String Language corresponding to
|
|
|
|
|
each fullname
|
|
|
|
|
slant FC_SLANT Int Italic, oblique or roman
|
|
|
|
|
weight FC_WEIGHT Int Light, medium, demibold,
|
|
|
|
|
bold or black
|
|
|
|
|
size FC_SIZE Double Point size
|
|
|
|
|
width FC_WIDTH Int Condensed, normal or expanded
|
|
|
|
|
aspect FC_ASPECT Double Stretches glyphs horizontally
|
|
|
|
|
before hinting
|
|
|
|
|
pixelsize FC_PIXEL_SIZE Double Pixel size
|
|
|
|
|
spacing FC_SPACING Int Proportional, dual-width,
|
|
|
|
|
monospace or charcell
|
|
|
|
|
foundry FC_FOUNDRY String Font foundry name
|
|
|
|
|
antialias FC_ANTIALIAS Bool Whether glyphs can be
|
|
|
|
|
antialiased
|
|
|
|
|
hinting FC_HINTING Bool Whether the rasterizer should
|
|
|
|
|
use hinting
|
|
|
|
|
hintstyle FC_HINT_STYLE Int Automatic hinting style
|
|
|
|
|
verticallayout FC_VERTICAL_LAYOUT Bool Use vertical layout
|
|
|
|
|
autohint FC_AUTOHINT Bool Use autohinter instead of
|
|
|
|
|
normal hinter
|
|
|
|
|
globaladvance FC_GLOBAL_ADVANCE Bool Use font global advance data (deprecated)
|
|
|
|
|
file FC_FILE String The filename holding the font
|
|
|
|
|
index FC_INDEX Int The index of the font within
|
|
|
|
|
the file
|
|
|
|
|
ftface FC_FT_FACE FT_Face Use the specified FreeType
|
|
|
|
|
face object
|
2014-05-18 04:33:03 -06:00
|
|
|
|
rasterizer FC_RASTERIZER String Which rasterizer is in use (deprecated)
|
2013-03-09 06:33:45 -07:00
|
|
|
|
outline FC_OUTLINE Bool Whether the glyphs are outlines
|
|
|
|
|
scalable FC_SCALABLE Bool Whether glyphs can be scaled
|
|
|
|
|
scale FC_SCALE Double Scale factor for point->pixel
|
|
|
|
|
conversions
|
|
|
|
|
dpi FC_DPI Double Target dots per inch
|
|
|
|
|
rgba FC_RGBA Int unknown, rgb, bgr, vrgb,
|
|
|
|
|
vbgr, none - subpixel geometry
|
|
|
|
|
lcdfilter FC_LCD_FILTER Int Type of LCD filter
|
|
|
|
|
minspace FC_MINSPACE Bool Eliminate leading from line
|
|
|
|
|
spacing
|
|
|
|
|
charset FC_CHARSET CharSet Unicode chars encoded by
|
|
|
|
|
the font
|
|
|
|
|
lang FC_LANG LangSet Set of RFC-3066-style
|
|
|
|
|
languages this font supports
|
|
|
|
|
fontversion FC_FONTVERSION Int Version number of the font
|
|
|
|
|
capability FC_CAPABILITY String List of layout capabilities in
|
|
|
|
|
the font
|
|
|
|
|
embolden FC_EMBOLDEN Bool Rasterizer should
|
|
|
|
|
synthetically embolden the font
|
2014-05-18 04:33:03 -06:00
|
|
|
|
fontfeatures FC_FONT_FEATURES String List of extra feature tags in
|
|
|
|
|
OpenType to be enabled
|
2013-03-09 06:33:45 -07:00
|
|
|
|
namelang FC_NAMELANG String Language name to be used for the
|
|
|
|
|
default value of familylang,
|
|
|
|
|
stylelang and fullnamelang
|
2014-05-18 04:33:03 -06:00
|
|
|
|
prgname FC_PRGNAME String Name of the running program
|
|
|
|
|
hash FC_HASH String SHA256 hash value of the font data
|
|
|
|
|
with "sha256:" prefix.
|
|
|
|
|
postscriptname FC_POSTSCRIPT_NAME String Font name in PostScript
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Datatypes
|
|
|
|
|
|
|
|
|
|
Fontconfig uses abstract data types to hide internal implementation
|
|
|
|
|
details for most data structures. A few structures are exposed where
|
|
|
|
|
appropriate.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcChar8, FcChar16, FcChar32, FcBool
|
|
|
|
|
|
|
|
|
|
These are primitive data types; the FcChar* types hold precisely the
|
|
|
|
|
number of bits stated (if supported by the C implementation). FcBool holds
|
|
|
|
|
one of two C preprocessor symbols: FcFalse or FcTrue.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcMatrix
|
|
|
|
|
|
|
|
|
|
An FcMatrix holds an affine transformation, usually used to reshape
|
|
|
|
|
glyphs. A small set of matrix operations are provided to manipulate these.
|
|
|
|
|
|
|
|
|
|
typedef struct _FcMatrix {
|
|
|
|
|
double xx, xy, yx, yy;
|
|
|
|
|
} FcMatrix;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcCharSet
|
|
|
|
|
|
|
|
|
|
An FcCharSet is an abstract type that holds the set of encoded Unicode
|
|
|
|
|
chars in a font. Operations to build and compare these sets are provided.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcLangSet
|
|
|
|
|
|
|
|
|
|
An FcLangSet is an abstract type that holds the set of languages supported
|
|
|
|
|
by a font. Operations to build and compare these sets are provided. These
|
|
|
|
|
are computed for a font based on orthographic information built into the
|
|
|
|
|
fontconfig library. Fontconfig has orthographies for all of the ISO 639-1
|
|
|
|
|
languages except for MS, NA, PA, PS, QU, RN, RW, SD, SG, SN, SU and ZA. If
|
|
|
|
|
you have orthographic information for any of these languages, please
|
|
|
|
|
submit them.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcLangResult
|
|
|
|
|
|
|
|
|
|
An FcLangResult is an enumeration used to return the results of comparing
|
|
|
|
|
two language strings or FcLangSet objects. FcLangEqual means the objects
|
|
|
|
|
match language and territory. FcLangDifferentTerritory means the objects
|
|
|
|
|
match in language but differ in territory. FcLangDifferentLang means the
|
|
|
|
|
objects differ in language.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcType
|
|
|
|
|
|
|
|
|
|
Tags the kind of data stored in an FcValue.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcValue
|
|
|
|
|
|
|
|
|
|
An FcValue object holds a single value with one of a number of different
|
|
|
|
|
types. The 'type' tag indicates which member is valid.
|
|
|
|
|
|
|
|
|
|
typedef struct _FcValue {
|
|
|
|
|
FcType type;
|
|
|
|
|
union {
|
|
|
|
|
const FcChar8 *s;
|
|
|
|
|
int i;
|
|
|
|
|
FcBool b;
|
|
|
|
|
double d;
|
|
|
|
|
const FcMatrix *m;
|
|
|
|
|
const FcCharSet *c;
|
|
|
|
|
void *f;
|
|
|
|
|
const FcLangSet *l;
|
|
|
|
|
} u;
|
|
|
|
|
} FcValue;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcValue Members
|
|
|
|
|
|
|
|
|
|
Type Union member Datatype
|
|
|
|
|
--------------------------------
|
|
|
|
|
FcTypeVoid (none) (none)
|
|
|
|
|
FcTypeInteger i int
|
|
|
|
|
FcTypeDouble d double
|
|
|
|
|
FcTypeString s FcChar8 *
|
|
|
|
|
FcTypeBool b b
|
|
|
|
|
FcTypeMatrix m FcMatrix *
|
|
|
|
|
FcTypeCharSet c FcCharSet *
|
|
|
|
|
FcTypeFTFace f void * (FT_Face)
|
|
|
|
|
FcTypeLangSet l FcLangSet *
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcPattern
|
|
|
|
|
|
|
|
|
|
holds a set of names with associated value lists; each name refers to a
|
|
|
|
|
property of a font. FcPatterns are used as inputs to the matching code as
|
|
|
|
|
well as holding information about specific fonts. Each property can hold
|
|
|
|
|
one or more values; conventionally all of the same type, although the
|
|
|
|
|
interface doesn't demand that.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcFontSet
|
|
|
|
|
|
|
|
|
|
typedef struct _FcFontSet {
|
|
|
|
|
int nfont;
|
|
|
|
|
int sfont;
|
|
|
|
|
FcPattern **fonts;
|
|
|
|
|
} FcFontSet;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
An FcFontSet contains a list of FcPatterns. Internally fontconfig uses
|
|
|
|
|
this data structure to hold sets of fonts. Externally, fontconfig returns
|
|
|
|
|
the results of listing fonts in this format. 'nfont' holds the number of
|
|
|
|
|
patterns in the 'fonts' array; 'sfont' is used to indicate the size of
|
|
|
|
|
that array.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcStrSet, FcStrList
|
|
|
|
|
|
|
|
|
|
FcStrSet holds a list of strings that can be appended to and enumerated.
|
|
|
|
|
Its unique characteristic is that the enumeration works even while strings
|
|
|
|
|
are appended during enumeration. FcStrList is used during enumeration to
|
|
|
|
|
safely and correctly walk the list of strings even while that list is
|
|
|
|
|
edited in the middle of enumeration.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcObjectSet
|
|
|
|
|
|
|
|
|
|
typedef struct _FcObjectSet {
|
|
|
|
|
int nobject;
|
|
|
|
|
int sobject;
|
|
|
|
|
const char **objects;
|
|
|
|
|
} FcObjectSet;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcObjectType
|
|
|
|
|
|
|
|
|
|
typedef struct _FcObjectType {
|
|
|
|
|
const char *object;
|
|
|
|
|
FcType type;
|
|
|
|
|
} FcObjectType;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
marks the type of a pattern element generated when parsing font names.
|
|
|
|
|
Applications can add new object types so that font names may contain the
|
|
|
|
|
new elements.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcConstant
|
|
|
|
|
|
|
|
|
|
typedef struct _FcConstant {
|
|
|
|
|
const FcChar8 *name;
|
|
|
|
|
const char *object;
|
|
|
|
|
int value;
|
|
|
|
|
} FcConstant;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Provides for symbolic constants for new pattern elements. When 'name' is
|
|
|
|
|
seen in a font name, an 'object' element is created with value 'value'.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcBlanks
|
|
|
|
|
|
|
|
|
|
holds a list of Unicode chars which are expected to be blank; unexpectedly
|
|
|
|
|
blank chars are assumed to be invalid and are elided from the charset
|
|
|
|
|
associated with the font.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcFileCache
|
|
|
|
|
|
|
|
|
|
holds the per-user cache information for use while loading the font
|
|
|
|
|
database. This is built automatically for the current configuration when
|
|
|
|
|
that is loaded. Applications must always pass '0' when one is requested.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcConfig
|
|
|
|
|
|
|
|
|
|
holds a complete configuration of the library; there is one default
|
|
|
|
|
configuration, other can be constructed from XML data structures. All
|
|
|
|
|
public entry points that need global data can take an optional FcConfig*
|
|
|
|
|
argument; passing 0 uses the default configuration. FcConfig objects hold
|
|
|
|
|
two sets of fonts, the first contains those specified by the
|
|
|
|
|
configuration, the second set holds those added by the application at
|
|
|
|
|
run-time. Interfaces that need to reference a particular set use one of
|
|
|
|
|
the FcSetName enumerated values.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcSetName
|
|
|
|
|
|
|
|
|
|
Specifies one of the two sets of fonts available in a configuration;
|
|
|
|
|
FcSetSystem for those fonts specified in the configuration and
|
|
|
|
|
FcSetApplication which holds fonts provided by the application.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcResult
|
|
|
|
|
|
|
|
|
|
Used as a return type for functions manipulating FcPattern objects.
|
|
|
|
|
|
|
|
|
|
FcResult Values
|
|
|
|
|
Result Code Meaning
|
|
|
|
|
-----------------------------------------------------------
|
|
|
|
|
FcResultMatch Object exists with the specified ID
|
|
|
|
|
FcResultNoMatch Object doesn't exist at all
|
|
|
|
|
FcResultTypeMismatch Object exists, but the type doesn't match
|
|
|
|
|
FcResultNoId Object exists, but has fewer values
|
|
|
|
|
than specified
|
|
|
|
|
FcResultOutOfMemory malloc failed
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcAtomic
|
|
|
|
|
|
|
|
|
|
Used for locking access to configuration files. Provides a safe way to
|
|
|
|
|
update configuration files.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcCache
|
|
|
|
|
|
|
|
|
|
Holds information about the fonts contained in a single directory. Normal
|
|
|
|
|
applications need not worry about this as caches for font access are
|
|
|
|
|
automatically managed by the library. Applications dealing with cache
|
|
|
|
|
management may want to use some of these objects in their work, however
|
|
|
|
|
the included 'fc-cache' program generally suffices for all of that.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FUNCTIONS
|
|
|
|
|
|
|
|
|
|
These are grouped by functionality, often using the main data type being
|
|
|
|
|
manipulated.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Initialization
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[5]FcInitLoadConfig -- load configuration
|
|
|
|
|
|
|
|
|
|
[6]FcInitLoadConfigAndFonts -- load configuration and font data
|
|
|
|
|
|
|
|
|
|
[7]FcInit -- initialize fontconfig library
|
|
|
|
|
|
|
|
|
|
[8]FcFini -- finalize fontconfig library
|
|
|
|
|
|
|
|
|
|
[9]FcGetVersion -- library version number
|
|
|
|
|
|
|
|
|
|
[10]FcInitReinitialize -- re-initialize library
|
|
|
|
|
|
|
|
|
|
[11]FcInitBringUptoDate -- reload configuration files if needed
|
|
|
|
|
|
|
|
|
|
These functions provide some control over how the library is initialized.
|
|
|
|
|
|
|
|
|
|
FcInitLoadConfig
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcInitLoadConfig -- load configuration
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcConfig * FcInitLoadConfig(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Loads the default configuration file and returns the resulting
|
|
|
|
|
configuration. Does not load any font information.
|
|
|
|
|
|
|
|
|
|
FcInitLoadConfigAndFonts
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcInitLoadConfigAndFonts -- load configuration and font data
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcConfig * FcInitLoadConfigAndFonts(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Loads the default configuration file and builds information about the
|
|
|
|
|
available fonts. Returns the resulting configuration.
|
|
|
|
|
|
|
|
|
|
FcInit
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcInit -- initialize fontconfig library
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcInit(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Loads the default configuration file and the fonts referenced therein and
|
|
|
|
|
sets the default configuration to that result. Returns whether this
|
|
|
|
|
process succeeded or not. If the default configuration has already been
|
|
|
|
|
loaded, this routine does nothing and returns FcTrue.
|
|
|
|
|
|
|
|
|
|
FcFini
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFini -- finalize fontconfig library
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcFini(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Frees all data structures allocated by previous calls to fontconfig
|
|
|
|
|
functions. Fontconfig returns to an uninitialized state, requiring a new
|
|
|
|
|
call to one of the FcInit functions before any other fontconfig function
|
|
|
|
|
may be called.
|
|
|
|
|
|
|
|
|
|
FcGetVersion
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcGetVersion -- library version number
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcGetVersion(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the version number of the library.
|
|
|
|
|
|
|
|
|
|
FcInitReinitialize
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcInitReinitialize -- re-initialize library
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcInitReinitialize(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Forces the default configuration file to be reloaded and resets the
|
|
|
|
|
default configuration. Returns FcFalse if the configuration cannot be
|
|
|
|
|
reloaded (due to configuration file errors, allocation failures or other
|
|
|
|
|
issues) and leaves the existing configuration unchanged. Otherwise returns
|
|
|
|
|
FcTrue.
|
|
|
|
|
|
|
|
|
|
FcInitBringUptoDate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcInitBringUptoDate -- reload configuration files if needed
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcInitBringUptoDate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Checks the rescan interval in the default configuration, checking the
|
|
|
|
|
configuration if the interval has passed and reloading the configuration
|
|
|
|
|
if when any changes are detected. Returns FcFalse if the configuration
|
|
|
|
|
cannot be reloaded (see FcInitReinitialize). Otherwise returns FcTrue.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcPattern
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[12]FcPatternCreate -- Create a pattern
|
|
|
|
|
|
|
|
|
|
[13]FcPatternDuplicate -- Copy a pattern
|
|
|
|
|
|
|
|
|
|
[14]FcPatternReference -- Increment pattern reference count
|
|
|
|
|
|
|
|
|
|
[15]FcPatternDestroy -- Destroy a pattern
|
|
|
|
|
|
|
|
|
|
[16]FcPatternEqual -- Compare patterns
|
|
|
|
|
|
|
|
|
|
[17]FcPatternEqualSubset -- Compare portions of patterns
|
|
|
|
|
|
|
|
|
|
[18]FcPatternFilter -- Filter the objects of pattern
|
|
|
|
|
|
|
|
|
|
[19]FcPatternHash -- Compute a pattern hash value
|
|
|
|
|
|
|
|
|
|
[20]FcPatternAdd -- Add a value to a pattern
|
|
|
|
|
|
|
|
|
|
[21]FcPatternAddWeak -- Add a value to a pattern with weak binding
|
|
|
|
|
|
|
|
|
|
[22]FcPatternAdd-Type -- Add a typed value to a pattern
|
|
|
|
|
|
|
|
|
|
[23]FcPatternGet -- Return a value from a pattern
|
|
|
|
|
|
|
|
|
|
[24]FcPatternGet-Type -- Return a typed value from a pattern
|
|
|
|
|
|
|
|
|
|
[25]FcPatternBuild -- Create patterns from arguments
|
|
|
|
|
|
|
|
|
|
[26]FcPatternDel -- Delete a property from a pattern
|
|
|
|
|
|
|
|
|
|
[27]FcPatternRemove -- Remove one object of the specified type from the
|
|
|
|
|
pattern
|
|
|
|
|
|
|
|
|
|
[28]FcPatternPrint -- Print a pattern for debugging
|
|
|
|
|
|
|
|
|
|
[29]FcDefaultSubstitute -- Perform default substitutions in a pattern
|
|
|
|
|
|
|
|
|
|
[30]FcNameParse -- Parse a pattern string
|
|
|
|
|
|
|
|
|
|
[31]FcNameUnparse -- Convert a pattern back into a string that can be
|
|
|
|
|
parsed
|
|
|
|
|
|
|
|
|
|
[32]FcPatternFormat -- Format a pattern into a string according to a
|
|
|
|
|
format specifier
|
|
|
|
|
|
|
|
|
|
An FcPattern is an opaque type that holds both patterns to match against
|
|
|
|
|
the available fonts, as well as the information about each font.
|
|
|
|
|
|
|
|
|
|
FcPatternCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternCreate -- Create a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcPatternCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates a pattern with no properties; used to build patterns from scratch.
|
|
|
|
|
|
|
|
|
|
FcPatternDuplicate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternDuplicate -- Copy a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcPatternDuplicate(const FcPattern *p);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Copy a pattern, returning a new pattern that matches p. Each pattern may
|
|
|
|
|
be modified without affecting the other.
|
|
|
|
|
|
|
|
|
|
FcPatternReference
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternReference -- Increment pattern reference count
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcPatternReference(FcPattern *p);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Add another reference to p. Patterns are freed only when the reference
|
|
|
|
|
count reaches zero.
|
|
|
|
|
|
|
|
|
|
FcPatternDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternDestroy -- Destroy a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcPatternDestroy(FcPattern *p);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Decrement the pattern reference count. If all references are gone,
|
|
|
|
|
destroys the pattern, in the process destroying all related values.
|
|
|
|
|
|
|
|
|
|
FcPatternEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternEqual -- Compare patterns
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternEqual(const FcPattern *pa, const FcPattern *pb);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether pa and pb are exactly alike.
|
|
|
|
|
|
|
|
|
|
FcPatternEqualSubset
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternEqualSubset -- Compare portions of patterns
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternEqualSubset(const FcPattern *pa, const FcPattern *pb,
|
|
|
|
|
const FcObjectSet *os);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether pa and pb have exactly the same values for all of the
|
|
|
|
|
objects in os.
|
|
|
|
|
|
|
|
|
|
FcPatternFilter
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternFilter -- Filter the objects of pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcPatternFilter(FcPattern *p, const FcObjectSet *);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a new pattern that only has those objects from p that are in os.
|
|
|
|
|
If os is NULL, a duplicate of p is returned.
|
|
|
|
|
|
|
|
|
|
FcPatternHash
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternHash -- Compute a pattern hash value
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcPatternHash(const FcPattern *p);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a 32-bit number which is the same for any two patterns which are
|
|
|
|
|
equal.
|
|
|
|
|
|
|
|
|
|
FcPatternAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternAdd -- Add a value to a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAdd(FcPattern *p, const char *object, FcValue value,
|
|
|
|
|
FcBool append);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a single value to the list of values associated with the property
|
|
|
|
|
named `object. If `append is FcTrue, the value is added at the end of any
|
|
|
|
|
existing list, otherwise it is inserted at the beginning. `value' is saved
|
|
|
|
|
(with FcValueSave) when inserted into the pattern so that the library
|
|
|
|
|
retains no reference to any application-supplied data structure.
|
|
|
|
|
|
|
|
|
|
FcPatternAddWeak
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternAddWeak -- Add a value to a pattern with weak binding
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddWeak(FcPattern *p, const char *object, FcValue value,
|
|
|
|
|
FcBool append);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcPatternAddWeak is essentially the same as FcPatternAdd except that any
|
|
|
|
|
values added to the list have binding weak instead of strong.
|
|
|
|
|
|
|
|
|
|
FcPatternAdd-Type
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString,
|
|
|
|
|
FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool,
|
|
|
|
|
FcPatternAddFTFace, FcPatternAddLangSet -- Add a typed value to a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddInteger(FcPattern *p, const char *object, int i);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddDouble(FcPattern *p, const char *object, double d);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddString(FcPattern *p, const char *object, const FcChar8
|
|
|
|
|
*s);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddMatrix(FcPattern *p, const char *object, const FcMatrix
|
|
|
|
|
*m);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddCharSet(FcPattern *p, const char *object, const
|
|
|
|
|
FcCharSet *c);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddBool(FcPattern *p, const char *object, FcBool b);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddFTFace(FcPattern *p, const char *object, const
|
|
|
|
|
FT_Facef);
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternAddLangSet(FcPattern *p, const char *object, const
|
|
|
|
|
FcLangSet *l);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
These are all convenience functions that insert objects of the specified
|
|
|
|
|
type into the pattern. Use these in preference to FcPatternAdd as they
|
|
|
|
|
will provide compile-time typechecking. These all append values to any
|
|
|
|
|
existing list of values.
|
|
|
|
|
|
|
|
|
|
FcPatternGet
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternGet -- Return a value from a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGet(FcPattern *p, const char *object, int id, FcValue
|
|
|
|
|
*v);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns in v the id'th value associated with the property object. The
|
|
|
|
|
value returned is not a copy, but rather refers to the data stored within
|
|
|
|
|
the pattern directly. Applications must not free this value.
|
|
|
|
|
|
|
|
|
|
FcPatternGet-Type
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString,
|
|
|
|
|
FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool,
|
|
|
|
|
FcPatternGetFTFace, FcPatternGetLangSet -- Return a typed value from a
|
|
|
|
|
pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetInteger(FcPattern *p, const char *object, int n, int
|
|
|
|
|
*i);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetDouble(FcPattern *p, const char *object, int n,
|
|
|
|
|
double *d);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetString(FcPattern *p, const char *object, int n,
|
|
|
|
|
FcChar8 **s);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetMatrix(FcPattern *p, const char *object, int n,
|
|
|
|
|
FcMatrix **s);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetCharSet(FcPattern *p, const char *object, int n,
|
|
|
|
|
FcCharSet **c);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetBool(FcPattern *p, const char *object, int n, FcBool
|
|
|
|
|
*b);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetFTFace(FcPattern *p, const char *object, int n);
|
|
|
|
|
|
|
|
|
|
FcResult FcPatternGetLangSet(FcPattern *p, const char *object, FT_Face
|
|
|
|
|
*f);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
These are convenience functions that call FcPatternGet and verify that the
|
|
|
|
|
returned data is of the expected type. They return FcResultTypeMismatch if
|
|
|
|
|
this is not the case. Note that these (like FcPatternGet) do not make a
|
|
|
|
|
copy of any data structure referenced by the return value. Use these in
|
|
|
|
|
preference to FcPatternGet to provide compile-time typechecking.
|
|
|
|
|
|
|
|
|
|
FcPatternBuild
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild -- Create patterns
|
|
|
|
|
from arguments
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcPatternBuild(FcPattern *pattern, ...);
|
|
|
|
|
|
|
|
|
|
FcPattern * FcPatternVaBuild(FcPattern *pattern, va_list va);
|
|
|
|
|
|
|
|
|
|
void FcPatternVapBuild(FcPattern *result, FcPattern *pattern, va_list va);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Builds a pattern using a list of objects, types and values. Each value to
|
|
|
|
|
be entered in the pattern is specified with three arguments:
|
|
|
|
|
|
|
|
|
|
1. Object name, a string describing the property to be added.
|
|
|
|
|
|
|
|
|
|
2. Object type, one of the FcType enumerated values
|
|
|
|
|
|
|
|
|
|
3. Value, not an FcValue, but the raw type as passed to any of the
|
|
|
|
|
FcPatternAdd<type> functions. Must match the type of the second
|
|
|
|
|
argument.
|
|
|
|
|
|
|
|
|
|
The argument list is terminated by a null object name, no object type nor
|
|
|
|
|
value need be passed for this. The values are added to `pattern', if
|
|
|
|
|
`pattern' is null, a new pattern is created. In either case, the pattern
|
|
|
|
|
is returned. Example
|
|
|
|
|
|
|
|
|
|
pattern = FcPatternBuild (0, FC_FAMILY, FcTypeString, "Times", (char *) 0);
|
|
|
|
|
|
|
|
|
|
FcPatternVaBuild is used when the arguments are already in the form of a
|
|
|
|
|
varargs value. FcPatternVapBuild is a macro version of FcPatternVaBuild
|
|
|
|
|
which returns its result directly in the result variable.
|
|
|
|
|
|
|
|
|
|
FcPatternDel
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternDel -- Delete a property from a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternDel(FcPattern *p, const char *object);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deletes all values associated with the property `object', returning
|
|
|
|
|
whether the property existed or not.
|
|
|
|
|
|
|
|
|
|
FcPatternRemove
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternRemove -- Remove one object of the specified type from the
|
|
|
|
|
pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcPatternRemove(FcPattern *p, const char *object, int id);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Removes the value associated with the property `object' at position `id',
|
|
|
|
|
returning whether the property existed and had a value at that position or
|
|
|
|
|
not.
|
|
|
|
|
|
|
|
|
|
FcPatternPrint
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternPrint -- Print a pattern for debugging
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcPatternPrint(const FcPattern *p);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Prints an easily readable version of the pattern to stdout. There is no
|
|
|
|
|
provision for reparsing data in this format, it's just for diagnostics and
|
|
|
|
|
debugging.
|
|
|
|
|
|
|
|
|
|
FcDefaultSubstitute
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDefaultSubstitute -- Perform default substitutions in a pattern
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcDefaultSubstitute(FcPattern *pattern);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Supplies default values for underspecified font patterns:
|
|
|
|
|
|
|
|
|
|
* Patterns without a specified style or weight are set to Medium
|
|
|
|
|
|
|
|
|
|
* Patterns without a specified style or slant are set to Roman
|
|
|
|
|
|
|
|
|
|
* Patterns without a specified pixel size are given one computed from
|
|
|
|
|
any specified point size (default 12), dpi (default 75) and scale
|
|
|
|
|
(default 1).
|
|
|
|
|
|
|
|
|
|
FcNameParse
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameParse -- Parse a pattern string
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcNameParse(const FcChar8 *name);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts name from the standard text format described above into a
|
|
|
|
|
pattern.
|
|
|
|
|
|
|
|
|
|
FcNameUnparse
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameUnparse -- Convert a pattern back into a string that can be parsed
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcNameUnparse(FcPattern *pat);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts the given pattern into the standard text format described above.
|
|
|
|
|
The return value is not static, but instead refers to newly allocated
|
|
|
|
|
memory which should be freed by the caller using free().
|
|
|
|
|
|
|
|
|
|
FcPatternFormat
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcPatternFormat -- Format a pattern into a string according to a format
|
|
|
|
|
specifier
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcPatternFormat(FcPattern *pat, const FcChar8 *format);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts given pattern pat into text described by the format specifier
|
|
|
|
|
format. The return value refers to newly allocated memory which should be
|
|
|
|
|
freed by the caller using free(), or NULL if format is invalid.
|
|
|
|
|
|
|
|
|
|
The format is loosely modeled after printf-style format string. The
|
|
|
|
|
format string is composed of zero or more directives: ordinary characters
|
|
|
|
|
(not "%"), which are copied unchanged to the output stream; and tags which
|
|
|
|
|
are interpreted to construct text from the pattern in a variety of ways
|
|
|
|
|
(explained below). Special characters can be escaped using backslash.
|
|
|
|
|
C-string style special characters like \n and \r are also supported (this
|
|
|
|
|
is useful when the format string is not a C string literal). It is
|
|
|
|
|
advisable to always escape curly braces that are meant to be copied to the
|
|
|
|
|
output as ordinary characters.
|
|
|
|
|
|
|
|
|
|
Each tag is introduced by the character "%", followed by an optional
|
|
|
|
|
minimum field width, followed by tag contents in curly braces ({}). If the
|
|
|
|
|
minimum field width value is provided the tag will be expanded and the
|
|
|
|
|
result padded to achieve the minimum width. If the minimum field width is
|
|
|
|
|
positive, the padding will right-align the text. Negative field width will
|
|
|
|
|
left-align. The rest of this section describes various supported tag
|
|
|
|
|
contents and their expansion.
|
|
|
|
|
|
|
|
|
|
A simple tag is one where the content is an identifier. When simple tags
|
|
|
|
|
are expanded, the named identifier will be looked up in pattern and the
|
|
|
|
|
resulting list of values returned, joined together using comma. For
|
|
|
|
|
example, to print the family name and style of the pattern, use the format
|
|
|
|
|
"%{family} %{style}\n". To extend the family column to forty characters
|
|
|
|
|
use "%-40{family}%{style}\n".
|
|
|
|
|
|
|
|
|
|
Simple tags expand to list of all values for an element. To only choose
|
|
|
|
|
one of the values, one can index using the syntax "%{elt[idx]}". For
|
|
|
|
|
example, to get the first family name only, use "%{family[0]}".
|
|
|
|
|
|
|
|
|
|
If a simple tag ends with "=" and the element is found in the pattern,
|
|
|
|
|
the name of the element followed by "=" will be output before the list of
|
|
|
|
|
values. For example, "%{weight=}" may expand to the string "weight=80". Or
|
|
|
|
|
to the empty string if pattern does not have weight set.
|
|
|
|
|
|
|
|
|
|
If a simple tag starts with ":" and the element is found in the pattern,
|
|
|
|
|
":" will be printed first. For example, combining this with the =, the
|
|
|
|
|
format "%{:weight=}" may expand to ":weight=80" or to the empty string if
|
|
|
|
|
pattern does not have weight set.
|
|
|
|
|
|
|
|
|
|
If a simple tag contains the string ":-", the rest of the the tag
|
|
|
|
|
contents will be used as a default string. The default string is output if
|
|
|
|
|
the element is not found in the pattern. For example, the format
|
|
|
|
|
"%{:weight=:-123}" may expand to ":weight=80" or to the string
|
|
|
|
|
":weight=123" if pattern does not have weight set.
|
|
|
|
|
|
|
|
|
|
A count tag is one that starts with the character "#" followed by an
|
|
|
|
|
element name, and expands to the number of values for the element in the
|
|
|
|
|
pattern. For example, "%{#family}" expands to the number of family names
|
|
|
|
|
pattern has set, which may be zero.
|
|
|
|
|
|
|
|
|
|
A sub-expression tag is one that expands a sub-expression. The tag
|
|
|
|
|
contents are the sub-expression to expand placed inside another set of
|
|
|
|
|
curly braces. Sub-expression tags are useful for aligning an entire
|
|
|
|
|
sub-expression, or to apply converters (explained later) to the entire
|
|
|
|
|
sub-expression output. For example, the format "%40{{%{family} %{style}}}"
|
|
|
|
|
expands the sub-expression to construct the family name followed by the
|
|
|
|
|
style, then takes the entire string and pads it on the left to be at least
|
|
|
|
|
forty characters.
|
|
|
|
|
|
|
|
|
|
A filter-out tag is one starting with the character "-" followed by a
|
|
|
|
|
comma-separated list of element names, followed by a sub-expression
|
|
|
|
|
enclosed in curly braces. The sub-expression will be expanded but with a
|
|
|
|
|
pattern that has the listed elements removed from it. For example, the
|
|
|
|
|
format "%{-size,pixelsize{sub-expr}}" will expand "sub-expr" with pattern
|
|
|
|
|
sans the size and pixelsize elements.
|
|
|
|
|
|
|
|
|
|
A filter-in tag is one starting with the character "+" followed by a
|
|
|
|
|
comma-separated list of element names, followed by a sub-expression
|
|
|
|
|
enclosed in curly braces. The sub-expression will be expanded but with a
|
|
|
|
|
pattern that only has the listed elements from the surrounding pattern.
|
|
|
|
|
For example, the format "%{+family,familylang{sub-expr}}" will expand
|
|
|
|
|
"sub-expr" with a sub-pattern consisting only the family and family lang
|
|
|
|
|
elements of pattern.
|
|
|
|
|
|
|
|
|
|
A conditional tag is one starting with the character "?" followed by a
|
|
|
|
|
comma-separated list of element conditions, followed by two sub-expression
|
|
|
|
|
enclosed in curly braces. An element condition can be an element name, in
|
|
|
|
|
which case it tests whether the element is defined in pattern, or the
|
|
|
|
|
character "!" followed by an element name, in which case the test is
|
|
|
|
|
negated. The conditional passes if all the element conditions pass. The
|
|
|
|
|
tag expands the first sub-expression if the conditional passes, and
|
|
|
|
|
expands the second sub-expression otherwise. For example, the format
|
|
|
|
|
"%{?size,dpi,!pixelsize{pass}{fail}}" will expand to "pass" if pattern has
|
|
|
|
|
size and dpi elements but no pixelsize element, and to "fail" otherwise.
|
|
|
|
|
|
|
|
|
|
An enumerate tag is one starting with the string "[]" followed by a
|
|
|
|
|
comma-separated list of element names, followed by a sub-expression
|
|
|
|
|
enclosed in curly braces. The list of values for the named elements are
|
|
|
|
|
walked in parallel and the sub-expression expanded each time with a
|
|
|
|
|
pattern just having a single value for those elements, starting from the
|
|
|
|
|
first value and continuing as long as any of those elements has a value.
|
|
|
|
|
For example, the format "%{[]family,familylang{%{family}
|
|
|
|
|
(%{familylang})\n}}" will expand the pattern "%{family} (%{familylang})\n"
|
|
|
|
|
with a pattern having only the first value of the family and familylang
|
|
|
|
|
elements, then expands it with the second values, then the third, etc.
|
|
|
|
|
|
|
|
|
|
As a special case, if an enumerate tag has only one element, and that
|
|
|
|
|
element has only one value in the pattern, and that value is of type
|
|
|
|
|
FcLangSet, the individual languages in the language set are enumerated.
|
|
|
|
|
|
|
|
|
|
A builtin tag is one starting with the character "=" followed by a
|
|
|
|
|
builtin name. The following builtins are defined:
|
|
|
|
|
|
|
|
|
|
unparse
|
|
|
|
|
|
|
|
|
|
Expands to the result of calling FcNameUnparse() on the pattern.
|
|
|
|
|
|
|
|
|
|
fcmatch
|
|
|
|
|
|
|
|
|
|
Expands to the output of the default output format of the fc-match
|
|
|
|
|
command on the pattern, without the final newline.
|
|
|
|
|
|
|
|
|
|
fclist
|
|
|
|
|
|
|
|
|
|
Expands to the output of the default output format of the fc-list
|
|
|
|
|
command on the pattern, without the final newline.
|
|
|
|
|
|
|
|
|
|
fccat
|
|
|
|
|
|
|
|
|
|
Expands to the output of the default output format of the fc-cat
|
|
|
|
|
command on the pattern, without the final newline.
|
|
|
|
|
|
|
|
|
|
pkgkit
|
|
|
|
|
|
|
|
|
|
Expands to the list of PackageKit font() tags for the pattern.
|
|
|
|
|
Currently this includes tags for each family name, and each
|
|
|
|
|
language from the pattern, enumerated and sanitized into a set of
|
|
|
|
|
tags terminated by newline. Package management systems can use
|
|
|
|
|
these tags to tag their packages accordingly.
|
|
|
|
|
|
|
|
|
|
For example, the format "%{+family,style{%{=unparse}}}\n" will expand to
|
|
|
|
|
an unparsed name containing only the family and style element values from
|
|
|
|
|
pattern.
|
|
|
|
|
|
|
|
|
|
The contents of any tag can be followed by a set of zero or more
|
|
|
|
|
converters. A converter is specified by the character "|" followed by the
|
|
|
|
|
converter name and arguments. The following converters are defined:
|
|
|
|
|
|
|
|
|
|
basename
|
|
|
|
|
|
|
|
|
|
Replaces text with the results of calling FcStrBasename() on it.
|
|
|
|
|
|
|
|
|
|
dirname
|
|
|
|
|
|
|
|
|
|
Replaces text with the results of calling FcStrDirname() on it.
|
|
|
|
|
|
|
|
|
|
downcase
|
|
|
|
|
|
|
|
|
|
Replaces text with the results of calling FcStrDowncase() on it.
|
|
|
|
|
|
|
|
|
|
shescape
|
|
|
|
|
|
|
|
|
|
Escapes text for one level of shell expansion. (Escapes
|
|
|
|
|
single-quotes, also encloses text in single-quotes.)
|
|
|
|
|
|
|
|
|
|
cescape
|
|
|
|
|
|
|
|
|
|
Escapes text such that it can be used as part of a C string
|
|
|
|
|
literal. (Escapes backslash and double-quotes.)
|
|
|
|
|
|
|
|
|
|
xmlescape
|
|
|
|
|
|
|
|
|
|
Escapes text such that it can be used in XML and HTML. (Escapes
|
|
|
|
|
less-than, greater-than, and ampersand.)
|
|
|
|
|
|
|
|
|
|
delete(chars)
|
|
|
|
|
|
|
|
|
|
Deletes all occurrences of each of the characters in chars from
|
|
|
|
|
the text. FIXME: This converter is not UTF-8 aware yet.
|
|
|
|
|
|
|
|
|
|
escape(chars)
|
|
|
|
|
|
|
|
|
|
Escapes all occurrences of each of the characters in chars by
|
|
|
|
|
prepending it by the first character in chars. FIXME: This
|
|
|
|
|
converter is not UTF-8 aware yet.
|
|
|
|
|
|
|
|
|
|
translate(from,to)
|
|
|
|
|
|
|
|
|
|
Translates all occurrences of each of the characters in from by
|
|
|
|
|
replacing them with their corresponding character in to. If to has
|
|
|
|
|
fewer characters than from, it will be extended by repeating its
|
|
|
|
|
last character. FIXME: This converter is not UTF-8 aware yet.
|
|
|
|
|
|
|
|
|
|
For example, the format "%{family|downcase|delete( )}\n" will expand to
|
|
|
|
|
the values of the family element in pattern, lower-cased and with spaces
|
|
|
|
|
removed.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcFontSet
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[33]FcFontSetCreate -- Create a font set
|
|
|
|
|
|
|
|
|
|
[34]FcFontSetDestroy -- Destroy a font set
|
|
|
|
|
|
|
|
|
|
[35]FcFontSetAdd -- Add to a font set
|
|
|
|
|
|
|
|
|
|
[36]FcFontSetList -- List fonts from a set of font sets
|
|
|
|
|
|
|
|
|
|
[37]FcFontSetMatch -- Return the best font from a set of font sets
|
|
|
|
|
|
|
|
|
|
[38]FcFontSetPrint -- Print a set of patterns to stdout
|
|
|
|
|
|
|
|
|
|
[39]FcFontSetSort -- Add to a font set
|
|
|
|
|
|
|
|
|
|
[40]FcFontSetSortDestroy -- DEPRECATED destroy a font set
|
|
|
|
|
|
|
|
|
|
An FcFontSet simply holds a list of patterns; these are used to return the
|
|
|
|
|
results of listing available fonts.
|
|
|
|
|
|
|
|
|
|
FcFontSetCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetCreate -- Create a font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcFontSetCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates an empty font set.
|
|
|
|
|
|
|
|
|
|
FcFontSetDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetDestroy -- Destroy a font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcFontSetDestroy(FcFontSet *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys a font set. Note that this destroys any referenced patterns as
|
|
|
|
|
well.
|
|
|
|
|
|
|
|
|
|
FcFontSetAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetAdd -- Add to a font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcFontSetAdd(FcFontSet *s, FcPattern *font);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a pattern to a font set. Note that the pattern is not copied before
|
|
|
|
|
being inserted into the set. Returns FcFalse if the pattern cannot be
|
|
|
|
|
inserted into the set (due to allocation failure). Otherwise returns
|
|
|
|
|
FcTrue.
|
|
|
|
|
|
|
|
|
|
FcFontSetList
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetList -- List fonts from a set of font sets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcFontSetList(FcConfig *config, FcFontSet **sets, intnsets,
|
|
|
|
|
FcPattern *pattern, FcObjectSet *object_set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Selects fonts matching pattern from sets, creates patterns from those
|
|
|
|
|
fonts containing only the objects in object_set and returns the set of
|
|
|
|
|
unique such patterns. If config is NULL, the default configuration is
|
|
|
|
|
checked to be up to date, and used.
|
|
|
|
|
|
|
|
|
|
FcFontSetMatch
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetMatch -- Return the best font from a set of font sets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcFontSetMatch(FcConfig *config, FcFontSet **sets, intnsets,
|
|
|
|
|
FcPattern *pattern, FcResult *result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Finds the font in sets most closely matching pattern and returns the
|
|
|
|
|
result of FcFontRenderPrepare for that font and the provided pattern. This
|
|
|
|
|
function should be called only after FcConfigSubstitute and
|
|
|
|
|
FcDefaultSubstitute have been called for pattern; otherwise the results
|
|
|
|
|
will not be correct. If config is NULL, the current configuration is used.
|
|
|
|
|
Returns NULL if an error occurs during this process.
|
|
|
|
|
|
|
|
|
|
FcFontSetPrint
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetPrint -- Print a set of patterns to stdout
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcFontSetPrint(FcFontSet *set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function is useful for diagnosing font related issues, printing the
|
|
|
|
|
complete contents of every pattern in set. The format of the output is
|
|
|
|
|
designed to be of help to users and developers, and may change at any
|
|
|
|
|
time.
|
|
|
|
|
|
|
|
|
|
FcFontSetSort
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetSort -- Add to a font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSetSort(FcConfig *config, FcFontSet **sets, intnsets, FcPattern
|
|
|
|
|
*pattern, FcBool trim, FcCharSet **csp, FcResult *result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the list of fonts from sets sorted by closeness to pattern. If
|
|
|
|
|
trim is FcTrue, elements in the list which don't include Unicode coverage
|
|
|
|
|
not provided by earlier elements in the list are elided. The union of
|
|
|
|
|
Unicode coverage of all of the fonts is returned in csp, if csp is not
|
|
|
|
|
NULL. This function should be called only after FcConfigSubstitute and
|
|
|
|
|
FcDefaultSubstitute have been called for p; otherwise the results will not
|
|
|
|
|
be correct.
|
|
|
|
|
|
|
|
|
|
The returned FcFontSet references FcPattern structures which may be shared
|
|
|
|
|
by the return value from multiple FcFontSort calls, applications cannot
|
|
|
|
|
modify these patterns. Instead, they should be passed, along with pattern
|
|
|
|
|
to FcFontRenderPrepare which combines them into a complete pattern.
|
|
|
|
|
|
|
|
|
|
The FcFontSet returned by FcFontSetSort is destroyed by calling
|
|
|
|
|
FcFontSetDestroy.
|
|
|
|
|
|
|
|
|
|
FcFontSetSortDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSetSortDestroy -- DEPRECATED destroy a font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSetSortDestroy(FcFontSet *set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function is DEPRECATED. FcFontSetSortDestroy destroys set by calling
|
|
|
|
|
FcFontSetDestroy. Applications should use FcFontSetDestroy directly
|
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcObjectSet
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[41]FcObjectSetCreate -- Create an object set
|
|
|
|
|
|
|
|
|
|
[42]FcObjectSetAdd -- Add to an object set
|
|
|
|
|
|
|
|
|
|
[43]FcObjectSetDestroy -- Destroy an object set
|
|
|
|
|
|
|
|
|
|
[44]FcObjectSetBuild -- Build object set from args
|
|
|
|
|
|
|
|
|
|
An FcObjectSet holds a list of pattern property names; it is used to
|
|
|
|
|
indicate which properties are to be returned in the patterns from
|
|
|
|
|
FcFontList.
|
|
|
|
|
|
|
|
|
|
FcObjectSetCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcObjectSetCreate -- Create an object set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcObjectSet * FcObjectSetCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates an empty set.
|
|
|
|
|
|
|
|
|
|
FcObjectSetAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcObjectSetAdd -- Add to an object set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcObjectSetAdd(FcObjectSet *os, const char *object);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a property name to the set. Returns FcFalse if the property name
|
|
|
|
|
cannot be inserted into the set (due to allocation failure). Otherwise
|
|
|
|
|
returns FcTrue.
|
|
|
|
|
|
|
|
|
|
FcObjectSetDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcObjectSetDestroy -- Destroy an object set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcObjectSetDestroy(FcObjectSet *os);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys an object set.
|
|
|
|
|
|
|
|
|
|
FcObjectSetBuild
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcObjectSetBuild, FcObjectSetVaBuild, FcObjectSetVapBuild -- Build object
|
|
|
|
|
set from args
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcObjectSet * FcObjectSetBuild(const char *first, ...);
|
|
|
|
|
|
|
|
|
|
FcObjectSet * FcObjectSetVaBuild(const char *first, va_list va);
|
|
|
|
|
|
|
|
|
|
void FcObjectSetVapBuild(FcObjectSet *result, const char *first, va_list
|
|
|
|
|
va);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
These build an object set from a null-terminated list of property names.
|
|
|
|
|
FcObjectSetVapBuild is a macro version of FcObjectSetVaBuild which returns
|
|
|
|
|
the result in the result variable directly.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FreeType specific functions
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[45]FcFreeTypeCharIndex -- map Unicode to glyph id
|
|
|
|
|
|
|
|
|
|
[46]FcFreeTypeCharSet -- compute Unicode coverage
|
|
|
|
|
|
|
|
|
|
[47]FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and spacing
|
|
|
|
|
type
|
|
|
|
|
|
|
|
|
|
[48]FcFreeTypeQuery -- compute pattern from font file (and index)
|
|
|
|
|
|
|
|
|
|
[49]FcFreeTypeQueryFace -- compute pattern from FT_Face
|
|
|
|
|
|
|
|
|
|
While the fontconfig library doesn't insist that FreeType be used as the
|
|
|
|
|
rasterization mechanism for fonts, it does provide some convenience
|
|
|
|
|
functions.
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharIndex
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharIndex -- map Unicode to glyph id
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig.h>
|
|
|
|
|
#include <fcfreetype.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FT_UInt FcFreeTypeCharIndex(FT_Face face, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Maps a Unicode char to a glyph index. This function uses information from
|
|
|
|
|
several possible underlying encoding tables to work around broken fonts.
|
|
|
|
|
As a result, this function isn't designed to be used in performance
|
|
|
|
|
sensitive areas; results from this function are intended to be cached by
|
|
|
|
|
higher level functions.
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharSet
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharSet -- compute Unicode coverage
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig.h>
|
|
|
|
|
#include <fcfreetype.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcFreeTypeCharSet(FT_Face face, FcBlanks *blanks);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Scans a FreeType face and returns the set of encoded Unicode chars. This
|
|
|
|
|
scans several encoding tables to build as complete a list as possible. If
|
|
|
|
|
'blanks' is not 0, the glyphs in the font are examined and any blank
|
|
|
|
|
glyphs not in 'blanks' are not placed in the returned FcCharSet.
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharSetAndSpacing
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and spacing type
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig.h>
|
|
|
|
|
#include <fcfreetype.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcFreeTypeCharSetAndSpacing(FT_Face face, FcBlanks *blanks,
|
|
|
|
|
int *spacing);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Scans a FreeType face and returns the set of encoded Unicode chars. This
|
|
|
|
|
scans several encoding tables to build as complete a list as possible. If
|
|
|
|
|
'blanks' is not 0, the glyphs in the font are examined and any blank
|
|
|
|
|
glyphs not in 'blanks' are not placed in the returned FcCharSet. spacing
|
|
|
|
|
receives the computed spacing type of the font, one of FC_MONO for a font
|
|
|
|
|
where all glyphs have the same width, FC_DUAL, where the font has glyphs
|
|
|
|
|
in precisely two widths, one twice as wide as the other, or
|
|
|
|
|
FC_PROPORTIONAL where the font has glyphs of many widths.
|
|
|
|
|
|
|
|
|
|
FcFreeTypeQuery
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFreeTypeQuery -- compute pattern from font file (and index)
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig.h>
|
|
|
|
|
#include <fcfreetype.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcFreeTypeQuery(const FcChar8 *file, int id, FcBlanks *blanks,
|
|
|
|
|
int *count);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Constructs a pattern representing the 'id'th font in 'file'. The number of
|
|
|
|
|
fonts in 'file' is returned in 'count'.
|
|
|
|
|
|
|
|
|
|
FcFreeTypeQueryFace
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFreeTypeQueryFace -- compute pattern from FT_Face
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig.h>
|
|
|
|
|
#include <fcfreetype.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcFreeTypeQueryFace(const FT_Face face, const FcChar8 *file,
|
|
|
|
|
int id, FcBlanks *blanks);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Constructs a pattern representing 'face'. 'file' and 'id' are used solely
|
|
|
|
|
as data for pattern elements (FC_FILE, FC_INDEX and sometimes FC_FAMILY).
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcValue
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[50]FcValueDestroy -- Free a value
|
|
|
|
|
|
|
|
|
|
[51]FcValueSave -- Copy a value
|
|
|
|
|
|
|
|
|
|
[52]FcValuePrint -- Print a value to stdout
|
|
|
|
|
|
|
|
|
|
[53]FcValueEqual -- Test two values for equality
|
|
|
|
|
|
|
|
|
|
FcValue is a structure containing a type tag and a union of all possible
|
|
|
|
|
datatypes. The tag is an enum of type FcType and is intended to provide a
|
|
|
|
|
measure of run-time typechecking, although that depends on careful
|
|
|
|
|
programming.
|
|
|
|
|
|
|
|
|
|
FcValueDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcValueDestroy -- Free a value
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcValueDestroy(FcValue v);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Frees any memory referenced by v. Values of type FcTypeString,
|
|
|
|
|
FcTypeMatrix and FcTypeCharSet reference memory, the other types do not.
|
|
|
|
|
|
|
|
|
|
FcValueSave
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcValueSave -- Copy a value
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcValue FcValueSave(FcValue v);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a copy of v duplicating any object referenced by it so that v may
|
|
|
|
|
be safely destroyed without harming the new value.
|
|
|
|
|
|
|
|
|
|
FcValuePrint
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcValuePrint -- Print a value to stdout
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcValuePrint(FcValue v);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Prints a human-readable representation of v to stdout. The format should
|
|
|
|
|
not be considered part of the library specification as it may change in
|
|
|
|
|
the future.
|
|
|
|
|
|
|
|
|
|
FcValueEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcValueEqual -- Test two values for equality
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcValueEqual(FcValue v_a, FcValue v_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Compares two values. Integers and Doubles are compared as numbers;
|
|
|
|
|
otherwise the two values have to be the same type to be considered equal.
|
|
|
|
|
Strings are compared ignoring case.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcCharSet
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[54]FcCharSetCreate -- Create an empty character set
|
|
|
|
|
|
|
|
|
|
[55]FcCharSetDestroy -- Destroy a character set
|
|
|
|
|
|
|
|
|
|
[56]FcCharSetAddChar -- Add a character to a charset
|
|
|
|
|
|
|
|
|
|
[57]FcCharSetDelChar -- Add a character to a charset
|
|
|
|
|
|
|
|
|
|
[58]FcCharSetCopy -- Copy a charset
|
|
|
|
|
|
|
|
|
|
[59]FcCharSetEqual -- Compare two charsets
|
|
|
|
|
|
|
|
|
|
[60]FcCharSetIntersect -- Intersect charsets
|
|
|
|
|
|
|
|
|
|
[61]FcCharSetUnion -- Add charsets
|
|
|
|
|
|
|
|
|
|
[62]FcCharSetSubtract -- Subtract charsets
|
|
|
|
|
|
|
|
|
|
[63]FcCharSetMerge -- Merge charsets
|
|
|
|
|
|
|
|
|
|
[64]FcCharSetHasChar -- Check a charset for a char
|
|
|
|
|
|
|
|
|
|
[65]FcCharSetCount -- Count entries in a charset
|
|
|
|
|
|
|
|
|
|
[66]FcCharSetIntersectCount -- Intersect and count charsets
|
|
|
|
|
|
|
|
|
|
[67]FcCharSetSubtractCount -- Subtract and count charsets
|
|
|
|
|
|
|
|
|
|
[68]FcCharSetIsSubset -- Test for charset inclusion
|
|
|
|
|
|
|
|
|
|
[69]FcCharSetFirstPage -- Start enumerating charset contents
|
|
|
|
|
|
|
|
|
|
[70]FcCharSetNextPage -- Continue enumerating charset contents
|
|
|
|
|
|
|
|
|
|
[71]FcCharSetCoverage -- DEPRECATED return coverage for a Unicode page
|
|
|
|
|
|
|
|
|
|
[72]FcCharSetNew -- DEPRECATED alias for FcCharSetCreate
|
|
|
|
|
|
|
|
|
|
An FcCharSet is a boolean array indicating a set of Unicode chars. Those
|
|
|
|
|
associated with a font are marked constant and cannot be edited.
|
|
|
|
|
FcCharSets may be reference counted internally to reduce memory
|
|
|
|
|
consumption; this may be visible to applications as the result of
|
|
|
|
|
FcCharSetCopy may return it's argument, and that CharSet may remain
|
|
|
|
|
unmodifiable.
|
|
|
|
|
|
|
|
|
|
FcCharSetCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetCreate -- Create an empty character set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcCharSetCreate allocates and initializes a new empty character set
|
|
|
|
|
object.
|
|
|
|
|
|
|
|
|
|
FcCharSetDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetDestroy -- Destroy a character set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcCharSetDestroy(FcCharSet *fcs);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcCharSetDestroy decrements the reference count fcs. If the reference
|
|
|
|
|
count becomes zero, all memory referenced is freed.
|
|
|
|
|
|
|
|
|
|
FcCharSetAddChar
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetAddChar -- Add a character to a charset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetAddChar(FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcCharSetAddChar adds a single Unicode char to the set, returning FcFalse
|
|
|
|
|
on failure, either as a result of a constant set or from running out of
|
|
|
|
|
memory.
|
|
|
|
|
|
|
|
|
|
FcCharSetDelChar
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetDelChar -- Add a character to a charset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetDelChar(FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcCharSetDelChar deletes a single Unicode char from the set, returning
|
|
|
|
|
FcFalse on failure, either as a result of a constant set or from running
|
|
|
|
|
out of memory.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcCharSetCopy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetCopy -- Copy a charset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetCopy(FcCharSet *src);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Makes a copy of src; note that this may not actually do anything more than
|
|
|
|
|
increment the reference count on src.
|
|
|
|
|
|
|
|
|
|
FcCharSetEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetEqual -- Compare two charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetEqual(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether a and b contain the same set of Unicode chars.
|
|
|
|
|
|
|
|
|
|
FcCharSetIntersect
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetIntersect -- Intersect charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetIntersect(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a set including only those chars found in both a and b.
|
|
|
|
|
|
|
|
|
|
FcCharSetUnion
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetUnion -- Add charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetUnion(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a set including only those chars found in either a or b.
|
|
|
|
|
|
|
|
|
|
FcCharSetSubtract
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetSubtract -- Subtract charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetSubtract(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a set including only those chars found in a but not b.
|
|
|
|
|
|
|
|
|
|
FcCharSetMerge
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetMerge -- Merge charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetMerge(FcCharSet *a, const FcCharSet *b, FcBool *changed);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds all chars in b to a. In other words, this is an in-place version of
|
|
|
|
|
FcCharSetUnion. If changed is not NULL, then it returns whether any new
|
|
|
|
|
chars from b were added to a. Returns FcFalse on failure, either when a is
|
|
|
|
|
a constant set or from running out of memory.
|
|
|
|
|
|
|
|
|
|
FcCharSetHasChar
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetHasChar -- Check a charset for a char
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetHasChar(const FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether fcs contains the char ucs4.
|
|
|
|
|
|
|
|
|
|
FcCharSetCount
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetCount -- Count entries in a charset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetCount(const FcCharSet *a);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the total number of Unicode chars in a.
|
|
|
|
|
|
|
|
|
|
FcCharSetIntersectCount
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetIntersectCount -- Intersect and count charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetIntersectCount(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the number of chars that are in both a and b.
|
|
|
|
|
|
|
|
|
|
FcCharSetSubtractCount
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetSubtractCount -- Subtract and count charsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetSubtractCount(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the number of chars that are in a but not in b.
|
|
|
|
|
|
|
|
|
|
FcCharSetIsSubset
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetIsSubset -- Test for charset inclusion
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcCharSetIsSubset(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether a is a subset of b.
|
|
|
|
|
|
|
|
|
|
FcCharSetFirstPage
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetFirstPage -- Start enumerating charset contents
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetFirstPage(const FcCharSet *a,
|
|
|
|
|
FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Builds an array of bits in map marking the first page of Unicode coverage
|
|
|
|
|
of a. *next is set to contains the base code point for the next page in a.
|
|
|
|
|
Returns the base code point for the page, or FC_CHARSET_DONE if a contains
|
|
|
|
|
no pages. As an example, if FcCharSetFirstPage returns 0x300 and fills map
|
|
|
|
|
with
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff7fff 0xffff0003
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Then the page contains code points 0x300 through 0x33f (the first 64 code
|
|
|
|
|
points on the page) because map[0] and map[1] both have all their bits
|
|
|
|
|
set. It also contains code points 0x343 (0x300 + 32*2 + (4-1)) and 0x35e
|
|
|
|
|
(0x300 + 32*2 + (31-1)) because map[2] has the 4th and 31st bits set. The
|
|
|
|
|
code points represented by map[3] and later are left as an excercise for
|
|
|
|
|
the reader ;).
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcCharSetNextPage
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetNextPage -- Continue enumerating charset contents
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetNextPage(const FcCharSet *a,
|
|
|
|
|
FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Builds an array of bits in map marking the Unicode coverage of a for page
|
|
|
|
|
containing *next (see the FcCharSetFirstPage description for details).
|
|
|
|
|
*next is set to contains the base code point for the next page in a.
|
|
|
|
|
Returns the base of code point for the page, or FC_CHARSET_DONE if a does
|
|
|
|
|
not contain *next.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcCharSetCoverage
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetCoverage -- DEPRECATED return coverage for a Unicode page
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcCharSetCoverage(const FcCharSet *a, FcChar32page,
|
|
|
|
|
FcChar32[8]result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
DEPRECATED This function returns a bitmask in result which indicates which
|
|
|
|
|
code points in page are included in a. FcCharSetCoverage returns the next
|
|
|
|
|
page in the charset which has any coverage.
|
|
|
|
|
|
|
|
|
|
FcCharSetNew
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCharSetNew -- DEPRECATED alias for FcCharSetCreate
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCharSet * FcCharSetNew(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcCharSetNew is a DEPRECATED alias for FcCharSetCreate.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcLangSet
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
|
|
|
|
[73]FcLangSetCreate -- create a langset object
|
|
|
|
|
|
|
|
|
|
[74]FcLangSetDestroy -- destroy a langset object
|
|
|
|
|
|
|
|
|
|
[75]FcLangSetCopy -- copy a langset object
|
|
|
|
|
|
|
|
|
|
[76]FcLangSetAdd -- add a language to a langset
|
|
|
|
|
|
|
|
|
|
[77]FcLangSetDel -- delete a language from a langset
|
|
|
|
|
|
|
|
|
|
[78]FcLangSetUnion -- Add langsets
|
|
|
|
|
|
|
|
|
|
[79]FcLangSetSubtract -- Subtract langsets
|
|
|
|
|
|
|
|
|
|
[80]FcLangSetCompare -- compare language sets
|
|
|
|
|
|
|
|
|
|
[81]FcLangSetContains -- check langset subset relation
|
|
|
|
|
|
|
|
|
|
[82]FcLangSetEqual -- test for matching langsets
|
|
|
|
|
|
|
|
|
|
[83]FcLangSetHash -- return a hash value for a langset
|
|
|
|
|
|
|
|
|
|
[84]FcLangSetHasLang -- test langset for language support
|
|
|
|
|
|
|
|
|
|
[85]FcGetDefaultLangs -- Get the default languages list
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[86]FcLangSetGetLangs -- get the list of languages in the langset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[87]FcGetLangs -- Get list of languages
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[88]FcLangNormalize -- Normalize the language string
|
|
|
|
|
|
|
|
|
|
[89]FcLangGetCharSet -- Get character map for a language
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
An FcLangSet is a set of language names (each of which include language
|
|
|
|
|
and an optional territory). They are used when selecting fonts to indicate
|
|
|
|
|
which languages the fonts need to support. Each font is marked, using
|
|
|
|
|
language orthography information built into fontconfig, with the set of
|
|
|
|
|
supported languages.
|
|
|
|
|
|
|
|
|
|
FcLangSetCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetCreate -- create a langset object
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangSet * FcLangSetCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetCreate creates a new FcLangSet object.
|
|
|
|
|
|
|
|
|
|
FcLangSetDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetDestroy -- destroy a langset object
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcLangSetDestroy(FcLangSet *ls);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetDestroy destroys a FcLangSet object, freeing all memory
|
|
|
|
|
associated with it.
|
|
|
|
|
|
|
|
|
|
FcLangSetCopy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetCopy -- copy a langset object
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangSet * FcLangSetCopy(const FcLangSet *ls);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetCopy creates a new FcLangSet object and populates it with the
|
|
|
|
|
contents of ls.
|
|
|
|
|
|
|
|
|
|
FcLangSetAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetAdd -- add a language to a langset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcLangSetAdd(FcLangSet *ls, const FcChar8 *lang);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
lang is added to ls. lang should be of the form Ll-Tt where Ll is a two or
|
|
|
|
|
three letter language from ISO 639 and Tt is a territory from ISO 3166.
|
|
|
|
|
|
|
|
|
|
FcLangSetDel
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetDel -- delete a language from a langset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcLangSetDel(FcLangSet *ls, const FcChar8 *lang);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
lang is removed from ls. lang should be of the form Ll-Tt where Ll is a
|
|
|
|
|
two or three letter language from ISO 639 and Tt is a territory from ISO
|
|
|
|
|
3166.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcLangSetUnion
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetUnion -- Add langsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangSet * FcLangSetUnion(const FcLangSet *ls_a, const FcLangSet *ls_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a set including only those languages found in either ls_a or ls_b.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcLangSetSubtract
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetSubtract -- Subtract langsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangSet * FcLangSetSubtract(const FcLangSet *ls_a, const FcLangSet
|
|
|
|
|
*ls_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a set including only those languages found in ls_a but not in
|
|
|
|
|
ls_b.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcLangSetCompare
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetCompare -- compare language sets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangResult FcLangSetCompare(const FcLangSet *ls_a, const FcLangSet
|
|
|
|
|
*ls_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetCompare compares language coverage for ls_a and ls_b. If they
|
|
|
|
|
share any language and territory pair, this function returns FcLangEqual.
|
|
|
|
|
If they share a language but differ in which territory that language is
|
|
|
|
|
for, this function returns FcLangDifferentTerritory. If they share no
|
|
|
|
|
languages in common, this function returns FcLangDifferentLang.
|
|
|
|
|
|
|
|
|
|
FcLangSetContains
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetContains -- check langset subset relation
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcLangSetContains(const FcLangSet *ls_a, const FcLangSet *ls_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetContains returns FcTrue if ls_a contains every language in ls_b.
|
|
|
|
|
ls_a will 'contain' a language from ls_b if ls_a has exactly the language,
|
|
|
|
|
or either the language or ls_a has no territory.
|
|
|
|
|
|
|
|
|
|
FcLangSetEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetEqual -- test for matching langsets
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcLangSetEqual(const FcLangSet *ls_a, const FcLangSet *ls_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns FcTrue if and only if ls_a supports precisely the same language
|
|
|
|
|
and territory combinations as ls_b.
|
|
|
|
|
|
|
|
|
|
FcLangSetHash
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetHash -- return a hash value for a langset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar32 FcLangSetHash(const FcLangSet *ls);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function returns a value which depends solely on the languages
|
|
|
|
|
supported by ls. Any language which equals ls will have the same result
|
|
|
|
|
from FcLangSetHash. However, two langsets with the same hash value may not
|
|
|
|
|
be equal.
|
|
|
|
|
|
|
|
|
|
FcLangSetHasLang
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetHasLang -- test langset for language support
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcLangResult FcLangSetHasLang(const FcLangSet *ls, const FcChar8 *lang);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcLangSetHasLang checks whether ls supports lang. If ls has a matching
|
|
|
|
|
language and territory pair, this function returns FcLangEqual. If ls has
|
|
|
|
|
a matching language but differs in which territory that language is for,
|
|
|
|
|
this function returns FcLangDifferentTerritory. If ls has no matching
|
|
|
|
|
language, this function returns FcLangDifferentLang.
|
|
|
|
|
|
|
|
|
|
FcGetDefaultLangs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcGetDefaultLangs -- Get the default languages list
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcStrSet * FcGetDefaultLangs(void);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a string set of the default languages according to the environment
|
|
|
|
|
variables on the system. This function looks for them in order of FC_LANG,
|
|
|
|
|
LC_ALL, LC_CTYPE and LANG then. If there are no valid values in those
|
|
|
|
|
environment variables, "en" will be set as fallback.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
|
|
|
|
|
|
|
|
|
version 2.9.91
|
|
|
|
|
|
|
|
|
|
FcLangSetGetLangs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangSetGetLangs -- get the list of languages in the langset
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcStrSet * FcLangSetGetLangs(const FcLangSet *ls);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a string set of all languages in langset.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcGetLangs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcGetLangs -- Get list of languages
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrSet * FcGetLangs(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a string set of all known languages.
|
|
|
|
|
|
|
|
|
|
FcLangNormalize
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangNormalize -- Normalize the language string
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcLangNormalize(const FcChar8 *lang);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns a string to make lang suitable on fontconfig.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.10.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcLangGetCharSet
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcLangGetCharSet -- Get character map for a language
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcCharSet * FcLangGetCharSet(const FcChar8 *lang);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the FcCharMap for a language.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcMatrix
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[90]FcMatrixInit -- initialize an FcMatrix structure
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[91]FcMatrixCopy -- Copy a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[92]FcMatrixEqual -- Compare two matrices
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[93]FcMatrixMultiply -- Multiply matrices
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[94]FcMatrixRotate -- Rotate a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[95]FcMatrixScale -- Scale a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[96]FcMatrixShear -- Shear a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcMatrix structures hold an affine transformation in matrix form.
|
|
|
|
|
|
|
|
|
|
FcMatrixInit
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixInit -- initialize an FcMatrix structure
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixInit(FcMatrix *matrix);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixInit initializes matrix to the identity matrix.
|
|
|
|
|
|
|
|
|
|
FcMatrixCopy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixCopy -- Copy a matrix
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixCopy(const FcMatrix *matrix);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixCopy allocates a new FcMatrix and copies mat into it.
|
|
|
|
|
|
|
|
|
|
FcMatrixEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixEqual -- Compare two matrices
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixEqual(const FcMatrix *matrix1, const FcMatrix *matrix2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixEqual compares matrix1 and matrix2 returning FcTrue when they are
|
|
|
|
|
equal and FcFalse when they are not.
|
|
|
|
|
|
|
|
|
|
FcMatrixMultiply
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixMultiply -- Multiply matrices
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixMultiply(FcMatrix *result, const FcMatrix *matrix1, const
|
|
|
|
|
FcMatrix *matrix2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixMultiply multiplies matrix1 and matrix2 storing the result in
|
|
|
|
|
result.
|
|
|
|
|
|
|
|
|
|
FcMatrixRotate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixRotate -- Rotate a matrix
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixRotate(FcMatrix *matrix, double cos, double sin);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixRotate rotates matrix by the angle who's sine is sin and cosine is
|
|
|
|
|
cos. This is done by multiplying by the matrix:
|
|
|
|
|
|
|
|
|
|
cos -sin
|
|
|
|
|
sin cos
|
|
|
|
|
|
|
|
|
|
FcMatrixScale
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixScale -- Scale a matrix
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixScale(FcMatrix *matrix, double sx, double dy);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixScale multiplies matrix x values by sx and y values by dy. This is
|
|
|
|
|
done by multiplying by the matrix:
|
|
|
|
|
|
|
|
|
|
sx 0
|
|
|
|
|
0 dy
|
|
|
|
|
|
|
|
|
|
FcMatrixShear
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcMatrixShear -- Shear a matrix
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcMatrixShear(FcMatrix *matrix, double sh, double sv);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcMatrixShare shears matrix horizontally by sh and vertically by sv. This
|
|
|
|
|
is done by multiplying by the matrix:
|
|
|
|
|
|
|
|
|
|
1 sh
|
|
|
|
|
sv 1
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcConfig
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[97]FcConfigCreate -- Create a configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[98]FcConfigReference -- Increment config reference count
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[99]FcConfigDestroy -- Destroy a configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[100]FcConfigSetCurrent -- Set configuration as default
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[101]FcConfigGetCurrent -- Return current configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[102]FcConfigUptoDate -- Check timestamps on config files
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[103]FcConfigHome -- return the current home directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[104]FcConfigEnableHome -- controls use of the home directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[105]FcConfigBuildFonts -- Build font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[106]FcConfigGetConfigDirs -- Get config directories
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[107]FcConfigGetFontDirs -- Get font directories
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[108]FcConfigGetConfigFiles -- Get config files
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[109]FcConfigGetCache -- DEPRECATED used to return per-user cache filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[110]FcConfigGetCacheDirs -- return the list of directories searched for
|
2013-03-09 06:33:45 -07:00
|
|
|
|
cache files
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[111]FcConfigGetFonts -- Get config font set
|
|
|
|
|
|
|
|
|
|
[112]FcConfigGetBlanks -- Get config blanks
|
|
|
|
|
|
|
|
|
|
[113]FcConfigGetRescanInterval -- Get config rescan interval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[114]FcConfigSetRescanInterval -- Set config rescan interval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[115]FcConfigAppFontAddFile -- Add font file to font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[116]FcConfigAppFontAddDir -- Add fonts from directory to font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[117]FcConfigAppFontClear -- Remove all app fonts from font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[118]FcConfigSubstituteWithPat -- Execute substitutions
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[119]FcConfigSubstitute -- Execute substitutions
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[120]FcFontMatch -- Return best font
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[121]FcFontSort -- Return list of matching fonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[122]FcFontRenderPrepare -- Prepare pattern for loading font file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[123]FcFontList -- List fonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[124]FcConfigFilename -- Find a config file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[125]FcConfigParseAndLoad -- load a configuration file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[126]FcConfigGetSysRoot -- Obtain the system root directory
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[127]FcConfigSetSysRoot -- Set the system root directory
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
An FcConfig object holds the internal representation of a configuration.
|
|
|
|
|
There is a default configuration which applications may use by passing 0
|
|
|
|
|
to any function using the data within an FcConfig.
|
|
|
|
|
|
|
|
|
|
FcConfigCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigCreate -- Create a configuration
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcConfig * FcConfigCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates an empty configuration.
|
|
|
|
|
|
|
|
|
|
FcConfigReference
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigReference -- Increment config reference count
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcConfig * FcConfigReference(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Add another reference to config. Configs are freed only when the reference
|
|
|
|
|
count reaches zero. If config is NULL, the current configuration is used.
|
|
|
|
|
In that case this function will be similar to FcConfigGetCurrent() except
|
|
|
|
|
that it increments the reference count before returning and the user is
|
|
|
|
|
responsible for destroying the configuration when not needed anymore.
|
|
|
|
|
|
|
|
|
|
FcConfigDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigDestroy -- Destroy a configuration
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcConfigDestroy(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Decrements the config reference count. If all references are gone,
|
|
|
|
|
destroys the configuration and any data associated with it. Note that
|
|
|
|
|
calling this function with the return from FcConfigGetCurrent will cause a
|
|
|
|
|
new configuration to be created for use as current configuration.
|
|
|
|
|
|
|
|
|
|
FcConfigSetCurrent
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigSetCurrent -- Set configuration as default
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigSetCurrent(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Sets the current default configuration to config. Implicitly calls
|
|
|
|
|
FcConfigBuildFonts if necessary, returning FcFalse if that call fails.
|
|
|
|
|
|
|
|
|
|
FcConfigGetCurrent
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetCurrent -- Return current configuration
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcConfig * FcConfigGetCurrent(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the current default configuration.
|
|
|
|
|
|
|
|
|
|
FcConfigUptoDate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigUptoDate -- Check timestamps on config files
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigUptoDate(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Checks all of the files related to config and returns whether any of them
|
|
|
|
|
has been modified since the configuration was created. If config is NULL,
|
|
|
|
|
the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigHome
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigHome -- return the current home directory.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcConfigHome(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Return the current user's home directory, if it is available, and if using
|
|
|
|
|
it is enabled, and NULL otherwise. See also FcConfigEnableHome).
|
|
|
|
|
|
|
|
|
|
FcConfigEnableHome
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigEnableHome -- controls use of the home directory.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigEnableHome(FcBool enable);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
If enable is FcTrue, then Fontconfig will use various files which are
|
|
|
|
|
specified relative to the user's home directory (using the ~ notation in
|
|
|
|
|
the configuration). When enable is FcFalse, then all use of the home
|
|
|
|
|
directory in these contexts will be disabled. The previous setting of the
|
|
|
|
|
value is returned.
|
|
|
|
|
|
|
|
|
|
FcConfigBuildFonts
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigBuildFonts -- Build font database
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigBuildFonts(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Builds the set of available fonts for the given configuration. Note that
|
|
|
|
|
any changes to the configuration after this call have indeterminate
|
|
|
|
|
effects. Returns FcFalse if this operation runs out of memory. If config
|
|
|
|
|
is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetConfigDirs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetConfigDirs -- Get config directories
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrList * FcConfigGetConfigDirs(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the list of font directories specified in the configuration files
|
|
|
|
|
for config. Does not include any subdirectories. If config is NULL, the
|
|
|
|
|
current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetFontDirs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetFontDirs -- Get font directories
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrList * FcConfigGetFontDirs(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the list of font directories in config. This includes the
|
|
|
|
|
configured font directories along with any directories below those in the
|
|
|
|
|
filesystem. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetConfigFiles
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetConfigFiles -- Get config files
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrList * FcConfigGetConfigFiles(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the list of known configuration files used to generate config. If
|
|
|
|
|
config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetCache
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetCache -- DEPRECATED used to return per-user cache filename
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcConfigGetCache(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
With fontconfig no longer using per-user cache files, this function now
|
|
|
|
|
simply returns NULL to indicate that no per-user file exists.
|
|
|
|
|
|
|
|
|
|
FcConfigGetCacheDirs
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetCacheDirs -- return the list of directories searched for cache
|
|
|
|
|
files
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrList * FcConfigGetCacheDirs(const FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcConfigGetCacheDirs returns a string list containing all of the
|
|
|
|
|
directories that fontconfig will search when attempting to load a cache
|
|
|
|
|
file for a font directory. If config is NULL, the current configuration is
|
|
|
|
|
used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetFonts
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetFonts -- Get config font set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcConfigGetFonts(FcConfig *config, FcSetName set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns one of the two sets of fonts from the configuration as specified
|
|
|
|
|
by set. This font set is owned by the library and must not be modified or
|
|
|
|
|
freed. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetBlanks
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetBlanks -- Get config blanks
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBlanks * FcConfigGetBlanks(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the FcBlanks object associated with the given configuration, if no
|
|
|
|
|
blanks were present in the configuration, this function will return 0. The
|
|
|
|
|
returned FcBlanks object if not NULL, is valid as long as the owning
|
|
|
|
|
FcConfig is alive. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigGetRescanInterval
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetRescanInterval -- Get config rescan interval
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcConfigGetRescanInterval(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the interval between automatic checks of the configuration (in
|
|
|
|
|
seconds) specified in config. The configuration is checked during a call
|
|
|
|
|
to FcFontList when this interval has passed since the last check. An
|
|
|
|
|
interval setting of zero disables automatic checks. If config is NULL, the
|
|
|
|
|
current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigSetRescanInterval
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigSetRescanInterval -- Set config rescan interval
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigSetRescanInterval(FcConfig *config, int rescanInterval);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Sets the rescan interval. Returns FcFalse if the interval cannot be set
|
|
|
|
|
(due to allocation failure). Otherwise returns FcTrue. An interval setting
|
|
|
|
|
of zero disables automatic checks. If config is NULL, the current
|
|
|
|
|
configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontAddFile
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontAddFile -- Add font file to font database
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigAppFontAddFile(FcConfig *config, const FcChar8 *file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds an application-specific font to the configuration. Returns FcFalse if
|
|
|
|
|
the fonts cannot be added (due to allocation failure). Otherwise returns
|
|
|
|
|
FcTrue. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontAddDir
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontAddDir -- Add fonts from directory to font database
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigAppFontAddDir(FcConfig *config, const FcChar8 *dir);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Scans the specified directory for fonts, adding each one found to the
|
|
|
|
|
application-specific set of fonts. Returns FcFalse if the fonts cannot be
|
|
|
|
|
added (due to allocation failure). Otherwise returns FcTrue. If config is
|
|
|
|
|
NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontClear
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigAppFontClear -- Remove all app fonts from font database
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcConfigAppFontClear(FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Clears the set of application-specific fonts. If config is NULL, the
|
|
|
|
|
current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcConfigSubstituteWithPat
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigSubstituteWithPat -- Execute substitutions
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigSubstituteWithPat(FcConfig *config, FcPattern *p, FcPattern
|
|
|
|
|
*p_pat, FcMatchKind kind);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Performs the sequence of pattern modification operations, if kind is
|
|
|
|
|
FcMatchPattern, then those tagged as pattern operations are applied, else
|
|
|
|
|
if kind is FcMatchFont, those tagged as font operations are applied and
|
|
|
|
|
p_pat is used for <test> elements with target=pattern. Returns FcFalse if
|
|
|
|
|
the substitution cannot be performed (due to allocation failure).
|
|
|
|
|
Otherwise returns FcTrue. If config is NULL, the current configuration is
|
|
|
|
|
used.
|
|
|
|
|
|
|
|
|
|
FcConfigSubstitute
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigSubstitute -- Execute substitutions
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigSubstitute(FcConfig *config, FcPattern *p, FcMatchKind
|
|
|
|
|
kind);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Calls FcConfigSubstituteWithPat setting p_pat to NULL. Returns FcFalse if
|
|
|
|
|
the substitution cannot be performed (due to allocation failure).
|
|
|
|
|
Otherwise returns FcTrue. If config is NULL, the current configuration is
|
|
|
|
|
used.
|
|
|
|
|
|
|
|
|
|
FcFontMatch
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontMatch -- Return best font
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcFontMatch(FcConfig *config, FcPattern *p, FcResult *result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Finds the font in sets most closely matching pattern and returns the
|
|
|
|
|
result of FcFontRenderPrepare for that font and the provided pattern. This
|
|
|
|
|
function should be called only after FcConfigSubstitute and
|
|
|
|
|
FcDefaultSubstitute have been called for p; otherwise the results will not
|
|
|
|
|
be correct. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcFontSort
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontSort -- Return list of matching fonts
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcFontSort(FcConfig *config, FcPattern *p, FcBool trim,
|
|
|
|
|
FcCharSet **csp, FcResult *result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the list of fonts sorted by closeness to p. If trim is FcTrue,
|
|
|
|
|
elements in the list which don't include Unicode coverage not provided by
|
|
|
|
|
earlier elements in the list are elided. The union of Unicode coverage of
|
|
|
|
|
all of the fonts is returned in csp, if csp is not NULL. This function
|
|
|
|
|
should be called only after FcConfigSubstitute and FcDefaultSubstitute
|
|
|
|
|
have been called for p; otherwise the results will not be correct.
|
|
|
|
|
|
|
|
|
|
The returned FcFontSet references FcPattern structures which may be shared
|
|
|
|
|
by the return value from multiple FcFontSort calls, applications must not
|
|
|
|
|
modify these patterns. Instead, they should be passed, along with p to
|
|
|
|
|
FcFontRenderPrepare which combines them into a complete pattern.
|
|
|
|
|
|
|
|
|
|
The FcFontSet returned by FcFontSort is destroyed by calling
|
|
|
|
|
FcFontSetDestroy. If config is NULL, the current configuration is used.
|
|
|
|
|
|
|
|
|
|
FcFontRenderPrepare
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontRenderPrepare -- Prepare pattern for loading font file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcPattern * FcFontRenderPrepare(FcConfig *config, FcPattern *pat,
|
|
|
|
|
FcPattern *font);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates a new pattern consisting of elements of font not appearing in pat,
|
|
|
|
|
elements of pat not appearing in font and the best matching value from pat
|
|
|
|
|
for elements appearing in both. The result is passed to
|
|
|
|
|
FcConfigSubstituteWithPat with kind FcMatchFont and then returned.
|
|
|
|
|
|
|
|
|
|
FcFontList
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFontList -- List fonts
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcFontList(FcConfig *config, FcPattern *p, FcObjectSet *os);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Selects fonts matching p, creates patterns from those fonts containing
|
|
|
|
|
only the objects in os and returns the set of unique such patterns. If
|
|
|
|
|
config is NULL, the default configuration is checked to be up to date, and
|
|
|
|
|
used.
|
|
|
|
|
|
|
|
|
|
FcConfigFilename
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigFilename -- Find a config file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcConfigFilename(const FcChar8 *name);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Given the specified external entity name, return the associated filename.
|
|
|
|
|
This provides applications a way to convert various configuration file
|
|
|
|
|
references into filename form.
|
|
|
|
|
|
|
|
|
|
A null or empty name indicates that the default configuration file should
|
|
|
|
|
be used; which file this references can be overridden with the
|
|
|
|
|
FONTCONFIG_FILE environment variable. Next, if the name starts with ~, it
|
|
|
|
|
refers to a file in the current users home directory. Otherwise if the
|
|
|
|
|
name doesn't start with '/', it refers to a file in the default
|
|
|
|
|
configuration directory; the built-in default directory can be overridden
|
|
|
|
|
with the FONTCONFIG_PATH environment variable.
|
|
|
|
|
|
|
|
|
|
FcConfigParseAndLoad
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigParseAndLoad -- load a configuration file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcConfigParseAndLoad(FcConfig *config, const FcChar8 *file, FcBool
|
|
|
|
|
complain);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Walks the configuration in 'file' and constructs the internal
|
|
|
|
|
representation in 'config'. Any include files referenced from within
|
|
|
|
|
'file' will be loaded and parsed. If 'complain' is FcFalse, no warning
|
|
|
|
|
will be displayed if 'file' does not exist. Error and warning messages
|
|
|
|
|
will be output to stderr. Returns FcFalse if some error occurred while
|
|
|
|
|
loading the file, either a parse error, semantic error or allocation
|
|
|
|
|
failure. Otherwise returns FcTrue.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcConfigGetSysRoot
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigGetSysRoot -- Obtain the system root directory
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcChar8 * FcConfigGetSysRoot(const FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Obtrains the system root directory in 'config' if available.
|
|
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
|
|
version 2.10.92
|
|
|
|
|
|
|
|
|
|
FcConfigSetSysRoot
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcConfigSetSysRoot -- Set the system root directory
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcConfigSetSysRoot(FcConfig *config, const FcChar8 *sysroot);
|
|
|
|
|
|
|
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Set 'sysroot' as the system root directory. fontconfig prepend 'sysroot'
|
|
|
|
|
to the cache directories in order to allow people to generate caches at
|
|
|
|
|
the build time. Note that this causes changing current config. i.e. this
|
|
|
|
|
function calls FcConfigSetCurrent() internally.
|
|
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
|
|
version 2.10.92
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcObjectType
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[128]FcNameRegisterObjectTypes -- Register object types
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[129]FcNameUnregisterObjectTypes -- Unregister object types
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[130]FcNameGetObjectType -- Lookup an object type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
Provides for application-specified font name object types so that new
|
|
|
|
|
pattern elements can be generated from font names.
|
|
|
|
|
|
|
|
|
|
FcNameRegisterObjectTypes
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameRegisterObjectTypes -- Register object types
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcNameRegisterObjectTypes(const FcObjectType *types, int ntype);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
|
|
|
|
|
FcNameUnregisterObjectTypes
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameUnregisterObjectTypes -- Unregister object types
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcNameUnregisterObjectTypes(const FcObjectType *types, int ntype);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
|
|
|
|
|
FcNameGetObjectType
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameGetObjectType -- Lookup an object type
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcObjectType * FcNameGetObjectType(const char *object);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Return the object type for the pattern element named object.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcConstant
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[131]FcNameRegisterConstants -- Register symbolic constants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[132]FcNameUnregisterConstants -- Unregister symbolic constants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[133]FcNameGetConstant -- Lookup symbolic constant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[134]FcNameConstant -- Get the value for a symbolic constant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
Provides for application-specified symbolic constants for font names.
|
|
|
|
|
|
|
|
|
|
FcNameRegisterConstants
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameRegisterConstants -- Register symbolic constants
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcNameRegisterConstants(const FcConstant *consts, int nconsts);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
|
|
|
|
|
FcNameUnregisterConstants
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameUnregisterConstants -- Unregister symbolic constants
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcNameUnregisterConstants(const FcConstant *consts, int nconsts);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
|
|
|
|
|
FcNameGetConstant
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameGetConstant -- Lookup symbolic constant
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcConstant * FcNameGetConstant(FcChar8 *string);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Return the FcConstant structure related to symbolic constant string.
|
|
|
|
|
|
|
|
|
|
FcNameConstant
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcNameConstant -- Get the value for a symbolic constant
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcNameConstant(FcChar8 *string, int *result);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether a symbolic constant with name string is registered,
|
|
|
|
|
placing the value of the constant in result if present.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcBlanks
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[135]FcBlanksCreate -- Create an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[136]FcBlanksDestroy -- Destroy and FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[137]FcBlanksAdd -- Add a character to an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[138]FcBlanksIsMember -- Query membership in an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
An FcBlanks object holds a list of Unicode chars which are expected to be
|
|
|
|
|
blank when drawn. When scanning new fonts, any glyphs which are empty and
|
|
|
|
|
not in this list will be assumed to be broken and not placed in the
|
|
|
|
|
FcCharSet associated with the font. This provides a significantly more
|
|
|
|
|
accurate CharSet for applications.
|
|
|
|
|
|
|
|
|
|
FcBlanksCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcBlanksCreate -- Create an FcBlanks
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBlanks * FcBlanksCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates an empty FcBlanks object.
|
|
|
|
|
|
|
|
|
|
FcBlanksDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcBlanksDestroy -- Destroy and FcBlanks
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcBlanksDestroy(FcBlanks *b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys an FcBlanks object, freeing any associated memory.
|
|
|
|
|
|
|
|
|
|
FcBlanksAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcBlanksAdd -- Add a character to an FcBlanks
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcBlanksAdd(FcBlanks *b, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a single character to an FcBlanks object, returning FcFalse if this
|
|
|
|
|
process ran out of memory.
|
|
|
|
|
|
|
|
|
|
FcBlanksIsMember
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcBlanksIsMember -- Query membership in an FcBlanks
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcBlanksIsMember(FcBlanks *b, FcChar32 ucs4);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether the specified FcBlanks object contains the indicated
|
|
|
|
|
Unicode value.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcAtomic
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[139]FcAtomicCreate -- create an FcAtomic object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[140]FcAtomicLock -- lock a file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[141]FcAtomicNewFile -- return new temporary file name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[142]FcAtomicOrigFile -- return original file name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[143]FcAtomicReplaceOrig -- replace original with new
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[144]FcAtomicDeleteNew -- delete new file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[145]FcAtomicUnlock -- unlock a file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[146]FcAtomicDestroy -- destroy an FcAtomic object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
These functions provide a safe way to update configuration files, allowing
|
|
|
|
|
ongoing reading of the old configuration file while locked for writing and
|
|
|
|
|
ensuring that a consistent and complete version of the configuration file
|
|
|
|
|
is always available.
|
|
|
|
|
|
|
|
|
|
FcAtomicCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicCreate -- create an FcAtomic object
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcAtomic * FcAtomicCreate(const FcChar8 *file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates a data structure containing data needed to control access to file.
|
|
|
|
|
Writing is done to a separate file. Once that file is complete, the
|
|
|
|
|
original configuration file is atomically replaced so that reading process
|
|
|
|
|
always see a consistent and complete file without the need to lock for
|
|
|
|
|
reading.
|
|
|
|
|
|
|
|
|
|
FcAtomicLock
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicLock -- lock a file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcAtomicLock(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Attempts to lock the file referenced by atomic. Returns FcFalse if the
|
|
|
|
|
file is already locked, else returns FcTrue and leaves the file locked.
|
|
|
|
|
|
|
|
|
|
FcAtomicNewFile
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicNewFile -- return new temporary file name
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcAtomicNewFile(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the filename for writing a new version of the file referenced by
|
|
|
|
|
atomic.
|
|
|
|
|
|
|
|
|
|
FcAtomicOrigFile
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicOrigFile -- return original file name
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcAtomicOrigFile(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the file referenced by atomic.
|
|
|
|
|
|
|
|
|
|
FcAtomicReplaceOrig
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicReplaceOrig -- replace original with new
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcAtomicReplaceOrig(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Replaces the original file referenced by atomic with the new file. Returns
|
|
|
|
|
FcFalse if the file cannot be replaced due to permission issues in the
|
|
|
|
|
filesystem. Otherwise returns FcTrue.
|
|
|
|
|
|
|
|
|
|
FcAtomicDeleteNew
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicDeleteNew -- delete new file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcAtomicDeleteNew(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Deletes the new file. Used in error recovery to back out changes.
|
|
|
|
|
|
|
|
|
|
FcAtomicUnlock
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicUnlock -- unlock a file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcAtomicUnlock(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Unlocks the file.
|
|
|
|
|
|
|
|
|
|
FcAtomicDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcAtomicDestroy -- destroy an FcAtomic object
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcAtomicDestroy(FcAtomic *atomic);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys atomic.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
File and Directory routines
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[147]FcFileScan -- scan a font file
|
|
|
|
|
|
|
|
|
|
[148]FcFileIsDir -- check whether a file is a directory
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[149]FcDirScan -- scan a font directory without caching it
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[150]FcDirSave -- DEPRECATED: formerly used to save a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[151]FcDirCacheUnlink -- Remove all caches related to dir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[152]FcDirCacheValid -- check directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[153]FcDirCacheLoad -- load a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[154]FcDirCacheRescan -- Re-scan a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[155]FcDirCacheRead -- read or construct a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[156]FcDirCacheLoadFile -- load a cache file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[157]FcDirCacheUnload -- unload a cache file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
These routines work with font files and directories, including font
|
|
|
|
|
directory cache files.
|
|
|
|
|
|
|
|
|
|
FcFileScan
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFileScan -- scan a font file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcFileScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache,
|
|
|
|
|
FcBlanks *blanks, const FcChar8 *file, FcBool force);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Scans a single file and adds all fonts found to set. If force is FcTrue,
|
|
|
|
|
then the file is scanned even if associated information is found in cache.
|
|
|
|
|
If file is a directory, it is added to dirs. Whether fonts are found
|
|
|
|
|
depends on fontconfig policy as well as the current configuration.
|
|
|
|
|
Internally, fontconfig will ignore BDF and PCF fonts which are not in
|
|
|
|
|
Unicode (or the effectively equivalent ISO Latin-1) encoding as those are
|
|
|
|
|
not usable by Unicode-based applications. The configuration can ignore
|
|
|
|
|
fonts based on filename or contents of the font file itself. Returns
|
|
|
|
|
FcFalse if any of the fonts cannot be added (due to allocation failure).
|
|
|
|
|
Otherwise returns FcTrue.
|
|
|
|
|
|
|
|
|
|
FcFileIsDir
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcFileIsDir -- check whether a file is a directory
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcFileIsDir(const FcChar8 *file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns FcTrue if file is a directory, otherwise returns FcFalse.
|
|
|
|
|
|
|
|
|
|
FcDirScan
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirScan -- scan a font directory without caching it
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcDirScan(FcFontSet *set, FcStrSet *dirs, FcFileCache *cache,
|
|
|
|
|
FcBlanks *blanks, const FcChar8 *dir, FcBool force);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
If cache is not zero or if force is FcFalse, this function currently
|
|
|
|
|
returns FcFalse. Otherwise, it scans an entire directory and adds all
|
|
|
|
|
fonts found to set. Any subdirectories found are added to dirs. Calling
|
|
|
|
|
this function does not create any cache files. Use FcDirCacheRead() if
|
|
|
|
|
caching is desired.
|
|
|
|
|
|
|
|
|
|
FcDirSave
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirSave -- DEPRECATED: formerly used to save a directory cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcDirSave(FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function now does nothing aside from returning FcFalse. It used to
|
|
|
|
|
creates the per-directory cache file for dir and populates it with the
|
|
|
|
|
fonts in set and subdirectories in dirs. All of this functionality is now
|
|
|
|
|
automatically managed by FcDirCacheLoad and FcDirCacheRead.
|
|
|
|
|
|
|
|
|
|
FcDirCacheUnlink
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheUnlink -- Remove all caches related to dir
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcDirCacheUnlink(const FcChar8 *dir, FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Scans the cache directories in config, removing any instances of the cache
|
|
|
|
|
file for dir. Returns FcFalse when some internal error occurs (out of
|
|
|
|
|
memory, etc). Errors actually unlinking any files are ignored.
|
|
|
|
|
|
|
|
|
|
FcDirCacheValid
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheValid -- check directory cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcDirCacheValid(const FcChar8 *dir);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns FcTrue if dir has an associated valid cache file, else returns
|
|
|
|
|
FcFalse
|
|
|
|
|
|
|
|
|
|
FcDirCacheLoad
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheLoad -- load a directory cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCache * FcDirCacheLoad(const FcChar8 *dir, FcConfig *config, FcChar8
|
|
|
|
|
**cache_file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Loads the cache related to dir. If no cache file exists, returns NULL. The
|
|
|
|
|
name of the cache file is returned in cache_file, unless that is NULL. See
|
|
|
|
|
also FcDirCacheRead.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcDirCacheRescan
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheRescan -- Re-scan a directory cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcCache * FcDirCacheRescan(const FcChar8 *dir, FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Re-scan directories only at dir and update the cache. returns NULL if
|
|
|
|
|
failed.
|
|
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
|
|
version 2.11.1
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcDirCacheRead
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheRead -- read or construct a directory cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCache * FcDirCacheRead(const FcChar8 *dir, FcBool force, FcConfig
|
|
|
|
|
*config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This returns a cache for dir. If force is FcFalse, then an existing, valid
|
|
|
|
|
cache file will be used. Otherwise, a new cache will be created by
|
|
|
|
|
scanning the directory and that returned.
|
|
|
|
|
|
|
|
|
|
FcDirCacheLoadFile
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheLoadFile -- load a cache file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcCache * FcDirCacheLoadFile(const FcChar8 *cache_file, struct stat
|
|
|
|
|
*file_stat);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function loads a directory cache from cache_file. If file_stat is
|
|
|
|
|
non-NULL, it will be filled with the results of stat(2) on the cache file.
|
|
|
|
|
|
|
|
|
|
FcDirCacheUnload
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheUnload -- unload a cache file
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcDirCacheUnload(FcCache *cache);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function dereferences cache. When no other references to it remain,
|
|
|
|
|
all memory associated with the cache will be freed.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcCache routines
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[158]FcCacheDir -- Return directory of cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[159]FcCacheCopySet -- Returns a copy of the fontset from cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[160]FcCacheSubdir -- Return the i'th subdirectory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[161]FcCacheNumSubdir -- Return the number of subdirectories in cache.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[162]FcCacheNumFont -- Returns the number of fonts in cache.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[163]FcDirCacheClean -- This tries to clean up the cache directory of
|
2013-03-09 06:33:45 -07:00
|
|
|
|
cache_dir. This returns FcTrue if the operation is successfully complete.
|
|
|
|
|
otherwise FcFalse.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[164]FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
These routines work with font directory caches, accessing their contents
|
|
|
|
|
in limited ways. It is not expected that normal applications will need to
|
|
|
|
|
use these functions.
|
|
|
|
|
|
|
|
|
|
FcCacheDir
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheDir -- Return directory of cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcChar8 * FcCacheDir(const FcCache *cache);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function returns the directory from which the cache was constructed.
|
|
|
|
|
|
|
|
|
|
FcCacheCopySet
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheCopySet -- Returns a copy of the fontset from cache
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcFontSet * FcCacheCopySet(const FcCache *cache);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
The returned fontset contains each of the font patterns from cache. This
|
|
|
|
|
fontset may be modified, but the patterns from the cache are read-only.
|
|
|
|
|
|
|
|
|
|
FcCacheSubdir
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheSubdir -- Return the i'th subdirectory.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
const FcChar8 * FcCacheSubdir(const FcCache *cache, inti);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
The set of subdirectories stored in a cache file are indexed by this
|
|
|
|
|
function, i should range from 0 to n-1, where n is the return value from
|
|
|
|
|
FcCacheNumSubdir.
|
|
|
|
|
|
|
|
|
|
FcCacheNumSubdir
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheNumSubdir -- Return the number of subdirectories in cache.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcCacheNumSubdir(const FcCache *cache);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This returns the total number of subdirectories in the cache.
|
|
|
|
|
|
|
|
|
|
FcCacheNumFont
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheNumFont -- Returns the number of fonts in cache.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcCacheNumFont(const FcCache *cache);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This returns the number of fonts which would be included in the return
|
|
|
|
|
from FcCacheCopySet.
|
|
|
|
|
|
|
|
|
|
FcDirCacheClean
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcDirCacheClean -- This tries to clean up the cache directory of
|
|
|
|
|
cache_dir. This returns FcTrue if the operation is successfully complete.
|
|
|
|
|
otherwise FcFalse.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcDirCacheClean(const FcChar8 *cache_dir, FcBoolverbose);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcCacheCreateTagFile
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory.
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcCacheCreateTagFile(const FcConfig *config);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This tries to create CACHEDIR.TAG file at the cache directory registered
|
|
|
|
|
to config.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
version 2.9.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
FcStrSet and FcStrList
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[165]FcStrSetCreate -- create a string set
|
|
|
|
|
|
|
|
|
|
[166]FcStrSetMember -- check set for membership
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[167]FcStrSetEqual -- check sets for equality
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[168]FcStrSetAdd -- add to a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[169]FcStrSetAddFilename -- add a filename to a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[170]FcStrSetDel -- delete from a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[171]FcStrSetDestroy -- destroy a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[172]FcStrListCreate -- create a string iterator
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[173]FcStrListFirst -- get first string in iteration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[174]FcStrListNext -- get next string in iteration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[175]FcStrListDone -- destroy a string iterator
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
A data structure for enumerating strings, used to list directories while
|
|
|
|
|
scanning the configuration as directories are added while scanning.
|
|
|
|
|
|
|
|
|
|
FcStrSetCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetCreate -- create a string set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrSet * FcStrSetCreate(void);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Create an empty set.
|
|
|
|
|
|
|
|
|
|
FcStrSetMember
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetMember -- check set for membership
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcStrSetMember(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether s is a member of set.
|
|
|
|
|
|
|
|
|
|
FcStrSetEqual
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetEqual -- check sets for equality
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcStrSetEqual(FcStrSet *set_a, FcStrSet *set_b);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns whether set_a contains precisely the same strings as set_b.
|
|
|
|
|
Ordering of strings within the two sets is not considered.
|
|
|
|
|
|
|
|
|
|
FcStrSetAdd
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetAdd -- add to a string set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcStrSetAdd(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a copy of s to set.
|
|
|
|
|
|
|
|
|
|
FcStrSetAddFilename
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetAddFilename -- add a filename to a string set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcStrSetAddFilename(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Adds a copy s to set, The copy is created with FcStrCopyFilename so that
|
|
|
|
|
leading '~' values are replaced with the value of the HOME environment
|
|
|
|
|
variable.
|
|
|
|
|
|
|
|
|
|
FcStrSetDel
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetDel -- delete from a string set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcStrSetDel(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Removes s from set, returning FcTrue if s was a member else FcFalse.
|
|
|
|
|
|
|
|
|
|
FcStrSetDestroy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrSetDestroy -- destroy a string set
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcStrSetDestroy(FcStrSet *set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys set.
|
|
|
|
|
|
|
|
|
|
FcStrListCreate
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrListCreate -- create a string iterator
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcStrList * FcStrListCreate(FcStrSet *set);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Creates an iterator to list the strings in set.
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
FcStrListFirst
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrListFirst -- get first string in iteration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcStrListFirst(FcStrList *list);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the first string in list.
|
|
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
|
|
version 2.11.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcStrListNext
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrListNext -- get next string in iteration
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrListNext(FcStrList *list);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
Returns the next string in list.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
FcStrListDone
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrListDone -- destroy a string iterator
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcStrListDone(FcStrList *list);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Destroys the enumerator list.
|
|
|
|
|
|
|
|
|
|
--------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
String utilities
|
|
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[176]FcUtf8ToUcs4 -- convert UTF-8 to UCS4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[177]FcUcs4ToUtf8 -- convert UCS4 to UTF-8
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[178]FcUtf8Len -- count UTF-8 encoded chars
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[179]FcUtf16ToUcs4 -- convert UTF-16 to UCS4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[180]FcUtf16Len -- count UTF-16 encoded chars
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[181]FcIsLower -- check for lower case ASCII character
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[182]FcIsUpper -- check for upper case ASCII character
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[183]FcToLower -- convert upper case ASCII to lower case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[184]FcStrCopy -- duplicate a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[185]FcStrDowncase -- create a lower case translation of a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[186]FcStrCopyFilename -- create a complete path from a filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[187]FcStrCmp -- compare UTF-8 strings
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[188]FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[189]FcStrStr -- locate UTF-8 substring
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[190]FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[191]FcStrPlus -- concatenate two strings
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[192]FcStrFree -- free a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[193]FcStrDirname -- directory part of filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
|
[194]FcStrBasename -- last component of filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
|
|
Fontconfig manipulates many UTF-8 strings represented with the FcChar8
|
|
|
|
|
type. These functions are exposed to help applications deal with these
|
|
|
|
|
UTF-8 strings in a locale-insensitive manner.
|
|
|
|
|
|
|
|
|
|
FcUtf8ToUcs4
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcUtf8ToUcs4 -- convert UTF-8 to UCS4
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcUtf8ToUcs4(FcChar8 *src, FcChar32 *dst, int len);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts the next Unicode char from src into dst and returns the number of
|
|
|
|
|
bytes containing the char. src must be at least len bytes long.
|
|
|
|
|
|
|
|
|
|
FcUcs4ToUtf8
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcUcs4ToUtf8 -- convert UCS4 to UTF-8
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcUcs4ToUtf8(FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN]);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts the Unicode char from src into dst and returns the number of
|
|
|
|
|
bytes needed to encode the char.
|
|
|
|
|
|
|
|
|
|
FcUtf8Len
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcUtf8Len -- count UTF-8 encoded chars
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcUtf8Len(FcChar8 *src, int len, int *nchar, int *wchar);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Counts the number of Unicode chars in len bytes of src. Places that count
|
|
|
|
|
in nchar. wchar contains 1, 2 or 4 depending on the number of bytes needed
|
|
|
|
|
to hold the largest Unicode char counted. The return value indicates
|
|
|
|
|
whether src is a well-formed UTF8 string.
|
|
|
|
|
|
|
|
|
|
FcUtf16ToUcs4
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcUtf16ToUcs4 -- convert UTF-16 to UCS4
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcUtf16ToUcs4(FcChar8 *src, FcEndian endian, FcChar32 *dst, int len);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Converts the next Unicode char from src into dst and returns the number of
|
|
|
|
|
bytes containing the char. src must be at least len bytes long. Bytes of
|
|
|
|
|
src are combined into 16-bit units according to endian.
|
|
|
|
|
|
|
|
|
|
FcUtf16Len
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcUtf16Len -- count UTF-16 encoded chars
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcUtf16Len(FcChar8 *src, FcEndian endian, int len, int *nchar, int
|
|
|
|
|
*wchar);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Counts the number of Unicode chars in len bytes of src. Bytes of src are
|
|
|
|
|
combined into 16-bit units according to endian. Places that count in
|
|
|
|
|
nchar. wchar contains 1, 2 or 4 depending on the number of bytes needed to
|
|
|
|
|
hold the largest Unicode char counted. The return value indicates whether
|
|
|
|
|
string is a well-formed UTF16 string.
|
|
|
|
|
|
|
|
|
|
FcIsLower
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcIsLower -- check for lower case ASCII character
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcIsLower(FcChar8c);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This macro checks whether c is an lower case ASCII letter.
|
|
|
|
|
|
|
|
|
|
FcIsUpper
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcIsUpper -- check for upper case ASCII character
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcBool FcIsUpper(FcChar8c);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This macro checks whether c is a upper case ASCII letter.
|
|
|
|
|
|
|
|
|
|
FcToLower
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcToLower -- convert upper case ASCII to lower case
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 FcToLower(FcChar8c);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This macro converts upper case ASCII c to the equivalent lower case
|
|
|
|
|
letter.
|
|
|
|
|
|
|
|
|
|
FcStrCopy
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrCopy -- duplicate a string
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrCopy(const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Allocates memory, copies s and returns the resulting buffer. Yes, this is
|
|
|
|
|
strdup, but that function isn't available on every platform.
|
|
|
|
|
|
|
|
|
|
FcStrDowncase
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrDowncase -- create a lower case translation of a string
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrDowncase(const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Allocates memory, copies s, converting upper case letters to lower case
|
|
|
|
|
and returns the allocated buffer.
|
|
|
|
|
|
|
|
|
|
FcStrCopyFilename
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrCopyFilename -- create a complete path from a filename
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrCopyFilename(const FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
FcStrCopyFilename constructs an absolute pathname from s. It converts any
|
|
|
|
|
leading '~' characters in to the value of the HOME environment variable,
|
|
|
|
|
and any relative paths are converted to absolute paths using the current
|
|
|
|
|
working directory. Sequences of '/' characters are converted to a single
|
|
|
|
|
'/', and names containing the current directory '.' or parent directory
|
|
|
|
|
'..' are correctly reconstructed. Returns NULL if '~' is the leading
|
|
|
|
|
character and HOME is unset or disabled (see FcConfigEnableHome).
|
|
|
|
|
|
|
|
|
|
FcStrCmp
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrCmp -- compare UTF-8 strings
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcStrCmp(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the usual <0, 0, >0 result of comparing s1 and s2.
|
|
|
|
|
|
|
|
|
|
FcStrCmpIgnoreCase
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
int FcStrCmpIgnoreCase(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the usual <0, 0, >0 result of comparing s1 and s2. This test is
|
|
|
|
|
case-insensitive for all proper UTF-8 encoded strings.
|
|
|
|
|
|
|
|
|
|
FcStrStr
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrStr -- locate UTF-8 substring
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrStr(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the location of s2 in s1. Returns NULL if s2 is not present in s1.
|
|
|
|
|
This test will operate properly with UTF8 encoded strings.
|
|
|
|
|
|
|
|
|
|
FcStrStrIgnoreCase
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII case
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrStrIgnoreCase(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the location of s2 in s1, ignoring case. Returns NULL if s2 is not
|
|
|
|
|
present in s1. This test is case-insensitive for all proper UTF-8 encoded
|
|
|
|
|
strings.
|
|
|
|
|
|
|
|
|
|
FcStrPlus
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrPlus -- concatenate two strings
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrPlus(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This function allocates new storage and places the concatenation of s1 and
|
|
|
|
|
s2 there, returning the new string.
|
|
|
|
|
|
|
|
|
|
FcStrFree
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrFree -- free a string
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
void FcStrFree(FcChar8 *s);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
This is just a wrapper around free(3) which helps track memory usage of
|
|
|
|
|
strings within the fontconfig library.
|
|
|
|
|
|
|
|
|
|
FcStrDirname
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrDirname -- directory part of filename
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrDirname(const FcChar8 *file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the directory containing file. This is returned in newly allocated
|
|
|
|
|
storage which should be freed when no longer needed.
|
|
|
|
|
|
|
|
|
|
FcStrBasename
|
|
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
|
|
FcStrBasename -- last component of filename
|
|
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FcChar8 * FcStrBasename(const FcChar8 *file);
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
|
|
Returns the filename of file stripped of any leading directory names. This
|
|
|
|
|
is returned in newly allocated storage which should be freed when no
|
|
|
|
|
longer needed.
|
|
|
|
|
|
|
|
|
|
References
|
|
|
|
|
|
|
|
|
|
Visible links
|
2014-05-18 04:33:03 -06:00
|
|
|
|
1. file:///tmp/html-rhkMLA#AEN16
|
|
|
|
|
2. file:///tmp/html-rhkMLA#AEN19
|
|
|
|
|
3. file:///tmp/html-rhkMLA#AEN31
|
|
|
|
|
4. file:///tmp/html-rhkMLA#AEN102
|
|
|
|
|
5. file:///tmp/html-rhkMLA#FCINITLOADCONFIG
|
|
|
|
|
6. file:///tmp/html-rhkMLA#FCINITLOADCONFIGANDFONTS
|
|
|
|
|
7. file:///tmp/html-rhkMLA#FCINIT
|
|
|
|
|
8. file:///tmp/html-rhkMLA#FCFINI
|
|
|
|
|
9. file:///tmp/html-rhkMLA#FCGETVERSION
|
|
|
|
|
10. file:///tmp/html-rhkMLA#FCINITREINITIALIZE
|
|
|
|
|
11. file:///tmp/html-rhkMLA#FCINITBRINGUPTODATE
|
|
|
|
|
12. file:///tmp/html-rhkMLA#FCPATTERNCREATE
|
|
|
|
|
13. file:///tmp/html-rhkMLA#FCPATTERNDUPLICATE
|
|
|
|
|
14. file:///tmp/html-rhkMLA#FCPATTERNREFERENCE
|
|
|
|
|
15. file:///tmp/html-rhkMLA#FCPATTERNDESTROY
|
|
|
|
|
16. file:///tmp/html-rhkMLA#FCPATTERNEQUAL
|
|
|
|
|
17. file:///tmp/html-rhkMLA#FCPATTERNEQUALSUBSET
|
|
|
|
|
18. file:///tmp/html-rhkMLA#FCPATTERNFILTER
|
|
|
|
|
19. file:///tmp/html-rhkMLA#FCPATTERNHASH
|
|
|
|
|
20. file:///tmp/html-rhkMLA#FCPATTERNADD
|
|
|
|
|
21. file:///tmp/html-rhkMLA#FCPATTERNADDWEAK
|
|
|
|
|
22. file:///tmp/html-rhkMLA#FCPATTERNADD-TYPE
|
|
|
|
|
23. file:///tmp/html-rhkMLA#FCPATTERNGET
|
|
|
|
|
24. file:///tmp/html-rhkMLA#FCPATTERNGET-TYPE
|
|
|
|
|
25. file:///tmp/html-rhkMLA#FCPATTERNBUILD
|
|
|
|
|
26. file:///tmp/html-rhkMLA#FCPATTERNDEL
|
|
|
|
|
27. file:///tmp/html-rhkMLA#FCPATTERNREMOVE
|
|
|
|
|
28. file:///tmp/html-rhkMLA#FCPATTERNPRINT
|
|
|
|
|
29. file:///tmp/html-rhkMLA#FCDEFAULTSUBSTITUTE
|
|
|
|
|
30. file:///tmp/html-rhkMLA#FCNAMEPARSE
|
|
|
|
|
31. file:///tmp/html-rhkMLA#FCNAMEUNPARSE
|
|
|
|
|
32. file:///tmp/html-rhkMLA#FCPATTERNFORMAT
|
|
|
|
|
33. file:///tmp/html-rhkMLA#FCFONTSETCREATE
|
|
|
|
|
34. file:///tmp/html-rhkMLA#FCFONTSETDESTROY
|
|
|
|
|
35. file:///tmp/html-rhkMLA#FCFONTSETADD
|
|
|
|
|
36. file:///tmp/html-rhkMLA#FCFONTSETLIST
|
|
|
|
|
37. file:///tmp/html-rhkMLA#FCFONTSETMATCH
|
|
|
|
|
38. file:///tmp/html-rhkMLA#FCFONTSETPRINT
|
|
|
|
|
39. file:///tmp/html-rhkMLA#FCFONTSETSORT
|
|
|
|
|
40. file:///tmp/html-rhkMLA#FCFONTSETSORTDESTROY
|
|
|
|
|
41. file:///tmp/html-rhkMLA#FCOBJECTSETCREATE
|
|
|
|
|
42. file:///tmp/html-rhkMLA#FCOBJECTSETADD
|
|
|
|
|
43. file:///tmp/html-rhkMLA#FCOBJECTSETDESTROY
|
|
|
|
|
44. file:///tmp/html-rhkMLA#FCOBJECTSETBUILD
|
|
|
|
|
45. file:///tmp/html-rhkMLA#FCFREETYPECHARINDEX
|
|
|
|
|
46. file:///tmp/html-rhkMLA#FCFREETYPECHARSET
|
|
|
|
|
47. file:///tmp/html-rhkMLA#FCFREETYPECHARSETANDSPACING
|
|
|
|
|
48. file:///tmp/html-rhkMLA#FCFREETYPEQUERY
|
|
|
|
|
49. file:///tmp/html-rhkMLA#FCFREETYPEQUERYFACE
|
|
|
|
|
50. file:///tmp/html-rhkMLA#FCVALUEDESTROY
|
|
|
|
|
51. file:///tmp/html-rhkMLA#FCVALUESAVE
|
|
|
|
|
52. file:///tmp/html-rhkMLA#FCVALUEPRINT
|
|
|
|
|
53. file:///tmp/html-rhkMLA#FCVALUEEQUAL
|
|
|
|
|
54. file:///tmp/html-rhkMLA#FCCHARSETCREATE
|
|
|
|
|
55. file:///tmp/html-rhkMLA#FCCHARSETDESTROY
|
|
|
|
|
56. file:///tmp/html-rhkMLA#FCCHARSETADDCHAR
|
|
|
|
|
57. file:///tmp/html-rhkMLA#FCCHARSETDELCHAR
|
|
|
|
|
58. file:///tmp/html-rhkMLA#FCCHARSETCOPY
|
|
|
|
|
59. file:///tmp/html-rhkMLA#FCCHARSETEQUAL
|
|
|
|
|
60. file:///tmp/html-rhkMLA#FCCHARSETINTERSECT
|
|
|
|
|
61. file:///tmp/html-rhkMLA#FCCHARSETUNION
|
|
|
|
|
62. file:///tmp/html-rhkMLA#FCCHARSETSUBTRACT
|
|
|
|
|
63. file:///tmp/html-rhkMLA#FCCHARSETMERGE
|
|
|
|
|
64. file:///tmp/html-rhkMLA#FCCHARSETHASCHAR
|
|
|
|
|
65. file:///tmp/html-rhkMLA#FCCHARSETCOUNT
|
|
|
|
|
66. file:///tmp/html-rhkMLA#FCCHARSETINTERSECTCOUNT
|
|
|
|
|
67. file:///tmp/html-rhkMLA#FCCHARSETSUBTRACTCOUNT
|
|
|
|
|
68. file:///tmp/html-rhkMLA#FCCHARSETISSUBSET
|
|
|
|
|
69. file:///tmp/html-rhkMLA#FCCHARSETFIRSTPAGE
|
|
|
|
|
70. file:///tmp/html-rhkMLA#FCCHARSETNEXTPAGE
|
|
|
|
|
71. file:///tmp/html-rhkMLA#FCCHARSETCOVERAGE
|
|
|
|
|
72. file:///tmp/html-rhkMLA#FCCHARSETNEW
|
|
|
|
|
73. file:///tmp/html-rhkMLA#FCLANGSETCREATE
|
|
|
|
|
74. file:///tmp/html-rhkMLA#FCLANGSETDESTROY
|
|
|
|
|
75. file:///tmp/html-rhkMLA#FCLANGSETCOPY
|
|
|
|
|
76. file:///tmp/html-rhkMLA#FCLANGSETADD
|
|
|
|
|
77. file:///tmp/html-rhkMLA#FCLANGSETDEL
|
|
|
|
|
78. file:///tmp/html-rhkMLA#FCLANGSETUNION
|
|
|
|
|
79. file:///tmp/html-rhkMLA#FCLANGSETSUBTRACT
|
|
|
|
|
80. file:///tmp/html-rhkMLA#FCLANGSETCOMPARE
|
|
|
|
|
81. file:///tmp/html-rhkMLA#FCLANGSETCONTAINS
|
|
|
|
|
82. file:///tmp/html-rhkMLA#FCLANGSETEQUAL
|
|
|
|
|
83. file:///tmp/html-rhkMLA#FCLANGSETHASH
|
|
|
|
|
84. file:///tmp/html-rhkMLA#FCLANGSETHASLANG
|
|
|
|
|
85. file:///tmp/html-rhkMLA#FCGETDEFAULTLANGS
|
|
|
|
|
86. file:///tmp/html-rhkMLA#FCLANGSETGETLANGS
|
|
|
|
|
87. file:///tmp/html-rhkMLA#FCGETLANGS
|
|
|
|
|
88. file:///tmp/html-rhkMLA#FCLANGNORMALIZE
|
|
|
|
|
89. file:///tmp/html-rhkMLA#FCLANGGETCHARSET
|
|
|
|
|
90. file:///tmp/html-rhkMLA#FCMATRIXINIT
|
|
|
|
|
91. file:///tmp/html-rhkMLA#FCMATRIXCOPY
|
|
|
|
|
92. file:///tmp/html-rhkMLA#FCMATRIXEQUAL
|
|
|
|
|
93. file:///tmp/html-rhkMLA#FCMATRIXMULTIPLY
|
|
|
|
|
94. file:///tmp/html-rhkMLA#FCMATRIXROTATE
|
|
|
|
|
95. file:///tmp/html-rhkMLA#FCMATRIXSCALE
|
|
|
|
|
96. file:///tmp/html-rhkMLA#FCMATRIXSHEAR
|
|
|
|
|
97. file:///tmp/html-rhkMLA#FCCONFIGCREATE
|
|
|
|
|
98. file:///tmp/html-rhkMLA#FCCONFIGREFERENCE
|
|
|
|
|
99. file:///tmp/html-rhkMLA#FCCONFIGDESTROY
|
|
|
|
|
100. file:///tmp/html-rhkMLA#FCCONFIGSETCURRENT
|
|
|
|
|
101. file:///tmp/html-rhkMLA#FCCONFIGGETCURRENT
|
|
|
|
|
102. file:///tmp/html-rhkMLA#FCCONFIGUPTODATE
|
|
|
|
|
103. file:///tmp/html-rhkMLA#FCCONFIGHOME
|
|
|
|
|
104. file:///tmp/html-rhkMLA#FCCONFIGENABLEHOME
|
|
|
|
|
105. file:///tmp/html-rhkMLA#FCCONFIGBUILDFONTS
|
|
|
|
|
106. file:///tmp/html-rhkMLA#FCCONFIGGETCONFIGDIRS
|
|
|
|
|
107. file:///tmp/html-rhkMLA#FCCONFIGGETFONTDIRS
|
|
|
|
|
108. file:///tmp/html-rhkMLA#FCCONFIGGETCONFIGFILES
|
|
|
|
|
109. file:///tmp/html-rhkMLA#FCCONFIGGETCACHE
|
|
|
|
|
110. file:///tmp/html-rhkMLA#FCCONFIGGETCACHEDIRS
|
|
|
|
|
111. file:///tmp/html-rhkMLA#FCCONFIGGETFONTS
|
|
|
|
|
112. file:///tmp/html-rhkMLA#FCCONFIGGETBLANKS
|
|
|
|
|
113. file:///tmp/html-rhkMLA#FCCONFIGGETRESCANINTERVAL
|
|
|
|
|
114. file:///tmp/html-rhkMLA#FCCONFIGSETRESCANINTERVAL
|
|
|
|
|
115. file:///tmp/html-rhkMLA#FCCONFIGAPPFONTADDFILE
|
|
|
|
|
116. file:///tmp/html-rhkMLA#FCCONFIGAPPFONTADDDIR
|
|
|
|
|
117. file:///tmp/html-rhkMLA#FCCONFIGAPPFONTCLEAR
|
|
|
|
|
118. file:///tmp/html-rhkMLA#FCCONFIGSUBSTITUTEWITHPAT
|
|
|
|
|
119. file:///tmp/html-rhkMLA#FCCONFIGSUBSTITUTE
|
|
|
|
|
120. file:///tmp/html-rhkMLA#FCFONTMATCH
|
|
|
|
|
121. file:///tmp/html-rhkMLA#FCFONTSORT
|
|
|
|
|
122. file:///tmp/html-rhkMLA#FCFONTRENDERPREPARE
|
|
|
|
|
123. file:///tmp/html-rhkMLA#FCFONTLIST
|
|
|
|
|
124. file:///tmp/html-rhkMLA#FCCONFIGFILENAME
|
|
|
|
|
125. file:///tmp/html-rhkMLA#FCCONFIGPARSEANDLOAD
|
|
|
|
|
126. file:///tmp/html-rhkMLA#FCCONFIGGETSYSROOT
|
|
|
|
|
127. file:///tmp/html-rhkMLA#FCCONFIGSETSYSROOT
|
|
|
|
|
128. file:///tmp/html-rhkMLA#FCNAMEREGISTEROBJECTTYPES
|
|
|
|
|
129. file:///tmp/html-rhkMLA#FCNAMEUNREGISTEROBJECTTYPES
|
|
|
|
|
130. file:///tmp/html-rhkMLA#FCNAMEGETOBJECTTYPE
|
|
|
|
|
131. file:///tmp/html-rhkMLA#FCNAMEREGISTERCONSTANTS
|
|
|
|
|
132. file:///tmp/html-rhkMLA#FCNAMEUNREGISTERCONSTANTS
|
|
|
|
|
133. file:///tmp/html-rhkMLA#FCNAMEGETCONSTANT
|
|
|
|
|
134. file:///tmp/html-rhkMLA#FCNAMECONSTANT
|
|
|
|
|
135. file:///tmp/html-rhkMLA#FCBLANKSCREATE
|
|
|
|
|
136. file:///tmp/html-rhkMLA#FCBLANKSDESTROY
|
|
|
|
|
137. file:///tmp/html-rhkMLA#FCBLANKSADD
|
|
|
|
|
138. file:///tmp/html-rhkMLA#FCBLANKSISMEMBER
|
|
|
|
|
139. file:///tmp/html-rhkMLA#FCATOMICCREATE
|
|
|
|
|
140. file:///tmp/html-rhkMLA#FCATOMICLOCK
|
|
|
|
|
141. file:///tmp/html-rhkMLA#FCATOMICNEWFILE
|
|
|
|
|
142. file:///tmp/html-rhkMLA#FCATOMICORIGFILE
|
|
|
|
|
143. file:///tmp/html-rhkMLA#FCATOMICREPLACEORIG
|
|
|
|
|
144. file:///tmp/html-rhkMLA#FCATOMICDELETENEW
|
|
|
|
|
145. file:///tmp/html-rhkMLA#FCATOMICUNLOCK
|
|
|
|
|
146. file:///tmp/html-rhkMLA#FCATOMICDESTROY
|
|
|
|
|
147. file:///tmp/html-rhkMLA#FCFILESCAN
|
|
|
|
|
148. file:///tmp/html-rhkMLA#FCFILEISDIR
|
|
|
|
|
149. file:///tmp/html-rhkMLA#FCDIRSCAN
|
|
|
|
|
150. file:///tmp/html-rhkMLA#FCDIRSAVE
|
|
|
|
|
151. file:///tmp/html-rhkMLA#FCDIRCACHEUNLINK
|
|
|
|
|
152. file:///tmp/html-rhkMLA#FCDIRCACHEVALID
|
|
|
|
|
153. file:///tmp/html-rhkMLA#FCDIRCACHELOAD
|
|
|
|
|
154. file:///tmp/html-rhkMLA#FCDIRCACHERESCAN
|
|
|
|
|
155. file:///tmp/html-rhkMLA#FCDIRCACHEREAD
|
|
|
|
|
156. file:///tmp/html-rhkMLA#FCDIRCACHELOADFILE
|
|
|
|
|
157. file:///tmp/html-rhkMLA#FCDIRCACHEUNLOAD
|
|
|
|
|
158. file:///tmp/html-rhkMLA#FCCACHEDIR
|
|
|
|
|
159. file:///tmp/html-rhkMLA#FCCACHECOPYSET
|
|
|
|
|
160. file:///tmp/html-rhkMLA#FCCACHESUBDIR
|
|
|
|
|
161. file:///tmp/html-rhkMLA#FCCACHENUMSUBDIR
|
|
|
|
|
162. file:///tmp/html-rhkMLA#FCCACHENUMFONT
|
|
|
|
|
163. file:///tmp/html-rhkMLA#FCDIRCACHECLEAN
|
|
|
|
|
164. file:///tmp/html-rhkMLA#FCCACHECREATETAGFILE
|
|
|
|
|
165. file:///tmp/html-rhkMLA#FCSTRSETCREATE
|
|
|
|
|
166. file:///tmp/html-rhkMLA#FCSTRSETMEMBER
|
|
|
|
|
167. file:///tmp/html-rhkMLA#FCSTRSETEQUAL
|
|
|
|
|
168. file:///tmp/html-rhkMLA#FCSTRSETADD
|
|
|
|
|
169. file:///tmp/html-rhkMLA#FCSTRSETADDFILENAME
|
|
|
|
|
170. file:///tmp/html-rhkMLA#FCSTRSETDEL
|
|
|
|
|
171. file:///tmp/html-rhkMLA#FCSTRSETDESTROY
|
|
|
|
|
172. file:///tmp/html-rhkMLA#FCSTRLISTCREATE
|
|
|
|
|
173. file:///tmp/html-rhkMLA#FCSTRLISTFIRST
|
|
|
|
|
174. file:///tmp/html-rhkMLA#FCSTRLISTNEXT
|
|
|
|
|
175. file:///tmp/html-rhkMLA#FCSTRLISTDONE
|
|
|
|
|
176. file:///tmp/html-rhkMLA#FCUTF8TOUCS4
|
|
|
|
|
177. file:///tmp/html-rhkMLA#FCUCS4TOUTF8
|
|
|
|
|
178. file:///tmp/html-rhkMLA#FCUTF8LEN
|
|
|
|
|
179. file:///tmp/html-rhkMLA#FCUTF16TOUCS4
|
|
|
|
|
180. file:///tmp/html-rhkMLA#FCUTF16LEN
|
|
|
|
|
181. file:///tmp/html-rhkMLA#FCISLOWER
|
|
|
|
|
182. file:///tmp/html-rhkMLA#FCISUPPER
|
|
|
|
|
183. file:///tmp/html-rhkMLA#FCTOLOWER
|
|
|
|
|
184. file:///tmp/html-rhkMLA#FCSTRCOPY
|
|
|
|
|
185. file:///tmp/html-rhkMLA#FCSTRDOWNCASE
|
|
|
|
|
186. file:///tmp/html-rhkMLA#FCSTRCOPYFILENAME
|
|
|
|
|
187. file:///tmp/html-rhkMLA#FCSTRCMP
|
|
|
|
|
188. file:///tmp/html-rhkMLA#FCSTRCMPIGNORECASE
|
|
|
|
|
189. file:///tmp/html-rhkMLA#FCSTRSTR
|
|
|
|
|
190. file:///tmp/html-rhkMLA#FCSTRSTRIGNORECASE
|
|
|
|
|
191. file:///tmp/html-rhkMLA#FCSTRPLUS
|
|
|
|
|
192. file:///tmp/html-rhkMLA#FCSTRFREE
|
|
|
|
|
193. file:///tmp/html-rhkMLA#FCSTRDIRNAME
|
|
|
|
|
194. file:///tmp/html-rhkMLA#FCSTRBASENAME
|