/*
- * $XFree86: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.2 2002/02/15 06:01:27 keithp Exp $
+ * $RCSId: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.30 2002/09/26 00:17:27 keithp Exp $
*
- * Copyright © 2001 Keith Packard, member of The XFree86 Project, Inc.
+ * Copyright © 2001 Keith Packard
*
* Permission to use, copy, modify, distribute, and sell this software and its
* documentation for any purpose is hereby granted without fee, provided that
typedef int FcBool;
/*
- * Current Fontconfig version number
+ * Current Fontconfig version number. This same number
+ * must appear in the fontconfig configure.in file. Yes,
+ * it'a a pain to synchronize version numbers like this.
*/
-#define FC_MAJOR 1
-#define FC_MINOR 0
-#define FC_REVISION 0
+
+#define FC_MAJOR 2
+#define FC_MINOR 2
+#define FC_REVISION 96
#define FC_VERSION ((FC_MAJOR * 10000) + (FC_MINOR * 100) + (FC_REVISION))
+/*
+ * Current font cache file format version
+ * This is appended to the cache files so that multiple
+ * versions of the library will peacefully coexist
+ *
+ * Change this value whenever the disk format for the cache file
+ * changes in any non-compatible way. Try to avoid such changes as
+ * it means multiple copies of the font information.
+ */
+
+#define FC_CACHE_VERSION "1"
+
#define FcTrue 1
#define FcFalse 0
#define FC_SLANT "slant" /* Int */
#define FC_WEIGHT "weight" /* Int */
#define FC_SIZE "size" /* Double */
+#define FC_ASPECT "aspect" /* Double */
#define FC_PIXEL_SIZE "pixelsize" /* Double */
#define FC_SPACING "spacing" /* Int */
#define FC_FOUNDRY "foundry" /* String */
#define FC_ANTIALIAS "antialias" /* Bool (depends) */
#define FC_HINTING "hinting" /* Bool (true) */
+#define FC_HINT_STYLE "hintstyle" /* Int */
#define FC_VERTICAL_LAYOUT "verticallayout" /* Bool (false) */
#define FC_AUTOHINT "autohint" /* Bool (false) */
#define FC_GLOBAL_ADVANCE "globaladvance" /* Bool (true) */
+#define FC_WIDTH "width" /* Int */
#define FC_FILE "file" /* String */
#define FC_INDEX "index" /* Int */
+#define FC_FT_FACE "ftface" /* FT_Face */
#define FC_RASTERIZER "rasterizer" /* String */
#define FC_OUTLINE "outline" /* Bool */
#define FC_SCALABLE "scalable" /* Bool */
#define FC_MINSPACE "minspace" /* Bool use minimum line spacing */
#define FC_SOURCE "source" /* String (X11, freetype) */
#define FC_CHARSET "charset" /* CharSet */
-#define FC_LANG "lang" /* String OS/2 CodePageRange */
+#define FC_LANG "lang" /* String RFC 3066 langs */
+#define FC_FONTVERSION "fontversion" /* Int from 'head' table */
-#define FC_DIR_CACHE_FILE "fonts.cache"
-#define FC_USER_CACHE_FILE ".fonts.cache"
+#define FC_DIR_CACHE_FILE "fonts.cache-"FC_CACHE_VERSION
+#define FC_USER_CACHE_FILE ".fonts.cache-"FC_CACHE_VERSION
/* Adjust outline rasterizer */
#define FC_CHAR_WIDTH "charwidth" /* Int */
#define FC_CHAR_HEIGHT "charheight"/* Int */
#define FC_MATRIX "matrix" /* FcMatrix */
-#define FC_WEIGHT_LIGHT 0
-#define FC_WEIGHT_MEDIUM 100
-#define FC_WEIGHT_DEMIBOLD 180
-#define FC_WEIGHT_BOLD 200
-#define FC_WEIGHT_BLACK 210
-
-#define FC_SLANT_ROMAN 0
-#define FC_SLANT_ITALIC 100
-#define FC_SLANT_OBLIQUE 110
-
-#define FC_PROPORTIONAL 0
-#define FC_MONO 100
-#define FC_CHARCELL 110
+#define FC_WEIGHT_THIN 0
+#define FC_WEIGHT_EXTRALIGHT 40
+#define FC_WEIGHT_ULTRALIGHT FC_WEIGHT_EXTRALIGHT
+#define FC_WEIGHT_LIGHT 50
+#define FC_WEIGHT_BOOK 75
+#define FC_WEIGHT_REGULAR 80
+#define FC_WEIGHT_NORMAL FC_WEIGHT_REGULAR
+#define FC_WEIGHT_MEDIUM 100
+#define FC_WEIGHT_DEMIBOLD 180
+#define FC_WEIGHT_SEMIBOLD FC_WEIGHT_DEMIBOLD
+#define FC_WEIGHT_BOLD 200
+#define FC_WEIGHT_EXTRABOLD 205
+#define FC_WEIGHT_ULTRABOLD FC_WEIGHT_EXTRABOLD
+#define FC_WEIGHT_BLACK 210
+#define FC_WEIGHT_HEAVY FC_WEIGHT_BLACK
+
+#define FC_SLANT_ROMAN 0
+#define FC_SLANT_ITALIC 100
+#define FC_SLANT_OBLIQUE 110
+
+#define FC_WIDTH_ULTRACONDENSED 50
+#define FC_WIDTH_EXTRACONDENSED 63
+#define FC_WIDTH_CONDENSED 75
+#define FC_WIDTH_SEMICONDENSED 87
+#define FC_WIDTH_NORMAL 100
+#define FC_WIDTH_SEMIEXPANDED 113
+#define FC_WIDTH_EXPANDED 125
+#define FC_WIDTH_EXTRAEXPANDED 150
+#define FC_WIDTH_ULTRAEXPANDED 200
+
+#define FC_PROPORTIONAL 0
+#define FC_DUAL 90
+#define FC_MONO 100
+#define FC_CHARCELL 110
/* sub-pixel order */
-#define FC_RGBA_NONE 0
+#define FC_RGBA_UNKNOWN 0
#define FC_RGBA_RGB 1
#define FC_RGBA_BGR 2
#define FC_RGBA_VRGB 3
#define FC_RGBA_VBGR 4
-
-/* language groups from the OS/2 CodePageRange bits */
-#define FC_LANG_LATIN_1 "latin1" /* 0 */
-#define FC_LANG_LATIN_2_EASTERN_EUROPE "latin2easterneurope" /* 1 */
-#define FC_LANG_CYRILLIC "cyrillic" /* 2 */
-#define FC_LANG_GREEK "greek" /* 3 */
-#define FC_LANG_TURKISH "turkish" /* 4 */
-#define FC_LANG_HEBREW "hebrew" /* 5 */
-#define FC_LANG_ARABIC "arabic" /* 6 */
-#define FC_LANG_WINDOWS_BALTIC "windowsbaltic" /* 7 */
-#define FC_LANG_VIETNAMESE "vietnamese" /* 8 */
-/* 9-15 reserved for Alternate ANSI */
-#define FC_LANG_THAI "thai" /* 16 */
-#define FC_LANG_JAPANESE "japanese" /* 17 */
-#define FC_LANG_SIMPLIFIED_CHINESE "simplifiedchinese" /* 18 */
-#define FC_LANG_KOREAN_WANSUNG "koreanwansung" /* 19 */
-#define FC_LANG_TRADITIONAL_CHINESE "traditionalchinese" /* 20 */
-#define FC_LANG_KOREAN_JOHAB "koreanjohab" /* 21 */
-/* 22-28 reserved for Alternate ANSI & OEM */
-#define FC_LANG_MACINTOSH "macintosh" /* 29 */
-#define FC_LANG_OEM "oem" /* 30 */
-#define FC_LANG_SYMBOL "symbol" /* 31 */
-/* 32-47 reserved for OEM */
-#define FC_LANG_IBM_GREEK "ibmgreek" /* 48 */
-#define FC_LANG_MSDOS_RUSSIAN "msdosrussian" /* 49 */
-#define FC_LANG_MSDOS_NORDIC "msdosnordic" /* 50 */
-#define FC_LANG_ARABIC_864 "arabic864" /* 51 */
-#define FC_LANG_MSDOS_CANADIAN_FRENCH "msdoscanadianfrench" /* 52 */
-#define FC_LANG_HEBREW_862 "hebrew862" /* 53 */
-#define FC_LANG_MSDOS_ICELANDIC "msdosicelandic" /* 54 */
-#define FC_LANG_MSDOS_PORTUGUESE "msdosportuguese" /* 55 */
-#define FC_LANG_IBM_TURKISH "ibmturkish" /* 56 */
-#define FC_LANG_IBM_CYRILLIC "ibmcyrillic" /* 57 */
-#define FC_LANG_LATIN_2 "latin2" /* 58 */
-#define FC_LANG_MSDOS_BALTIC "msdosbaltic" /* 59 */
-#define FC_LANG_GREEK_437_G "greek437g" /* 60 */
-#define FC_LANG_ARABIC_ASMO_708 "arabicasmo708" /* 61 */
-#define FC_LANG_WE_LATIN_1 "welatin1" /* 62 */
-#define FC_LANG_US "us" /* 63 */
-
+#define FC_RGBA_NONE 5
+
+/* hinting style */
+#define FC_HINT_NONE 0
+#define FC_HINT_SLIGHT 1
+#define FC_HINT_MEDIUM 2
+#define FC_HINT_FULL 3
+
typedef enum _FcType {
FcTypeVoid,
FcTypeInteger,
FcTypeString,
FcTypeBool,
FcTypeMatrix,
- FcTypeCharSet
+ FcTypeCharSet,
+ FcTypeFTFace,
+ FcTypeLangSet
} FcType;
typedef struct _FcMatrix {
} FcConstant;
typedef enum _FcResult {
- FcResultMatch, FcResultNoMatch, FcResultTypeMismatch, FcResultNoId
+ FcResultMatch, FcResultNoMatch, FcResultTypeMismatch, FcResultNoId,
+ FcResultOutOfMemory
} FcResult;
+typedef struct _FcPattern FcPattern;
+
+typedef struct _FcLangSet FcLangSet;
+
typedef struct _FcValue {
FcType type;
union {
double d;
const FcMatrix *m;
const FcCharSet *c;
+ void *f;
+ const FcPattern *p;
+ const FcLangSet *l;
} u;
} FcValue;
-typedef struct _FcPattern FcPattern;
-
typedef struct _FcFontSet {
int nfont;
int sfont;
} FcObjectSet;
typedef enum _FcMatchKind {
- FcMatchPattern, FcMatchFont
+ FcMatchPattern, FcMatchFont
} FcMatchKind;
+typedef enum _FcLangResult {
+ FcLangEqual, FcLangDifferentCountry, FcLangDifferentLang
+} FcLangResult;
+
typedef enum _FcSetName {
FcSetSystem = 0,
FcSetApplication = 1
} FcSetName;
+typedef struct _FcAtomic FcAtomic;
+
#if defined(__cplusplus) || defined(c_plusplus) /* for C++ V2.0 */
#define _FCFUNCPROTOBEGIN extern "C" { /* do not leave open across includes */
#define _FCFUNCPROTOEND }
#define _FCFUNCPROTOEND
#endif
+typedef enum { FcEndianBig, FcEndianLittle } FcEndian;
+
typedef struct _FcConfig FcConfig;
-typedef struct _FcFileCache FcFileCache;
+typedef struct _FcGlobalCache FcFileCache;
typedef struct _FcBlanks FcBlanks;
+typedef struct _FcStrList FcStrList;
+
+typedef struct _FcStrSet FcStrSet;
+
_FCFUNCPROTOBEGIN
+FcBool
+FcDirCacheValid (const FcChar8 *cache_file);
+
/* fcblanks.c */
FcBlanks *
FcBlanksCreate (void);
FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4);
/* fccfg.c */
+FcChar8 *
+FcConfigHome (void);
+
+FcBool
+FcConfigEnableHome (FcBool enable);
+
FcChar8 *
FcConfigFilename (const FcChar8 *url);
FcConfig *
FcConfigGetCurrent (void);
+FcBool
+FcConfigUptoDate (FcConfig *config);
+
FcBool
FcConfigBuildFonts (FcConfig *config);
-FcChar8 **
-FcConfigGetDirs (FcConfig *config);
+FcStrList *
+FcConfigGetFontDirs (FcConfig *config);
-FcChar8 **
+FcStrList *
+FcConfigGetConfigDirs (FcConfig *config);
+
+FcStrList *
FcConfigGetConfigFiles (FcConfig *config);
FcChar8 *
FcBlanks *
FcConfigGetBlanks (FcConfig *config);
+int
+FcConfigGetRescanInverval (FcConfig *config);
+
+FcBool
+FcConfigSetRescanInverval (FcConfig *config, int rescanInterval);
+
FcFontSet *
FcConfigGetFonts (FcConfig *config,
FcSetName set);
void
FcConfigAppFontClear (FcConfig *config);
+FcBool
+FcConfigSubstituteWithPat (FcConfig *config,
+ FcPattern *p,
+ FcPattern *p_pat,
+ FcMatchKind kind);
+
FcBool
FcConfigSubstitute (FcConfig *config,
FcPattern *p,
FcChar32
FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b);
+FcBool
+FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b);
+
+#define FC_CHARSET_MAP_SIZE (256/32)
+#define FC_CHARSET_DONE ((FcChar32) -1)
+
+FcChar32
+FcCharSetFirstPage (const FcCharSet *a,
+ FcChar32 map[FC_CHARSET_MAP_SIZE],
+ FcChar32 *next);
+
FcChar32
-FcCharSetCoverage (const FcCharSet *a, FcChar32 page, FcChar32 *result);
+FcCharSetNextPage (const FcCharSet *a,
+ FcChar32 map[FC_CHARSET_MAP_SIZE],
+ FcChar32 *next);
+
/* fcdbg.c */
void
-FcPatternPrint (FcPattern *p);
+FcValuePrint (const FcValue v);
+
+void
+FcPatternPrint (const FcPattern *p);
+
+void
+FcFontSetPrint (const FcFontSet *s);
/* fcdefault.c */
void
/* fcdir.c */
FcBool
FcFileScan (FcFontSet *set,
+ FcStrSet *dirs,
FcFileCache *cache,
FcBlanks *blanks,
const FcChar8 *file,
FcBool
FcDirScan (FcFontSet *set,
+ FcStrSet *dirs,
FcFileCache *cache,
FcBlanks *blanks,
const FcChar8 *dir,
FcBool force);
FcBool
-FcDirSave (FcFontSet *set, const FcChar8 *dir);
+FcDirSave (FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir);
/* fcfreetype.c */
FcPattern *
FcFontSetAdd (FcFontSet *s, FcPattern *font);
/* fcinit.c */
+FcConfig *
+FcInitLoadConfig (void);
+
+FcConfig *
+FcInitLoadConfigAndFonts (void);
+
FcBool
-FcInitFonts (void);
+FcInit (void);
+
+void
+FcFini (void);
+
+int
+FcGetVersion (void);
FcBool
-FcInitConfig (void);
+FcInitReinitialize (void);
FcBool
-FcInit (void);
+FcInitBringUptoDate (void);
+
+/* fclang.c */
+FcLangSet *
+FcLangSetCreate (void);
+
+void
+FcLangSetDestroy (FcLangSet *ls);
+
+FcLangSet *
+FcLangSetCopy (const FcLangSet *ls);
+
+FcBool
+FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang);
+
+FcLangResult
+FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang);
+
+FcLangResult
+FcLangSetCompare (const FcLangSet *lsa, const FcLangSet *lsb);
+
+FcBool
+FcLangSetContains (const FcLangSet *lsa, const FcLangSet *lsb);
+
+FcBool
+FcLangSetEqual (const FcLangSet *lsa, const FcLangSet *lsb);
+
+FcChar32
+FcLangSetHash (const FcLangSet *ls);
/* fclist.c */
FcObjectSet *
FcObjectSet *
FcObjectSetBuild (const char *first, ...);
+FcFontSet *
+FcFontSetList (FcConfig *config,
+ FcFontSet **sets,
+ int nsets,
+ FcPattern *p,
+ FcObjectSet *os);
+
FcFontSet *
FcFontList (FcConfig *config,
FcPattern *p,
FcObjectSet *os);
+/* fcatomic.c */
+
+FcAtomic *
+FcAtomicCreate (const FcChar8 *file);
+
+FcBool
+FcAtomicLock (FcAtomic *atomic);
+
+FcChar8 *
+FcAtomicNewFile (FcAtomic *atomic);
+
+FcChar8 *
+FcAtomicOrigFile (FcAtomic *atomic);
+
+FcBool
+FcAtomicReplaceOrig (FcAtomic *atomic);
+
+void
+FcAtomicDeleteNew (FcAtomic *atomic);
+
+void
+FcAtomicUnlock (FcAtomic *atomic);
+
+void
+FcAtomicDestroy (FcAtomic *atomic);
+
/* fcmatch.c */
+FcPattern *
+FcFontSetMatch (FcConfig *config,
+ FcFontSet **sets,
+ int nsets,
+ FcPattern *p,
+ FcResult *result);
+
FcPattern *
FcFontMatch (FcConfig *config,
FcPattern *p,
FcResult *result);
+FcPattern *
+FcFontRenderPrepare (FcConfig *config,
+ FcPattern *pat,
+ FcPattern *font);
+
+FcFontSet *
+FcFontSetSort (FcConfig *config,
+ FcFontSet **sets,
+ int nsets,
+ FcPattern *p,
+ FcBool trim,
+ FcCharSet **csp,
+ FcResult *result);
+
+FcFontSet *
+FcFontSort (FcConfig *config,
+ FcPattern *p,
+ FcBool trim,
+ FcCharSet **csp,
+ FcResult *result);
+
+void
+FcFontSetSortDestroy (FcFontSet *fs);
+
/* fcmatrix.c */
FcMatrix *
FcMatrixCopy (const FcMatrix *mat);
FcPatternCreate (void);
FcPattern *
-FcPatternDuplicate (FcPattern *p);
+FcPatternDuplicate (const FcPattern *p);
+
+void
+FcPatternReference (FcPattern *p);
void
FcValueDestroy (FcValue v);
+FcBool
+FcValueEqual (FcValue va, FcValue vb);
+
FcValue
FcValueSave (FcValue v);
void
FcPatternDestroy (FcPattern *p);
+FcBool
+FcPatternEqual (const FcPattern *pa, const FcPattern *pb);
+
+FcBool
+FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os);
+
+FcChar32
+FcPatternHash (const FcPattern *p);
+
FcBool
FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
+FcBool
+FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append);
+
FcResult
-FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v);
+FcPatternGet (const FcPattern *p, const char *object, int id, FcValue *v);
FcBool
FcPatternDel (FcPattern *p, const char *object);
FcBool
FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
+FcBool
+FcPatternAddLangSet (FcPattern *p, const char *object, const FcLangSet *ls);
+
FcResult
-FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i);
+FcPatternGetInteger (const FcPattern *p, const char *object, int n, int *i);
FcResult
-FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d);
+FcPatternGetDouble (const FcPattern *p, const char *object, int n, double *d);
FcResult
-FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 ** s);
+FcPatternGetString (const FcPattern *p, const char *object, int n, FcChar8 ** s);
FcResult
-FcPatternGetMatrix (FcPattern *p, const char *object, int n, FcMatrix **s);
+FcPatternGetMatrix (const FcPattern *p, const char *object, int n, FcMatrix **s);
FcResult
-FcPatternGetCharSet (FcPattern *p, const char *object, int n, FcCharSet **c);
+FcPatternGetCharSet (const FcPattern *p, const char *object, int n, FcCharSet **c);
FcResult
-FcPatternGetBool (FcPattern *p, const char *object, int n, FcBool *b);
+FcPatternGetBool (const FcPattern *p, const char *object, int n, FcBool *b);
+
+FcResult
+FcPatternGetLangSet (const FcPattern *p, const char *object, int n, FcLangSet **ls);
FcPattern *
FcPatternVaBuild (FcPattern *orig, va_list va);
FcChar8 *
FcStrCopy (const FcChar8 *s);
-#define FcToLower(c) (('A' <= (c) && (c) <= 'Z') ? (c) - 'A' + 'a' : (c))
+FcChar8 *
+FcStrCopyFilename (const FcChar8 *s);
+
+#define FcIsUpper(c) (('A' <= (c) && (c) <= 'Z'))
+#define FcIsLower(c) (('a' <= (c) && (c) <= 'z'))
+#define FcToLower(c) (FcIsUpper(c) ? (c) - 'A' + 'a' : (c))
int
FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
int
-FcUtf8ToUcs4 (FcChar8 *src_orig,
- FcChar32 *dst,
- int len);
+FcStrCmp (const FcChar8 *s1, const FcChar8 *s2);
+
+const FcChar8 *
+FcStrStrIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
+
+const FcChar8 *
+FcStrStr (const FcChar8 *s1, const FcChar8 *s2);
+
+int
+FcUtf8ToUcs4 (const FcChar8 *src_orig,
+ FcChar32 *dst,
+ int len);
FcBool
-FcUtf8Len (FcChar8 *string,
- int len,
- int *nchar,
- int *wchar);
+FcUtf8Len (const FcChar8 *string,
+ int len,
+ int *nchar,
+ int *wchar);
+
+#define FC_UTF8_MAX_LEN 6
+
+int
+FcUcs4ToUtf8 (FcChar32 ucs4,
+ FcChar8 dest[FC_UTF8_MAX_LEN]);
+
+int
+FcUtf16ToUcs4 (const FcChar8 *src_orig,
+ FcEndian endian,
+ FcChar32 *dst,
+ int len); /* in bytes */
+
+FcBool
+FcUtf16Len (const FcChar8 *string,
+ FcEndian endian,
+ int len, /* in bytes */
+ int *nchar,
+ int *wchar);
+
+FcChar8 *
+FcStrDirname (const FcChar8 *file);
+
+FcChar8 *
+FcStrBasename (const FcChar8 *file);
+
+FcStrSet *
+FcStrSetCreate (void);
+
+FcBool
+FcStrSetMember (FcStrSet *set, const FcChar8 *s);
+
+FcBool
+FcStrSetEqual (FcStrSet *sa, FcStrSet *sb);
+
+FcBool
+FcStrSetAdd (FcStrSet *set, const FcChar8 *s);
+
+FcBool
+FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s);
+
+FcBool
+FcStrSetDel (FcStrSet *set, const FcChar8 *s);
+
+void
+FcStrSetDestroy (FcStrSet *set);
+
+FcStrList *
+FcStrListCreate (FcStrSet *set);
+
+FcChar8 *
+FcStrListNext (FcStrList *list);
+
+void
+FcStrListDone (FcStrList *list);
/* fcxml.c */
FcBool