]> git.wh0rd.org - fontconfig.git/blob - fontconfig/fontconfig.h
A few random fontconfig build fixes
[fontconfig.git] / fontconfig / fontconfig.h
1 /*
2 * $XFree86: xc/lib/fontconfig/fontconfig/fontconfig.h,v 1.9 2002/05/22 04:37:07 keithp Exp $
3 *
4 * Copyright © 2001 Keith Packard, member of The XFree86 Project, Inc.
5 *
6 * Permission to use, copy, modify, distribute, and sell this software and its
7 * documentation for any purpose is hereby granted without fee, provided that
8 * the above copyright notice appear in all copies and that both that
9 * copyright notice and this permission notice appear in supporting
10 * documentation, and that the name of Keith Packard not be used in
11 * advertising or publicity pertaining to distribution of the software without
12 * specific, written prior permission. Keith Packard makes no
13 * representations about the suitability of this software for any purpose. It
14 * is provided "as is" without express or implied warranty.
15 *
16 * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
17 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
18 * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
19 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
20 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
21 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
22 * PERFORMANCE OF THIS SOFTWARE.
23 */
24
25 #ifndef _FONTCONFIG_H_
26 #define _FONTCONFIG_H_
27
28 #include <stdarg.h>
29
30 typedef unsigned char FcChar8;
31 typedef unsigned short FcChar16;
32 typedef unsigned int FcChar32;
33 typedef int FcBool;
34
35 /*
36 * Current Fontconfig version number
37 */
38 #define FC_MAJOR 1
39 #define FC_MINOR 0
40 #define FC_REVISION 1
41
42 #define FC_VERSION ((FC_MAJOR * 10000) + (FC_MINOR * 100) + (FC_REVISION))
43
44 #define FcTrue 1
45 #define FcFalse 0
46
47 #define FC_FAMILY "family" /* String */
48 #define FC_STYLE "style" /* String */
49 #define FC_SLANT "slant" /* Int */
50 #define FC_WEIGHT "weight" /* Int */
51 #define FC_SIZE "size" /* Double */
52 #define FC_PIXEL_SIZE "pixelsize" /* Double */
53 #define FC_SPACING "spacing" /* Int */
54 #define FC_FOUNDRY "foundry" /* String */
55 #define FC_ANTIALIAS "antialias" /* Bool (depends) */
56 #define FC_HINTING "hinting" /* Bool (true) */
57 #define FC_VERTICAL_LAYOUT "verticallayout" /* Bool (false) */
58 #define FC_AUTOHINT "autohint" /* Bool (false) */
59 #define FC_GLOBAL_ADVANCE "globaladvance" /* Bool (true) */
60 #define FC_FILE "file" /* String */
61 #define FC_INDEX "index" /* Int */
62 #define FC_RASTERIZER "rasterizer" /* String */
63 #define FC_OUTLINE "outline" /* Bool */
64 #define FC_SCALABLE "scalable" /* Bool */
65 #define FC_SCALE "scale" /* double */
66 #define FC_DPI "dpi" /* double */
67 #define FC_RGBA "rgba" /* Int */
68 #define FC_MINSPACE "minspace" /* Bool use minimum line spacing */
69 #define FC_SOURCE "source" /* String (X11, freetype) */
70 #define FC_CHARSET "charset" /* CharSet */
71 #define FC_LANG "lang" /* String OS/2 CodePageRange */
72
73 #define FC_DIR_CACHE_FILE "fonts.cache"
74 #define FC_USER_CACHE_FILE ".fonts.cache"
75
76 /* Adjust outline rasterizer */
77 #define FC_CHAR_WIDTH "charwidth" /* Int */
78 #define FC_CHAR_HEIGHT "charheight"/* Int */
79 #define FC_MATRIX "matrix" /* FcMatrix */
80
81 #define FC_WEIGHT_LIGHT 0
82 #define FC_WEIGHT_MEDIUM 100
83 #define FC_WEIGHT_DEMIBOLD 180
84 #define FC_WEIGHT_BOLD 200
85 #define FC_WEIGHT_BLACK 210
86
87 #define FC_SLANT_ROMAN 0
88 #define FC_SLANT_ITALIC 100
89 #define FC_SLANT_OBLIQUE 110
90
91 #define FC_PROPORTIONAL 0
92 #define FC_MONO 100
93 #define FC_CHARCELL 110
94
95 /* sub-pixel order */
96 #define FC_RGBA_NONE 0
97 #define FC_RGBA_RGB 1
98 #define FC_RGBA_BGR 2
99 #define FC_RGBA_VRGB 3
100 #define FC_RGBA_VBGR 4
101
102 /* language groups from the OS/2 CodePageRange bits */
103 #define FC_LANG_LATIN_1 "latin1" /* 0 */
104 #define FC_LANG_LATIN_2_EASTERN_EUROPE "latin2easterneurope" /* 1 */
105 #define FC_LANG_CYRILLIC "cyrillic" /* 2 */
106 #define FC_LANG_GREEK "greek" /* 3 */
107 #define FC_LANG_TURKISH "turkish" /* 4 */
108 #define FC_LANG_HEBREW "hebrew" /* 5 */
109 #define FC_LANG_ARABIC "arabic" /* 6 */
110 #define FC_LANG_WINDOWS_BALTIC "windowsbaltic" /* 7 */
111 #define FC_LANG_VIETNAMESE "vietnamese" /* 8 */
112 /* 9-15 reserved for Alternate ANSI */
113 #define FC_LANG_THAI "thai" /* 16 */
114 #define FC_LANG_JAPANESE "japanese" /* 17 */
115 #define FC_LANG_SIMPLIFIED_CHINESE "simplifiedchinese" /* 18 */
116 #define FC_LANG_KOREAN_WANSUNG "koreanwansung" /* 19 */
117 #define FC_LANG_TRADITIONAL_CHINESE "traditionalchinese" /* 20 */
118 #define FC_LANG_KOREAN_JOHAB "koreanjohab" /* 21 */
119 /* 22-28 reserved for Alternate ANSI & OEM */
120 #define FC_LANG_MACINTOSH "macintosh" /* 29 */
121 #define FC_LANG_OEM "oem" /* 30 */
122 #define FC_LANG_SYMBOL "symbol" /* 31 */
123 /* 32-47 reserved for OEM */
124 #define FC_LANG_IBM_GREEK "ibmgreek" /* 48 */
125 #define FC_LANG_MSDOS_RUSSIAN "msdosrussian" /* 49 */
126 #define FC_LANG_MSDOS_NORDIC "msdosnordic" /* 50 */
127 #define FC_LANG_ARABIC_864 "arabic864" /* 51 */
128 #define FC_LANG_MSDOS_CANADIAN_FRENCH "msdoscanadianfrench" /* 52 */
129 #define FC_LANG_HEBREW_862 "hebrew862" /* 53 */
130 #define FC_LANG_MSDOS_ICELANDIC "msdosicelandic" /* 54 */
131 #define FC_LANG_MSDOS_PORTUGUESE "msdosportuguese" /* 55 */
132 #define FC_LANG_IBM_TURKISH "ibmturkish" /* 56 */
133 #define FC_LANG_IBM_CYRILLIC "ibmcyrillic" /* 57 */
134 #define FC_LANG_LATIN_2 "latin2" /* 58 */
135 #define FC_LANG_MSDOS_BALTIC "msdosbaltic" /* 59 */
136 #define FC_LANG_GREEK_437_G "greek437g" /* 60 */
137 #define FC_LANG_ARABIC_ASMO_708 "arabicasmo708" /* 61 */
138 #define FC_LANG_WE_LATIN_1 "welatin1" /* 62 */
139 #define FC_LANG_US "us" /* 63 */
140
141 typedef enum _FcType {
142 FcTypeVoid,
143 FcTypeInteger,
144 FcTypeDouble,
145 FcTypeString,
146 FcTypeBool,
147 FcTypeMatrix,
148 FcTypeCharSet
149 } FcType;
150
151 typedef struct _FcMatrix {
152 double xx, xy, yx, yy;
153 } FcMatrix;
154
155 #define FcMatrixInit(m) ((m)->xx = (m)->yy = 1, \
156 (m)->xy = (m)->yx = 0)
157
158 /*
159 * A data structure to represent the available glyphs in a font.
160 * This is represented as a sparse boolean btree.
161 */
162
163 typedef struct _FcCharSet FcCharSet;
164
165 typedef struct _FcObjectType {
166 const char *object;
167 FcType type;
168 } FcObjectType;
169
170 typedef struct _FcConstant {
171 const FcChar8 *name;
172 const char *object;
173 int value;
174 } FcConstant;
175
176 typedef enum _FcResult {
177 FcResultMatch, FcResultNoMatch, FcResultTypeMismatch, FcResultNoId
178 } FcResult;
179
180 typedef struct _FcValue {
181 FcType type;
182 union {
183 const FcChar8 *s;
184 int i;
185 FcBool b;
186 double d;
187 const FcMatrix *m;
188 const FcCharSet *c;
189 } u;
190 } FcValue;
191
192 typedef struct _FcPattern FcPattern;
193
194 typedef struct _FcFontSet {
195 int nfont;
196 int sfont;
197 FcPattern **fonts;
198 } FcFontSet;
199
200 typedef struct _FcObjectSet {
201 int nobject;
202 int sobject;
203 const char **objects;
204 } FcObjectSet;
205
206 typedef enum _FcMatchKind {
207 FcMatchPattern, FcMatchFont
208 } FcMatchKind;
209
210 typedef enum _FcSetName {
211 FcSetSystem = 0,
212 FcSetApplication = 1
213 } FcSetName;
214
215 typedef struct _FcAtomic FcAtomic;
216
217 #if defined(__cplusplus) || defined(c_plusplus) /* for C++ V2.0 */
218 #define _FCFUNCPROTOBEGIN extern "C" { /* do not leave open across includes */
219 #define _FCFUNCPROTOEND }
220 #else
221 #define _FCFUNCPROTOBEGIN
222 #define _FCFUNCPROTOEND
223 #endif
224
225 typedef struct _FcConfig FcConfig;
226
227 typedef struct _FcFileCache FcFileCache;
228
229 typedef struct _FcBlanks FcBlanks;
230
231 typedef struct _FcStrList FcStrList;
232
233 typedef struct _FcStrSet FcStrSet;
234
235 _FCFUNCPROTOBEGIN
236
237 /* fcblanks.c */
238 FcBlanks *
239 FcBlanksCreate (void);
240
241 void
242 FcBlanksDestroy (FcBlanks *b);
243
244 FcBool
245 FcBlanksAdd (FcBlanks *b, FcChar32 ucs4);
246
247 FcBool
248 FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4);
249
250 /* fccfg.c */
251 FcChar8 *
252 FcConfigFilename (const FcChar8 *url);
253
254 FcConfig *
255 FcConfigCreate (void);
256
257 void
258 FcConfigDestroy (FcConfig *config);
259
260 FcBool
261 FcConfigSetCurrent (FcConfig *config);
262
263 FcConfig *
264 FcConfigGetCurrent (void);
265
266 FcBool
267 FcConfigUptoDate (FcConfig *config);
268
269 FcBool
270 FcConfigBuildFonts (FcConfig *config);
271
272 FcStrList *
273 FcConfigGetFontDirs (FcConfig *config);
274
275 FcStrList *
276 FcConfigGetConfigDirs (FcConfig *config);
277
278 FcStrList *
279 FcConfigGetConfigFiles (FcConfig *config);
280
281 FcChar8 *
282 FcConfigGetCache (FcConfig *config);
283
284 FcBlanks *
285 FcConfigGetBlanks (FcConfig *config);
286
287 int
288 FcConfigGetRescanInverval (FcConfig *config);
289
290 FcBool
291 FcConfigSetRescanInverval (FcConfig *config, int rescanInterval);
292
293 FcFontSet *
294 FcConfigGetFonts (FcConfig *config,
295 FcSetName set);
296
297 FcBool
298 FcConfigAppFontAddFile (FcConfig *config,
299 const FcChar8 *file);
300
301 FcBool
302 FcConfigAppFontAddDir (FcConfig *config,
303 const FcChar8 *dir);
304
305 void
306 FcConfigAppFontClear (FcConfig *config);
307
308 FcBool
309 FcConfigSubstitute (FcConfig *config,
310 FcPattern *p,
311 FcMatchKind kind);
312
313 /* fccharset.c */
314 FcCharSet *
315 FcCharSetCreate (void);
316
317 void
318 FcCharSetDestroy (FcCharSet *fcs);
319
320 FcBool
321 FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4);
322
323 FcCharSet *
324 FcCharSetCopy (FcCharSet *src);
325
326 FcBool
327 FcCharSetEqual (const FcCharSet *a, const FcCharSet *b);
328
329 FcCharSet *
330 FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b);
331
332 FcCharSet *
333 FcCharSetUnion (const FcCharSet *a, const FcCharSet *b);
334
335 FcCharSet *
336 FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b);
337
338 FcBool
339 FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4);
340
341 FcChar32
342 FcCharSetCount (const FcCharSet *a);
343
344 FcChar32
345 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b);
346
347 FcChar32
348 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b);
349
350 FcChar32
351 FcCharSetCoverage (const FcCharSet *a, FcChar32 page, FcChar32 *result);
352
353 /* fcdbg.c */
354 void
355 FcValuePrint (FcValue v);
356
357 void
358 FcPatternPrint (FcPattern *p);
359
360 void
361 FcFontSetPrint (FcFontSet *s);
362
363 /* fcdefault.c */
364 void
365 FcDefaultSubstitute (FcPattern *pattern);
366
367 /* fcdir.c */
368 FcBool
369 FcFileScan (FcFontSet *set,
370 FcStrSet *dirs,
371 FcFileCache *cache,
372 FcBlanks *blanks,
373 const FcChar8 *file,
374 FcBool force);
375
376 FcBool
377 FcDirScan (FcFontSet *set,
378 FcStrSet *dirs,
379 FcFileCache *cache,
380 FcBlanks *blanks,
381 const FcChar8 *dir,
382 FcBool force);
383
384 FcBool
385 FcDirSave (FcFontSet *set, FcStrSet *dirs, const FcChar8 *dir);
386
387 FcBool
388 FcDirCacheValid (const FcChar8 *dir);
389
390 /* fcfreetype.c */
391 FcPattern *
392 FcFreeTypeQuery (const FcChar8 *file, int id, FcBlanks *blanks, int *count);
393
394 /* fcfs.c */
395
396 FcFontSet *
397 FcFontSetCreate (void);
398
399 void
400 FcFontSetDestroy (FcFontSet *s);
401
402 FcBool
403 FcFontSetAdd (FcFontSet *s, FcPattern *font);
404
405 /* fcinit.c */
406 FcConfig *
407 FcInitLoadConfig (void);
408
409 FcConfig *
410 FcInitLoadConfigAndFonts (void);
411
412 FcBool
413 FcInit (void);
414
415 int
416 FcGetVersion (void);
417
418 FcBool
419 FcInitReinitialize (void);
420
421 FcBool
422 FcInitBringUptoDate (void);
423
424 /* fclist.c */
425 FcObjectSet *
426 FcObjectSetCreate (void);
427
428 FcBool
429 FcObjectSetAdd (FcObjectSet *os, const char *object);
430
431 void
432 FcObjectSetDestroy (FcObjectSet *os);
433
434 FcObjectSet *
435 FcObjectSetVaBuild (const char *first, va_list va);
436
437 FcObjectSet *
438 FcObjectSetBuild (const char *first, ...);
439
440 FcFontSet *
441 FcFontSetList (FcConfig *config,
442 FcFontSet **sets,
443 int nsets,
444 FcPattern *p,
445 FcObjectSet *os);
446
447 FcFontSet *
448 FcFontList (FcConfig *config,
449 FcPattern *p,
450 FcObjectSet *os);
451
452 /* fcatomic.c */
453
454 FcAtomic *
455 FcAtomicCreate (const FcChar8 *file);
456
457 FcBool
458 FcAtomicLock (FcAtomic *atomic);
459
460 FcChar8 *
461 FcAtomicNewFile (FcAtomic *atomic);
462
463 FcChar8 *
464 FcAtomicOrigFile (FcAtomic *atomic);
465
466 FcBool
467 FcAtomicReplaceOrig (FcAtomic *atomic);
468
469 void
470 FcAtomicDeleteNew (FcAtomic *atomic);
471
472 void
473 FcAtomicUnlock (FcAtomic *atomic);
474
475 void
476 FcAtomicDestroy (FcAtomic *atomic);
477
478 /* fcmatch.c */
479 FcPattern *
480 FcFontSetMatch (FcConfig *config,
481 FcFontSet **sets,
482 int nsets,
483 FcPattern *p,
484 FcResult *result);
485
486 FcPattern *
487 FcFontMatch (FcConfig *config,
488 FcPattern *p,
489 FcResult *result);
490
491 FcPattern *
492 FcFontRenderPrepare (FcConfig *config,
493 FcPattern *pat,
494 FcPattern *font);
495
496 FcFontSet *
497 FcFontSetSort (FcConfig *config,
498 FcFontSet **sets,
499 int nsets,
500 FcPattern *p,
501 FcBool trim,
502 FcCharSet **csp,
503 FcResult *result);
504
505 /* fcmatrix.c */
506 FcMatrix *
507 FcMatrixCopy (const FcMatrix *mat);
508
509 FcBool
510 FcMatrixEqual (const FcMatrix *mat1, const FcMatrix *mat2);
511
512 void
513 FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b);
514
515 void
516 FcMatrixRotate (FcMatrix *m, double c, double s);
517
518 void
519 FcMatrixScale (FcMatrix *m, double sx, double sy);
520
521 void
522 FcMatrixShear (FcMatrix *m, double sh, double sv);
523
524 /* fcname.c */
525
526 FcBool
527 FcNameRegisterObjectTypes (const FcObjectType *types, int ntype);
528
529 FcBool
530 FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype);
531
532 const FcObjectType *
533 FcNameGetObjectType (const char *object);
534
535 FcBool
536 FcNameRegisterConstants (const FcConstant *consts, int nconsts);
537
538 FcBool
539 FcNameUnregisterConstants (const FcConstant *consts, int nconsts);
540
541 const FcConstant *
542 FcNameGetConstant (FcChar8 *string);
543
544 FcBool
545 FcNameConstant (FcChar8 *string, int *result);
546
547 FcPattern *
548 FcNameParse (const FcChar8 *name);
549
550 FcChar8 *
551 FcNameUnparse (FcPattern *pat);
552
553 /* fcpat.c */
554 FcPattern *
555 FcPatternCreate (void);
556
557 FcPattern *
558 FcPatternDuplicate (FcPattern *p);
559
560 void
561 FcValueDestroy (FcValue v);
562
563 FcBool
564 FcValueEqual (FcValue va, FcValue vb);
565
566 FcValue
567 FcValueSave (FcValue v);
568
569 void
570 FcPatternDestroy (FcPattern *p);
571
572 FcBool
573 FcPatternEqual (FcPattern *pa, FcPattern *pb);
574
575 FcBool
576 FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append);
577
578 FcResult
579 FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v);
580
581 FcBool
582 FcPatternDel (FcPattern *p, const char *object);
583
584 FcBool
585 FcPatternAddInteger (FcPattern *p, const char *object, int i);
586
587 FcBool
588 FcPatternAddDouble (FcPattern *p, const char *object, double d);
589
590 FcBool
591 FcPatternAddString (FcPattern *p, const char *object, const FcChar8 *s);
592
593 FcBool
594 FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s);
595
596 FcBool
597 FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c);
598
599 FcBool
600 FcPatternAddBool (FcPattern *p, const char *object, FcBool b);
601
602 FcResult
603 FcPatternGetInteger (FcPattern *p, const char *object, int n, int *i);
604
605 FcResult
606 FcPatternGetDouble (FcPattern *p, const char *object, int n, double *d);
607
608 FcResult
609 FcPatternGetString (FcPattern *p, const char *object, int n, FcChar8 ** s);
610
611 FcResult
612 FcPatternGetMatrix (FcPattern *p, const char *object, int n, FcMatrix **s);
613
614 FcResult
615 FcPatternGetCharSet (FcPattern *p, const char *object, int n, FcCharSet **c);
616
617 FcResult
618 FcPatternGetBool (FcPattern *p, const char *object, int n, FcBool *b);
619
620 FcPattern *
621 FcPatternVaBuild (FcPattern *orig, va_list va);
622
623 FcPattern *
624 FcPatternBuild (FcPattern *orig, ...);
625
626 /* fcstr.c */
627
628 FcChar8 *
629 FcStrCopy (const FcChar8 *s);
630
631 FcChar8 *
632 FcStrCopyFilename (const FcChar8 *s);
633
634 #define FcToLower(c) (('A' <= (c) && (c) <= 'Z') ? (c) - 'A' + 'a' : (c))
635
636 int
637 FcStrCmpIgnoreCase (const FcChar8 *s1, const FcChar8 *s2);
638
639 int
640 FcStrCmp (const FcChar8 *s1, const FcChar8 *s2);
641
642 int
643 FcUtf8ToUcs4 (FcChar8 *src_orig,
644 FcChar32 *dst,
645 int len);
646
647 FcBool
648 FcUtf8Len (FcChar8 *string,
649 int len,
650 int *nchar,
651 int *wchar);
652
653 FcChar8 *
654 FcStrDirname (const FcChar8 *file);
655
656 FcChar8 *
657 FcStrBasename (const FcChar8 *file);
658
659 FcStrSet *
660 FcStrSetCreate (void);
661
662 FcBool
663 FcStrSetMember (FcStrSet *set, const FcChar8 *s);
664
665 FcBool
666 FcStrSetAdd (FcStrSet *set, const FcChar8 *s);
667
668 FcBool
669 FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s);
670
671 FcBool
672 FcStrSetDel (FcStrSet *set, const FcChar8 *s);
673
674 void
675 FcStrSetDestroy (FcStrSet *set);
676
677 FcStrList *
678 FcStrListCreate (FcStrSet *set);
679
680 FcChar8 *
681 FcStrListNext (FcStrList *list);
682
683 void
684 FcStrListDone (FcStrList *list);
685
686 /* fcxml.c */
687 FcBool
688 FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain);
689
690 _FCFUNCPROTOEND
691
692 #endif /* _FONTCONFIG_H_ */