1 /* font.h -- Interface definition for font handling.
2 Copyright (C) 2006 Free Software Foundation, Inc.
4 National Institute of Advanced Industrial Science and Technology (AIST)
5 Registration Number H13PRO009
7 This file is part of GNU Emacs.
9 GNU Emacs is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2, or (at your option)
14 GNU Emacs is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with GNU Emacs; see the file COPYING. If not, write to
21 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA. */
29 /* We have three types of Lisp objects related to font.
33 Vector (length FONT_SPEC_MAX) of font properties. Some
34 properties can be left unspecified (i.e. nil). Emacs asks
35 font-drivers to find a font by FONT-SPEC. A fontset entry
36 specifies requisite properties whereas a face specifies just
37 preferable properties. This object is fully modifiable by
42 Vector (length FONT_ENTITY_MAX) of fully specified font
43 properties that a font-driver returns upon a request of
46 Note: Only the method `list' of a font-driver can create this
47 object, and should never be modified by Lisp. In that sense,
48 it may be cleaner to implement it as a Lisp object of a new
49 type (e.g. struct Lisp_Font).
53 Lisp object of type Lisp_Misc_Save_Value encapsulating a
54 pointer to "struct font". This corresponds to an opened font.
56 Note: The note for FONT-ENTITY also applies to this.
63 /* An enumerator for each font property. This is used as an index to
64 the vector of FONT-SPEC and FONT-ENTITY.
66 Note: The order is important and should not be changed. */
68 enum font_property_index
70 /* FONT-TYPE is a symbol indicating a font backend; currently `x',
71 `xft', `ftx', `freetype' are available. For windows, we need
72 `bdf' and `windows'. For Mac OS X, we need `atm'. */
75 /* FONT-FOUNDRY is a foundry name (symbol). */
78 /* FONT-FAMILY is a family name (symbol). */
81 /* FONT-ADSTYLE is an additional style name (symbol). */
84 /* FONT-REGISTRY is a combination of a charset-registry and
85 charset0encoding name (symbol). */
88 /* FONT-WEIGHT is a numeric value of weight (e.g. medium, bold) of
89 the font. The value is what defined by FC_WEIGHT_* in
93 /* FONT-SLANT is a numeric value of slant (e.g. r, i, o) of the
94 font. The value is what defined by FC_SLANT_* in
95 fontconfig plus 100. */
98 /* FONT-WIDTH is a numeric value of setwidth (e.g. normal,
99 condensed) of the font. The value is what defined by
100 FC_WIDTH_* in fontconfig. */
103 /* FONT-SIZE is a size of the font. If integer, it is a pixel
104 size. For a font-spec, the value can be float specifying a
105 point size. For a font-entity, the value can be zero meaning
106 that the font is scalable. */
109 /* In a font-spec, the value is an alist of extra information of a
110 font such as name, OpenType features, and language coverage.
111 In a font-entity, the value is an extra infomation for
112 identifying a font (font-driver dependent). */
113 FONT_EXTRA_INDEX
, /* alist alist */
115 /* This value is the length of font-spec vector. */
118 /* The followings are used only for a font-entity. */
120 /* Frame on which the font is found. The value is nil if the font
121 can be opend on any frame. */
122 FONT_FRAME_INDEX
= FONT_SPEC_MAX
,
124 /* List of font-objects opened from the font-entity. The value is
125 nil if no font can be opened for this font-entity. */
128 /* This value is the length of font-entity vector. */
132 extern Lisp_Object QCspacing
, QCdpi
, QCscalable
, QCotf
, QClanguage
, QCscript
;
134 /* Important character set symbols. */
135 extern Lisp_Object Qiso8859_1
, Qiso10646_1
, Qunicode_bmp
, Qunicode_sip
;
137 extern Lisp_Object null_string
;
138 extern Lisp_Object null_vector
;
140 /* Structure for an opened font. We can safely cast this structure to
141 "struct font_info". */
145 struct font_info font
;
147 /* From which font-entity the font is opened. */
150 /* By which pixel size the font is opened. */
153 /* Font-driver for the font. */
154 struct font_driver
*driver
;
156 /* Symbol of font font; x, ttf, pcf, etc, */
159 /* File name of the font, or NULL if the font is not associated with
163 /* Charset to encode a character code into a glyph code of the font.
164 -1 means that the font doesn't require this information to encode
166 int encoding_charset
;
168 /* Charset to check if a character code is supported by the font.
169 -1 means that the contents of the font must be looked up to
171 int repertory_charset
;
173 /* Minimum glyph width (in pixels). */
176 /* Ascent and descent of the font (in pixels). */
179 /* 1 iff the font is scalable. */
182 /* There will be more to this structure, but they are private to a
188 FONT_SPACING_PROPORTIONAL
= 0,
189 FONT_SPACING_DUAL
= 90,
190 FONT_SPACING_MONO
= 100,
191 FONT_SPACING_CHARCELL
= 110
196 short lbearing
, rbearing
, width
, ascent
, descent
;
205 unsigned char *buffer
;
212 /* Predicates to check various font-related objects. */
215 (VECTORP (x) && (ASIZE (x) == FONT_SPEC_MAX || ASIZE (x) == FONT_ENTITY_MAX))
216 #define FONT_SPEC_P(x) \
217 (VECTORP (x) && ASIZE (x) == FONT_SPEC_MAX)
218 #define FONT_ENTITY_P(x) \
219 (VECTORP (x) && ASIZE (x) == FONT_ENTITY_MAX)
220 #define FONT_OBJECT_P(x) \
221 (XTYPE (x) == Lisp_Misc && XMISCTYPE (x) == Lisp_Misc_Save_Value)
223 #define FONT_ENTITY_NOT_LOADABLE(entity) \
224 EQ (AREF (entity, FONT_OBJLIST_INDEX), Qt)
226 #define FONT_ENTITY_SET_NOT_LOADABLE(entity) \
227 ASET (entity, FONT_OBJLIST_INDEX, Qt)
230 /* Check macros for various font-related objects. */
232 #define CHECK_FONT(x) \
233 do { if (! FONTP (x)) x = wrong_type_argument (Qfont, x); } while (0)
234 #define CHECK_FONT_SPEC(x) \
235 do { if (! FONT_SPEC_P (x)) x = wrong_type_argument (Qfont, x); } while (0)
236 #define CHECK_FONT_ENTITY(x) \
237 do { if (! FONT_ENTITY_P (x)) x = wrong_type_argument (Qfont, x); } while (0)
238 #define CHECK_FONT_OBJECT(x) \
239 do { if (! FONT_OBJECT_P (x)) x = wrong_type_argument (Qfont, x); } while (0)
241 #define CHECK_FONT_GET_OBJECT(x, font) \
243 if (! FONT_OBJECT_P (x)) x = wrong_type_argument (Qfont, x); \
244 if (! XSAVE_VALUE (x)->pointer) error ("Font already closed"); \
245 font = XSAVE_VALUE (x)->pointer; \
248 /* Ignore the difference of font pixel sizes less than or equal to
250 #define FONT_PIXEL_SIZE_QUANTUM 1
255 /* Macros for lispy glyph-string. */
256 #define LGSTRING_FONT(lgs) AREF (AREF ((lgs), 0), 0)
257 #define LGSTRING_WIDTH(lgs) XINT (AREF (AREF ((lgs), 0), 1))
258 #define LGSTRING_LBEARING(lgs) XINT (AREF (AREF ((lgs), 0), 2))
259 #define LGSTRING_RBEARING(lgs) XINT (AREF (AREF ((lgs), 0), 3))
260 #define LGSTRING_ASCENT(lgs) XINT (AREF (AREF ((lgs), 0), 4))
261 #define LGSTRING_DESCENT(lgs) XINT (AREF (AREF ((lgs), 0), 5))
262 #define LGSTRING_SET_FONT(lgs, val) \
263 ASET (AREF ((lgs), 0), 0, (val))
264 #define LGSTRING_SET_WIDTH(lgs, val) \
265 ASET (AREF ((lgs), 0), 1, make_number (val))
266 #define LGSTRING_SET_LBEARING(lgs, val) \
267 ASET (AREF ((lgs), 0), 2, make_number (val))
268 #define LGSTRING_SET_RBEARING(lgs, val) \
269 ASET (AREF ((lgs), 0), 3, make_number (val))
270 #define LGSTRING_SET_ASCENT(lgs, val) \
271 ASET (AREF ((lgs), 0), 4, make_number (val))
272 #define LGSTRING_SET_DESCENT(lgs, val) \
273 ASET (AREF ((lgs), 0), 5, make_number (val))
275 #define LGSTRING_LENGTH(lgs) (ASIZE ((lgs)) - 1)
276 #define LGSTRING_GLYPH(lgs, idx) AREF ((lgs), (idx) + 1)
277 #define LGSTRING_SET_GLYPH(lgs, idx, val) ASET ((lgs), (idx) + 1, (val))
279 #define LGLYPH_FROM(g) XINT (AREF ((g), 0))
280 #define LGLYPH_TO(g) XINT (AREF ((g), 1))
281 #define LGLYPH_CHAR(g) XINT (AREF ((g), 2))
282 #define LGLYPH_CODE(g) XINT (AREF ((g), 3))
283 #define LGLYPH_WIDTH(g) XINT (AREF ((g), 4))
284 #define LGLYPH_LBEARING(g) XINT (AREF ((g), 5))
285 #define LGLYPH_RBEARING(g) XINT (AREF ((g), 6))
286 #define LGLYPH_ASCENT(g) XINT (AREF ((g), 7))
287 #define LGLYPH_DESCENT(g) XINT (AREF ((g), 8))
288 #define LGLYPH_ADJUSTMENT(g) AREF ((g), 9)
289 #define LGLYPH_SET_FROM(g, val) ASET ((g), 0, make_number (val))
290 #define LGLYPH_SET_TO(g, val) ASET ((g), 1, make_number (val))
291 #define LGLYPH_SET_CHAR(g, val) ASET ((g), 2, make_number (val))
292 #define LGLYPH_SET_CODE(g, val) ASET ((g), 3, make_number (val))
293 #define LGLYPH_SET_WIDTH(g, val) ASET ((g), 4, make_number (val))
294 #define LGLYPH_SET_LBEARING(g, val) ASET ((g), 5, make_number (val))
295 #define LGLYPH_SET_RBEARING(g, val) ASET ((g), 6, make_number (val))
296 #define LGLYPH_SET_ASCENT(g, val) ASET ((g), 7, make_number (val))
297 #define LGLYPH_SET_DESCENT(g, val) ASET ((g), 8, make_number (val))
298 #define LGLYPH_SET_ADJUSTMENT(g, val) ASET ((g), 9, (val))
300 #define LGLYPH_XOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
301 ? XINT (AREF (LGLYPH_ADJUSTMENT (g), 0)) : 0)
302 #define LGLYPH_YOFF(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
303 ? XINT (AREF (LGLYPH_ADJUSTMENT (g), 1)) : 0)
304 #define LGLYPH_WADJUST(g) (VECTORP (LGLYPH_ADJUSTMENT (g)) \
305 ? XINT (AREF (LGLYPH_ADJUSTMENT (g), 2)) : 0)
307 #define FONT_INVALID_CODE 0xFFFFFFFF
309 /* Font driver. Members specified as "optional" can be NULL. */
313 /* Symbol indicating the type of the font-driver. */
316 /* Return a cache of font-entities on FRAME. The cache must be a
317 cons whose cdr part is the actual cache area. */
318 Lisp_Object (*get_cache
) P_ ((Lisp_Object frame
));
320 /* List fonts exactly matching with FONT_SPEC on FRAME. The value
321 is a vector of font-entities. This is the sole API that
322 allocates font-entities. */
323 Lisp_Object (*list
) P_ ((Lisp_Object frame
, Lisp_Object font_spec
));
325 /* Return a font entity most closely maching with FONT_SPEC on
326 FRAME. The closeness is detemined by the font backend, thus
327 `face-font-selection-order' is ignored here. */
328 Lisp_Object (*match
) P_ ((Lisp_Object frame
, Lisp_Object font_spec
));
331 List available families. The value is a list of family names
333 Lisp_Object (*list_family
) P_ ((Lisp_Object frame
));
335 /* Optional (if FONT_EXTRA_INDEX is not Lisp_Save_Value).
336 Free FONT_EXTRA_INDEX field of FONT_ENTITY. */
337 void (*free_entity
) P_ ((Lisp_Object font_entity
));
339 /* Open a font specified by FONT_ENTITY on frame F. If the font is
340 scalable, open it with PIXEL_SIZE. */
341 struct font
*(*open
) P_ ((FRAME_PTR f
, Lisp_Object font_entity
,
344 /* Close FONT on frame F. */
345 void (*close
) P_ ((FRAME_PTR f
, struct font
*font
));
347 /* Optional (if FACE->extra is not used).
348 Prepare FACE for displaying characters by FONT on frame F by
349 storing some data in FACE->extra. If successful, return 0.
350 Otherwise, return -1. */
351 int (*prepare_face
) P_ ((FRAME_PTR f
, struct face
*face
));
354 Done FACE for displaying characters by FACE->font on frame F. */
355 void (*done_face
) P_ ((FRAME_PTR f
, struct face
*face
));
358 If FONT_ENTITY has a glyph for character C (Unicode code point),
359 return 1. If not, return 0. If a font must be opened to check
361 int (*has_char
) P_ ((Lisp_Object entity
, int c
));
363 /* Return a glyph code of FONT for characer C (Unicode code point).
364 If FONT doesn't have such a glyph, return FONT_INVALID_CODE. */
365 unsigned (*encode_char
) P_ ((struct font
*font
, int c
));
367 /* Computate the total metrics of the NGLYPHS glyphs specified by
368 the font FONT and the sequence of glyph codes CODE, and store the
369 result in METRICS. */
370 int (*text_extents
) P_ ((struct font
*font
,
371 unsigned *code
, int nglyphs
,
372 struct font_metrics
*metrics
));
375 Draw glyphs between FROM and TO of S->char2b at (X Y) pixel
376 position of frame F with S->FACE and S->GC. If WITH_BACKGROUND
377 is nonzero, fill the background in advance. It is assured that
378 WITH_BACKGROUND is zero when (FROM > 0 || TO < S->nchars). */
379 int (*draw
) P_ ((struct glyph_string
*s
, int from
, int to
,
380 int x
, int y
, int with_background
));
383 Store bitmap data for glyph-code CODE of FONT in BITMAP. It is
384 intended that this method is callled from the other font-driver
385 for actual drawing. */
386 int (*get_bitmap
) P_ ((struct font
*font
, unsigned code
,
387 struct font_bitmap
*bitmap
,
388 int bits_per_pixel
));
391 Free bitmap data in BITMAP. */
392 void (*free_bitmap
) P_ ((struct font
*font
, struct font_bitmap
*bitmap
));
395 Return an outline data for glyph-code CODE of FONT. The format
396 of the outline data depends on the font-driver. */
397 void *(*get_outline
) P_ ((struct font
*font
, unsigned code
));
400 Free OUTLINE (that is obtained by the above method). */
401 void (*free_outline
) P_ ((struct font
*font
, void *outline
));
404 Get coordinates of the INDEXth anchor point of the glyph whose
405 code is CODE. Store the coordinates in *X and *Y. Return 0 if
406 the operations was successfull. Otherwise return -1. */
407 int (*anchor_point
) P_ ((struct font
*font
, unsigned code
, int index
,
411 Return a list describing which scripts/languages FONT
412 supports by which GSUB/GPOS features of OpenType tables. */
413 Lisp_Object (*otf_capability
) P_ ((struct font
*font
));
416 Apply FONT's OTF-FEATURES to the glyph string.
418 FEATURES specifies which OTF features to apply in this format:
419 (SCRIPT LANGSYS GSUB-FEATURE GPOS-FEATURE)
420 See the documentation of `font-drive-otf' for the detail.
422 This method applies the specified features to the codes in the
423 elements of GSTRING-IN (between FROMth and TOth). The output
424 codes are stored in GSTRING-OUT at the IDXth element and the
427 Return the number of output codes. If none of the features are
428 applicable to the input data, return 0. If GSTRING-OUT is too
430 int (*otf_drive
) P_ ((struct font
*font
, Lisp_Object features
,
431 Lisp_Object gstring_in
, int from
, int to
,
432 Lisp_Object gstring_out
, int idx
, int alternate_subst
));
435 Make the font driver ready for frame F. Usually this function
436 makes some data specific to F and store it in F by calling
437 font_put_frame_data (). */
438 int (*start_for_frame
) P_ ((FRAME_PTR f
));
441 End using the driver for frame F. Usually this function free
442 some data stored for F. */
443 int (*end_for_frame
) P_ ((FRAME_PTR f
));
446 Shape text in LGSTRING. */
447 Lisp_Object (*shape
) P_ ((Lisp_Object lgstring
));
451 /* Chain of font drivers. There's one global font driver list
452 (font_driver_list in font.c). In addition, each frame has it's own
453 font driver list at FRAME_PTR->font_driver_list. */
455 struct font_driver_list
457 /* 1 iff this driver is currently used. It is igonred in the global
460 /* Pointer to the font driver. */
461 struct font_driver
*driver
;
462 /* Pointer to the next element of the chain. */
463 struct font_driver_list
*next
;
467 /* Chain of arbitrary data specific to each font driver. Each frame
468 has it's own font data list at FRAME_PTR->font_data_list. */
470 struct font_data_list
472 /* Pointer to the font driver. */
473 struct font_driver
*driver
;
474 /* Data specific to the font driver. */
476 /* Pointer to the next element of the chain. */
477 struct font_data_list
*next
;
480 extern int enable_font_backend
;
482 EXFUN (Ffont_spec
, MANY
);
483 EXFUN (Ffont_get
, 2);
484 EXFUN (Flist_fonts
, 4);
485 EXFUN (Fclear_font_cache
, 0);
486 EXFUN (Ffont_xlfd_name
, 1);
488 extern int font_registry_charsets
P_ ((Lisp_Object
, struct charset
**,
490 extern Lisp_Object font_symbolic_weight
P_ ((Lisp_Object font
));
491 extern Lisp_Object font_symbolic_slant
P_ ((Lisp_Object font
));
492 extern Lisp_Object font_symbolic_width
P_ ((Lisp_Object font
));
494 extern int font_match_p
P_ ((Lisp_Object spec
, Lisp_Object entity
));
496 extern Lisp_Object font_find_object
P_ ((struct font
*font
));
497 extern Lisp_Object font_get_name
P_ ((Lisp_Object font_object
));
498 extern Lisp_Object font_get_spec
P_ ((Lisp_Object font_object
));
499 extern Lisp_Object font_get_frame
P_ ((Lisp_Object font_object
));
500 extern int font_has_char
P_ ((FRAME_PTR
, Lisp_Object
, int));
501 extern unsigned font_encode_char
P_ ((Lisp_Object
, int));
503 extern int font_set_lface_from_name
P_ ((FRAME_PTR f
,
505 Lisp_Object fontname
,
506 int force_p
, int may_fail_p
));
507 extern Lisp_Object font_find_for_lface
P_ ((FRAME_PTR f
, Lisp_Object
*lface
,
508 Lisp_Object spec
, int c
));
509 extern Lisp_Object font_open_for_lface
P_ ((FRAME_PTR f
, Lisp_Object entity
,
512 extern void font_load_for_face
P_ ((FRAME_PTR f
, struct face
*face
));
513 extern void font_prepare_for_face
P_ ((FRAME_PTR f
, struct face
*face
));
514 extern Lisp_Object font_open_by_name
P_ ((FRAME_PTR f
, char *name
));
515 extern void font_close_object (FRAME_PTR f
, Lisp_Object font_object
);
517 extern Lisp_Object intern_downcase
P_ ((char *str
, int len
));
518 extern void font_update_sort_order
P_ ((int *order
));
520 extern void font_merge_old_spec
P_ ((Lisp_Object name
, Lisp_Object family
,
521 Lisp_Object registry
, Lisp_Object spec
));
524 extern int font_parse_xlfd
P_ ((char *name
, Lisp_Object font
));
525 extern int font_unparse_xlfd
P_ ((Lisp_Object font
, int pixel_size
,
526 char *name
, int bytes
));
527 extern int font_parse_fcname
P_ ((char *name
, Lisp_Object font
));
528 extern int font_unparse_fcname
P_ ((Lisp_Object font
, int pixel_size
,
529 char *name
, int bytes
));
530 extern void register_font_driver
P_ ((struct font_driver
*driver
, FRAME_PTR f
));
531 extern void free_font_driver_list
P_ ((FRAME_PTR f
));
532 extern Lisp_Object font_update_drivers
P_ ((FRAME_PTR f
, Lisp_Object list
));
533 extern Lisp_Object font_at
P_ ((int c
, EMACS_INT pos
, struct face
*face
,
534 struct window
*w
, Lisp_Object object
));
536 extern struct font
*font_prepare_composition
P_ ((struct composition
*cmp
,
539 extern Lisp_Object font_put_extra
P_ ((Lisp_Object font
, Lisp_Object prop
,
542 extern int font_put_frame_data
P_ ((FRAME_PTR f
,
543 struct font_driver
*driver
,
545 extern void *font_get_frame_data
P_ ((FRAME_PTR f
,
546 struct font_driver
*driver
));
549 extern struct font_driver ftfont_driver
;
550 #endif /* HAVE_FREETYPE */
551 #ifdef HAVE_X_WINDOWS
552 extern struct font_driver xfont_driver
;
553 extern struct font_driver ftxfont_driver
;
555 extern struct font_driver xftfont_driver
;
556 #endif /* HAVE_XFT */
557 #endif /* HAVE_X_WINDOWS */
559 extern struct font_driver w32font_driver
;
560 #endif /* WINDOWSNT */
562 extern struct font_driver atmfont_driver
;
565 #endif /* not EMACS_FONT_H */
567 /* arch-tag: 3b7260c3-5bec-4d6b-a0db-95c1b431b1a2
568 (do not change this comment) */