2016-08-09 12:57:41 -06:00
|
|
|
Fontconfig Developers Reference, Version 2.12.1
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Copyright © 2002 Keith Packard
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
_______________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
DESCRIPTION
|
|
|
|
FUNCTIONAL OVERVIEW
|
|
|
|
Datatypes
|
|
|
|
FUNCTIONS
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
|
|
|
Fontconfig is a library designed to provide system-wide font
|
|
|
|
configuration, customization and application access.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FUNCTIONAL OVERVIEW
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
structure and syntax.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
Property Definitions
|
|
|
|
|
|
|
|
Property C Preprocessor Symbol Type Description
|
|
|
|
----------------------------------------------------
|
|
|
|
family FC_FAMILY String Font family names
|
2016-08-09 12:57:41 -06:00
|
|
|
familylang FC_FAMILYLANG String Language corresponding
|
|
|
|
to
|
2013-03-09 06:33:45 -07:00
|
|
|
each family name
|
2016-08-09 12:57:41 -06:00
|
|
|
style FC_STYLE String Font style. Overrides
|
|
|
|
weight
|
2013-03-09 06:33:45 -07:00
|
|
|
and slant
|
2016-08-09 12:57:41 -06:00
|
|
|
stylelang FC_STYLELANG String Language corresponding
|
|
|
|
to
|
2013-03-09 06:33:45 -07:00
|
|
|
each style name
|
2016-08-09 12:57:41 -06:00
|
|
|
fullname FC_FULLNAME String Font face full name wh
|
|
|
|
ere
|
|
|
|
different from family
|
|
|
|
and
|
2013-03-09 06:33:45 -07:00
|
|
|
family + style
|
2016-08-09 12:57:41 -06:00
|
|
|
fullnamelang FC_FULLNAMELANG String Language corresponding
|
|
|
|
to
|
2013-03-09 06:33:45 -07:00
|
|
|
each fullname
|
2016-08-09 12:57:41 -06:00
|
|
|
slant FC_SLANT Int Italic, oblique or rom
|
|
|
|
an
|
|
|
|
weight FC_WEIGHT Int Light, medium, demibol
|
|
|
|
d,
|
2013-03-09 06:33:45 -07:00
|
|
|
bold or black
|
|
|
|
size FC_SIZE Double Point size
|
2016-08-09 12:57:41 -06:00
|
|
|
width FC_WIDTH Int Condensed, normal or e
|
|
|
|
xpanded
|
|
|
|
aspect FC_ASPECT Double Stretches glyphs horiz
|
|
|
|
ontally
|
2013-03-09 06:33:45 -07:00
|
|
|
before hinting
|
|
|
|
pixelsize FC_PIXEL_SIZE Double Pixel size
|
2016-08-09 12:57:41 -06:00
|
|
|
spacing FC_SPACING Int Proportional, dual-wid
|
|
|
|
th,
|
2013-03-09 06:33:45 -07:00
|
|
|
monospace or charcell
|
|
|
|
foundry FC_FOUNDRY String Font foundry name
|
|
|
|
antialias FC_ANTIALIAS Bool Whether glyphs can be
|
|
|
|
antialiased
|
2016-08-09 12:57:41 -06:00
|
|
|
hinting FC_HINTING Bool Whether the rasterizer
|
|
|
|
should
|
2013-03-09 06:33:45 -07:00
|
|
|
use hinting
|
2016-08-09 12:57:41 -06:00
|
|
|
hintstyle FC_HINT_STYLE Int Automatic hinting styl
|
|
|
|
e
|
2013-03-09 06:33:45 -07:00
|
|
|
verticallayout FC_VERTICAL_LAYOUT Bool Use vertical layout
|
2016-08-09 12:57:41 -06:00
|
|
|
autohint FC_AUTOHINT Bool Use autohinter instead
|
|
|
|
of
|
2013-03-09 06:33:45 -07:00
|
|
|
normal hinter
|
2016-08-09 12:57:41 -06:00
|
|
|
globaladvance FC_GLOBAL_ADVANCE Bool Use font global advanc
|
|
|
|
e data (deprecated)
|
|
|
|
file FC_FILE String The filename holding t
|
|
|
|
he font
|
|
|
|
index FC_INDEX Int The index of the font
|
|
|
|
within
|
2013-03-09 06:33:45 -07:00
|
|
|
the file
|
2016-08-09 12:57:41 -06:00
|
|
|
ftface FC_FT_FACE FT_Face Use the specified Free
|
|
|
|
Type
|
2013-03-09 06:33:45 -07:00
|
|
|
face object
|
2016-08-09 12:57:41 -06:00
|
|
|
rasterizer FC_RASTERIZER String Which rasterizer is in
|
|
|
|
use (deprecated)
|
|
|
|
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 (deprecate
|
|
|
|
d)
|
|
|
|
symbol FC_SYMBOL Bool Whether font uses MS s
|
|
|
|
ymbol-font encoding
|
|
|
|
color FC_COLOR Bool Whether any glyphs hav
|
|
|
|
e color
|
2013-03-09 06:33:45 -07:00
|
|
|
dpi FC_DPI Double Target dots per inch
|
2016-08-09 12:57:41 -06:00
|
|
|
rgba FC_RGBA Int unknown, rgb, bgr, vrg
|
|
|
|
b,
|
|
|
|
vbgr, none - subpixel
|
|
|
|
geometry
|
2013-03-09 06:33:45 -07:00
|
|
|
lcdfilter FC_LCD_FILTER Int Type of LCD filter
|
2016-08-09 12:57:41 -06:00
|
|
|
minspace FC_MINSPACE Bool Eliminate leading from
|
|
|
|
line
|
2013-03-09 06:33:45 -07:00
|
|
|
spacing
|
2016-08-09 12:57:41 -06:00
|
|
|
charset FC_CHARSET CharSet Unicode chars encoded
|
|
|
|
by
|
2013-03-09 06:33:45 -07:00
|
|
|
the font
|
|
|
|
lang FC_LANG LangSet Set of RFC-3066-style
|
2016-08-09 12:57:41 -06:00
|
|
|
languages this font su
|
|
|
|
pports
|
|
|
|
fontversion FC_FONTVERSION Int Version number of the
|
|
|
|
font
|
|
|
|
capability FC_CAPABILITY String List of layout capabil
|
|
|
|
ities in
|
2013-03-09 06:33:45 -07:00
|
|
|
the font
|
2016-08-09 12:57:41 -06:00
|
|
|
fontformat FC_FONTFORMAT String String name of the fon
|
|
|
|
t format
|
2013-03-09 06:33:45 -07:00
|
|
|
embolden FC_EMBOLDEN Bool Rasterizer should
|
2016-08-09 12:57:41 -06:00
|
|
|
synthetically embolden
|
|
|
|
the font
|
|
|
|
embeddedbitmap FC_EMBEDDED_BITMAP Bool Use the embedded bitma
|
|
|
|
p instead
|
|
|
|
of the outline
|
|
|
|
decorative FC_DECORATIVE Bool Whether the style is a
|
|
|
|
decorative
|
|
|
|
variant
|
|
|
|
fontfeatures FC_FONT_FEATURES String List of extra feature
|
|
|
|
tags in
|
2014-05-18 04:33:03 -06:00
|
|
|
OpenType to be enabled
|
2016-08-09 12:57:41 -06:00
|
|
|
namelang FC_NAMELANG String Language name to be us
|
|
|
|
ed for the
|
|
|
|
default value of famil
|
|
|
|
ylang,
|
|
|
|
stylelang and fullname
|
|
|
|
lang
|
|
|
|
prgname FC_PRGNAME String Name of the running pr
|
|
|
|
ogram
|
|
|
|
hash FC_HASH String SHA256 hash value of t
|
|
|
|
he font data
|
|
|
|
with "sha256:" prefix
|
|
|
|
(deprecated)
|
|
|
|
postscriptname FC_POSTSCRIPT_NAME String Font name in PostScrip
|
|
|
|
t
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Datatypes
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Fontconfig uses abstract data types to hide internal
|
|
|
|
implementation details for most data structures. A few
|
|
|
|
structures are exposed where appropriate.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcChar8, FcChar16, FcChar32, FcBool
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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;
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangResult
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcType
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Tags the kind of data stored in an FcValue.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
|
|
|
|
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
the FcSetName enumerated values.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
|
|
|
|
|
|
|
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 matc
|
|
|
|
h
|
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FUNCTIONS
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
These are grouped by functionality, often using the main data
|
|
|
|
type being manipulated.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Initialization
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitLoadConfig -- load configuration
|
|
|
|
FcInitLoadConfigAndFonts -- load configuration and font data
|
|
|
|
FcInit -- initialize fontconfig library
|
|
|
|
FcFini -- finalize fontconfig library
|
|
|
|
FcGetVersion -- library version number
|
|
|
|
FcInitReinitialize -- re-initialize library
|
|
|
|
FcInitBringUptoDate -- reload configuration files if needed
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
These functions provide some control over how the library is
|
|
|
|
initialized.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitLoadConfig
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitLoadConfig -- load configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcConfig * FcInitLoadConfig(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Loads the default configuration file and returns the resulting
|
|
|
|
configuration. Does not load any font information.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitLoadConfigAndFonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitLoadConfigAndFonts -- load configuration and font data
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcConfig * FcInitLoadConfigAndFonts(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Loads the default configuration file and builds information
|
|
|
|
about the available fonts. Returns the resulting configuration.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInit
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInit -- initialize fontconfig library
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcInit(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFini
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFini -- finalize fontconfig library
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcFini(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetVersion
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetVersion -- library version number
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcGetVersion(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the version number of the library.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitReinitialize
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitReinitialize -- re-initialize library
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcInitReinitialize(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitBringUptoDate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcInitBringUptoDate -- reload configuration files if needed
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcInitBringUptoDate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternCreate -- Create a pattern
|
|
|
|
FcPatternDuplicate -- Copy a pattern
|
|
|
|
FcPatternReference -- Increment pattern reference count
|
|
|
|
FcPatternDestroy -- Destroy a pattern
|
|
|
|
FcPatternEqual -- Compare patterns
|
|
|
|
FcPatternEqualSubset -- Compare portions of patterns
|
|
|
|
FcPatternFilter -- Filter the objects of pattern
|
|
|
|
FcPatternHash -- Compute a pattern hash value
|
|
|
|
FcPatternAdd -- Add a value to a pattern
|
|
|
|
FcPatternAddWeak -- Add a value to a pattern with weak binding
|
|
|
|
FcPatternAdd-Type -- Add a typed value to a pattern
|
|
|
|
FcPatternGet -- Return a value from a pattern
|
|
|
|
FcPatternGet-Type -- Return a typed value from a pattern
|
|
|
|
FcPatternBuild -- Create patterns from arguments
|
|
|
|
FcPatternDel -- Delete a property from a pattern
|
|
|
|
FcPatternRemove -- Remove one object of the specified type from
|
|
|
|
the pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternPrint -- Print a pattern for debugging
|
|
|
|
FcDefaultSubstitute -- Perform default substitutions in a
|
|
|
|
pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameParse -- Parse a pattern string
|
|
|
|
FcNameUnparse -- Convert a pattern back into a string that can
|
|
|
|
be parsed
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternFormat -- Format a pattern into a string according to
|
|
|
|
a format specifier
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
An FcPattern is an opaque type that holds both patterns to
|
|
|
|
match against the available fonts, as well as the information
|
|
|
|
about each font.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternCreate -- Create a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcPattern * FcPatternCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Creates a pattern with no properties; used to build patterns
|
|
|
|
from scratch.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDuplicate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDuplicate -- Copy a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcPattern * FcPatternDuplicate(const FcPattern *p);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Copy a pattern, returning a new pattern that matches p. Each
|
|
|
|
pattern may be modified without affecting the other.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternReference
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternReference -- Increment pattern reference count
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcPatternReference(FcPattern *p);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Add another reference to p. Patterns are freed only when the
|
|
|
|
reference count reaches zero.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDestroy -- Destroy a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcPatternDestroy(FcPattern *p);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Decrement the pattern reference count. If all references are
|
|
|
|
gone, destroys the pattern, in the process destroying all
|
|
|
|
related values.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternEqual -- Compare patterns
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternEqual(const FcPattern *pa, const FcPattern
|
|
|
|
*pb);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns whether pa and pb are exactly alike.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternEqualSubset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternEqualSubset -- Compare portions of patterns
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternEqualSubset(const FcPattern *pa, const
|
|
|
|
FcPattern *pb, const FcObjectSet *os);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns whether pa and pb have exactly the same values for all
|
|
|
|
of the objects in os.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternFilter
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternFilter -- Filter the objects of pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcPattern * FcPatternFilter(FcPattern *p, const FcObjectSet *);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternHash
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternHash -- Compute a pattern hash value
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcPatternHash(const FcPattern *p);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns a 32-bit number which is the same for any two patterns
|
|
|
|
which are equal.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAdd -- Add a value to a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAdd(FcPattern *p, const char *object, FcValue
|
|
|
|
value, FcBool append);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAddWeak
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAddWeak -- Add a value to a pattern with weak binding
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddWeak(FcPattern *p, const char *object,
|
|
|
|
FcValue value, FcBool append);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAddWeak is essentially the same as FcPatternAdd except
|
|
|
|
that any values added to the list have binding weak instead of
|
|
|
|
strong.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAdd-Type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString,
|
|
|
|
FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool,
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternAddFTFace, FcPatternAddLangSet,
|
|
|
|
FcPatternAddRange -- Add a typed value to a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddInteger(FcPattern *p, const char *object,
|
|
|
|
int i);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddDouble(FcPattern *p, const char *object,
|
|
|
|
double d);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddString(FcPattern *p, const char *object,
|
|
|
|
const FcChar8 *s);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddMatrix(FcPattern *p, const char *object,
|
|
|
|
const FcMatrix *m);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddCharSet(FcPattern *p, const char *object,
|
|
|
|
const FcCharSet *c);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddBool(FcPattern *p, const char *object,
|
|
|
|
FcBool b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddFTFace(FcPattern *p, const char *object,
|
|
|
|
const FT_Facef);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddLangSet(FcPattern *p, const char *object,
|
|
|
|
const FcLangSet *l);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternAddRange(FcPattern *p, const char *object,
|
|
|
|
const FcRange *r);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
FcPatternAddRange are available since 2.11.91.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternGet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternGet -- Return a value from a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGet(FcPattern *p, const char *object, int id,
|
|
|
|
FcValue *v);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternGet-Type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString,
|
|
|
|
FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool,
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternGetFTFace, FcPatternGetLangSet,
|
|
|
|
FcPatternGetRange -- Return a typed value from a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetInteger(FcPattern *p, const char *object,
|
|
|
|
int n, int *i);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetDouble(FcPattern *p, const char *object,
|
|
|
|
int n, double *d);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetString(FcPattern *p, const char *object,
|
|
|
|
int n, FcChar8 **s);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetMatrix(FcPattern *p, const char *object,
|
|
|
|
int n, FcMatrix **s);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetCharSet(FcPattern *p, const char *object,
|
|
|
|
int n, FcCharSet **c);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetBool(FcPattern *p, const char *object, int
|
|
|
|
n, FcBool *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetFTFace(FcPattern *p, const char *object,
|
|
|
|
int n, FT_Face *f);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetLangSet(FcPattern *p, const char *object,
|
|
|
|
int n, FcLangSet **l);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcResult FcPatternGetRange(FcPattern *p, const char *object,
|
|
|
|
int n, FcRange **r);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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. FcPatternGetRange are available since 2.11.91.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternBuild
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternBuild, FcPatternVaBuild, FcPatternVapBuild -- Create
|
|
|
|
patterns from arguments
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcPattern * FcPatternBuild(FcPattern *pattern, ...);
|
|
|
|
|
|
|
|
FcPattern * FcPatternVaBuild(FcPattern *pattern, va_list va);
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcPatternVapBuild(FcPattern *result, FcPattern *pattern,
|
|
|
|
va_list va);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Builds a pattern using a list of objects, types and values.
|
|
|
|
Each value to be entered in the pattern is specified with three
|
|
|
|
arguments:
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDel
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternDel -- Delete a property from a pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcPatternDel(FcPattern *p, const char *object);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Deletes all values associated with the property `object',
|
|
|
|
returning whether the property existed or not.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternRemove
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternRemove -- Remove one object of the specified type from
|
|
|
|
the pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcPatternRemove(FcPattern *p, const char *object, int
|
|
|
|
id);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternPrint
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPatternPrint -- Print a pattern for debugging
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcPatternPrint(const FcPattern *p);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDefaultSubstitute
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDefaultSubstitute -- Perform default substitutions in a
|
|
|
|
pattern
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcDefaultSubstitute(FcPattern *pattern);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Supplies default values for underspecified font patterns:
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
* 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).
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameParse
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameParse -- Parse a pattern string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcPattern * FcNameParse(const FcChar8 *name);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Converts name from the standard text format described above
|
|
|
|
into a pattern.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnparse
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnparse -- Convert a pattern back into a string that can
|
|
|
|
be parsed
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcNameUnparse(FcPattern *pat);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
For example, the format "%{[]family,familylang{%{family}
|
2016-08-09 12:57:41 -06:00
|
|
|
(%{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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
A builtin tag is one starting with the character "=" followed
|
|
|
|
by a builtin name. The following builtins are defined:
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
unparse
|
2016-08-09 12:57:41 -06:00
|
|
|
Expands to the result of calling FcNameUnparse() on the
|
|
|
|
pattern.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
fcmatch
|
2016-08-09 12:57:41 -06:00
|
|
|
Expands to the output of the default output format of
|
|
|
|
the fc-match command on the pattern, without the final
|
|
|
|
newline.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
fclist
|
2016-08-09 12:57:41 -06:00
|
|
|
Expands to the output of the default output format of
|
|
|
|
the fc-list command on the pattern, without the final
|
|
|
|
newline.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
fccat
|
2016-08-09 12:57:41 -06:00
|
|
|
Expands to the output of the default output format of
|
|
|
|
the fc-cat command on the pattern, without the final
|
|
|
|
newline.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
pkgkit
|
2016-08-09 12:57:41 -06:00
|
|
|
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:
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
basename
|
2016-08-09 12:57:41 -06:00
|
|
|
Replaces text with the results of calling
|
|
|
|
FcStrBasename() on it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
dirname
|
2016-08-09 12:57:41 -06:00
|
|
|
Replaces text with the results of calling FcStrDirname()
|
|
|
|
on it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
downcase
|
2016-08-09 12:57:41 -06:00
|
|
|
Replaces text with the results of calling
|
|
|
|
FcStrDowncase() on it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
shescape
|
2016-08-09 12:57:41 -06:00
|
|
|
Escapes text for one level of shell expansion. (Escapes
|
|
|
|
single-quotes, also encloses text in single-quotes.)
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
cescape
|
2016-08-09 12:57:41 -06:00
|
|
|
Escapes text such that it can be used as part of a C
|
|
|
|
string literal. (Escapes backslash and double-quotes.)
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
xmlescape
|
2016-08-09 12:57:41 -06:00
|
|
|
Escapes text such that it can be used in XML and HTML.
|
|
|
|
(Escapes less-than, greater-than, and ampersand.)
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
delete(chars)
|
2016-08-09 12:57:41 -06:00
|
|
|
Deletes all occurrences of each of the characters in
|
|
|
|
chars from the text. FIXME: This converter is not UTF-8
|
|
|
|
aware yet.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
escape(chars)
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
translate(from,to)
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetCreate -- Create a font set
|
|
|
|
FcFontSetDestroy -- Destroy a font set
|
|
|
|
FcFontSetAdd -- Add to a font set
|
|
|
|
FcFontSetList -- List fonts from a set of font sets
|
|
|
|
FcFontSetMatch -- Return the best font from a set of font sets
|
|
|
|
FcFontSetPrint -- Print a set of patterns to stdout
|
|
|
|
FcFontSetSort -- Add to a font set
|
|
|
|
FcFontSetSortDestroy -- DEPRECATED destroy a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
An FcFontSet simply holds a list of patterns; these are used to
|
|
|
|
return the results of listing available fonts.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetCreate -- Create a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcFontSet * FcFontSetCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Creates an empty font set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetDestroy -- Destroy a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcFontSetDestroy(FcFontSet *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Destroys a font set. Note that this destroys any referenced
|
|
|
|
patterns as well.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetAdd -- Add to a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcFontSetAdd(FcFontSet *s, FcPattern *font);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetList
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetList -- List fonts from a set of font sets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSet * FcFontSetList(FcConfig *config, FcFontSet **sets,
|
|
|
|
intnsets, FcPattern *pattern, FcObjectSet *object_set);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetMatch
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetMatch -- Return the best font from a set of font sets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern * FcFontSetMatch(FcConfig *config, FcFontSet **sets,
|
|
|
|
intnsets, FcPattern *pattern, FcResult *result);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetPrint
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetPrint -- Print a set of patterns to stdout
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcFontSetPrint(FcFontSet *set);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetSort
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetSort -- Add to a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetSort(FcConfig *config, FcFontSet **sets, intnsets,
|
|
|
|
FcPattern *pattern, FcBool trim, FcCharSet **csp, FcResult
|
|
|
|
*result);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
The FcFontSet returned by FcFontSetSort is destroyed by calling
|
|
|
|
FcFontSetDestroy.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetSortDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetSortDestroy -- DEPRECATED destroy a font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcFontSetSortDestroy(FcFontSet *set);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This function is DEPRECATED. FcFontSetSortDestroy destroys set
|
|
|
|
by calling FcFontSetDestroy. Applications should use
|
|
|
|
FcFontSetDestroy directly instead.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetCreate -- Create an object set
|
|
|
|
FcObjectSetAdd -- Add to an object set
|
|
|
|
FcObjectSetDestroy -- Destroy an object set
|
|
|
|
FcObjectSetBuild -- Build object set from args
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetCreate -- Create an object set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcObjectSet * FcObjectSetCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Creates an empty set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetAdd -- Add to an object set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcObjectSetAdd(FcObjectSet *os, const char *object);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetDestroy -- Destroy an object set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcObjectSetDestroy(FcObjectSet *os);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Destroys an object set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetBuild
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSetBuild, FcObjectSetVaBuild,
|
|
|
|
FcObjectSetVapBuild -- Build object set from args
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcObjectSet * FcObjectSetBuild(const char *first, ...);
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectSet * FcObjectSetVaBuild(const char *first, va_list
|
2013-03-09 06:33:45 -07:00
|
|
|
va);
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcObjectSetVapBuild(FcObjectSet *result, const char
|
|
|
|
*first, va_list va);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FreeType specific functions
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharIndex -- map Unicode to glyph id
|
|
|
|
FcFreeTypeCharSet -- compute Unicode coverage
|
|
|
|
FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and
|
|
|
|
spacing type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeQuery -- compute pattern from font file (and index)
|
|
|
|
FcFreeTypeQueryFace -- compute pattern from FT_Face
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
While the fontconfig library doesn't insist that FreeType be
|
|
|
|
used as the rasterization mechanism for fonts, it does provide
|
|
|
|
some convenience functions.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharIndex
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharIndex -- map Unicode to glyph id
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig.h>
|
|
|
|
#include <fcfreetype.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FT_UInt FcFreeTypeCharIndex(FT_Face face, FcChar32 ucs4);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharSet -- compute Unicode coverage
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig.h>
|
|
|
|
#include <fcfreetype.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcCharSet * FcFreeTypeCharSet(FT_Face face, FcBlanks *blanks);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharSetAndSpacing
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeCharSetAndSpacing -- compute Unicode coverage and
|
|
|
|
spacing type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig.h>
|
|
|
|
#include <fcfreetype.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet * FcFreeTypeCharSetAndSpacing(FT_Face face, FcBlanks
|
|
|
|
*blanks, int *spacing);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
in precisely two widths, one twice as wide as the other, or
|
|
|
|
FC_PROPORTIONAL where the font has glyphs of many widths.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeQuery
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeQuery -- compute pattern from font file (and index)
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig.h>
|
|
|
|
#include <fcfreetype.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern * FcFreeTypeQuery(const FcChar8 *file, int id,
|
|
|
|
FcBlanks *blanks, int *count);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Constructs a pattern representing the 'id'th font in 'file'.
|
|
|
|
The number of fonts in 'file' is returned in 'count'.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeQueryFace
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFreeTypeQueryFace -- compute pattern from FT_Face
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig.h>
|
|
|
|
#include <fcfreetype.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern * FcFreeTypeQueryFace(const FT_Face face, const
|
|
|
|
FcChar8 *file, int id, FcBlanks *blanks);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Constructs a pattern representing 'face'. 'file' and 'id' are
|
|
|
|
used solely as data for pattern elements (FC_FILE, FC_INDEX and
|
|
|
|
sometimes FC_FAMILY).
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValue
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueDestroy -- Free a value
|
|
|
|
FcValueSave -- Copy a value
|
|
|
|
FcValuePrint -- Print a value to stdout
|
|
|
|
FcValueEqual -- Test two values for equality
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueDestroy -- Free a value
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcValueDestroy(FcValue v);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Frees any memory referenced by v. Values of type FcTypeString,
|
2016-08-09 12:57:41 -06:00
|
|
|
FcTypeMatrix and FcTypeCharSet reference memory, the other
|
|
|
|
types do not.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueSave
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueSave -- Copy a value
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcValue FcValueSave(FcValue v);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns a copy of v duplicating any object referenced by it so
|
|
|
|
that v may be safely destroyed without harming the new value.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValuePrint
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValuePrint -- Print a value to stdout
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcValuePrint(FcValue v);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcValueEqual -- Test two values for equality
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcValueEqual(FcValue v_a, FcValue v_b);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCreate -- Create an empty character set
|
|
|
|
FcCharSetDestroy -- Destroy a character set
|
|
|
|
FcCharSetAddChar -- Add a character to a charset
|
|
|
|
FcCharSetDelChar -- Add a character to a charset
|
|
|
|
FcCharSetCopy -- Copy a charset
|
|
|
|
FcCharSetEqual -- Compare two charsets
|
|
|
|
FcCharSetIntersect -- Intersect charsets
|
|
|
|
FcCharSetUnion -- Add charsets
|
|
|
|
FcCharSetSubtract -- Subtract charsets
|
|
|
|
FcCharSetMerge -- Merge charsets
|
|
|
|
FcCharSetHasChar -- Check a charset for a char
|
|
|
|
FcCharSetCount -- Count entries in a charset
|
|
|
|
FcCharSetIntersectCount -- Intersect and count charsets
|
|
|
|
FcCharSetSubtractCount -- Subtract and count charsets
|
|
|
|
FcCharSetIsSubset -- Test for charset inclusion
|
|
|
|
FcCharSetFirstPage -- Start enumerating charset contents
|
|
|
|
FcCharSetNextPage -- Continue enumerating charset contents
|
|
|
|
FcCharSetCoverage -- DEPRECATED return coverage for a Unicode
|
|
|
|
page
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetNew -- DEPRECATED alias for FcCharSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCreate -- Create an empty character set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcCharSet * FcCharSetCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCreate allocates and initializes a new empty character
|
|
|
|
set object.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetDestroy -- Destroy a character set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcCharSetDestroy(FcCharSet *fcs);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetDestroy decrements the reference count fcs. If the
|
|
|
|
reference count becomes zero, all memory referenced is freed.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetAddChar
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetAddChar -- Add a character to a charset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcCharSetAddChar(FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetDelChar
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetDelChar -- Add a character to a charset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcCharSetDelChar(FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCopy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCopy -- Copy a charset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcCharSet * FcCharSetCopy(FcCharSet *src);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Makes a copy of src; note that this may not actually do
|
|
|
|
anything more than increment the reference count on src.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetEqual -- Compare two charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcCharSetEqual(const FcCharSet *a, const FcCharSet *b);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns whether a and b contain the same set of Unicode chars.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIntersect
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIntersect -- Intersect charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet * FcCharSetIntersect(const FcCharSet *a, const
|
|
|
|
FcCharSet *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns a set including only those chars found in both a and b.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetUnion
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetUnion -- Add charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet * FcCharSetUnion(const FcCharSet *a, const FcCharSet
|
|
|
|
*b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns a set including only those chars found in either a or
|
|
|
|
b.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetSubtract
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetSubtract -- Subtract charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSet * FcCharSetSubtract(const FcCharSet *a, const
|
|
|
|
FcCharSet *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns a set including only those chars found in a but not b.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetMerge
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetMerge -- Merge charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcCharSetMerge(FcCharSet *a, const FcCharSet *b, FcBool
|
|
|
|
*changed);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetHasChar
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetHasChar -- Check a charset for a char
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcCharSetHasChar(const FcCharSet *fcs, FcChar32 ucs4);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns whether fcs contains the char ucs4.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCount
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCount -- Count entries in a charset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcCharSetCount(const FcCharSet *a);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the total number of Unicode chars in a.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIntersectCount
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIntersectCount -- Intersect and count charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcChar32 FcCharSetIntersectCount(const FcCharSet *a, const
|
|
|
|
FcCharSet *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the number of chars that are in both a and b.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetSubtractCount
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetSubtractCount -- Subtract and count charsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcChar32 FcCharSetSubtractCount(const FcCharSet *a, const
|
|
|
|
FcCharSet *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the number of chars that are in a but not in b.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIsSubset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetIsSubset -- Test for charset inclusion
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcCharSetIsSubset(const FcCharSet *a, const FcCharSet
|
|
|
|
*b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns whether a is a subset of b.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetFirstPage
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetFirstPage -- Start enumerating charset contents
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcCharSetFirstPage(const FcCharSet *a,
|
|
|
|
FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -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
|
|
|
|
0xffffffff 0xffffffff 0x01000008 0x44300002 0xffffd7f0 0xfffffffb 0xffff
|
|
|
|
7fff 0xffff0003
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -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
|
2014-05-18 04:33:03 -06:00
|
|
|
the reader ;).
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetNextPage
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetNextPage -- Continue enumerating charset contents
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcCharSetNextPage(const FcCharSet *a,
|
|
|
|
FcChar32[FC_CHARSET_MAP_SIZE] map, FcChar32 *next);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCoverage
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetCoverage -- DEPRECATED return coverage for a Unicode
|
|
|
|
page
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcCharSetCoverage(const FcCharSet *a, FcChar32page,
|
|
|
|
FcChar32[8]result);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetNew
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCharSetNew -- DEPRECATED alias for FcCharSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcCharSet * FcCharSetNew(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
FcCharSetNew is a DEPRECATED alias for FcCharSetCreate.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCreate -- create a langset object
|
|
|
|
FcLangSetDestroy -- destroy a langset object
|
|
|
|
FcLangSetCopy -- copy a langset object
|
|
|
|
FcLangSetAdd -- add a language to a langset
|
|
|
|
FcLangSetDel -- delete a language from a langset
|
|
|
|
FcLangSetUnion -- Add langsets
|
|
|
|
FcLangSetSubtract -- Subtract langsets
|
|
|
|
FcLangSetCompare -- compare language sets
|
|
|
|
FcLangSetContains -- check langset subset relation
|
|
|
|
FcLangSetEqual -- test for matching langsets
|
|
|
|
FcLangSetHash -- return a hash value for a langset
|
|
|
|
FcLangSetHasLang -- test langset for language support
|
|
|
|
FcGetDefaultLangs -- Get the default languages list
|
|
|
|
FcLangSetGetLangs -- get the list of languages in the langset
|
|
|
|
FcGetLangs -- Get list of languages
|
|
|
|
FcLangNormalize -- Normalize the language string
|
|
|
|
FcLangGetCharSet -- Get character map for a language
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06: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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCreate -- create a langset object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcLangSet * FcLangSetCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
FcLangSetCreate creates a new FcLangSet object.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetDestroy -- destroy a langset object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcLangSetDestroy(FcLangSet *ls);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetDestroy destroys a FcLangSet object, freeing all
|
|
|
|
memory associated with it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCopy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCopy -- copy a langset object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcLangSet * FcLangSetCopy(const FcLangSet *ls);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCopy creates a new FcLangSet object and populates it
|
|
|
|
with the contents of ls.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetAdd -- add a language to a langset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcLangSetAdd(FcLangSet *ls, const FcChar8 *lang);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetDel
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetDel -- delete a language from a langset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcLangSetDel(FcLangSet *ls, const FcChar8 *lang);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetUnion
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetUnion -- Add langsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSet * FcLangSetUnion(const FcLangSet *ls_a, const
|
|
|
|
FcLangSet *ls_b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns a set including only those languages found in either
|
|
|
|
ls_a or ls_b.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetSubtract
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetSubtract -- Subtract langsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSet * FcLangSetSubtract(const FcLangSet *ls_a, const
|
|
|
|
FcLangSet *ls_b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns a set including only those languages found in ls_a but
|
|
|
|
not in ls_b.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCompare
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetCompare -- compare language sets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangResult FcLangSetCompare(const FcLangSet *ls_a, const
|
|
|
|
FcLangSet *ls_b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetContains
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetContains -- check langset subset relation
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcLangSetContains(const FcLangSet *ls_a, const FcLangSet
|
|
|
|
*ls_b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetEqual -- test for matching langsets
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcLangSetEqual(const FcLangSet *ls_a, const FcLangSet
|
|
|
|
*ls_b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns FcTrue if and only if ls_a supports precisely the same
|
|
|
|
language and territory combinations as ls_b.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetHash
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetHash -- return a hash value for a langset
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar32 FcLangSetHash(const FcLangSet *ls);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetHasLang
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetHasLang -- test langset for language support
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangResult FcLangSetHasLang(const FcLangSet *ls, const
|
|
|
|
FcChar8 *lang);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetDefaultLangs
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetDefaultLangs -- Get the default languages list
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
FcStrSet * FcGetDefaultLangs(void);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.9.91
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetGetLangs
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangSetGetLangs -- get the list of languages in the langset
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetLangs
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcGetLangs -- Get list of languages
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrSet * FcGetLangs(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns a string set of all known languages.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangNormalize
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangNormalize -- Normalize the language string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangGetCharSet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcLangGetCharSet -- Get character map for a language
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
const FcCharSet * FcLangGetCharSet(const FcChar8 *lang);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the FcCharMap for a language.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixInit -- initialize an FcMatrix structure
|
|
|
|
FcMatrixCopy -- Copy a matrix
|
|
|
|
FcMatrixEqual -- Compare two matrices
|
|
|
|
FcMatrixMultiply -- Multiply matrices
|
|
|
|
FcMatrixRotate -- Rotate a matrix
|
|
|
|
FcMatrixScale -- Scale a matrix
|
|
|
|
FcMatrixShear -- Shear a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrix structures hold an affine transformation in matrix
|
|
|
|
form.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixInit
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixInit -- initialize an FcMatrix structure
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixInit(FcMatrix *matrix);
|
|
|
|
|
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixInit initializes matrix to the identity matrix.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixCopy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixCopy -- Copy a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixCopy(const FcMatrix *matrix);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixCopy allocates a new FcMatrix and copies mat into it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixEqual -- Compare two matrices
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixEqual(const FcMatrix *matrix1, const FcMatrix
|
|
|
|
*matrix2);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixEqual compares matrix1 and matrix2 returning FcTrue
|
|
|
|
when they are equal and FcFalse when they are not.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixMultiply
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixMultiply -- Multiply matrices
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixMultiply(FcMatrix *result, const FcMatrix
|
|
|
|
*matrix1, const FcMatrix *matrix2);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixMultiply multiplies matrix1 and matrix2 storing the
|
|
|
|
result in result.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixRotate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixRotate -- Rotate a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixRotate(FcMatrix *matrix, double cos, double sin);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixScale
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixScale -- Scale a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixScale(FcMatrix *matrix, double sx, double dy);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixScale multiplies matrix x values by sx and y values by
|
|
|
|
dy. This is done by multiplying by the matrix:
|
|
|
|
sx 0
|
|
|
|
0 dy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixShear
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixShear -- Shear a matrix
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcMatrixShear(FcMatrix *matrix, double sh, double sv);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcMatrixShare shears matrix horizontally by sh and vertically
|
|
|
|
by sv. This is done by multiplying by the matrix:
|
|
|
|
1 sh
|
|
|
|
sv 1
|
|
|
|
__________________________________________________________
|
|
|
|
|
|
|
|
FcRange
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
FcRangeCopy -- Copy a range object
|
|
|
|
FcRangeCreateDouble -- create a range object for double
|
|
|
|
FcRangeCreateInteger -- create a range object for integer
|
|
|
|
FcRangeDestroy -- destroy a range object
|
|
|
|
FcRangeGetDouble -- Get the range in double
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
An FcRange holds two variables to indicate a range in between.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCopy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCopy -- Copy a range object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRange * FcRangeCopy(const FcRange *range);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCopy creates a new FcRange object and populates it with
|
|
|
|
the contents of range.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCreateDouble
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
|
|
|
|
|
|
|
FcRangeCreateDouble -- create a range object for double
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRange * FcRangeCreateDouble(doublebegin, doubleend);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCreateDouble creates a new FcRange object with double
|
|
|
|
sized value.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCreateInteger
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCreateInteger -- create a range object for integer
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRange * FcRangeCreateInteger(intbegin, intend);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeCreateInteger creates a new FcRange object with integer
|
|
|
|
sized value.
|
2014-05-18 04:33:03 -06:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2014-05-18 04:33:03 -06:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeDestroy -- destroy a range object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcRangeDestroy(FcRange *range);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeDestroy destroys a FcRange object, freeing all memory
|
|
|
|
associated with it.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeGetDouble
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcRangeGetDouble -- Get the range in double
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcRangeGetDouble(const FcRange *range, double *begin,
|
|
|
|
double *end);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns in begin and end as the range.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfig
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
FcConfigCreate -- Create a configuration
|
|
|
|
FcConfigReference -- Increment config reference count
|
|
|
|
FcConfigDestroy -- Destroy a configuration
|
|
|
|
FcConfigSetCurrent -- Set configuration as default
|
|
|
|
FcConfigGetCurrent -- Return current configuration
|
|
|
|
FcConfigUptoDate -- Check timestamps on config files
|
|
|
|
FcConfigHome -- return the current home directory.
|
|
|
|
FcConfigEnableHome -- controls use of the home directory.
|
|
|
|
FcConfigBuildFonts -- Build font database
|
|
|
|
FcConfigGetConfigDirs -- Get config directories
|
|
|
|
FcConfigGetFontDirs -- Get font directories
|
|
|
|
FcConfigGetConfigFiles -- Get config files
|
|
|
|
FcConfigGetCache -- DEPRECATED used to return per-user cache
|
|
|
|
filename
|
|
|
|
|
|
|
|
FcConfigGetCacheDirs -- return the list of directories searched
|
|
|
|
for cache files
|
|
|
|
|
|
|
|
FcConfigGetFonts -- Get config font set
|
|
|
|
FcConfigGetBlanks -- Get config blanks
|
|
|
|
FcConfigGetRescanInterval -- Get config rescan interval
|
|
|
|
FcConfigSetRescanInterval -- Set config rescan interval
|
|
|
|
FcConfigAppFontAddFile -- Add font file to font database
|
|
|
|
FcConfigAppFontAddDir -- Add fonts from directory to font
|
|
|
|
database
|
|
|
|
|
|
|
|
FcConfigAppFontClear -- Remove all app fonts from font database
|
|
|
|
FcConfigSubstituteWithPat -- Execute substitutions
|
|
|
|
FcConfigSubstitute -- Execute substitutions
|
|
|
|
FcFontMatch -- Return best font
|
|
|
|
FcFontSort -- Return list of matching fonts
|
|
|
|
FcFontRenderPrepare -- Prepare pattern for loading font file
|
|
|
|
FcFontList -- List fonts
|
|
|
|
FcConfigFilename -- Find a config file
|
|
|
|
FcConfigParseAndLoad -- load a configuration file
|
|
|
|
FcConfigGetSysRoot -- Obtain the system root directory
|
|
|
|
FcConfigSetSysRoot -- Set the system root directory
|
|
|
|
|
|
|
|
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>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcConfig * FcConfigCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Creates an empty configuration.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigReference
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigReference -- Increment config reference count
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcConfig * FcConfigReference(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigDestroy -- Destroy a configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcConfigDestroy(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetCurrent
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetCurrent -- Set configuration as default
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcConfigSetCurrent(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Sets the current default configuration to config. Implicitly
|
|
|
|
calls FcConfigBuildFonts if necessary, and FcConfigReference()
|
|
|
|
to inrease the reference count in config since 2.12.0,
|
|
|
|
returning FcFalse if that call fails.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCurrent
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCurrent -- Return current configuration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcConfig * FcConfigGetCurrent(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the current default configuration.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigUptoDate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigUptoDate -- Check timestamps on config files
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcConfigUptoDate(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigHome
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigHome -- return the current home directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcConfigHome(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Return the current user's home directory, if it is available,
|
|
|
|
and if using it is enabled, and NULL otherwise. See also
|
|
|
|
FcConfigEnableHome).
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigEnableHome
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigEnableHome -- controls use of the home directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcConfigEnableHome(FcBool enable);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigBuildFonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigBuildFonts -- Build font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcConfigBuildFonts(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetConfigDirs
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetConfigDirs -- Get config directories
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrList * FcConfigGetConfigDirs(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetFontDirs
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetFontDirs -- Get font directories
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrList * FcConfigGetFontDirs(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetConfigFiles
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetConfigFiles -- Get config files
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrList * FcConfigGetConfigFiles(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns the list of known configuration files used to generate
|
|
|
|
config. If config is NULL, the current configuration is used.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCache -- DEPRECATED used to return per-user cache
|
|
|
|
filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcConfigGetCache(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
With fontconfig no longer using per-user cache files, this
|
|
|
|
function now simply returns NULL to indicate that no per-user
|
|
|
|
file exists.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCacheDirs
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetCacheDirs -- return the list of directories searched
|
|
|
|
for cache files
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrList * FcConfigGetCacheDirs(const FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetFonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetFonts -- Get config font set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcFontSet * FcConfigGetFonts(FcConfig *config, FcSetName set);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetBlanks -- Get config blanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBlanks * FcConfigGetBlanks(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetRescanInterval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetRescanInterval -- Get config rescan interval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcConfigGetRescanInterval(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
current configuration is used.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetRescanInterval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetRescanInterval -- Set config rescan interval
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigSetRescanInterval(FcConfig *config, int
|
|
|
|
rescanInterval);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontAddFile
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontAddFile -- Add font file to font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigAppFontAddFile(FcConfig *config, const FcChar8
|
|
|
|
*file);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Adds an application-specific font to the configuration. Returns
|
|
|
|
FcFalse if the fonts cannot be added (due to allocation failure
|
|
|
|
or no fonts found). Otherwise returns FcTrue. If config is
|
|
|
|
NULL, the current configuration is used.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontAddDir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontAddDir -- Add fonts from directory to font
|
|
|
|
database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigAppFontAddDir(FcConfig *config, const FcChar8
|
|
|
|
*dir);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontClear
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigAppFontClear -- Remove all app fonts from font database
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcConfigAppFontClear(FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Clears the set of application-specific fonts. If config is
|
|
|
|
NULL, the current configuration is used.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSubstituteWithPat
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSubstituteWithPat -- Execute substitutions
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigSubstituteWithPat(FcConfig *config, FcPattern
|
|
|
|
*p, FcPattern *p_pat, FcMatchKind kind);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSubstitute
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSubstitute -- Execute substitutions
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigSubstitute(FcConfig *config, FcPattern *p,
|
|
|
|
FcMatchKind kind);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontMatch
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontMatch -- Return best font
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern * FcFontMatch(FcConfig *config, FcPattern *p,
|
|
|
|
FcResult *result);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSort
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSort -- Return list of matching fonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSet * FcFontSort(FcConfig *config, FcPattern *p, FcBool
|
|
|
|
trim, FcCharSet **csp, FcResult *result);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
The FcFontSet returned by FcFontSort is destroyed by calling
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSetDestroy. If config is NULL, the current configuration
|
|
|
|
is used.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontRenderPrepare
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontRenderPrepare -- Prepare pattern for loading font file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcPattern * FcFontRenderPrepare(FcConfig *config, FcPattern
|
|
|
|
*pat, FcPattern *font);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontList
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontList -- List fonts
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFontSet * FcFontList(FcConfig *config, FcPattern *p,
|
|
|
|
FcObjectSet *os);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigFilename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigFilename -- Find a config file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcConfigFilename(const FcChar8 *name);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Given the specified external entity name, return the associated
|
|
|
|
filename. This provides applications a way to convert various
|
|
|
|
configuration file references into filename form.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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
|
2013-03-09 06:33:45 -07:00
|
|
|
with the FONTCONFIG_PATH environment variable.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigParseAndLoad
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigParseAndLoad -- load a configuration file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcConfigParseAndLoad(FcConfig *config, const FcChar8
|
|
|
|
*file, FcBool complain);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Walks the configuration in 'file' and constructs the internal
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetSysRoot
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigGetSysRoot -- Obtain the system root directory
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
const FcChar8 * FcConfigGetSysRoot(const FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Obtrains the system root directory in 'config' if available.
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.10.92
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetSysRoot
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConfigSetSysRoot -- Set the system root directory
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2014-05-18 04:33:03 -06:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcConfigSetSysRoot(FcConfig *config, const FcChar8
|
|
|
|
*sysroot);
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -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.
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.10.92
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcObjectType
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterObjectTypes -- Register object types
|
|
|
|
FcNameUnregisterObjectTypes -- Unregister object types
|
|
|
|
FcNameGetObjectType -- Lookup an object type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Provides for application-specified font name object types so
|
|
|
|
that new pattern elements can be generated from font names.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterObjectTypes
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterObjectTypes -- Register object types
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcNameRegisterObjectTypes(const FcObjectType *types, int
|
|
|
|
ntype);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnregisterObjectTypes
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnregisterObjectTypes -- Unregister object types
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcNameUnregisterObjectTypes(const FcObjectType *types,
|
|
|
|
int ntype);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameGetObjectType
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameGetObjectType -- Lookup an object type
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
const FcObjectType * FcNameGetObjectType(const char *object);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Return the object type for the pattern element named object.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcConstant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterConstants -- Register symbolic constants
|
|
|
|
FcNameUnregisterConstants -- Unregister symbolic constants
|
|
|
|
FcNameGetConstant -- Lookup symbolic constant
|
|
|
|
FcNameConstant -- Get the value for a symbolic constant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Provides for application-specified symbolic constants for font
|
|
|
|
names.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterConstants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameRegisterConstants -- Register symbolic constants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcNameRegisterConstants(const FcConstant *consts, int
|
|
|
|
nconsts);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnregisterConstants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameUnregisterConstants -- Unregister symbolic constants
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcNameUnregisterConstants(const FcConstant *consts, int
|
|
|
|
nconsts);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Deprecated. Does nothing. Returns FcFalse.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameGetConstant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameGetConstant -- Lookup symbolic constant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
const FcConstant * FcNameGetConstant(FcChar8 *string);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Return the FcConstant structure related to symbolic constant
|
|
|
|
string.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameConstant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcNameConstant -- Get the value for a symbolic constant
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcNameConstant(FcChar8 *string, int *result);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns whether a symbolic constant with name string is
|
|
|
|
registered, placing the value of the constant in result if
|
|
|
|
present.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeight
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeightFromOpenType -- Convert from OpenType weight values to
|
|
|
|
fontconfig ones
|
|
|
|
|
|
|
|
FcWeightToOpenType -- Convert from fontconfig weight values to
|
|
|
|
OpenType ones
|
|
|
|
|
|
|
|
Maps weights to and from OpenType weights.
|
|
|
|
|
|
|
|
FcWeightFromOpenType
|
|
|
|
|
|
|
|
Name
|
|
|
|
|
|
|
|
FcWeightFromOpenType -- Convert from OpenType weight values to
|
|
|
|
fontconfig ones
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
int FcWeightFromOpenType(intot_weight);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeightFromOpenType returns an integer value to use with
|
|
|
|
FC_WEIGHT, from an integer in the 1..1000 range, resembling the
|
|
|
|
numbers from OpenType specification's OS/2 usWeight numbers,
|
|
|
|
which are also similar to CSS font-weight numbers. If input is
|
|
|
|
negative, zero, or greater than 1000, returns -1. This function
|
|
|
|
linearly interpolates between various FC_WEIGHT_* constants. As
|
|
|
|
such, the returned value does not necessarily match any of the
|
|
|
|
predefined constants.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Since
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
version 2.11.91
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeightToOpenType
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeightToOpenType -- Convert from fontconfig weight values to
|
|
|
|
OpenType ones
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
int FcWeightToOpenType(intot_weight);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcWeightToOpenType is the inverse of FcWeightFromOpenType. If
|
|
|
|
the input is less than FC_WEIGHT_THIN or greater than
|
|
|
|
FC_WEIGHT_EXTRABLACK, returns -1. Otherwise returns a number in
|
|
|
|
the range 1 to 1000.
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.11.91
|
|
|
|
__________________________________________________________
|
|
|
|
|
|
|
|
FcBlanks
|
|
|
|
|
|
|
|
Table of Contents
|
|
|
|
FcBlanksCreate -- Create an FcBlanks
|
|
|
|
FcBlanksDestroy -- Destroy and FcBlanks
|
|
|
|
FcBlanksAdd -- Add a character to an FcBlanks
|
|
|
|
FcBlanksIsMember -- Query membership in an FcBlanks
|
|
|
|
|
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksCreate -- Create an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanks * FcBlanksCreate(void);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Creates an empty FcBlanks object.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksDestroy -- Destroy and FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
void FcBlanksDestroy(FcBlanks *b);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Destroys an FcBlanks object, freeing any associated memory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksAdd -- Add a character to an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcBlanksAdd(FcBlanks *b, FcChar32 ucs4);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Adds a single character to an FcBlanks object, returning
|
|
|
|
FcFalse if this process ran out of memory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksIsMember
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBlanksIsMember -- Query membership in an FcBlanks
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Synopsis
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcBlanksIsMember(FcBlanks *b, FcChar32 ucs4);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Description
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns whether the specified FcBlanks object contains the
|
|
|
|
indicated Unicode value.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomic
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Table of Contents
|
|
|
|
FcAtomicCreate -- create an FcAtomic object
|
|
|
|
FcAtomicLock -- lock a file
|
|
|
|
FcAtomicNewFile -- return new temporary file name
|
|
|
|
FcAtomicOrigFile -- return original file name
|
|
|
|
FcAtomicReplaceOrig -- replace original with new
|
|
|
|
FcAtomicDeleteNew -- delete new file
|
|
|
|
FcAtomicUnlock -- unlock a file
|
|
|
|
FcAtomicDestroy -- destroy an FcAtomic object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06: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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicCreate -- create an FcAtomic object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcAtomic * FcAtomicCreate(const FcChar8 *file);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicLock
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicLock -- lock a file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcAtomicLock(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Attempts to lock the file referenced by atomic. Returns FcFalse
|
|
|
|
if the file is already locked, else returns FcTrue and leaves
|
|
|
|
the file locked.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicNewFile
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicNewFile -- return new temporary file name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcAtomicNewFile(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns the filename for writing a new version of the file
|
|
|
|
referenced by atomic.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicOrigFile
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicOrigFile -- return original file name
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcAtomicOrigFile(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the file referenced by atomic.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicReplaceOrig
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicReplaceOrig -- replace original with new
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcAtomicReplaceOrig(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicDeleteNew
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicDeleteNew -- delete new file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcAtomicDeleteNew(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Deletes the new file. Used in error recovery to back out
|
|
|
|
changes.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicUnlock
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicUnlock -- unlock a file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcAtomicUnlock(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Unlocks the file.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcAtomicDestroy -- destroy an FcAtomic object
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcAtomicDestroy(FcAtomic *atomic);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Destroys atomic.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
File and Directory routines
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFileScan -- scan a font file
|
|
|
|
FcFileIsDir -- check whether a file is a directory
|
|
|
|
FcDirScan -- scan a font directory without caching it
|
|
|
|
FcDirSave -- DEPRECATED: formerly used to save a directory
|
|
|
|
cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheUnlink -- Remove all caches related to dir
|
|
|
|
FcDirCacheValid -- check directory cache
|
|
|
|
FcDirCacheLoad -- load a directory cache
|
|
|
|
FcDirCacheRescan -- Re-scan a directory cache
|
|
|
|
FcDirCacheRead -- read or construct a directory cache
|
|
|
|
FcDirCacheLoadFile -- load a cache file
|
|
|
|
FcDirCacheUnload -- unload a cache file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
These routines work with font files and directories, including
|
|
|
|
font directory cache files.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFileScan
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFileScan -- scan a font file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcFileScan(FcFontSet *set, FcStrSet *dirs, FcFileCache
|
|
|
|
*cache, FcBlanks *blanks, const FcChar8 *file, FcBool force);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFileIsDir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcFileIsDir -- check whether a file is a directory
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcFileIsDir(const FcChar8 *file);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns FcTrue if file is a directory, otherwise returns
|
|
|
|
FcFalse.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirScan
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirScan -- scan a font directory without caching it
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcDirScan(FcFontSet *set, FcStrSet *dirs, FcFileCache
|
|
|
|
*cache, FcBlanks *blanks, const FcChar8 *dir, FcBool force);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirSave
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirSave -- DEPRECATED: formerly used to save a directory
|
|
|
|
cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcDirSave(FcFontSet *set, FcStrSet *dirs, const FcChar8
|
|
|
|
*dir);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheUnlink
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheUnlink -- Remove all caches related to dir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcDirCacheUnlink(const FcChar8 *dir, FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheValid
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheValid -- check directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcDirCacheValid(const FcChar8 *dir);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns FcTrue if dir has an associated valid cache file, else
|
|
|
|
returns FcFalse
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheLoad
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheLoad -- load a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCache * FcDirCacheLoad(const FcChar8 *dir, FcConfig *config,
|
|
|
|
FcChar8 **cache_file);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheRescan
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheRescan -- Re-scan a directory cache
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2014-05-18 04:33:03 -06:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCache * FcDirCacheRescan(const FcChar8 *dir, FcConfig
|
|
|
|
*config);
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Re-scan directories only at dir and update the cache. returns
|
|
|
|
NULL if failed.
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.11.1
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheRead
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheRead -- read or construct a directory cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCache * FcDirCacheRead(const FcChar8 *dir, FcBool force,
|
|
|
|
FcConfig *config);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheLoadFile
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheLoadFile -- load a cache file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCache * FcDirCacheLoadFile(const FcChar8 *cache_file, struct
|
|
|
|
stat *file_stat);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheUnload
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheUnload -- unload a cache file
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcDirCacheUnload(FcCache *cache);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This function dereferences cache. When no other references to
|
|
|
|
it remain, all memory associated with the cache will be freed.
|
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCache routines
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheDir -- Return directory of cache
|
|
|
|
FcCacheCopySet -- Returns a copy of the fontset from cache
|
|
|
|
FcCacheSubdir -- Return the i'th subdirectory.
|
|
|
|
FcCacheNumSubdir -- Return the number of subdirectories in
|
|
|
|
cache.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheNumFont -- Returns the number of fonts in cache.
|
|
|
|
FcDirCacheClean -- This tries to clean up the cache directory
|
|
|
|
of cache_dir. This returns FcTrue if the operation is
|
|
|
|
successfully complete. otherwise FcFalse.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06: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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheDir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheDir -- Return directory of cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
const FcChar8 * FcCacheDir(const FcCache *cache);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This function returns the directory from which the cache was
|
|
|
|
constructed.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheCopySet
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheCopySet -- Returns a copy of the fontset from cache
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcFontSet * FcCacheCopySet(const FcCache *cache);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheSubdir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheSubdir -- Return the i'th subdirectory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
const FcChar8 * FcCacheSubdir(const FcCache *cache, inti);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheNumSubdir
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheNumSubdir -- Return the number of subdirectories in
|
|
|
|
cache.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcCacheNumSubdir(const FcCache *cache);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
This returns the total number of subdirectories in the cache.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheNumFont
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheNumFont -- Returns the number of fonts in cache.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcCacheNumFont(const FcCache *cache);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This returns the number of fonts which would be included in the
|
|
|
|
return from FcCacheCopySet.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheClean
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcDirCacheClean -- This tries to clean up the cache directory
|
|
|
|
of cache_dir. This returns FcTrue if the operation is
|
|
|
|
successfully complete. otherwise FcFalse.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcDirCacheClean(const FcChar8 *cache_dir,
|
|
|
|
FcBoolverbose);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheCreateTagFile
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcCacheCreateTagFile -- Create CACHEDIR.TAG at cache directory.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcCacheCreateTagFile(const FcConfig *config);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This tries to create CACHEDIR.TAG file at the cache directory
|
|
|
|
registered to config.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
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
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSet and FcStrList
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetCreate -- create a string set
|
|
|
|
FcStrSetMember -- check set for membership
|
|
|
|
FcStrSetEqual -- check sets for equality
|
|
|
|
FcStrSetAdd -- add to a string set
|
|
|
|
FcStrSetAddFilename -- add a filename to a string set
|
|
|
|
FcStrSetDel -- delete from a string set
|
|
|
|
FcStrSetDestroy -- destroy a string set
|
|
|
|
FcStrListCreate -- create a string iterator
|
|
|
|
FcStrListFirst -- get first string in iteration
|
|
|
|
FcStrListNext -- get next string in iteration
|
|
|
|
FcStrListDone -- destroy a string iterator
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
A data structure for enumerating strings, used to list
|
|
|
|
directories while scanning the configuration as directories are
|
|
|
|
added while scanning.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetCreate -- create a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrSet * FcStrSetCreate(void);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Create an empty set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetMember
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetMember -- check set for membership
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcStrSetMember(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns whether s is a member of set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetEqual
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetEqual -- check sets for equality
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcStrSetEqual(FcStrSet *set_a, FcStrSet *set_b);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns whether set_a contains precisely the same strings as
|
|
|
|
set_b. Ordering of strings within the two sets is not
|
|
|
|
considered.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetAdd
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetAdd -- add to a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcStrSetAdd(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Adds a copy of s to set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetAddFilename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetAddFilename -- add a filename to a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcStrSetAddFilename(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetDel
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetDel -- delete from a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcStrSetDel(FcStrSet *set, const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Removes s from set, returning FcTrue if s was a member else
|
|
|
|
FcFalse.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetDestroy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrSetDestroy -- destroy a string set
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcStrSetDestroy(FcStrSet *set);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Destroys set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListCreate
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListCreate -- create a string iterator
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcStrList * FcStrListCreate(FcStrSet *set);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Creates an iterator to list the strings in set.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListFirst
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListFirst -- get first string in iteration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2014-05-18 04:33:03 -06:00
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2014-05-18 04:33:03 -06:00
|
|
|
|
|
|
|
void FcStrListFirst(FcStrList *list);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the first string in list.
|
|
|
|
|
|
|
|
Since
|
|
|
|
|
|
|
|
version 2.11.0
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListNext
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListNext -- get next string in iteration
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
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
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListDone
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrListDone -- destroy a string iterator
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcStrListDone(FcStrList *list);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Destroys the enumerator list.
|
2016-08-09 12:57:41 -06:00
|
|
|
__________________________________________________________
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
String utilities
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Table of Contents
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf8ToUcs4 -- convert UTF-8 to UCS4
|
|
|
|
FcUcs4ToUtf8 -- convert UCS4 to UTF-8
|
|
|
|
FcUtf8Len -- count UTF-8 encoded chars
|
|
|
|
FcUtf16ToUcs4 -- convert UTF-16 to UCS4
|
|
|
|
FcUtf16Len -- count UTF-16 encoded chars
|
|
|
|
FcIsLower -- check for lower case ASCII character
|
|
|
|
FcIsUpper -- check for upper case ASCII character
|
|
|
|
FcToLower -- convert upper case ASCII to lower case
|
|
|
|
FcStrCopy -- duplicate a string
|
|
|
|
FcStrDowncase -- create a lower case translation of a string
|
|
|
|
FcStrCopyFilename -- create a complete path from a filename
|
|
|
|
FcStrCmp -- compare UTF-8 strings
|
|
|
|
FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case
|
|
|
|
FcStrStr -- locate UTF-8 substring
|
|
|
|
FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII
|
|
|
|
case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrPlus -- concatenate two strings
|
|
|
|
FcStrFree -- free a string
|
|
|
|
FcStrDirname -- directory part of filename
|
|
|
|
FcStrBasename -- last component of filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06: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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf8ToUcs4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf8ToUcs4 -- convert UTF-8 to UCS4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcUtf8ToUcs4(FcChar8 *src, FcChar32 *dst, int len);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUcs4ToUtf8
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUcs4ToUtf8 -- convert UCS4 to UTF-8
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcUcs4ToUtf8(FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN]);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Converts the Unicode char from src into dst and returns the
|
|
|
|
number of bytes needed to encode the char.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf8Len
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf8Len -- count UTF-8 encoded chars
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcUtf8Len(FcChar8 *src, int len, int *nchar, int
|
|
|
|
*wchar);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf16ToUcs4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf16ToUcs4 -- convert UTF-16 to UCS4
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
int FcUtf16ToUcs4(FcChar8 *src, FcEndian endian, FcChar32 *dst,
|
|
|
|
int len);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf16Len
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcUtf16Len -- count UTF-16 encoded chars
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcBool FcUtf16Len(FcChar8 *src, FcEndian endian, int len, int
|
|
|
|
*nchar, int *wchar);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcIsLower
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcIsLower -- check for lower case ASCII character
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcIsLower(FcChar8c);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
This macro checks whether c is an lower case ASCII letter.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcIsUpper
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcIsUpper -- check for upper case ASCII character
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcBool FcIsUpper(FcChar8c);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
This macro checks whether c is a upper case ASCII letter.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcToLower
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcToLower -- convert upper case ASCII to lower case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 FcToLower(FcChar8c);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This macro converts upper case ASCII c to the equivalent lower
|
|
|
|
case letter.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCopy
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCopy -- duplicate a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrCopy(const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Allocates memory, copies s and returns the resulting buffer.
|
|
|
|
Yes, this is strdup, but that function isn't available on every
|
|
|
|
platform.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrDowncase
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrDowncase -- create a lower case translation of a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrDowncase(const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Allocates memory, copies s, converting upper case letters to
|
|
|
|
lower case and returns the allocated buffer.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCopyFilename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCopyFilename -- create a complete path from a filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrCopyFilename(const FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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).
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCmp
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCmp -- compare UTF-8 strings
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcStrCmp(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
|
|
|
Returns the usual <0, 0, >0 result of comparing s1 and s2.
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCmpIgnoreCase
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrCmpIgnoreCase -- compare UTF-8 strings ignoring case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
int FcStrCmpIgnoreCase(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns the usual <0, 0, >0 result of comparing s1 and s2. This
|
|
|
|
test is case-insensitive for all proper UTF-8 encoded strings.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrStr
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrStr -- locate UTF-8 substring
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrStr(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrStrIgnoreCase
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrStrIgnoreCase -- locate UTF-8 substring ignoring ASCII
|
|
|
|
case
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcChar8 * FcStrStrIgnoreCase(const FcChar8 *s1, const FcChar8
|
|
|
|
*s2);
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrPlus
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrPlus -- concatenate two strings
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrPlus(const FcChar8 *s1, const FcChar8 *s2);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This function allocates new storage and places the
|
|
|
|
concatenation of s1 and s2 there, returning the new string.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrFree
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrFree -- free a string
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
void FcStrFree(FcChar8 *s);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
This is just a wrapper around free(3) which helps track memory
|
|
|
|
usage of strings within the fontconfig library.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrDirname
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrDirname -- directory part of filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrDirname(const FcChar8 *file);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
Returns the directory containing file. This is returned in
|
|
|
|
newly allocated storage which should be freed when no longer
|
|
|
|
needed.
|
2013-03-09 06:33:45 -07:00
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrBasename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Name
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
FcStrBasename -- last component of filename
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
Synopsis
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
#include <fontconfig/fontconfig.h>
|
2013-03-09 06:33:45 -07:00
|
|
|
|
|
|
|
FcChar8 * FcStrBasename(const FcChar8 *file);
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
2016-08-09 12:57:41 -06:00
|
|
|
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.
|