1
/***************************************************************************/
5
/* OpenType font driver implementation (body). */
7
/* Copyright 1996-2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, */
9
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
11
/* This file is part of the FreeType project, and may only be used, */
12
/* modified, and distributed under the terms of the FreeType project */
13
/* license, LICENSE.TXT. By continuing to use, modify, or distribute */
14
/* this file you indicate that you have read the license and */
15
/* understand and accept it fully. */
17
/***************************************************************************/
21
#include FT_FREETYPE_H
22
#include FT_INTERNAL_DEBUG_H
23
#include FT_INTERNAL_STREAM_H
24
#include FT_INTERNAL_SFNT_H
25
#include FT_SERVICE_CID_H
26
#include FT_SERVICE_POSTSCRIPT_INFO_H
27
#include FT_SERVICE_POSTSCRIPT_NAME_H
28
#include FT_SERVICE_TT_CMAP_H
39
#include FT_SERVICE_XFREE86_NAME_H
40
#include FT_SERVICE_GLYPH_DICT_H
43
/*************************************************************************/
45
/* The macro FT_COMPONENT is used in trace mode. It is an implicit */
46
/* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log */
47
/* messages during execution. */
50
#define FT_COMPONENT trace_cffdriver
53
/*************************************************************************/
54
/*************************************************************************/
55
/*************************************************************************/
61
/*************************************************************************/
62
/*************************************************************************/
63
/*************************************************************************/
67
#define PAIR_TAG( left, right ) ( ( (FT_ULong)left << 16 ) | \
71
/*************************************************************************/
77
/* A driver method used to return the kerning vector between two */
78
/* glyphs of the same face. */
81
/* face :: A handle to the source face object. */
83
/* left_glyph :: The index of the left glyph in the kern pair. */
85
/* right_glyph :: The index of the right glyph in the kern pair. */
88
/* kerning :: The kerning vector. This is in font units for */
89
/* scalable formats, and in pixels for fixed-sizes */
93
/* FreeType error code. 0 means success. */
96
/* Only horizontal layouts (left-to-right & right-to-left) are */
97
/* supported by this function. Other layouts, or more sophisticated */
98
/* kernings, are out of scope of this method (the basic driver */
99
/* interface is meant to be simple). */
101
/* They can be implemented by format-specific interfaces. */
103
FT_CALLBACK_DEF( FT_Error )
104
cff_get_kerning( FT_Face ttface, /* TT_Face */
109
TT_Face face = (TT_Face)ttface;
110
SFNT_Service sfnt = (SFNT_Service)face->sfnt;
117
kerning->x = sfnt->get_kerning( face, left_glyph, right_glyph );
126
/*************************************************************************/
132
/* A driver method used to load a glyph within a given glyph slot. */
135
/* slot :: A handle to the target slot object where the glyph */
136
/* will be loaded. */
138
/* size :: A handle to the source face size at which the glyph */
139
/* must be scaled, loaded, etc. */
141
/* glyph_index :: The index of the glyph in the font file. */
143
/* load_flags :: A flag indicating what to load for this glyph. The */
144
/* FT_LOAD_??? constants can be used to control the */
145
/* glyph loading process (e.g., whether the outline */
146
/* should be scaled, whether to load bitmaps or not, */
147
/* whether to hint the outline, etc). */
150
/* FreeType error code. 0 means success. */
152
FT_CALLBACK_DEF( FT_Error )
153
Load_Glyph( FT_GlyphSlot cffslot, /* CFF_GlyphSlot */
154
FT_Size cffsize, /* CFF_Size */
156
FT_Int32 load_flags )
159
CFF_GlyphSlot slot = (CFF_GlyphSlot)cffslot;
160
CFF_Size size = (CFF_Size)cffsize;
164
return CFF_Err_Invalid_Slot_Handle;
166
/* check whether we want a scaled outline or bitmap */
168
load_flags |= FT_LOAD_NO_SCALE | FT_LOAD_NO_HINTING;
170
/* reset the size object if necessary */
171
if ( load_flags & FT_LOAD_NO_SCALE )
176
/* these two objects must have the same parent */
177
if ( cffsize->face != cffslot->face )
178
return CFF_Err_Invalid_Face_Handle;
181
/* now load the glyph outline if necessary */
182
error = cff_slot_load( slot, size, glyph_index, load_flags );
184
/* force drop-out mode to 2 - irrelevant now */
185
/* slot->outline.dropout_mode = 2; */
191
FT_CALLBACK_DEF( FT_Error )
192
cff_get_advances( FT_Face face,
199
FT_Error error = CFF_Err_Ok;
200
FT_GlyphSlot slot = face->glyph;
203
flags |= (FT_UInt32)FT_LOAD_ADVANCE_ONLY;
205
for ( nn = 0; nn < count; nn++ )
207
error = Load_Glyph( slot, face->size, start + nn, flags );
211
advances[nn] = ( flags & FT_LOAD_VERTICAL_LAYOUT )
212
? slot->linearVertAdvance
213
: slot->linearHoriAdvance;
226
cff_get_glyph_name( CFF_Face face,
231
CFF_Font font = (CFF_Font)face->extra.data;
237
if ( !font->psnames )
239
FT_ERROR(( "cff_get_glyph_name:"
240
" cannot get glyph name from CFF & CEF fonts\n"
242
" without the `PSNames' module\n" ));
243
error = CFF_Err_Unknown_File_Format;
247
/* first, locate the sid in the charset table */
248
sid = font->charset.sids[glyph_index];
250
/* now, lookup the name itself */
251
gname = cff_index_get_sid_string( font, sid );
254
FT_STRCPYN( buffer, gname, buffer_max );
264
cff_get_name_index( CFF_Face face,
265
FT_String* glyph_name )
269
FT_Service_PsCMaps psnames;
275
cff = (CFF_FontRec *)face->extra.data;
276
charset = &cff->charset;
278
FT_FACE_FIND_GLOBAL_SERVICE( face, psnames, POSTSCRIPT_CMAPS );
282
for ( i = 0; i < cff->num_glyphs; i++ )
284
sid = charset->sids[i];
287
name = cff_index_get_string( cff, sid - 391 );
289
name = (FT_String *)psnames->adobe_std_strings( sid );
294
if ( !ft_strcmp( glyph_name, name ) )
302
FT_DEFINE_SERVICE_GLYPHDICTREC(cff_service_glyph_dict,
303
(FT_GlyphDict_GetNameFunc) cff_get_glyph_name,
304
(FT_GlyphDict_NameIndexFunc)cff_get_name_index
309
* POSTSCRIPT INFO SERVICE
314
cff_ps_has_glyph_names( FT_Face face )
316
return ( face->face_flags & FT_FACE_FLAG_GLYPH_NAMES ) > 0;
321
cff_ps_get_font_info( CFF_Face face,
322
PS_FontInfoRec* afont_info )
324
CFF_Font cff = (CFF_Font)face->extra.data;
325
FT_Error error = CFF_Err_Ok;
328
if ( cff && cff->font_info == NULL )
330
CFF_FontRecDict dict = &cff->top_font.font_dict;
331
PS_FontInfoRec *font_info;
332
FT_Memory memory = face->root.memory;
335
if ( FT_ALLOC( font_info, sizeof ( *font_info ) ) )
338
font_info->version = cff_index_get_sid_string( cff,
340
font_info->notice = cff_index_get_sid_string( cff,
342
font_info->full_name = cff_index_get_sid_string( cff,
344
font_info->family_name = cff_index_get_sid_string( cff,
346
font_info->weight = cff_index_get_sid_string( cff,
348
font_info->italic_angle = dict->italic_angle;
349
font_info->is_fixed_pitch = dict->is_fixed_pitch;
350
font_info->underline_position = (FT_Short)dict->underline_position;
351
font_info->underline_thickness = (FT_Short)dict->underline_thickness;
353
cff->font_info = font_info;
357
*afont_info = *cff->font_info;
364
FT_DEFINE_SERVICE_PSINFOREC(cff_service_ps_info,
365
(PS_GetFontInfoFunc) cff_ps_get_font_info,
366
(PS_GetFontExtraFunc) NULL,
367
(PS_HasGlyphNamesFunc) cff_ps_has_glyph_names,
368
(PS_GetFontPrivateFunc)NULL /* unsupported with CFF fonts */
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 )
603
FT_Module_Interface result;
606
result = ft_service_list_lookup( FT_CFF_SERVICES_GET, module_interface );
607
if ( result != NULL )
613
/* we pass our request to the `sfnt' module */
614
sfnt = FT_Get_Module( driver->library, "sfnt" );
616
return sfnt ? sfnt->clazz->get_interface( sfnt, module_interface ) : 0;
620
/* The FT_DriverInterface structure is defined in ftdriver.h. */
622
#ifdef TT_CONFIG_OPTION_EMBEDDED_BITMAPS
623
#define CFF_SIZE_SELECT cff_size_select
625
#define CFF_SIZE_SELECT 0
628
FT_DEFINE_DRIVER(cff_driver_class,
629
FT_MODULE_FONT_DRIVER |
630
FT_MODULE_DRIVER_SCALABLE |
631
FT_MODULE_DRIVER_HAS_HINTER,
633
sizeof( CFF_DriverRec ),
638
0, /* module-specific interface */
644
/* now the specific driver fields */
645
sizeof( TT_FaceRec ),
646
sizeof( CFF_SizeRec ),
647
sizeof( CFF_GlyphSlotRec ),
656
ft_stub_set_char_sizes, /* FT_CONFIG_OPTION_OLD_INTERNALS */
657
ft_stub_set_pixel_sizes, /* FT_CONFIG_OPTION_OLD_INTERNALS */
662
0, /* FT_Face_AttachFunc */
663
cff_get_advances, /* FT_Face_GetAdvancesFunc */