1 /* Font back-end driver for the NeXT/Open/GNUstep and MacOSX window system.
3 Copyright (C) 2006-2013 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software: you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation, either version 3 of the License, or
10 (at your option) any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
20 Author: Adrian Robert (arobert@cogsci.ucsd.edu)
23 /* This should be the first include, as it may set up #defines affecting
24 interpretation of even the system includes. */
28 #include "dispextern.h"
29 #include "composite.h"
30 #include "blockinput.h"
37 #include "character.h"
41 /* TODO: Drop once we can assume gnustep-gui 0.17.1. */
42 #ifdef NS_IMPL_GNUSTEP
43 #import <AppKit/NSFontDescriptor.h>
46 #define NSFONT_TRACE 0
47 #define LCD_SMOOTHING_MARGIN 2
49 extern Lisp_Object Qns;
50 extern Lisp_Object Qnormal, Qbold, Qitalic;
51 static Lisp_Object Qapple, Qroman, Qmedium;
52 static Lisp_Object Qcondensed, Qexpanded;
53 extern Lisp_Object Qappend;
54 extern float ns_antialias_threshold;
55 extern int ns_tmp_flags;
56 extern struct nsfont_info *ns_tmp_font;
59 /* font glyph and metrics caching functions, implemented at end */
60 static void ns_uni_to_glyphs (struct nsfont_info *font_info,
62 static void ns_glyph_metrics (struct nsfont_info *font_info,
66 /* ==========================================================================
70 ========================================================================== */
73 /* Replace spaces w/another character so emacs core font parsing routines
76 ns_escape_name (char *name)
84 /* Reconstruct spaces in a font family name passed through emacs. */
86 ns_unescape_name (char *name)
94 /* Extract family name from a font spec. */
96 ns_get_family (Lisp_Object font_spec)
98 Lisp_Object tem = AREF (font_spec, FONT_FAMILY_INDEX);
103 char *tmp = xstrdup (SSDATA (SYMBOL_NAME (tem)));
105 ns_unescape_name (tmp);
106 family = [NSString stringWithUTF8String: tmp];
113 /* Return 0 if attr not set, else value (which might also be 0).
114 On Leopard 0 gets returned even on descriptors where the attribute
115 was never set, so there's no way to distinguish between unspecified
116 and set to not have. Callers should assume 0 means unspecified. */
118 ns_attribute_fvalue (NSFontDescriptor *fdesc, NSString *trait)
120 NSDictionary *tdict = [fdesc objectForKey: NSFontTraitsAttribute];
121 NSNumber *val = [tdict objectForKey: trait];
122 return val == nil ? 0.0 : [val floatValue];
126 /* Converts FONT_WEIGHT, FONT_SLANT, FONT_WIDTH, plus family and script/lang
127 to NSFont descriptor. Information under extra only needed for matching. */
128 #define STYLE_REF 100
129 static NSFontDescriptor *
130 ns_spec_to_descriptor (Lisp_Object font_spec)
132 NSFontDescriptor *fdesc;
133 NSMutableDictionary *fdAttrs = [NSMutableDictionary new];
134 NSMutableDictionary *tdict = [NSMutableDictionary new];
135 NSString *family = ns_get_family (font_spec);
138 /* add each attr in font_spec to fdAttrs.. */
139 n = min (FONT_WEIGHT_NUMERIC (font_spec), 200);
140 if (n != -1 && n != STYLE_REF)
141 [tdict setObject: [NSNumber numberWithFloat: (n - 100.0) / 100.0]
142 forKey: NSFontWeightTrait];
143 n = min (FONT_SLANT_NUMERIC (font_spec), 200);
144 if (n != -1 && n != STYLE_REF)
145 [tdict setObject: [NSNumber numberWithFloat: (n - 100.0) / 100.0]
146 forKey: NSFontSlantTrait];
147 n = min (FONT_WIDTH_NUMERIC (font_spec), 200);
148 if (n > -1 && (n > STYLE_REF + 10 || n < STYLE_REF - 10))
149 [tdict setObject: [NSNumber numberWithFloat: (n - 100.0) / 100.0]
150 forKey: NSFontWidthTrait];
151 if ([tdict count] > 0)
152 [fdAttrs setObject: tdict forKey: NSFontTraitsAttribute];
154 fdesc = [NSFontDescriptor fontDescriptorWithFontAttributes: fdAttrs];
157 fdesc = [fdesc fontDescriptorWithFamily: family];
166 /* Converts NSFont descriptor to FONT_WEIGHT, FONT_SLANT, FONT_WIDTH, etc.. */
168 ns_descriptor_to_entity (NSFontDescriptor *desc,
172 Lisp_Object font_entity = font_make_entity ();
173 /* NSString *psName = [desc postscriptName]; */
174 NSString *family = [desc objectForKey: NSFontFamilyAttribute];
175 unsigned int traits = [desc symbolicTraits];
178 /* Shouldn't happen, but on Tiger fallback desc gets name but no family. */
180 family = [desc objectForKey: NSFontNameAttribute];
182 family = [[NSFont userFixedPitchFontOfSize: 0] familyName];
184 escapedFamily = xstrdup ([family UTF8String]);
185 ns_escape_name (escapedFamily);
187 ASET (font_entity, FONT_TYPE_INDEX, Qns);
188 ASET (font_entity, FONT_FOUNDRY_INDEX, Qapple);
189 ASET (font_entity, FONT_FAMILY_INDEX, intern (escapedFamily));
190 ASET (font_entity, FONT_ADSTYLE_INDEX, style ? intern (style) : Qnil);
191 ASET (font_entity, FONT_REGISTRY_INDEX, Qiso10646_1);
193 FONT_SET_STYLE (font_entity, FONT_WEIGHT_INDEX,
194 traits & NSFontBoldTrait ? Qbold : Qmedium);
195 /* FONT_SET_STYLE (font_entity, FONT_WEIGHT_INDEX,
196 make_number (100 + 100
197 * ns_attribute_fvalue (desc, NSFontWeightTrait)));*/
198 FONT_SET_STYLE (font_entity, FONT_SLANT_INDEX,
199 traits & NSFontItalicTrait ? Qitalic : Qnormal);
200 /* FONT_SET_STYLE (font_entity, FONT_SLANT_INDEX,
201 make_number (100 + 100
202 * ns_attribute_fvalue (desc, NSFontSlantTrait)));*/
203 FONT_SET_STYLE (font_entity, FONT_WIDTH_INDEX,
204 traits & NSFontCondensedTrait ? Qcondensed :
205 traits & NSFontExpandedTrait ? Qexpanded : Qnormal);
206 /* FONT_SET_STYLE (font_entity, FONT_WIDTH_INDEX,
207 make_number (100 + 100
208 * ns_attribute_fvalue (desc, NSFontWidthTrait)));*/
210 ASET (font_entity, FONT_SIZE_INDEX, make_number (0));
211 ASET (font_entity, FONT_AVGWIDTH_INDEX, make_number (0));
212 ASET (font_entity, FONT_SPACING_INDEX,
213 make_number([desc symbolicTraits] & NSFontMonoSpaceTrait
214 ? FONT_SPACING_MONO : FONT_SPACING_PROPORTIONAL));
216 ASET (font_entity, FONT_EXTRA_INDEX, extra);
217 ASET (font_entity, FONT_OBJLIST_INDEX, Qnil);
221 fprintf (stderr, "created font_entity:\n ");
222 debug_print (font_entity);
225 xfree (escapedFamily);
230 /* Default font entity. */
232 ns_fallback_entity (void)
234 return ns_descriptor_to_entity ([[NSFont userFixedPitchFontOfSize: 0]
235 fontDescriptor], Qnil, NULL);
239 /* Utility: get width of a char c in screen font SFONT */
241 ns_char_width (NSFont *sfont, int c)
244 NSString *cstr = [NSString stringWithFormat: @"%c", c];
247 NSGlyph glyph = [sfont glyphWithName: cstr];
249 w = [sfont advancementForGlyph: glyph].width;
254 NSDictionary *attrsDictionary =
255 [NSDictionary dictionaryWithObject: sfont forKey: NSFontAttributeName];
256 w = [cstr sizeWithAttributes: attrsDictionary].width;
262 /* Return average width over ASCII printable characters for SFONT. */
264 static NSString *ascii_printable;
267 ns_ascii_average_width (NSFont *sfont)
271 if (!ascii_printable)
275 for (ch = 0; ch < 95; ch++)
276 chars[ch] = ' ' + ch;
279 ascii_printable = [[NSString alloc] initWithFormat: @"%s", chars];
283 NSGlyph glyph = [sfont glyphWithName: ascii_printable];
285 w = [sfont advancementForGlyph: glyph].width;
290 NSDictionary *attrsDictionary =
291 [NSDictionary dictionaryWithObject: sfont forKey: NSFontAttributeName];
292 w = [ascii_printable sizeWithAttributes: attrsDictionary].width;
295 return lrint (w / 95.0);
299 /* Return whether set1 covers set2 to a reasonable extent given by pct.
300 We check, out of each 16 Unicode char range containing chars in set2,
301 whether at least one character is present in set1.
302 This must be true for pct of the pairs to consider it covering. */
304 ns_charset_covers(NSCharacterSet *set1, NSCharacterSet *set2, float pct)
306 const unsigned short *bytes1 = [[set1 bitmapRepresentation] bytes];
307 const unsigned short *bytes2 = [[set2 bitmapRepresentation] bytes];
308 int i, off = 0, tot = 0;
310 /* Work around what appears to be a GNUstep bug.
311 See <http://bugs.gnu.org/11853>. */
312 if (! (bytes1 && bytes2))
315 for (i=0; i<4096; i++, bytes1++, bytes2++)
319 if (*bytes1 == 0) // *bytes1 & *bytes2 != *bytes2
322 //fprintf(stderr, "off = %d\ttot = %d\n", off,tot);
323 return (float)off / tot < 1.0 - pct;
327 /* Convert :lang property to a script. Use of :lang property by font backend
328 seems to be limited for now (2009/05) to ja, zh, and ko. */
330 *ns_lang_to_script (Lisp_Object lang)
332 if (!strcmp (SSDATA (SYMBOL_NAME (lang)), "ja"))
334 /* NOTE: ja given for any hanzi that's also a kanji, but Chinese fonts
335 have more characters. */
336 else if (!strcmp (SSDATA (SYMBOL_NAME (lang)), "zh"))
338 else if (!strcmp (SSDATA (SYMBOL_NAME (lang)), "ko"))
345 /* Convert OTF 4-letter script code to emacs script name. (Why can't
346 everyone just use some standard Unicode names for these?) */
348 *ns_otf_to_script (Lisp_Object otf)
350 Lisp_Object script = assq_no_quit (XCAR (otf), Votf_script_alist);
351 return CONSP (script)
352 ? [NSString stringWithUTF8String: SSDATA (SYMBOL_NAME (XCDR ((script))))]
357 /* Convert a font registry, such as */
359 *ns_registry_to_script (char *reg)
361 Lisp_Object script, r, rts = Vns_reg_to_script;
364 r = XCAR (XCAR (rts));
365 if (!strncmp (SSDATA (r), reg, SBYTES (r)))
367 script = XCDR (XCAR (rts));
368 return [NSString stringWithUTF8String: SSDATA (SYMBOL_NAME (script))];
376 /* Searches the :script, :lang, and :otf extra-bundle properties of the spec,
377 plus registry regular property, for something that can be mapped to a
378 Unicode script. Empty string returned if no script spec found. */
380 *ns_get_req_script (Lisp_Object font_spec)
382 Lisp_Object reg = AREF (font_spec, FONT_REGISTRY_INDEX);
383 Lisp_Object extra = AREF (font_spec, FONT_EXTRA_INDEX);
385 /* The extra-bundle properties have priority. */
386 for ( ; CONSP (extra); extra = XCDR (extra))
388 Lisp_Object tmp = XCAR (extra);
391 Lisp_Object key = XCAR (tmp), val = XCDR (tmp);
392 if (EQ (key, QCscript) && SYMBOLP (val))
393 return [NSString stringWithUTF8String:
394 SSDATA (SYMBOL_NAME (val))];
395 if (EQ (key, QClang) && SYMBOLP (val))
396 return ns_lang_to_script (val);
397 if (EQ (key, QCotf) && CONSP (val) && SYMBOLP (XCAR (val)))
398 return ns_otf_to_script (val);
402 /* If we get here, check the charset portion of the registry. */
405 /* XXX: iso10646 is passed in for non-ascii latin-1 characters
406 (which causes box rendering if we don't treat it like iso8858-1)
407 but also for ascii (which causes unnecessary font substitution). */
409 if (EQ (reg, Qiso10646_1))
412 return ns_registry_to_script (SSDATA (SYMBOL_NAME (reg)));
419 /* This small function is static in fontset.c. If it can be made public for
420 all ports, remove this, but otherwise it doesn't seem worth the ifdefs. */
422 accumulate_script_ranges (Lisp_Object arg, Lisp_Object range, Lisp_Object val)
424 if (EQ (XCAR (arg), val))
427 XSETCDR (arg, Fcons (Fcons (XCAR (range), XCDR (range)), XCDR (arg)));
429 XSETCDR (arg, Fcons (Fcons (range, range), XCDR (arg)));
434 /* Use the Unicode range information in Vchar_script_table to convert a script
435 name into an NSCharacterSet. */
436 static NSCharacterSet
437 *ns_script_to_charset (NSString *scriptName)
439 NSMutableCharacterSet *charset = [NSMutableCharacterSet new];
440 Lisp_Object script = intern ([scriptName UTF8String]);
441 Lisp_Object script_list = XCHAR_TABLE (Vchar_script_table)->extras[0];
443 if (! NILP (Fmemq (script, script_list)))
445 Lisp_Object ranges, range_list;
447 ranges = Fcons (script, Qnil);
448 map_char_table (accumulate_script_ranges, Qnil, Vchar_script_table,
450 range_list = Fnreverse (XCDR (ranges));
451 if (! NILP (range_list))
453 for (; CONSP (range_list); range_list = XCDR (range_list))
455 int start = XINT (XCAR (XCAR (range_list)));
456 int end = XINT (XCDR (XCAR (range_list)));
458 debug_print (XCAR (range_list));
460 [charset addCharactersInRange:
461 NSMakeRange (start, end-start)];
469 /* Return an array of font families containing characters for the given
470 script, for the given coverage criterion, including at least LastResort.
471 Results are cached by script for faster access.
472 If none are found, we reduce the percentage and try again, until 5%.
473 This provides a font with at least some characters if such can be found.
474 We don't use isSupersetOfSet: because (a) it doesn't work on Tiger, and
475 (b) need approximate match as fonts covering full Unicode ranges are rare. */
477 *ns_get_covering_families (NSString *script, float pct)
479 static NSMutableDictionary *scriptToFamilies = nil;
480 NSMutableSet *families;
483 NSLog(@"Request covering families for script: '%@'", script);
485 if (scriptToFamilies == nil)
486 scriptToFamilies = [[NSMutableDictionary alloc] init];
488 if ((families = [scriptToFamilies objectForKey: script]) == nil)
490 NSFontManager *fontMgr = [NSFontManager sharedFontManager];
491 NSArray *allFamilies = [fontMgr availableFontFamilies];
493 if ([script length] == 0)
494 families = [NSMutableSet setWithArray: allFamilies];
497 NSCharacterSet *charset = ns_script_to_charset (script);
499 families = [NSMutableSet setWithCapacity: 10];
502 NSEnumerator *allFamiliesEnum = [allFamilies objectEnumerator];
503 while ((family = [allFamiliesEnum nextObject]))
505 NSCharacterSet *fset = [[fontMgr fontWithFamily: family
506 traits: 0 weight: 5 size: 12.0] coveredCharacterSet];
507 /* Some fonts on OS X, maybe many on GNUstep, return nil. */
509 fset = [NSCharacterSet characterSetWithRange:
510 NSMakeRange (0, 127)];
511 if (ns_charset_covers(fset, charset, pct))
512 [families addObject: family];
515 if ([families count] > 0 || pct < 0.05)
521 if ([families count] == 0)
522 [families addObject: @"LastResort"];
524 [scriptToFamilies setObject: families forKey: script];
528 NSLog(@" returning %d families", [families count]);
533 /* Implementation for list() and match(). List() can return nil, match()
534 must return something. Strategy is to drop family name from attribute
535 matching set for match. */
537 ns_findfonts (Lisp_Object font_spec, BOOL isMatch)
539 Lisp_Object tem, list = Qnil;
540 NSFontDescriptor *fdesc, *desc;
542 NSArray *matchingDescs;
551 fprintf (stderr, "nsfont: %s for fontspec:\n ",
552 (isMatch ? "match" : "list"));
553 debug_print (font_spec);
556 cFamilies = ns_get_covering_families (ns_get_req_script (font_spec), 0.90);
558 fdesc = ns_spec_to_descriptor (font_spec);
559 fkeys = [NSMutableSet setWithArray: [[fdesc fontAttributes] allKeys]];
561 [fkeys removeObject: NSFontFamilyAttribute];
563 matchingDescs = [fdesc matchingFontDescriptorsWithMandatoryKeys: fkeys];
566 NSLog(@"Got desc %@ and found %d matching fonts from it: ", fdesc,
567 [matchingDescs count]);
569 for (dEnum = [matchingDescs objectEnumerator]; (desc = [dEnum nextObject]);)
571 if (![cFamilies containsObject:
572 [desc objectForKey: NSFontFamilyAttribute]])
574 tem = ns_descriptor_to_entity (desc,
575 AREF (font_spec, FONT_EXTRA_INDEX),
579 list = Fcons (tem, list);
580 if (fabs (ns_attribute_fvalue (desc, NSFontSlantTrait)) > 0.05)
584 /* Add synthItal member if needed. */
585 family = [fdesc objectForKey: NSFontFamilyAttribute];
586 if (family != nil && !foundItal && XINT (Flength (list)) > 0)
588 NSFontDescriptor *s1 = [NSFontDescriptor new];
589 NSFontDescriptor *sDesc
590 = [[s1 fontDescriptorWithSymbolicTraits: NSFontItalicTrait]
591 fontDescriptorWithFamily: family];
592 list = Fcons (ns_descriptor_to_entity (sDesc,
593 AREF (font_spec, FONT_EXTRA_INDEX),
600 /* Return something if was a match and nothing found. */
602 return ns_fallback_entity ();
605 fprintf (stderr, " Returning %"pI"d entities.\n",
606 XINT (Flength (list)));
613 /* ==========================================================================
615 Font driver implementation
617 ========================================================================== */
620 static Lisp_Object nsfont_get_cache (FRAME_PTR frame);
621 static Lisp_Object nsfont_list (Lisp_Object frame, Lisp_Object font_spec);
622 static Lisp_Object nsfont_match (Lisp_Object frame, Lisp_Object font_spec);
623 static Lisp_Object nsfont_list_family (Lisp_Object frame);
624 static Lisp_Object nsfont_open (FRAME_PTR f, Lisp_Object font_entity,
626 static void nsfont_close (FRAME_PTR f, struct font *font);
627 static int nsfont_has_char (Lisp_Object entity, int c);
628 static unsigned int nsfont_encode_char (struct font *font, int c);
629 static int nsfont_text_extents (struct font *font, unsigned int *code,
630 int nglyphs, struct font_metrics *metrics);
631 static int nsfont_draw (struct glyph_string *s, int from, int to, int x, int y,
632 bool with_background);
634 struct font_driver nsfont_driver =
637 1, /* case sensitive */
642 NULL, /*free_entity */
645 NULL, /* prepare_face */
646 NULL, /* done_face */
651 /* excluded: get_bitmap, free_bitmap, get_outline, free_outline,
652 anchor_point, otf_capability, otf_driver,
653 start_for_frame, end_for_frame, shape */
657 /* Return a cache of font-entities on FRAME. The cache must be a
658 cons whose cdr part is the actual cache area. */
660 nsfont_get_cache (FRAME_PTR frame)
662 Display_Info *dpyinfo = FRAME_NS_DISPLAY_INFO (frame);
663 return (dpyinfo->name_list_element);
667 /* List fonts exactly matching with FONT_SPEC on FRAME. The value is a
668 **list** of font-entities. This and match () are sole APIs that allocate
669 font-entities. Properties to be considered (2009/05/19) are:
670 regular: foundry, family, adstyle, registry
671 extended: script, lang, otf
672 "Extended" properties are not part of the vector but get stored as
673 lisp properties under FONT_EXTRA_INDEX.
675 The returned entities should have type set (to 'ns), plus the following:
676 foundry, family, adstyle, registry,
677 weight, slant, width, size (0 if scalable),
678 dpi, spacing, avgwidth (0 if scalable) */
680 nsfont_list (Lisp_Object frame, Lisp_Object font_spec)
682 return ns_findfonts (font_spec, NO);
686 /* Return a font entity most closely matching with FONT_SPEC on
687 FRAME. The closeness is determined by the font backend, thus
688 `face-font-selection-order' is ignored here.
689 Properties to be considered are same as for list(). */
691 nsfont_match (Lisp_Object frame, Lisp_Object font_spec)
693 return ns_findfonts(font_spec, YES);
697 /* List available families. The value is a list of family names
700 nsfont_list_family (Lisp_Object frame)
702 Lisp_Object list = Qnil;
703 NSEnumerator *families;
707 families = [[[NSFontManager sharedFontManager] availableFontFamilies]
709 while ((family = [families nextObject]))
710 list = Fcons (intern ([family UTF8String]), list);
711 /* FIXME: escape the name? */
714 fprintf (stderr, "nsfont: list families returning %"pI"d entries\n",
715 XINT (Flength (list)));
722 /* Open a font specified by FONT_ENTITY on frame F. If the font is
723 scalable, open it with PIXEL_SIZE. */
725 nsfont_open (FRAME_PTR f, Lisp_Object font_entity, int pixel_size)
728 unsigned int traits = 0;
729 struct nsfont_info *font_info;
731 NSFontDescriptor *fontDesc = ns_spec_to_descriptor (font_entity);
732 NSFontManager *fontMgr = [NSFontManager sharedFontManager];
734 NSFont *nsfont, *sfont;
737 Lisp_Object font_object;
744 fprintf (stderr, "nsfont: open size %d of fontentity:\n ", pixel_size);
745 debug_print (font_entity);
750 /* try to get it out of frame params */
751 Lisp_Object tem = get_frame_param (f, Qfontsize);
752 pixel_size = NILP (tem) ? 0 : XFASTINT (tem);
755 tem = AREF (font_entity, FONT_ADSTYLE_INDEX);
756 synthItal = !NILP (tem) && !strncmp ("synthItal", SSDATA (SYMBOL_NAME (tem)),
758 family = ns_get_family (font_entity);
760 family = [[NSFont userFixedPitchFontOfSize: 0] familyName];
761 /* Should be > 0.23 as some font descriptors (e.g. Terminus) set to that
762 when setting family in ns_spec_to_descriptor(). */
763 if (ns_attribute_fvalue (fontDesc, NSFontWeightTrait) > 0.50)
764 traits |= NSBoldFontMask;
765 if (fabs (ns_attribute_fvalue (fontDesc, NSFontSlantTrait) > 0.05))
766 traits |= NSItalicFontMask;
768 /* see http://cocoadev.com/forums/comments.php?DiscussionID=74 */
769 fixLeopardBug = traits & NSBoldFontMask ? 10 : 5;
770 nsfont = [fontMgr fontWithFamily: family
771 traits: traits weight: fixLeopardBug
773 /* if didn't find, try synthetic italic */
774 if (nsfont == nil && synthItal)
776 nsfont = [fontMgr fontWithFamily: family
777 traits: traits & ~NSItalicFontMask
778 weight: fixLeopardBug size: pixel_size];
781 /* LastResort not really a family */
782 if (nsfont == nil && [@"LastResort" isEqualToString: family])
783 nsfont = [NSFont fontWithName: @"LastResort" size: pixel_size];
788 message_with_string ("*** Warning: font in family '%s' not found",
789 build_string ([family UTF8String]), 1);
790 nsfont = [NSFont userFixedPitchFontOfSize: pixel_size];
794 NSLog (@"%@\n", nsfont);
796 font_object = font_make_object (VECSIZE (struct nsfont_info),
797 font_entity, pixel_size);
798 font_info = (struct nsfont_info *) XFONT_OBJECT (font_object);
799 font = (struct font *) font_info;
803 return Qnil; /* FIXME: other terms do, but return Qnil causes segfault */
806 font_info->glyphs = xzalloc (0x100 * sizeof *font_info->glyphs);
807 font_info->metrics = xzalloc (0x100 * sizeof *font_info->metrics);
811 sfont = [nsfont screenFontWithRenderingMode:
812 NSFontAntialiasedIntegerAdvancementsRenderingMode];
814 sfont = [nsfont screenFont];
820 /* non-metric backend font struct fields */
821 font = (struct font *) font_info;
822 font->pixel_size = [sfont pointSize];
823 font->driver = &nsfont_driver;
824 font->encoding_charset = -1;
825 font->repertory_charset = -1;
826 font->default_ascent = 0;
827 font->vertical_centering = 0;
828 font->baseline_offset = 0;
829 font->relative_compose = 0;
830 font->font_encoder = NULL;
832 font->props[FONT_FORMAT_INDEX] = Qns;
833 font->props[FONT_FILE_INDEX] = Qnil;
836 const char *fontName = [[nsfont fontName] UTF8String];
838 /* The values specified by fonts are not always exact. For
839 * example, a 6x8 font could specify that the descender is
840 * -2.00000405... (represented by 0xc000000220000000). Without
841 * adjustment, the code below would round the descender to -3,
842 * resulting in a font that would be one pixel higher than
844 CGFloat adjusted_descender = [sfont descender] + 0.0001;
846 #ifdef NS_IMPL_GNUSTEP
847 font_info->nsfont = sfont;
849 font_info->nsfont = nsfont;
851 [font_info->nsfont retain];
853 /* set up ns_font (defined in nsgui.h) */
854 font_info->name = xstrdup (fontName);
855 font_info->bold = [fontMgr traitsOfFont: nsfont] & NSBoldFontMask;
857 synthItal || ([fontMgr traitsOfFont: nsfont] & NSItalicFontMask);
859 /* Metrics etc.; some fonts return an unusually large max advance, so we
860 only use it for fonts that have wide characters. */
861 font_info->width = ([sfont numberOfGlyphs] > 2000) ?
862 [sfont maximumAdvancement].width : ns_char_width (sfont, '0');
864 brect = [sfont boundingRectForFont];
866 font_info->underpos = [sfont underlinePosition];
867 font_info->underwidth = [sfont underlineThickness];
868 font_info->size = font->pixel_size;
871 font_info->max_bounds.ascent = lrint ([sfont ascender]);
872 /* Descender is usually negative. Use floor to avoid
873 clipping descenders. */
874 font_info->max_bounds.descent = -lrint (floor(adjusted_descender));
876 font_info->max_bounds.ascent + font_info->max_bounds.descent;
877 font_info->max_bounds.width = lrint (font_info->width);
878 font_info->max_bounds.lbearing = lrint (brect.origin.x);
879 font_info->max_bounds.rbearing =
880 lrint (brect.size.width - font_info->width);
883 /* set up synthItal and the CG font */
884 font_info->synthItal = synthItal;
886 ATSFontRef atsFont = ATSFontFindFromPostScriptName
887 ((CFStringRef)[nsfont fontName], kATSOptionFlagsDefault);
889 if (atsFont == kATSFontRefUnspecified)
891 /* see if we can get it by dropping italic (then synthesizing) */
892 atsFont = ATSFontFindFromPostScriptName ((CFStringRef)
893 [[fontMgr convertFont: nsfont toNotHaveTrait: NSItalicFontMask]
894 fontName], kATSOptionFlagsDefault);
895 if (atsFont != kATSFontRefUnspecified)
896 font_info->synthItal = YES;
899 /* last resort fallback */
900 atsFont = ATSFontFindFromPostScriptName
901 ((CFStringRef)@"Monaco", kATSOptionFlagsDefault);
904 font_info->cgfont = CGFontCreateWithPlatformFont ((void*)&atsFont);
908 /* set up metrics portion of font struct */
909 font->ascent = lrint([sfont ascender]);
910 font->descent = -lrint(floor(adjusted_descender));
911 font->space_width = lrint (ns_char_width (sfont, ' '));
912 font->max_width = lrint (font_info->max_bounds.width);
913 font->min_width = font->space_width; /* Approximate. */
914 font->average_width = ns_ascii_average_width (sfont);
916 font->height = lrint (font_info->height);
917 font->underline_position = lrint (font_info->underpos);
918 font->underline_thickness = lrint (font_info->underwidth);
920 font->props[FONT_NAME_INDEX] = Ffont_xlfd_name (font_object, Qnil);
921 font->props[FONT_FULLNAME_INDEX] =
922 make_unibyte_string (font_info->name, strlen (font_info->name));
930 /* Close FONT on frame F. */
932 nsfont_close (FRAME_PTR f, struct font *font)
934 struct nsfont_info *font_info = (struct nsfont_info *)font;
937 /* FIXME: this occurs apparently due to same failure to detect same font
938 that causes need for cache in nsfont_open () */
942 for (i =0; i<0x100; i++)
944 xfree (font_info->glyphs[i]);
945 xfree (font_info->metrics[i]);
947 [font_info->nsfont release];
949 CGFontRelease (font_info->cgfont);
951 xfree (font_info->name);
956 /* If FONT_ENTITY has a glyph for character C (Unicode code point),
957 return 1. If not, return 0. If a font must be opened to check
960 nsfont_has_char (Lisp_Object entity, int c)
966 /* Return a glyph code of FONT for character C (Unicode code point).
967 If FONT doesn't have such a glyph, return FONT_INVALID_CODE. */
969 nsfont_encode_char (struct font *font, int c)
971 struct nsfont_info *font_info = (struct nsfont_info *)font;
972 unsigned char high = (c & 0xff00) >> 8, low = c & 0x00ff;
976 return FONT_INVALID_CODE;
978 /* did we already cache this block? */
979 if (!font_info->glyphs[high])
980 ns_uni_to_glyphs (font_info, high);
982 g = font_info->glyphs[high][low];
983 return g == 0xFFFF ? FONT_INVALID_CODE : g;
987 /* Perform the size computation of glyphs of FONT and fill in members
988 of METRICS. The glyphs are specified by their glyph codes in
989 CODE (length NGLYPHS). */
991 nsfont_text_extents (struct font *font, unsigned int *code, int nglyphs,
992 struct font_metrics *metrics)
994 struct nsfont_info *font_info = (struct nsfont_info *)font;
995 struct font_metrics *pcm;
996 unsigned char high, low;
1000 memset (metrics, 0, sizeof (struct font_metrics));
1002 for (i =0; i<nglyphs; i++)
1004 /* get metrics for this glyph, filling cache if need be */
1005 /* TODO: get metrics for whole string from an NSLayoutManager
1006 (if not too slow) */
1007 high = (code[i] & 0xFF00) >> 8;
1008 low = code[i] & 0x00FF;
1009 if (!font_info->metrics[high])
1010 ns_glyph_metrics (font_info, high);
1011 pcm = &(font_info->metrics[high][low]);
1013 if (metrics->lbearing > totalWidth + pcm->lbearing)
1014 metrics->lbearing = totalWidth + pcm->lbearing;
1015 if (metrics->rbearing < totalWidth + pcm->rbearing)
1016 metrics->rbearing = totalWidth + pcm->rbearing;
1017 if (metrics->ascent < pcm->ascent)
1018 metrics->ascent = pcm->ascent;
1019 if (metrics->descent < pcm->descent)
1020 metrics->descent = pcm->descent;
1022 totalWidth += pcm->width;
1025 metrics->width = totalWidth;
1027 return totalWidth; /* not specified in doc, but xfont.c does it */
1031 /* Draw glyphs between FROM and TO of S->char2b at (X Y) pixel
1032 position of frame F with S->FACE and S->GC. If WITH_BACKGROUND,
1033 fill the background in advance. It is assured that WITH_BACKGROUND
1034 is false when (FROM > 0 || TO < S->nchars). */
1036 nsfont_draw (struct glyph_string *s, int from, int to, int x, int y,
1037 bool with_background)
1038 /* NOTE: focus and clip must be set
1039 also, currently assumed (true in nsterm.m call) from ==0, to ==nchars */
1041 static char cbuf[1024];
1043 #ifdef NS_IMPL_GNUSTEP
1044 static float advances[1024];
1045 float *adv = advances;
1047 static CGSize advances[1024];
1048 CGSize *adv = advances;
1052 struct nsfont_info *font = ns_tmp_font;
1053 NSColor *col, *bgCol;
1054 unsigned short *t = s->char2b;
1056 char isComposite = s->first_glyph->type == COMPOSITE_GLYPH;
1057 int end = isComposite ? s->cmp_to : s->nchars;
1060 /* Select face based on input flags */
1061 switch (ns_tmp_flags)
1063 case NS_DUMPGLYPH_CURSOR:
1066 case NS_DUMPGLYPH_MOUSEFACE:
1067 face = FACE_FROM_ID (s->f, MOUSE_HL_INFO (s->f)->mouse_face_face_id);
1069 face = FACE_FROM_ID (s->f, MOUSE_FACE_ID);
1076 if (s->face->box != FACE_NO_BOX && s->first_glyph->left_box_line_p)
1077 r.origin.x += abs (s->face->box_line_width);
1080 r.size.height = FONT_HEIGHT (font);
1082 /* Convert UTF-16 (?) to UTF-8 and determine advances. Note if we just ask
1083 NS to render the string, it will come out differently from the individual
1084 character widths added up because of layout processing. */
1086 int cwidth, twidth = 0;
1088 /* FIXME: composition: no vertical displacement is considered. */
1089 t += s->cmp_from; /* advance into composition */
1090 for (i = s->cmp_from; i < end; i++, t++)
1092 hi = (*t & 0xFF00) >> 8;
1096 if (!s->first_glyph->u.cmp.automatic)
1097 cwidth = s->cmp->offsets[i * 2] /* (H offset) */ - twidth;
1100 Lisp_Object gstring = composition_gstring_from_id (s->cmp_id);
1101 Lisp_Object glyph = LGSTRING_GLYPH (gstring, i);
1102 if (NILP (LGLYPH_ADJUSTMENT (glyph)))
1103 cwidth = LGLYPH_WIDTH (glyph);
1106 cwidth = LGLYPH_WADJUST (glyph);
1107 #ifdef NS_IMPL_GNUSTEP
1108 *(adv-1) += LGLYPH_XOFF (glyph);
1110 (*(adv-1)).width += LGLYPH_XOFF (glyph);
1117 if (!font->metrics[hi]) /* FIXME: why/how can we need this now? */
1118 ns_glyph_metrics (font, hi);
1119 cwidth = font->metrics[hi][lo].width;
1122 #ifdef NS_IMPL_GNUSTEP
1124 CHAR_STRING_ADVANCE (*t, c); /* this converts the char to UTF-8 */
1126 (*adv++).width = cwidth;
1129 len = adv - advances;
1130 r.size.width = twidth;
1134 /* fill background if requested */
1135 if (with_background && !isComposite)
1138 int fibw = FRAME_INTERNAL_BORDER_WIDTH (s->f);
1139 int mbox_line_width = max (s->face->box_line_width, 0);
1141 if (s->row->full_width_p)
1143 if (br.origin.x <= fibw + 1 + mbox_line_width)
1145 br.size.width += br.origin.x - mbox_line_width;
1146 br.origin.x = mbox_line_width;
1148 if (FRAME_PIXEL_WIDTH (s->f) - (br.origin.x + br.size.width)
1150 br.size.width += fibw;
1152 if (s->face->box == FACE_NO_BOX)
1154 /* expand unboxed top row over internal border */
1155 if (br.origin.y <= fibw + 1 + mbox_line_width)
1157 br.size.height += br.origin.y;
1163 int correction = abs (s->face->box_line_width)+1;
1164 br.origin.y += correction;
1165 br.size.height -= 2*correction;
1166 br.origin.x += correction;
1167 br.size.width -= 2*correction;
1170 if (!s->face->stipple)
1171 [(NS_FACE_BACKGROUND (face) != 0
1172 ? ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), s->f)
1173 : FRAME_BACKGROUND_COLOR (s->f)) set];
1176 struct ns_display_info *dpyinfo = FRAME_NS_DISPLAY_INFO (s->f);
1177 [[dpyinfo->bitmaps[face->stipple-1].img stippleMask] set];
1183 /* set up for character rendering */
1184 r.origin.y = s->ybase;
1186 col = (NS_FACE_FOREGROUND (face) != 0
1187 ? ns_lookup_indexed_color (NS_FACE_FOREGROUND (face), s->f)
1188 : FRAME_FOREGROUND_COLOR (s->f));
1189 /* FIXME: find another way to pass this */
1190 bgCol = (ns_tmp_flags != NS_DUMPGLYPH_FOREGROUND ? nil
1191 : (NS_FACE_BACKGROUND (face) != 0
1192 ? ns_lookup_indexed_color (NS_FACE_BACKGROUND (face), s->f)
1193 : FRAME_BACKGROUND_COLOR (s->f)));
1195 /* render under GNUstep using DPS */
1196 #ifdef NS_IMPL_GNUSTEP
1198 NSGraphicsContext *context = GSCurrentContext ();
1203 /* do erase if "foreground" mode */
1207 DPSmoveto (context, r.origin.x, r.origin.y);
1208 /*[context GSSetTextDrawingMode: GSTextFillStroke]; /// not implemented yet */
1209 DPSxshow (context, cbuf, advances, len);
1210 DPSstroke (context);
1212 /*[context GSSetTextDrawingMode: GSTextFill]; /// not implemented yet */
1217 /* draw with DPSxshow () */
1218 DPSmoveto (context, r.origin.x, r.origin.y);
1219 DPSxshow (context, cbuf, advances, len);
1220 DPSstroke (context);
1222 DPSgrestore (context);
1225 #else /* NS_IMPL_COCOA */
1227 CGContextRef gcontext =
1228 [[NSGraphicsContext currentContext] graphicsPort];
1229 static CGAffineTransform fliptf;
1230 static BOOL firstTime = YES;
1235 fliptf = CGAffineTransformMakeScale (1.0, -1.0);
1238 CGContextSaveGState (gcontext);
1240 fliptf.c = font->synthItal ? Fix2X (kATSItalicQDSkew) : 0.0;
1242 CGContextSetFont (gcontext, font->cgfont);
1243 CGContextSetFontSize (gcontext, font->size);
1244 if (NILP (ns_antialias_text) || font->size <= ns_antialias_threshold)
1245 CGContextSetShouldAntialias (gcontext, 0);
1247 CGContextSetShouldAntialias (gcontext, 1);
1249 CGContextSetTextMatrix (gcontext, fliptf);
1253 /* foreground drawing; erase first to avoid overstrike */
1255 CGContextSetTextDrawingMode (gcontext, kCGTextFillStroke);
1256 CGContextSetTextPosition (gcontext, r.origin.x, r.origin.y);
1257 CGContextShowGlyphsWithAdvances (gcontext, s->char2b, advances, len);
1258 CGContextSetTextDrawingMode (gcontext, kCGTextFill);
1263 CGContextSetTextPosition (gcontext, r.origin.x, r.origin.y);
1264 CGContextShowGlyphsWithAdvances (gcontext, s->char2b + s->cmp_from,
1267 if (face->overstrike)
1269 CGContextSetTextPosition (gcontext, r.origin.x+0.5, r.origin.y);
1270 CGContextShowGlyphsWithAdvances (gcontext, s->char2b + s->cmp_from,
1274 CGContextRestoreGState (gcontext);
1276 #endif /* NS_IMPL_COCOA */
1278 /* Draw underline, overline, strike-through. */
1279 ns_draw_text_decoration (s, face, col, r.size.width, r.origin.x);
1287 /* ==========================================================================
1289 Font glyph and metrics caching functions
1291 ========================================================================== */
1293 /* Find and cache corresponding glyph codes for unicode values in given
1294 hi-byte block of 256. */
1296 ns_uni_to_glyphs (struct nsfont_info *font_info, unsigned char block)
1298 #ifdef NS_IMPL_COCOA
1299 static EmacsGlyphStorage *glyphStorage;
1300 static char firstTime = 1;
1302 unichar *unichars = xmalloc (0x101 * sizeof (unichar));
1303 unsigned int i, g, idx;
1304 unsigned short *glyphs;
1307 fprintf (stderr, "%p\tFinding glyphs for glyphs in block %d\n",
1312 #ifdef NS_IMPL_COCOA
1316 glyphStorage = [[EmacsGlyphStorage alloc] initWithCapacity: 0x100];
1320 font_info->glyphs[block] = xmalloc (0x100 * sizeof (unsigned short));
1321 if (!unichars || !(font_info->glyphs[block]))
1324 /* create a string containing all Unicode characters in this block */
1325 for (idx = block<<8, i = 0; i < 0x100; idx++, i++)
1326 if (idx < 0xD800 || idx > 0xDFFF)
1329 unichars[i] = 0xFEFF;
1330 unichars[0x100] = 0;
1333 #ifdef NS_IMPL_COCOA
1334 NSString *allChars = [[NSString alloc]
1335 initWithCharactersNoCopy: unichars
1338 NSGlyphGenerator *glyphGenerator = [NSGlyphGenerator sharedGlyphGenerator];
1339 /*NSCharacterSet *coveredChars = [nsfont coveredCharacterSet]; */
1340 unsigned int numGlyphs = [font_info->nsfont numberOfGlyphs];
1341 NSUInteger gInd = 0, cInd = 0;
1343 [glyphStorage setString: allChars font: font_info->nsfont];
1344 [glyphGenerator generateGlyphsForGlyphStorage: glyphStorage
1345 desiredNumberOfCharacters: glyphStorage->maxChar
1346 glyphIndex: &gInd characterIndex: &cInd];
1348 glyphs = font_info->glyphs[block];
1349 for (i = 0; i < 0x100; i++, glyphs++)
1351 #ifdef NS_IMPL_GNUSTEP
1354 g = glyphStorage->cglyphs[i];
1355 /* TODO: is this a good check? maybe need to use coveredChars.. */
1357 g = 0xFFFF; /* hopefully unused... */
1362 #ifdef NS_IMPL_COCOA
1372 /* Determine and cache metrics for corresponding glyph codes in given
1373 hi-byte block of 256. */
1375 ns_glyph_metrics (struct nsfont_info *font_info, unsigned char block)
1378 unsigned int numGlyphs = [font_info->nsfont numberOfGlyphs];
1380 struct font_metrics *metrics;
1383 fprintf (stderr, "%p\tComputing metrics for glyphs in block %d\n",
1386 #ifdef NS_IMPL_GNUSTEP
1387 /* not implemented yet (as of startup 0.18), so punt */
1389 numGlyphs = 0x10000;
1393 #ifdef NS_IMPL_COCOA
1394 sfont = [font_info->nsfont screenFontWithRenderingMode:
1395 NSFontAntialiasedIntegerAdvancementsRenderingMode];
1397 sfont = [font_info->nsfont screenFont];
1400 font_info->metrics[block] = xzalloc (0x100 * sizeof (struct font_metrics));
1401 if (!(font_info->metrics[block]))
1404 metrics = font_info->metrics[block];
1405 for (g = block<<8, i =0; i<0x100 && g < numGlyphs; g++, i++, metrics++)
1408 NSRect r = [sfont boundingRectForGlyph: g];
1410 w = max ([sfont advancementForGlyph: g].width, 2.0);
1411 metrics->width = lrint (w);
1414 rb = r.size.width - w;
1415 // Add to bearing for LCD smoothing. We don't know if it is there.
1417 metrics->lbearing = round (lb - LCD_SMOOTHING_MARGIN);
1418 if (font_info->ital)
1419 rb += 0.22 * font_info->height;
1420 metrics->rbearing = lrint (w + rb + LCD_SMOOTHING_MARGIN);
1422 metrics->descent = r.origin.y < 0 ? -r.origin.y : 0;
1423 /*lrint (hshrink * [sfont ascender] + expand * hd/2); */
1424 metrics->ascent = r.size.height - metrics->descent;
1425 /*-lrint (hshrink* [sfont descender] - expand * hd/2); */
1431 #ifdef NS_IMPL_COCOA
1432 /* helper for font glyph setup */
1433 @implementation EmacsGlyphStorage
1437 return [self initWithCapacity: 1024];
1440 - initWithCapacity: (unsigned long) c
1442 self = [super init];
1445 dict = [NSMutableDictionary new];
1446 cglyphs = xmalloc (c * sizeof (CGGlyph));
1459 - (void) setString: (NSString *)str font: (NSFont *)font
1461 [dict setObject: font forKey: NSFontAttributeName];
1464 attrStr = [[NSAttributedString alloc] initWithString: str attributes: dict];
1465 maxChar = [str length];
1469 /* NSGlyphStorage protocol */
1470 - (NSUInteger)layoutOptions
1475 - (NSAttributedString *)attributedString
1480 - (void)insertGlyphs: (const NSGlyph *)glyphs length: (NSUInteger)length
1481 forStartingGlyphAtIndex: (NSUInteger)glyphIndex
1482 characterIndex: (NSUInteger)charIndex
1484 len = glyphIndex+length;
1485 for (i =glyphIndex; i<len; i++)
1486 cglyphs[i] = glyphs[i-glyphIndex];
1491 - (void)setIntAttribute: (NSInteger)attributeTag value: (NSInteger)val
1492 forGlyphAtIndex: (NSUInteger)glyphIndex
1498 #endif /* NS_IMPL_COCOA */
1503 ns_dump_glyphstring (struct glyph_string *s)
1507 fprintf (stderr, "Glyph string len = %d at (%d, %d) overhang (%d, %d),"
1508 "overlap = %d, bg_filled = %d:",
1509 s->nchars, s->x, s->y, s->left_overhang, s->right_overhang,
1510 s->row->overlapping_p, s->background_filled_p);
1511 for (i =0; i<s->nchars; i++)
1512 fprintf (stderr, "%c", s->first_glyph[i].u.ch);
1513 fprintf (stderr, "\n");
1518 syms_of_nsfont (void)
1520 nsfont_driver.type = Qns;
1521 register_font_driver (&nsfont_driver, NULL);
1522 DEFSYM (Qcondensed, "condensed");
1523 DEFSYM (Qexpanded, "expanded");
1524 DEFSYM (Qapple, "apple");
1525 DEFSYM (Qroman, "roman");
1526 DEFSYM (Qmedium, "medium");
1527 DEFVAR_LISP ("ns-reg-to-script", Vns_reg_to_script,
1528 doc: /* Internal use: maps font registry to Unicode script. */);
1530 ascii_printable = NULL;