/* * $RCSId: xc/lib/fontconfig/src/fcint.h,v 1.27 2002/08/31 22:17:32 keithp Exp $ * * Copyright © 2000 Keith Packard * * Permission to use, copy, modify, distribute, and sell this software and its * documentation for any purpose is hereby granted without fee, provided that * the above copyright notice appear in all copies and that both that * copyright notice and this permission notice appear in supporting * documentation, and that the name of Keith Packard not be used in * advertising or publicity pertaining to distribution of the software without * specific, written prior permission. Keith Packard makes no * representations about the suitability of this software for any purpose. It * is provided "as is" without express or implied warranty. * * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO * EVENT SHALL KEITH PACKARD 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. */ #ifndef _FCINT_H_ #define _FCINT_H_ #include #include #include #include #include #include #include #include #include #include #include #include #ifdef HAVE_CONFIG_H #include #endif #ifndef FC_CONFIG_PATH #define FC_CONFIG_PATH "fonts.conf" #endif #define FC_FONT_FILE_INVALID ((FcChar8 *) ".") #define FC_FONT_FILE_DIR ((FcChar8 *) ".dir") #ifdef _WIN32 #define FC_SEARCH_PATH_SEPARATOR ';' #else #define FC_SEARCH_PATH_SEPARATOR ':' #endif #define FC_DBG_MATCH 1 #define FC_DBG_MATCHV 2 #define FC_DBG_EDIT 4 #define FC_DBG_FONTSET 8 #define FC_DBG_CACHE 16 #define FC_DBG_CACHEV 32 #define FC_DBG_PARSE 64 #define FC_DBG_SCAN 128 #define FC_DBG_SCANV 256 #define FC_DBG_MEMORY 512 #define FC_DBG_CONFIG 1024 #define FC_MEM_CHARSET 0 #define FC_MEM_CHARLEAF 1 #define FC_MEM_FONTSET 2 #define FC_MEM_FONTPTR 3 #define FC_MEM_OBJECTSET 4 #define FC_MEM_OBJECTPTR 5 #define FC_MEM_MATRIX 6 #define FC_MEM_PATTERN 7 #define FC_MEM_PATELT 8 #define FC_MEM_VALLIST 9 #define FC_MEM_SUBSTATE 10 #define FC_MEM_STRING 11 #define FC_MEM_LISTBUCK 12 #define FC_MEM_STRSET 13 #define FC_MEM_STRLIST 14 #define FC_MEM_CONFIG 15 #define FC_MEM_LANGSET 16 #define FC_MEM_ATOMIC 17 #define FC_MEM_BLANKS 18 #define FC_MEM_CACHE 19 #define FC_MEM_STRBUF 20 #define FC_MEM_SUBST 21 #define FC_MEM_OBJECTTYPE 22 #define FC_MEM_CONSTANT 23 #define FC_MEM_TEST 24 #define FC_MEM_EXPR 25 #define FC_MEM_VSTACK 26 #define FC_MEM_ATTR 27 #define FC_MEM_PSTACK 28 #define FC_MEM_STATICSTR 29 #define FC_MEM_NUM 30 typedef enum _FcValueBinding { FcValueBindingWeak, FcValueBindingStrong, FcValueBindingSame } FcValueBinding; typedef struct _FcValueListPtr { int bank; union { int stat; struct _FcValueList *dyn; } u; } FcValueListPtr; typedef struct _FcValueList { FcValueListPtr next; FcValue value; FcValueBinding binding; } FcValueList; typedef int FcObjectPtr; typedef struct _FcPatternEltPtr { int bank; union { int stat; struct _FcPatternElt *dyn; } u; } FcPatternEltPtr; typedef struct _FcPatternElt { FcObjectPtr object; FcValueListPtr values; } FcPatternElt; struct _FcPattern { int num; int size; FcPatternEltPtr elts; int ref; int bank; }; typedef enum _FcOp { FcOpInteger, FcOpDouble, FcOpString, FcOpMatrix, FcOpBool, FcOpCharSet, FcOpNil, FcOpField, FcOpConst, FcOpAssign, FcOpAssignReplace, FcOpPrependFirst, FcOpPrepend, FcOpAppend, FcOpAppendLast, FcOpQuest, FcOpOr, FcOpAnd, FcOpEqual, FcOpNotEqual, FcOpContains, FcOpListing, FcOpNotContains, FcOpLess, FcOpLessEqual, FcOpMore, FcOpMoreEqual, FcOpPlus, FcOpMinus, FcOpTimes, FcOpDivide, FcOpNot, FcOpComma, FcOpFloor, FcOpCeil, FcOpRound, FcOpTrunc, FcOpInvalid } FcOp; typedef struct _FcExpr { FcOp op; union { int ival; double dval; FcChar8 *sval; FcMatrix *mval; FcBool bval; FcCharSet *cval; char *field; FcChar8 *constant; struct { struct _FcExpr *left, *right; } tree; } u; } FcExpr; typedef enum _FcQual { FcQualAny, FcQualAll, FcQualFirst, FcQualNotFirst } FcQual; #define FcMatchDefault ((FcMatchKind) -1) typedef struct _FcTest { struct _FcTest *next; FcMatchKind kind; FcQual qual; const char *field; FcOp op; FcExpr *expr; } FcTest; typedef struct _FcEdit { struct _FcEdit *next; const char *field; FcOp op; FcExpr *expr; FcValueBinding binding; } FcEdit; typedef struct _FcSubst { struct _FcSubst *next; FcTest *test; FcEdit *edit; } FcSubst; typedef struct _FcCharLeaf { FcChar32 map[256/32]; } FcCharLeaf; #define FC_REF_CONSTANT -1 struct _FcCharSet { int ref; /* reference count */ int num; /* size of leaves and numbers arrays */ int bank; union { struct { FcCharLeaf **leaves; FcChar16 *numbers; } dyn; struct { int leafidx_offset; int numbers_offset; } stat; } u; }; struct _FcStrSet { int ref; /* reference count */ int num; int size; FcChar8 **strs; }; struct _FcStrList { FcStrSet *set; int n; }; typedef struct _FcStrBuf { FcChar8 *buf; FcBool allocated; FcBool failed; int len; int size; } FcStrBuf; typedef struct _FcCache { int magic; int count; int bank; int pattern_count; int patternelt_count; int valuelist_count; int str_count; int langset_count; int charset_count; int charset_numbers_count; int charset_leaf_count; int charset_leaf_idx_count; } FcCache; /* * To map adobe glyph names to unicode values, a precomputed hash * table is used */ typedef struct _FcGlyphName { FcChar32 ucs; /* unicode value */ FcChar8 name[1]; /* name extends beyond struct */ } FcGlyphName; /* * To perform case-insensitive string comparisons, a table * is used which holds three different kinds of folding data. * * The first is a range of upper case values mapping to a range * of their lower case equivalents. Within each range, the offset * between upper and lower case is constant. * * The second is a range of upper case values which are interleaved * with their lower case equivalents. * * The third is a set of raw unicode values mapping to a list * of unicode values for comparison purposes. This allows conversion * of ß to "ss" so that SS, ss and ß all match. A separate array * holds the list of unicode values for each entry. * * These are packed into a single table. Using a binary search, * the appropriate entry can be located. */ #define FC_CASE_FOLD_RANGE 0 #define FC_CASE_FOLD_EVEN_ODD 1 #define FC_CASE_FOLD_FULL 2 typedef struct _FcCaseFold { FcChar32 upper; FcChar16 method : 2; FcChar16 count : 14; short offset; /* lower - upper for RANGE, table id for FULL */ } FcCaseFold; #define FC_MAX_FILE_LEN 4096 #define FC_STORAGE_STATIC 0x80 #define fc_value_string(v) (((v)->type & FC_STORAGE_STATIC) ? ((FcChar8 *) v) + (v)->u.s_off : (v) -> u.s) #define fc_value_charset(v) (((v)->type & FC_STORAGE_STATIC) ? (const FcCharSet *)(((char *) v) + (v)->u.c_off) : (v) -> u.c) #define fc_value_langset(v) (((v)->type & FC_STORAGE_STATIC) ? (const FcLangSet *)(((char *) v) + (v)->u.l_off) : (v) -> u.l) /* * The per-user ~/.fonts.cache- file is loaded into * this data structure. Each directory gets a substructure * which is validated by comparing the directory timestamp with * that saved in the cache. When valid, the entire directory cache * can be immediately loaded without reading the directory. Otherwise, * the files are checked individually; updated files are loaded into the * cache which is then rewritten to the users home directory */ #define FC_CACHE_MAGIC 0xFC02FC02 typedef struct _FcGlobalCacheDir FcGlobalCacheDir; struct _FcGlobalCacheDir { struct _FcGlobalCacheDir *next; FcChar8 *name; FcCache metadata; off_t offset; void *ent; }; typedef struct _FcGlobalCache { FcGlobalCacheDir *dirs; FcBool updated; int fd; } FcGlobalCache; struct _FcAtomic { FcChar8 *file; /* original file name */ FcChar8 *new; /* temp file name -- write data here */ FcChar8 *lck; /* lockfile name (used for locking) */ FcChar8 *tmp; /* tmpfile name (used for locking) */ }; struct _FcBlanks { int nblank; int sblank; FcChar32 *blanks; }; struct _FcConfig { /* * File names loaded from the configuration -- saved here as the * cache file must be consulted before the directories are scanned, * and those directives may occur in any order */ FcStrSet *configDirs; /* directories to scan for fonts */ FcChar8 *cache; /* name of per-user cache file */ /* * Set of allowed blank chars -- used to * trim fonts of bogus glyphs */ FcBlanks *blanks; /* * List of directories containing fonts, * built by recursively scanning the set * of configured directories */ FcStrSet *fontDirs; /* * Names of all of the configuration files used * to create this configuration */ FcStrSet *configFiles; /* config files loaded */ /* * Substitution instructions for patterns and fonts; * maxObjects is used to allocate appropriate intermediate storage * while performing a whole set of substitutions */ FcSubst *substPattern; /* substitutions for patterns */ FcSubst *substFont; /* substitutions for fonts */ int maxObjects; /* maximum number of tests in all substs */ /* * List of patterns used to control font file selection */ FcStrSet *acceptGlobs; FcStrSet *rejectGlobs; FcFontSet *acceptPatterns; FcFontSet *rejectPatterns; /* * The set of fonts loaded from the listed directories; the * order within the set does not determine the font selection, * except in the case of identical matches in which case earlier fonts * match preferrentially */ FcFontSet *fonts[FcSetApplication + 1]; /* * Fontconfig can periodically rescan the system configuration * and font directories. This rescanning occurs when font * listing requests are made, but no more often than rescanInterval * seconds apart. */ time_t rescanTime; /* last time information was scanned */ int rescanInterval; /* interval between scans */ }; extern FcConfig *_fcConfig; typedef struct _FcCharMap FcCharMap; /* fcblanks.c */ /* fccache.c */ FcGlobalCache * FcGlobalCacheCreate (void); void FcGlobalCacheDestroy (FcGlobalCache *cache); FcBool FcGlobalCacheReadDir (FcFontSet *set, FcStrSet *dirs, FcGlobalCache *cache, const FcChar8 *dir, FcConfig *config); void FcGlobalCacheLoad (FcGlobalCache *cache, FcStrSet *staleDirs, const FcChar8 *cache_file); FcBool FcGlobalCacheUpdate (FcGlobalCache *cache, const FcChar8 *file, FcFontSet *set); FcBool FcGlobalCacheSave (FcGlobalCache *cache, const FcChar8 *cache_file); FcFontSet * FcCacheRead (FcConfig *config, FcGlobalCache * cache); FcBool FcDirCacheWrite (FcFontSet *set, FcStrSet * dirs, const FcChar8 *dir); int FcCacheBankToIndex (int bank); /* fccfg.c */ FcBool FcConfigAddConfigDir (FcConfig *config, const FcChar8 *d); FcBool FcConfigAddFontDir (FcConfig *config, const FcChar8 *d); FcBool FcConfigAddDir (FcConfig *config, const FcChar8 *d); FcBool FcConfigAddConfigFile (FcConfig *config, const FcChar8 *f); FcBool FcConfigSetCache (FcConfig *config, const FcChar8 *c); FcBool FcConfigAddBlank (FcConfig *config, FcChar32 blank); FcBool FcConfigAddEdit (FcConfig *config, FcTest *test, FcEdit *edit, FcMatchKind kind); void FcConfigSetFonts (FcConfig *config, FcFontSet *fonts, FcSetName set); FcBool FcConfigCompareValue (const FcValue *m, FcOp op, const FcValue *v); FcBool FcConfigGlobAdd (FcConfig *config, const FcChar8 *glob, FcBool accept); FcBool FcConfigAcceptFilename (FcConfig *config, const FcChar8 *filename); FcBool FcConfigPatternsAdd (FcConfig *config, FcPattern *pattern, FcBool accept); FcBool FcConfigAcceptFont (FcConfig *config, const FcPattern *font); /* fccharset.c */ FcCharSet * FcCharSetFreeze (FcCharSet *cs); void FcCharSetThawAll (void); FcBool FcNameUnparseCharSet (FcStrBuf *buf, const FcCharSet *c); FcCharSet * FcNameParseCharSet (FcChar8 *string); FcCharLeaf * FcCharSetFindLeafCreate (FcCharSet *fcs, FcChar32 ucs4); void FcCharSetNewBank (void); int FcCharSetNeededBytes (const FcCharSet *c); void * FcCharSetDistributeBytes (FcCache * metadata, void * block_ptr); FcCharSet * FcCharSetSerialize(int bank, FcCharSet *c); void * FcCharSetUnserialize (FcCache metadata, void *block_ptr); FcCharLeaf * FcCharSetGetLeaf(const FcCharSet *c, int i); FcChar16 * FcCharSetGetNumbers(const FcCharSet *c); /* fcdbg.c */ void FcValueListPrint (const FcValueListPtr l); void FcLangSetPrint (const FcLangSet *ls); void FcOpPrint (FcOp op); void FcTestPrint (const FcTest *test); void FcExprPrint (const FcExpr *expr); void FcEditPrint (const FcEdit *edit); void FcSubstPrint (const FcSubst *subst); int FcDebug (void); /* fcdir.c */ FcBool FcFileIsDir (const FcChar8 *file); FcBool FcFileScanConfig (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *file, FcBool force, FcConfig *config); FcBool FcDirScanConfig (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const FcChar8 *dir, FcBool force, FcConfig *config); /* fcfont.c */ int FcFontDebug (void); /* fcfreetype.c */ FcBool FcFreeTypeIsExclusiveLang (const FcChar8 *lang); FcBool FcFreeTypeHasLang (FcPattern *pattern, const FcChar8 *lang); FcChar32 FcFreeTypeUcs4ToPrivate (FcChar32 ucs4, const FcCharMap *map); FcChar32 FcFreeTypePrivateToUcs4 (FcChar32 private, const FcCharMap *map); const FcCharMap * FcFreeTypeGetPrivateMap (FT_Encoding encoding); /* fcfs.c */ void FcFontSetNewBank (void); int FcFontSetNeededBytes (FcFontSet *s); void * FcFontSetDistributeBytes (FcCache * metadata, void * block_ptr); FcBool FcFontSetSerialize (int bank, FcFontSet * s); FcBool FcFontSetUnserialize(FcCache metadata, FcFontSet * s, void * block_ptr); /* fcgram.y */ int FcConfigparse (void); int FcConfigwrap (void); void FcConfigerror (char *fmt, ...); char * FcConfigSaveField (const char *field); void FcTestDestroy (FcTest *test); FcExpr * FcExprCreateInteger (int i); FcExpr * FcExprCreateDouble (double d); FcExpr * FcExprCreateString (const FcChar8 *s); FcExpr * FcExprCreateMatrix (const FcMatrix *m); FcExpr * FcExprCreateBool (FcBool b); FcExpr * FcExprCreateNil (void); FcExpr * FcExprCreateField (const char *field); FcExpr * FcExprCreateConst (const FcChar8 *constant); FcExpr * FcExprCreateOp (FcExpr *left, FcOp op, FcExpr *right); void FcExprDestroy (FcExpr *e); void FcEditDestroy (FcEdit *e); /* fcinit.c */ void FcMemReport (void); void FcMemAlloc (int kind, int size); void FcMemFree (int kind, int size); /* fclang.c */ FcLangSet * FcFreeTypeLangSet (const FcCharSet *charset, const FcChar8 *exclusiveLang); FcLangResult FcLangCompare (const FcChar8 *s1, const FcChar8 *s2); const FcCharSet * FcCharSetForLang (const FcChar8 *lang); FcLangSet * FcLangSetPromote (const FcChar8 *lang); FcLangSet * FcNameParseLangSet (const FcChar8 *string); FcBool FcNameUnparseLangSet (FcStrBuf *buf, const FcLangSet *ls); void FcLangSetNewBank (void); int FcLangSetNeededBytes (const FcLangSet *l); void * FcLangSetDistributeBytes (FcCache * metadata, void * block_ptr); FcLangSet * FcLangSetSerialize (int bank, FcLangSet *l); void * FcLangSetUnserialize (FcCache metadata, void *block_ptr); /* fclist.c */ FcBool FcListPatternMatchAny (const FcPattern *p, const FcPattern *font); /* fcmatch.c */ /* fcname.c */ FcBool FcNameBool (const FcChar8 *v, FcBool *result); void * FcObjectDistributeBytes (FcCache * metadata, void * block_ptr); FcObjectPtr FcObjectToPtr (const char * si); int FcObjectNeededBytes (void); void * FcObjectUnserialize (FcCache metadata, void *block_ptr); void FcObjectSerialize (void); const char * FcObjectPtrU (FcObjectPtr p); int FcObjectPtrCompare (FcObjectPtr a, FcObjectPtr b); void FcObjectStaticNameFini (void); /* fcpat.c */ FcValue FcValueCanonicalize (const FcValue *v); void FcValueListDestroy (FcValueListPtr l); FcPatternElt * FcPatternFindElt (const FcPattern *p, const char *object); FcPatternElt * FcPatternInsertElt (FcPattern *p, const char *object); FcBool FcPatternAddWithBinding (FcPattern *p, const char *object, FcValue value, FcValueBinding binding, FcBool append); FcPattern * FcPatternFreeze (FcPattern *p); void FcPatternFini (void); FcBool FcPatternAppend (FcPattern *p, FcPattern *s); const char * FcStrStaticName (const char *name); FcChar32 FcStringHash (const FcChar8 *s); void FcPatternNewBank (void); int FcPatternNeededBytes (FcPattern *p); void * FcPatternDistributeBytes (FcCache * metadata, void * block_ptr); FcValueList * FcValueListPtrU(FcValueListPtr p); FcPatternElt * FcPatternEltU (FcPatternEltPtr pei); FcValueListPtr FcValueListPtrCreateDynamic(FcValueList * p); FcPattern * FcPatternSerialize (int bank, FcPattern * p); void * FcPatternUnserialize (FcCache metadata, void *block_ptr); /* fcrender.c */ /* fcmatrix.c */ extern const FcMatrix FcIdentityMatrix; void FcMatrixFree (FcMatrix *mat); /* fcstr.c */ void FcStrSetSort (FcStrSet * set); FcChar8 * FcStrPlus (const FcChar8 *s1, const FcChar8 *s2); void FcStrFree (FcChar8 *s); void FcStrBufInit (FcStrBuf *buf, FcChar8 *init, int size); void FcStrBufDestroy (FcStrBuf *buf); FcChar8 * FcStrBufDone (FcStrBuf *buf); FcBool FcStrBufChar (FcStrBuf *buf, FcChar8 c); FcBool FcStrBufString (FcStrBuf *buf, const FcChar8 *s); FcBool FcStrBufData (FcStrBuf *buf, const FcChar8 *s, int len); int FcStrCmpIgnoreBlanksAndCase (const FcChar8 *s1, const FcChar8 *s2); const FcChar8 * FcStrContainsIgnoreBlanksAndCase (const FcChar8 *s1, const FcChar8 *s2); const FcChar8 * FcStrContainsIgnoreCase (const FcChar8 *s1, const FcChar8 *s2); FcBool FcStrUsesHome (const FcChar8 *s); FcChar8 * FcStrLastSlash (const FcChar8 *path); FcChar32 FcStrHashIgnoreCase (const FcChar8 *s); #endif /* _FC_INT_H_ */