xref: /aosp_15_r20/external/freetype/src/cid/cidobjs.c (revision 63949dbd25bcc50c4e1178497ff9e9574d44fc5a)
1 /****************************************************************************
2  *
3  * cidobjs.c
4  *
5  *   CID objects manager (body).
6  *
7  * Copyright (C) 1996-2023 by
8  * David Turner, Robert Wilhelm, and Werner Lemberg.
9  *
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.
15  *
16  */
17 
18 
19 #include <freetype/internal/ftdebug.h>
20 #include <freetype/internal/ftstream.h>
21 
22 #include "cidgload.h"
23 #include "cidload.h"
24 
25 #include <freetype/internal/services/svpscmap.h>
26 #include <freetype/internal/psaux.h>
27 #include <freetype/internal/pshints.h>
28 #include <freetype/ftdriver.h>
29 
30 #include "ciderrs.h"
31 
32 
33   /**************************************************************************
34    *
35    * The macro FT_COMPONENT is used in trace mode.  It is an implicit
36    * parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log
37    * messages during execution.
38    */
39 #undef  FT_COMPONENT
40 #define FT_COMPONENT  cidobjs
41 
42 
43   /**************************************************************************
44    *
45    *                           SLOT  FUNCTIONS
46    *
47    */
48 
49   FT_LOCAL_DEF( void )
cid_slot_done(FT_GlyphSlot slot)50   cid_slot_done( FT_GlyphSlot  slot )
51   {
52     if ( slot->internal )
53       slot->internal->glyph_hints = NULL;
54   }
55 
56 
57   FT_LOCAL_DEF( FT_Error )
cid_slot_init(FT_GlyphSlot slot)58   cid_slot_init( FT_GlyphSlot  slot )
59   {
60     CID_Face          face;
61     PSHinter_Service  pshinter;
62 
63 
64     face     = (CID_Face)slot->face;
65     pshinter = (PSHinter_Service)face->pshinter;
66 
67     if ( pshinter )
68     {
69       FT_Module  module;
70 
71 
72       module = FT_Get_Module( slot->library, "pshinter" );
73       if ( module )
74       {
75         T1_Hints_Funcs  funcs;
76 
77 
78         funcs = pshinter->get_t1_funcs( module );
79         slot->internal->glyph_hints = (void*)funcs;
80       }
81     }
82 
83     return 0;
84   }
85 
86 
87   /**************************************************************************
88    *
89    *                          SIZE  FUNCTIONS
90    *
91    */
92 
93 
94   static PSH_Globals_Funcs
cid_size_get_globals_funcs(CID_Size size)95   cid_size_get_globals_funcs( CID_Size  size )
96   {
97     CID_Face          face     = (CID_Face)size->root.face;
98     PSHinter_Service  pshinter = (PSHinter_Service)face->pshinter;
99     FT_Module         module;
100 
101 
102     module = FT_Get_Module( size->root.face->driver->root.library,
103                             "pshinter" );
104     return ( module && pshinter && pshinter->get_globals_funcs )
105            ? pshinter->get_globals_funcs( module )
106            : 0;
107   }
108 
109 
110   FT_LOCAL_DEF( void )
cid_size_done(FT_Size cidsize)111   cid_size_done( FT_Size  cidsize )         /* CID_Size */
112   {
113     CID_Size  size = (CID_Size)cidsize;
114 
115 
116     if ( cidsize->internal->module_data )
117     {
118       PSH_Globals_Funcs  funcs;
119 
120 
121       funcs = cid_size_get_globals_funcs( size );
122       if ( funcs )
123         funcs->destroy( (PSH_Globals)cidsize->internal->module_data );
124 
125       cidsize->internal->module_data = NULL;
126     }
127   }
128 
129 
130   FT_LOCAL_DEF( FT_Error )
cid_size_init(FT_Size cidsize)131   cid_size_init( FT_Size  cidsize )     /* CID_Size */
132   {
133     CID_Size           size  = (CID_Size)cidsize;
134     FT_Error           error = FT_Err_Ok;
135     PSH_Globals_Funcs  funcs = cid_size_get_globals_funcs( size );
136 
137 
138     if ( funcs )
139     {
140       PSH_Globals   globals;
141       CID_Face      face = (CID_Face)cidsize->face;
142       CID_FaceDict  dict = face->cid.font_dicts + face->root.face_index;
143       PS_Private    priv = &dict->private_dict;
144 
145 
146       error = funcs->create( cidsize->face->memory, priv, &globals );
147       if ( !error )
148         cidsize->internal->module_data = globals;
149     }
150 
151     return error;
152   }
153 
154 
155   FT_LOCAL_DEF( FT_Error )
cid_size_request(FT_Size size,FT_Size_Request req)156   cid_size_request( FT_Size          size,
157                     FT_Size_Request  req )
158   {
159     FT_Error  error;
160 
161     PSH_Globals_Funcs  funcs;
162 
163 
164     error = FT_Request_Metrics( size->face, req );
165     if ( error )
166       goto Exit;
167 
168     funcs = cid_size_get_globals_funcs( (CID_Size)size );
169 
170     if ( funcs )
171       funcs->set_scale( (PSH_Globals)size->internal->module_data,
172                         size->metrics.x_scale,
173                         size->metrics.y_scale,
174                         0, 0 );
175 
176   Exit:
177     return error;
178   }
179 
180 
181   /**************************************************************************
182    *
183    *                          FACE  FUNCTIONS
184    *
185    */
186 
187   /**************************************************************************
188    *
189    * @Function:
190    *   cid_face_done
191    *
192    * @Description:
193    *   Finalizes a given face object.
194    *
195    * @Input:
196    *   face ::
197    *     A pointer to the face object to destroy.
198    */
199   FT_LOCAL_DEF( void )
cid_face_done(FT_Face cidface)200   cid_face_done( FT_Face  cidface )         /* CID_Face */
201   {
202     CID_Face      face = (CID_Face)cidface;
203     FT_Memory     memory;
204     CID_FaceInfo  cid;
205     PS_FontInfo   info;
206 
207 
208     if ( !face )
209       return;
210 
211     cid    = &face->cid;
212     info   = &cid->font_info;
213     memory = cidface->memory;
214 
215     /* release subrs */
216     if ( face->subrs )
217     {
218       FT_UInt  n;
219 
220 
221       for ( n = 0; n < cid->num_dicts; n++ )
222       {
223         CID_Subrs  subr = face->subrs + n;
224 
225 
226         if ( subr->code )
227         {
228           FT_FREE( subr->code[0] );
229           FT_FREE( subr->code );
230         }
231       }
232 
233       FT_FREE( face->subrs );
234     }
235 
236     /* release FontInfo strings */
237     FT_FREE( info->version );
238     FT_FREE( info->notice );
239     FT_FREE( info->full_name );
240     FT_FREE( info->family_name );
241     FT_FREE( info->weight );
242 
243     /* release font dictionaries */
244     FT_FREE( cid->font_dicts );
245     cid->num_dicts = 0;
246 
247     /* release other strings */
248     FT_FREE( cid->cid_font_name );
249     FT_FREE( cid->registry );
250     FT_FREE( cid->ordering );
251 
252     cidface->family_name = NULL;
253     cidface->style_name  = NULL;
254 
255     FT_FREE( face->binary_data );
256     FT_FREE( face->cid_stream );
257   }
258 
259 
260   /**************************************************************************
261    *
262    * @Function:
263    *   cid_face_init
264    *
265    * @Description:
266    *   Initializes a given CID face object.
267    *
268    * @Input:
269    *   stream ::
270    *     Dummy argument for compatibility with the `FT_Face_InitFunc` API.
271    *     Ignored.  The stream should be passed through `face->root.stream`.
272    *
273    *   face_index ::
274    *     The index of the font face in the resource.
275    *
276    *   num_params ::
277    *     Number of additional generic parameters.  Ignored.
278    *
279    *   params ::
280    *     Additional generic parameters.  Ignored.
281    *
282    * @InOut:
283    *   face ::
284    *     The newly built face object.
285    *
286    * @Return:
287    *   FreeType error code.  0 means success.
288    */
289   FT_LOCAL_DEF( FT_Error )
cid_face_init(FT_Stream stream,FT_Face cidface,FT_Int face_index,FT_Int num_params,FT_Parameter * params)290   cid_face_init( FT_Stream      stream,
291                  FT_Face        cidface,        /* CID_Face */
292                  FT_Int         face_index,
293                  FT_Int         num_params,
294                  FT_Parameter*  params )
295   {
296     CID_Face          face = (CID_Face)cidface;
297     FT_Error          error;
298     PSAux_Service     psaux;
299     PSHinter_Service  pshinter;
300 
301     FT_UNUSED( num_params );
302     FT_UNUSED( params );
303     FT_UNUSED( stream );
304 
305 
306     cidface->num_faces = 1;
307 
308     psaux = (PSAux_Service)face->psaux;
309     if ( !psaux )
310     {
311       psaux = (PSAux_Service)FT_Get_Module_Interface(
312                 FT_FACE_LIBRARY( face ), "psaux" );
313 
314       if ( !psaux )
315       {
316         FT_ERROR(( "cid_face_init: cannot access `psaux' module\n" ));
317         error = FT_THROW( Missing_Module );
318         goto Exit;
319       }
320 
321       face->psaux = psaux;
322     }
323 
324     pshinter = (PSHinter_Service)face->pshinter;
325     if ( !pshinter )
326     {
327       pshinter = (PSHinter_Service)FT_Get_Module_Interface(
328                    FT_FACE_LIBRARY( face ), "pshinter" );
329 
330       face->pshinter = pshinter;
331     }
332 
333     FT_TRACE2(( "CID driver\n" ));
334 
335     /* open the tokenizer; this will also check the font format */
336     if ( FT_STREAM_SEEK( 0 ) )
337       goto Exit;
338 
339     error = cid_face_open( face, face_index );
340     if ( error )
341       goto Exit;
342 
343     /* if we just wanted to check the format, leave successfully now */
344     if ( face_index < 0 )
345       goto Exit;
346 
347     /* check the face index */
348     /* XXX: handle CID fonts with more than a single face */
349     if ( ( face_index & 0xFFFF ) != 0 )
350     {
351       FT_ERROR(( "cid_face_init: invalid face index\n" ));
352       error = FT_THROW( Invalid_Argument );
353       goto Exit;
354     }
355 
356     /* now load the font program into the face object */
357 
358     /* initialize the face object fields */
359 
360     /* set up root face fields */
361     {
362       CID_FaceInfo  cid  = &face->cid;
363       PS_FontInfo   info = &cid->font_info;
364 
365 
366       cidface->num_glyphs   = (FT_Long)cid->cid_count;
367       cidface->num_charmaps = 0;
368 
369       cidface->face_index = face_index & 0xFFFF;
370 
371       cidface->face_flags |= FT_FACE_FLAG_SCALABLE   | /* scalable outlines */
372                              FT_FACE_FLAG_HORIZONTAL | /* horizontal data   */
373                              FT_FACE_FLAG_HINTER;      /* has native hinter */
374 
375       if ( info->is_fixed_pitch )
376         cidface->face_flags |= FT_FACE_FLAG_FIXED_WIDTH;
377 
378       /*
379        * For the sfnt-wrapped CID fonts for MacOS, currently,
380        * its `cmap' tables are ignored, and the content in
381        * its `CID ' table is treated the same as naked CID-keyed
382        * font.  See ft_lookup_PS_in_sfnt_stream().
383        */
384       cidface->face_flags |= FT_FACE_FLAG_CID_KEYED;
385 
386       /* XXX: TODO: add kerning with .afm support */
387 
388       /* get style name -- be careful, some broken fonts only */
389       /* have a /FontName dictionary entry!                   */
390       cidface->family_name = info->family_name;
391       /* assume "Regular" style if we don't know better */
392       cidface->style_name = (char *)"Regular";
393       if ( cidface->family_name )
394       {
395         char*  full   = info->full_name;
396         char*  family = cidface->family_name;
397 
398 
399         if ( full )
400         {
401           while ( *full )
402           {
403             if ( *full == *family )
404             {
405               family++;
406               full++;
407             }
408             else
409             {
410               if ( *full == ' ' || *full == '-' )
411                 full++;
412               else if ( *family == ' ' || *family == '-' )
413                 family++;
414               else
415               {
416                 if ( !*family )
417                   cidface->style_name = full;
418                 break;
419               }
420             }
421           }
422         }
423       }
424       else
425       {
426         /* do we have a `/FontName'? */
427         if ( cid->cid_font_name )
428           cidface->family_name = cid->cid_font_name;
429       }
430 
431       /* compute style flags */
432       cidface->style_flags = 0;
433       if ( info->italic_angle )
434         cidface->style_flags |= FT_STYLE_FLAG_ITALIC;
435       if ( info->weight )
436       {
437         if ( !ft_strcmp( info->weight, "Bold"  ) ||
438              !ft_strcmp( info->weight, "Black" ) )
439           cidface->style_flags |= FT_STYLE_FLAG_BOLD;
440       }
441 
442       /* no embedded bitmap support */
443       cidface->num_fixed_sizes = 0;
444       cidface->available_sizes = NULL;
445 
446       cidface->bbox.xMin =   cid->font_bbox.xMin            >> 16;
447       cidface->bbox.yMin =   cid->font_bbox.yMin            >> 16;
448       /* no `U' suffix here to 0xFFFF! */
449       cidface->bbox.xMax = ( cid->font_bbox.xMax + 0xFFFF ) >> 16;
450       cidface->bbox.yMax = ( cid->font_bbox.yMax + 0xFFFF ) >> 16;
451 
452       if ( !cidface->units_per_EM )
453         cidface->units_per_EM = 1000;
454 
455       cidface->ascender  = (FT_Short)( cidface->bbox.yMax );
456       cidface->descender = (FT_Short)( cidface->bbox.yMin );
457 
458       cidface->height = (FT_Short)( ( cidface->units_per_EM * 12 ) / 10 );
459       if ( cidface->height < cidface->ascender - cidface->descender )
460         cidface->height = (FT_Short)( cidface->ascender - cidface->descender );
461 
462       cidface->underline_position  = (FT_Short)info->underline_position;
463       cidface->underline_thickness = (FT_Short)info->underline_thickness;
464     }
465 
466   Exit:
467     return error;
468   }
469 
470 
471   /**************************************************************************
472    *
473    * @Function:
474    *   cid_driver_init
475    *
476    * @Description:
477    *   Initializes a given CID driver object.
478    *
479    * @Input:
480    *   driver ::
481    *     A handle to the target driver object.
482    *
483    * @Return:
484    *   FreeType error code.  0 means success.
485    */
486   FT_LOCAL_DEF( FT_Error )
cid_driver_init(FT_Module module)487   cid_driver_init( FT_Module  module )
488   {
489     PS_Driver  driver = (PS_Driver)module;
490 
491     FT_UInt32  seed;
492 
493 
494     /* set default property values, cf. `ftt1drv.h' */
495     driver->hinting_engine = FT_HINTING_ADOBE;
496 
497     driver->no_stem_darkening = TRUE;
498 
499     driver->darken_params[0] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_X1;
500     driver->darken_params[1] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y1;
501     driver->darken_params[2] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_X2;
502     driver->darken_params[3] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y2;
503     driver->darken_params[4] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_X3;
504     driver->darken_params[5] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y3;
505     driver->darken_params[6] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_X4;
506     driver->darken_params[7] = CFF_CONFIG_OPTION_DARKENING_PARAMETER_Y4;
507 
508     /* compute random seed from some memory addresses */
509     seed = (FT_UInt32)( (FT_Offset)(char*)&seed          ^
510                         (FT_Offset)(char*)&module        ^
511                         (FT_Offset)(char*)module->memory );
512     seed = seed ^ ( seed >> 10 ) ^ ( seed >> 20 );
513 
514     driver->random_seed = (FT_Int32)seed;
515     if ( driver->random_seed < 0 )
516       driver->random_seed = -driver->random_seed;
517     else if ( driver->random_seed == 0 )
518       driver->random_seed = 123456789;
519 
520     return FT_Err_Ok;
521   }
522 
523 
524   /**************************************************************************
525    *
526    * @Function:
527    *   cid_driver_done
528    *
529    * @Description:
530    *   Finalizes a given CID driver.
531    *
532    * @Input:
533    *   driver ::
534    *     A handle to the target CID driver.
535    */
536   FT_LOCAL_DEF( void )
cid_driver_done(FT_Module driver)537   cid_driver_done( FT_Module  driver )
538   {
539     FT_UNUSED( driver );
540   }
541 
542 
543 /* END */
544