1 /***************************************************************************/
5 /* OpenType font driver implementation (body). */
7 /* Copyright 1996-2012 by */
8 /* David Turner, Robert Wilhelm, and Werner Lemberg. */
10 /* This file is part of the FreeType project, and may only be used, */
11 /* modified, and distributed under the terms of the FreeType project */
12 /* license, LICENSE.TXT. By continuing to use, modify, or distribute */
13 /* this file you indicate that you have read the license and */
14 /* understand and accept it fully. */
16 /***************************************************************************/
20 #include FT_FREETYPE_H
21 #include FT_INTERNAL_DEBUG_H
22 #include FT_INTERNAL_STREAM_H
23 #include FT_INTERNAL_SFNT_H
24 #include FT_SERVICE_CID_H
25 #include FT_SERVICE_POSTSCRIPT_INFO_H
26 #include FT_SERVICE_POSTSCRIPT_NAME_H
27 #include FT_SERVICE_TT_CMAP_H
38 #include FT_SERVICE_XFREE86_NAME_H
39 #include FT_SERVICE_GLYPH_DICT_H
42 /*************************************************************************/
44 /* The macro FT_COMPONENT is used in trace mode. It is an implicit */
45 /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log */
46 /* messages during execution. */
49 #define FT_COMPONENT trace_cffdriver
52 /*************************************************************************/
53 /*************************************************************************/
54 /*************************************************************************/
60 /*************************************************************************/
61 /*************************************************************************/
62 /*************************************************************************/
66 #define PAIR_TAG( left, right ) ( ( (FT_ULong)left << 16 ) | \
70 /*************************************************************************/
76 /* A driver method used to return the kerning vector between two */
77 /* glyphs of the same face. */
80 /* face :: A handle to the source face object. */
82 /* left_glyph :: The index of the left glyph in the kern pair. */
84 /* right_glyph :: The index of the right glyph in the kern pair. */
87 /* kerning :: The kerning vector. This is in font units for */
88 /* scalable formats, and in pixels for fixed-sizes */
92 /* FreeType error code. 0 means success. */
95 /* Only horizontal layouts (left-to-right & right-to-left) are */
96 /* supported by this function. Other layouts, or more sophisticated */
97 /* kernings, are out of scope of this method (the basic driver */
98 /* interface is meant to be simple). */
100 /* They can be implemented by format-specific interfaces. */
102 FT_CALLBACK_DEF( FT_Error )
103 cff_get_kerning( FT_Face ttface, /* TT_Face */
108 TT_Face face = (TT_Face)ttface;
109 SFNT_Service sfnt = (SFNT_Service)face->sfnt;
116 kerning->x = sfnt->get_kerning( face, left_glyph, right_glyph );
125 /*************************************************************************/
131 /* A driver method used to load a glyph within a given glyph slot. */
134 /* slot :: A handle to the target slot object where the glyph */
135 /* will be loaded. */
137 /* size :: A handle to the source face size at which the glyph */
138 /* must be scaled, loaded, etc. */
140 /* glyph_index :: The index of the glyph in the font file. */
142 /* load_flags :: A flag indicating what to load for this glyph. The */
143 /* FT_LOAD_??? constants can be used to control the */
144 /* glyph loading process (e.g., whether the outline */
145 /* should be scaled, whether to load bitmaps or not, */
146 /* whether to hint the outline, etc). */
149 /* FreeType error code. 0 means success. */
151 FT_CALLBACK_DEF( FT_Error )
152 cff_glyph_load( FT_GlyphSlot cffslot, /* CFF_GlyphSlot */
153 FT_Size cffsize, /* CFF_Size */
155 FT_Int32 load_flags )
158 CFF_GlyphSlot slot = (CFF_GlyphSlot)cffslot;
159 CFF_Size size = (CFF_Size)cffsize;
163 return CFF_Err_Invalid_Slot_Handle;
165 /* check whether we want a scaled outline or bitmap */
167 load_flags |= FT_LOAD_NO_SCALE | FT_LOAD_NO_HINTING;
169 /* reset the size object if necessary */
170 if ( load_flags & FT_LOAD_NO_SCALE )
175 /* these two objects must have the same parent */
176 if ( cffsize->face != cffslot->face )
177 return CFF_Err_Invalid_Face_Handle;
180 /* now load the glyph outline if necessary */
181 error = cff_slot_load( slot, size, glyph_index, load_flags );
183 /* force drop-out mode to 2 - irrelevant now */
184 /* slot->outline.dropout_mode = 2; */
190 FT_CALLBACK_DEF( FT_Error )
191 cff_get_advances( FT_Face face,
198 FT_Error error = CFF_Err_Ok;
199 FT_GlyphSlot slot = face->glyph;
202 flags |= (FT_UInt32)FT_LOAD_ADVANCE_ONLY;
204 for ( nn = 0; nn < count; nn++ )
206 error = cff_glyph_load( slot, face->size, start + nn, flags );
210 advances[nn] = ( flags & FT_LOAD_VERTICAL_LAYOUT )
211 ? slot->linearVertAdvance
212 : slot->linearHoriAdvance;
225 cff_get_glyph_name( CFF_Face face,
230 CFF_Font font = (CFF_Font)face->extra.data;
236 if ( !font->psnames )
238 FT_ERROR(( "cff_get_glyph_name:"
239 " cannot get glyph name from CFF & CEF fonts\n"
241 " without the `PSNames' module\n" ));
242 error = CFF_Err_Missing_Module;
246 /* first, locate the sid in the charset table */
247 sid = font->charset.sids[glyph_index];
249 /* now, lookup the name itself */
250 gname = cff_index_get_sid_string( font, sid );
253 FT_STRCPYN( buffer, gname, buffer_max );
263 cff_get_name_index( CFF_Face face,
264 FT_String* glyph_name )
268 FT_Service_PsCMaps psnames;
274 cff = (CFF_FontRec *)face->extra.data;
275 charset = &cff->charset;
277 FT_FACE_FIND_GLOBAL_SERVICE( face, psnames, POSTSCRIPT_CMAPS );
281 for ( i = 0; i < cff->num_glyphs; i++ )
283 sid = charset->sids[i];
286 name = cff_index_get_string( cff, sid - 391 );
288 name = (FT_String *)psnames->adobe_std_strings( sid );
293 if ( !ft_strcmp( glyph_name, name ) )
301 FT_DEFINE_SERVICE_GLYPHDICTREC(cff_service_glyph_dict,
302 (FT_GlyphDict_GetNameFunc) cff_get_glyph_name,
303 (FT_GlyphDict_NameIndexFunc)cff_get_name_index
308 * POSTSCRIPT INFO SERVICE
313 cff_ps_has_glyph_names( FT_Face face )
315 return ( face->face_flags & FT_FACE_FLAG_GLYPH_NAMES ) > 0;
320 cff_ps_get_font_info( CFF_Face face,
321 PS_FontInfoRec* afont_info )
323 CFF_Font cff = (CFF_Font)face->extra.data;
324 FT_Error error = CFF_Err_Ok;
327 if ( cff && cff->font_info == NULL )
329 CFF_FontRecDict dict = &cff->top_font.font_dict;
330 PS_FontInfoRec *font_info = NULL;
331 FT_Memory memory = face->root.memory;
334 if ( FT_ALLOC( font_info, sizeof ( *font_info ) ) )
337 font_info->version = cff_index_get_sid_string( cff,
339 font_info->notice = cff_index_get_sid_string( cff,
341 font_info->full_name = cff_index_get_sid_string( cff,
343 font_info->family_name = cff_index_get_sid_string( cff,
345 font_info->weight = cff_index_get_sid_string( cff,
347 font_info->italic_angle = dict->italic_angle;
348 font_info->is_fixed_pitch = dict->is_fixed_pitch;
349 font_info->underline_position = (FT_Short)dict->underline_position;
350 font_info->underline_thickness = (FT_Short)dict->underline_thickness;
352 cff->font_info = font_info;
356 *afont_info = *cff->font_info;
363 FT_DEFINE_SERVICE_PSINFOREC(cff_service_ps_info,
364 (PS_GetFontInfoFunc) cff_ps_get_font_info,
365 (PS_GetFontExtraFunc) NULL,
366 (PS_HasGlyphNamesFunc) cff_ps_has_glyph_names,
367 (PS_GetFontPrivateFunc)NULL, /* unsupported with CFF fonts */
368 (PS_GetFontValueFunc) NULL /* not implemented */
373 * POSTSCRIPT NAME SERVICE
378 cff_get_ps_name( CFF_Face face )
380 CFF_Font cff = (CFF_Font)face->extra.data;
383 return (const char*)cff->font_name;
387 FT_DEFINE_SERVICE_PSFONTNAMEREC(cff_service_ps_name,
388 (FT_PsName_GetFunc)cff_get_ps_name
395 * If the charmap is a synthetic Unicode encoding cmap or
396 * a Type 1 standard (or expert) encoding cmap, hide TT CMAP INFO
397 * service defined in SFNT module.
399 * Otherwise call the service function in the sfnt module.
403 cff_get_cmap_info( FT_CharMap charmap,
404 TT_CMapInfo *cmap_info )
406 FT_CMap cmap = FT_CMAP( charmap );
407 FT_Error error = CFF_Err_Ok;
408 FT_Face face = FT_CMAP_FACE( cmap );
409 FT_Library library = FT_FACE_LIBRARY( face );
412 cmap_info->language = 0;
413 cmap_info->format = 0;
415 if ( cmap->clazz != &FT_CFF_CMAP_ENCODING_CLASS_REC_GET &&
416 cmap->clazz != &FT_CFF_CMAP_UNICODE_CLASS_REC_GET )
418 FT_Module sfnt = FT_Get_Module( library, "sfnt" );
419 FT_Service_TTCMaps service =
420 (FT_Service_TTCMaps)ft_module_get_service( sfnt,
421 FT_SERVICE_ID_TT_CMAP );
424 if ( service && service->get_cmap_info )
425 error = service->get_cmap_info( charmap, cmap_info );
432 FT_DEFINE_SERVICE_TTCMAPSREC(cff_service_get_cmap_info,
433 (TT_CMap_Info_GetFunc)cff_get_cmap_info
442 cff_get_ros( CFF_Face face,
443 const char* *registry,
444 const char* *ordering,
447 FT_Error error = CFF_Err_Ok;
448 CFF_Font cff = (CFF_Font)face->extra.data;
453 CFF_FontRecDict dict = &cff->top_font.font_dict;
456 if ( dict->cid_registry == 0xFFFFU )
458 error = CFF_Err_Invalid_Argument;
464 if ( cff->registry == NULL )
465 cff->registry = cff_index_get_sid_string( cff,
466 dict->cid_registry );
467 *registry = cff->registry;
472 if ( cff->ordering == NULL )
473 cff->ordering = cff_index_get_sid_string( cff,
474 dict->cid_ordering );
475 *ordering = cff->ordering;
479 * XXX: According to Adobe TechNote #5176, the supplement in CFF
480 * can be a real number. We truncate it to fit public API
481 * since freetype-2.3.6.
485 if ( dict->cid_supplement < FT_INT_MIN ||
486 dict->cid_supplement > FT_INT_MAX )
487 FT_TRACE1(( "cff_get_ros: too large supplement %d is truncated\n",
488 dict->cid_supplement ));
489 *supplement = (FT_Int)dict->cid_supplement;
499 cff_get_is_cid( CFF_Face face,
502 FT_Error error = CFF_Err_Ok;
503 CFF_Font cff = (CFF_Font)face->extra.data;
510 CFF_FontRecDict dict = &cff->top_font.font_dict;
513 if ( dict->cid_registry != 0xFFFFU )
522 cff_get_cid_from_glyph_index( CFF_Face face,
526 FT_Error error = CFF_Err_Ok;
530 cff = (CFF_Font)face->extra.data;
535 CFF_FontRecDict dict = &cff->top_font.font_dict;
538 if ( dict->cid_registry == 0xFFFFU )
540 error = CFF_Err_Invalid_Argument;
544 if ( glyph_index > cff->num_glyphs )
546 error = CFF_Err_Invalid_Argument;
550 c = cff->charset.sids[glyph_index];
561 FT_DEFINE_SERVICE_CIDREC(cff_service_cid_info,
562 (FT_CID_GetRegistryOrderingSupplementFunc)cff_get_ros,
563 (FT_CID_GetIsInternallyCIDKeyedFunc) cff_get_is_cid,
564 (FT_CID_GetCIDFromGlyphIndexFunc) cff_get_cid_from_glyph_index
568 /*************************************************************************/
569 /*************************************************************************/
570 /*************************************************************************/
573 /**** D R I V E R I N T E R F A C E ****/
576 /*************************************************************************/
577 /*************************************************************************/
578 /*************************************************************************/
579 #ifndef FT_CONFIG_OPTION_NO_GLYPH_NAMES
580 FT_DEFINE_SERVICEDESCREC6(cff_services,
581 FT_SERVICE_ID_XF86_NAME, FT_XF86_FORMAT_CFF,
582 FT_SERVICE_ID_POSTSCRIPT_INFO, &FT_CFF_SERVICE_PS_INFO_GET,
583 FT_SERVICE_ID_POSTSCRIPT_FONT_NAME, &FT_CFF_SERVICE_PS_NAME_GET,
584 FT_SERVICE_ID_GLYPH_DICT, &FT_CFF_SERVICE_GLYPH_DICT_GET,
585 FT_SERVICE_ID_TT_CMAP, &FT_CFF_SERVICE_GET_CMAP_INFO_GET,
586 FT_SERVICE_ID_CID, &FT_CFF_SERVICE_CID_INFO_GET
589 FT_DEFINE_SERVICEDESCREC5(cff_services,
590 FT_SERVICE_ID_XF86_NAME, FT_XF86_FORMAT_CFF,
591 FT_SERVICE_ID_POSTSCRIPT_INFO, &FT_CFF_SERVICE_PS_INFO_GET,
592 FT_SERVICE_ID_POSTSCRIPT_FONT_NAME, &FT_CFF_SERVICE_PS_NAME_GET,
593 FT_SERVICE_ID_TT_CMAP, &FT_CFF_SERVICE_GET_CMAP_INFO_GET,
594 FT_SERVICE_ID_CID, &FT_CFF_SERVICE_CID_INFO_GET
598 FT_CALLBACK_DEF( FT_Module_Interface )
599 cff_get_interface( FT_Module driver, /* CFF_Driver */
600 const char* module_interface )
604 FT_Module_Interface result;
607 /* FT_CFF_SERVICES_GET derefers `library' in PIC mode */
608 #ifdef FT_CONFIG_OPTION_PIC
611 library = driver->library;
616 result = ft_service_list_lookup( FT_CFF_SERVICES_GET, module_interface );
617 if ( result != NULL )
620 /* `driver' is not yet evaluated in non-PIC mode */
621 #ifndef FT_CONFIG_OPTION_PIC
624 library = driver->library;
629 /* we pass our request to the `sfnt' module */
630 sfnt = FT_Get_Module( library, "sfnt" );
632 return sfnt ? sfnt->clazz->get_interface( sfnt, module_interface ) : 0;
636 /* The FT_DriverInterface structure is defined in ftdriver.h. */
638 #ifdef TT_CONFIG_OPTION_EMBEDDED_BITMAPS
639 #define CFF_SIZE_SELECT cff_size_select
641 #define CFF_SIZE_SELECT 0
644 FT_DEFINE_DRIVER( cff_driver_class,
646 FT_MODULE_FONT_DRIVER |
647 FT_MODULE_DRIVER_SCALABLE |
648 FT_MODULE_DRIVER_HAS_HINTER,
650 sizeof ( CFF_DriverRec ),
655 0, /* module-specific interface */
661 /* now the specific driver fields */
662 sizeof ( TT_FaceRec ),
663 sizeof ( CFF_SizeRec ),
664 sizeof ( CFF_GlyphSlotRec ),
673 ft_stub_set_char_sizes, /* FT_CONFIG_OPTION_OLD_INTERNALS */
674 ft_stub_set_pixel_sizes, /* FT_CONFIG_OPTION_OLD_INTERNALS */
679 0, /* FT_Face_AttachFunc */