X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=fontconfig%2Ffontconfig.h;h=410da1ec4c842e23a5a9fdc362336b59183820cc;hb=7ce196733129b0e664c1bdc20f973f15167292f7;hp=2a87aa7ee8a315928078d55adc3f7ad689c3b9bd;hpb=327a7fd491f17f23e37e260f8d74397e2ef933aa;p=fontconfig.git diff --git a/fontconfig/fontconfig.h b/fontconfig/fontconfig.h index 2a87aa7..410da1e 100644 --- a/fontconfig/fontconfig.h +++ b/fontconfig/fontconfig.h @@ -1,7 +1,7 @@ /* - * $XFree86: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.21 2002/07/11 02:47:50 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 @@ -27,20 +27,41 @@ #include +#if defined(__GNUC__) && (__GNUC__ >= 4) +#define FC_ATTRIBUTE_SENTINEL(x) __attribute__((__sentinel__(0))) +#else +#define FC_ATTRIBUTE_SENTINEL(x) +#endif + typedef unsigned char FcChar8; typedef unsigned short FcChar16; typedef unsigned int FcChar32; 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 1 + +#define FC_MAJOR 2 +#define FC_MINOR 3 +#define FC_REVISION 95 #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 "2" + #define FcTrue 1 #define FcFalse 0 @@ -55,9 +76,11 @@ typedef int FcBool; #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 */ @@ -68,39 +91,77 @@ typedef int FcBool; #define FC_DPI "dpi" /* double */ #define FC_RGBA "rgba" /* Int */ #define FC_MINSPACE "minspace" /* Bool use minimum line spacing */ -#define FC_SOURCE "source" /* String (X11, freetype) */ +#define FC_SOURCE "source" /* String (deprecated) */ #define FC_CHARSET "charset" /* CharSet */ -#define FC_LANG "lang" /* String OS/2 CodePageRange */ - -#define FC_DIR_CACHE_FILE "fonts.cache" -#define FC_USER_CACHE_FILE ".fonts.cache" +#define FC_LANG "lang" /* String RFC 3066 langs */ +#define FC_FONTVERSION "fontversion" /* Int from 'head' table */ +#define FC_FULLNAME "fullname" /* String */ +#define FC_FAMILYLANG "familylang" /* String RFC 3066 langs */ +#define FC_STYLELANG "stylelang" /* String RFC 3066 langs */ +#define FC_FULLNAMELANG "fullnamelang" /* String RFC 3066 langs */ +#define FC_CAPABILITY "capability" /* String */ +#define FC_FONTFORMAT "fontformat" /* String */ +#define FC_EMBOLDEN "embolden" /* Bool - true if emboldening needed*/ +#define FC_EMBEDDED_BITMAP "embeddedbitmap" /* Bool - true to enable embedded bitmaps */ + +#define FC_CACHE_SUFFIX ".cache-"FC_CACHE_VERSION +#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 - +#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, @@ -109,7 +170,8 @@ typedef enum _FcType { FcTypeBool, FcTypeMatrix, FcTypeCharSet, - FcTypeFTFace + FcTypeFTFace, + FcTypeLangSet } FcType; typedef struct _FcMatrix { @@ -138,24 +200,29 @@ typedef struct _FcConstant { } 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 { - const FcChar8 *s; + const FcChar8 *s; int i; FcBool b; double d; - const FcMatrix *m; - const FcCharSet *c; + 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; @@ -169,9 +236,13 @@ typedef struct _FcObjectSet { } FcObjectSet; typedef enum _FcMatchKind { - FcMatchPattern, FcMatchFont + FcMatchPattern, FcMatchFont } FcMatchKind; +typedef enum _FcLangResult { + FcLangEqual, FcLangDifferentCountry, FcLangDifferentLang +} FcLangResult; + typedef enum _FcSetName { FcSetSystem = 0, FcSetApplication = 1 @@ -201,6 +272,15 @@ typedef struct _FcStrSet FcStrSet; _FCFUNCPROTOBEGIN +FcBool +FcDirCacheValid (const FcChar8 *cache_file, FcConfig *config); + +FcBool +FcDirCacheHasCurrentArch (const FcChar8 *dir, FcConfig *config); + +FcBool +FcDirCacheUnlink (const FcChar8 *dir, FcConfig *config); + /* fcblanks.c */ FcBlanks * FcBlanksCreate (void); @@ -215,6 +295,12 @@ FcBool FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4); /* fccfg.c */ +FcChar8 * +FcConfigHome (void); + +FcBool +FcConfigEnableHome (FcBool enable); + FcChar8 * FcConfigFilename (const FcChar8 *url); @@ -239,6 +325,10 @@ FcConfigBuildFonts (FcConfig *config); FcStrList * FcConfigGetFontDirs (FcConfig *config); +const FcChar8 * +FcConfigNormalizeFontDir (FcConfig *config, + const FcChar8 *d); + FcStrList * FcConfigGetConfigDirs (FcConfig *config); @@ -272,6 +362,12 @@ FcConfigAppFontAddDir (FcConfig *config, void FcConfigAppFontClear (FcConfig *config); +FcBool +FcConfigSubstituteWithPat (FcConfig *config, + FcPattern *p, + FcPattern *p_pat, + FcMatchKind kind); + FcBool FcConfigSubstitute (FcConfig *config, FcPattern *p, @@ -333,13 +429,13 @@ FcCharSetNextPage (const FcCharSet *a, /* fcdbg.c */ void -FcValuePrint (FcValue v); +FcValuePrint (const FcValue v); void -FcPatternPrint (FcPattern *p); +FcPatternPrint (const FcPattern *p); void -FcFontSetPrint (FcFontSet *s); +FcFontSetPrint (const FcFontSet *s); /* fcdefault.c */ void @@ -390,6 +486,9 @@ FcInitLoadConfigAndFonts (void); FcBool FcInit (void); +void +FcFini (void); + int FcGetVersion (void); @@ -399,6 +498,34 @@ FcInitReinitialize (void); FcBool 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 * FcObjectSetCreate (void); @@ -413,7 +540,7 @@ FcObjectSet * FcObjectSetVaBuild (const char *first, va_list va); FcObjectSet * -FcObjectSetBuild (const char *first, ...); +FcObjectSetBuild (const char *first, ...) FC_ATTRIBUTE_SENTINEL(0); FcFontSet * FcFontSetList (FcConfig *config, @@ -538,12 +665,15 @@ FcNameParse (const FcChar8 *name); FcChar8 * FcNameUnparse (FcPattern *pat); +FcChar8 * +FcNameUnparseEscaped (FcPattern *pat, FcBool escape); + /* fcpat.c */ FcPattern * FcPatternCreate (void); FcPattern * -FcPatternDuplicate (FcPattern *p); +FcPatternDuplicate (const FcPattern *p); void FcPatternReference (FcPattern *p); @@ -576,11 +706,14 @@ 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 +FcPatternRemove (FcPattern *p, const char *object, int id); + FcBool FcPatternAddInteger (FcPattern *p, const char *object, int i); @@ -599,29 +732,35 @@ FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c); FcBool FcPatternAddBool (FcPattern *p, const char *object, FcBool b); +FcBool +FcPatternAddLangSet (FcPattern *p, const char *object, const FcLangSet *ls); + +FcResult +FcPatternGetInteger (const FcPattern *p, const char *object, int n, int *i); + FcResult -FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i); +FcPatternGetDouble (const FcPattern *p, const char *object, int n, double *d); FcResult -FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d); +FcPatternGetString (const FcPattern *p, const char *object, int n, FcChar8 ** s); FcResult -FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 ** s); +FcPatternGetMatrix (const FcPattern *p, const char *object, int n, FcMatrix **s); FcResult -FcPatternGetMatrix (FcPattern *p, const char *object, int n, FcMatrix **s); +FcPatternGetCharSet (const FcPattern *p, const char *object, int n, FcCharSet **c); FcResult -FcPatternGetCharSet (FcPattern *p, const char *object, int n, FcCharSet **c); +FcPatternGetBool (const FcPattern *p, const char *object, int n, FcBool *b); FcResult -FcPatternGetBool (FcPattern *p, const char *object, int n, FcBool *b); +FcPatternGetLangSet (const FcPattern *p, const char *object, int n, FcLangSet **ls); FcPattern * FcPatternVaBuild (FcPattern *orig, va_list va); FcPattern * -FcPatternBuild (FcPattern *orig, ...); +FcPatternBuild (FcPattern *orig, ...) FC_ATTRIBUTE_SENTINEL(0); /* fcstr.c */ @@ -631,7 +770,13 @@ FcStrCopy (const FcChar8 *s); FcChar8 * FcStrCopyFilename (const FcChar8 *s); -#define FcToLower(c) (('A' <= (c) && (c) <= 'Z') ? (c) - 'A' + 'a' : (c)) +/* These are ASCII only, suitable only for pattern element names */ +#define FcIsUpper(c) ((0101 <= (c) && (c) <= 0132)) +#define FcIsLower(c) ((0141 <= (c) && (c) <= 0172)) +#define FcToLower(c) (FcIsUpper(c) ? (c) - 0101 + 0141 : (c)) + +FcChar8 * +FcStrDowncase (const FcChar8 *s); int FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2); @@ -639,16 +784,22 @@ FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2); int 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 (FcChar8 *src_orig, - FcChar32 *dst, - int len); +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 @@ -657,17 +808,17 @@ FcUcs4ToUtf8 (FcChar32 ucs4, FcChar8 dest[FC_UTF8_MAX_LEN]); int -FcUtf16ToUcs4 (FcChar8 *src_orig, - FcEndian endian, - FcChar32 *dst, - int len); /* in bytes */ +FcUtf16ToUcs4 (const FcChar8 *src_orig, + FcEndian endian, + FcChar32 *dst, + int len); /* in bytes */ FcBool -FcUtf16Len (FcChar8 *string, - FcEndian endian, - int len, /* in bytes */ - int *nchar, - int *wchar); +FcUtf16Len (const FcChar8 *string, + FcEndian endian, + int len, /* in bytes */ + int *nchar, + int *wchar); FcChar8 * FcStrDirname (const FcChar8 *file); @@ -681,6 +832,9 @@ FcStrSetCreate (void); FcBool FcStrSetMember (FcStrSet *set, const FcChar8 *s); +FcBool +FcStrSetEqual (FcStrSet *sa, FcStrSet *sb); + FcBool FcStrSetAdd (FcStrSet *set, const FcChar8 *s); @@ -708,4 +862,6 @@ FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain); _FCFUNCPROTOEND +#undef FC_ATTRIBUTE_SENTINEL + #endif /* _FONTCONFIG_H_ */