source: trunk/poppler/freetype2/include/freetype/t1tables.h @ 262

Last change on this file since 262 was 262, checked in by Eugene Romanenko, 12 years ago

PDF plugin: freetype library updated to version 2.3.8

File size: 20.1 KB
Line 
1/***************************************************************************/
2/*                                                                         */
3/*  t1tables.h                                                             */
4/*                                                                         */
5/*    Basic Type 1/Type 2 tables definitions and interface (specification  */
6/*    only).                                                               */
7/*                                                                         */
8/*  Copyright 1996-2001, 2002, 2003, 2004, 2006, 2008 by                   */
9/*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
10/*                                                                         */
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.                                        */
16/*                                                                         */
17/***************************************************************************/
18
19
20#ifndef __T1TABLES_H__
21#define __T1TABLES_H__
22
23
24#include <ft2build.h>
25#include FT_FREETYPE_H
26
27#ifdef FREETYPE_H
28#error "freetype.h of FreeType 1 has been loaded!"
29#error "Please fix the directory search order for header files"
30#error "so that freetype.h of FreeType 2 is found first."
31#endif
32
33
34FT_BEGIN_HEADER
35
36
37  /*************************************************************************/
38  /*                                                                       */
39  /* <Section>                                                             */
40  /*    type1_tables                                                       */
41  /*                                                                       */
42  /* <Title>                                                               */
43  /*    Type 1 Tables                                                      */
44  /*                                                                       */
45  /* <Abstract>                                                            */
46  /*    Type~1 (PostScript) specific font tables.                          */
47  /*                                                                       */
48  /* <Description>                                                         */
49  /*    This section contains the definition of Type 1-specific tables,    */
50  /*    including structures related to other PostScript font formats.     */
51  /*                                                                       */
52  /*************************************************************************/
53
54
55  /* Note that we separate font data in PS_FontInfoRec and PS_PrivateRec */
56  /* structures in order to support Multiple Master fonts.               */
57
58
59  /*************************************************************************/
60  /*                                                                       */
61  /* <Struct>                                                              */
62  /*    PS_FontInfoRec                                                     */
63  /*                                                                       */
64  /* <Description>                                                         */
65  /*    A structure used to model a Type~1 or Type~2 FontInfo dictionary.  */
66  /*    Note that for Multiple Master fonts, each instance has its own     */
67  /*    FontInfo dictionary.                                               */
68  /*                                                                       */
69  typedef struct  PS_FontInfoRec_
70  {
71    FT_String*  version;
72    FT_String*  notice;
73    FT_String*  full_name;
74    FT_String*  family_name;
75    FT_String*  weight;
76    FT_Long     italic_angle;
77    FT_Bool     is_fixed_pitch;
78    FT_Short    underline_position;
79    FT_UShort   underline_thickness;
80
81    /* since 2.3.8 */
82
83    FT_UShort   fs_type;
84
85  } PS_FontInfoRec;
86
87
88  /*************************************************************************/
89  /*                                                                       */
90  /* <Struct>                                                              */
91  /*    PS_FontInfo                                                        */
92  /*                                                                       */
93  /* <Description>                                                         */
94  /*    A handle to a @PS_FontInfoRec structure.                           */
95  /*                                                                       */
96  typedef struct PS_FontInfoRec_*  PS_FontInfo;
97
98
99  /*************************************************************************/
100  /*                                                                       */
101  /* <Struct>                                                              */
102  /*    T1_FontInfo                                                        */
103  /*                                                                       */
104  /* <Description>                                                         */
105  /*    This type is equivalent to @PS_FontInfoRec.  It is deprecated but  */
106  /*    kept to maintain source compatibility between various versions of  */
107  /*    FreeType.                                                          */
108  /*                                                                       */
109  typedef PS_FontInfoRec  T1_FontInfo;
110
111
112  /*************************************************************************/
113  /*                                                                       */
114  /* <Struct>                                                              */
115  /*    PS_PrivateRec                                                      */
116  /*                                                                       */
117  /* <Description>                                                         */
118  /*    A structure used to model a Type~1 or Type~2 private dictionary.   */
119  /*    Note that for Multiple Master fonts, each instance has its own     */
120  /*    Private dictionary.                                                */
121  /*                                                                       */
122  typedef struct  PS_PrivateRec_
123  {
124    FT_Int     unique_id;
125    FT_Int     lenIV;
126
127    FT_Byte    num_blue_values;
128    FT_Byte    num_other_blues;
129    FT_Byte    num_family_blues;
130    FT_Byte    num_family_other_blues;
131
132    FT_Short   blue_values[14];
133    FT_Short   other_blues[10];
134
135    FT_Short   family_blues      [14];
136    FT_Short   family_other_blues[10];
137
138    FT_Fixed   blue_scale;
139    FT_Int     blue_shift;
140    FT_Int     blue_fuzz;
141
142    FT_UShort  standard_width[1];
143    FT_UShort  standard_height[1];
144
145    FT_Byte    num_snap_widths;
146    FT_Byte    num_snap_heights;
147    FT_Bool    force_bold;
148    FT_Bool    round_stem_up;
149
150    FT_Short   snap_widths [13];  /* including std width  */
151    FT_Short   snap_heights[13];  /* including std height */
152
153    FT_Fixed   expansion_factor;
154
155    FT_Long    language_group;
156    FT_Long    password;
157
158    FT_Short   min_feature[2];
159
160  } PS_PrivateRec;
161
162
163  /*************************************************************************/
164  /*                                                                       */
165  /* <Struct>                                                              */
166  /*    PS_Private                                                         */
167  /*                                                                       */
168  /* <Description>                                                         */
169  /*    A handle to a @PS_PrivateRec structure.                            */
170  /*                                                                       */
171  typedef struct PS_PrivateRec_*  PS_Private;
172
173
174  /*************************************************************************/
175  /*                                                                       */
176  /* <Struct>                                                              */
177  /*    T1_Private                                                         */
178  /*                                                                       */
179  /* <Description>                                                         */
180  /*   This type is equivalent to @PS_PrivateRec.  It is deprecated but    */
181  /*   kept to maintain source compatibility between various versions of   */
182  /*   FreeType.                                                           */
183  /*                                                                       */
184  typedef PS_PrivateRec  T1_Private;
185
186
187  /*************************************************************************/
188  /*                                                                       */
189  /* <Enum>                                                                */
190  /*    T1_Blend_Flags                                                     */
191  /*                                                                       */
192  /* <Description>                                                         */
193  /*    A set of flags used to indicate which fields are present in a      */
194  /*    given blend dictionary (font info or private).  Used to support    */
195  /*    Multiple Masters fonts.                                            */
196  /*                                                                       */
197  typedef enum  T1_Blend_Flags_
198  {
199    /*# required fields in a FontInfo blend dictionary */
200    T1_BLEND_UNDERLINE_POSITION = 0,
201    T1_BLEND_UNDERLINE_THICKNESS,
202    T1_BLEND_ITALIC_ANGLE,
203
204    /*# required fields in a Private blend dictionary */
205    T1_BLEND_BLUE_VALUES,
206    T1_BLEND_OTHER_BLUES,
207    T1_BLEND_STANDARD_WIDTH,
208    T1_BLEND_STANDARD_HEIGHT,
209    T1_BLEND_STEM_SNAP_WIDTHS,
210    T1_BLEND_STEM_SNAP_HEIGHTS,
211    T1_BLEND_BLUE_SCALE,
212    T1_BLEND_BLUE_SHIFT,
213    T1_BLEND_FAMILY_BLUES,
214    T1_BLEND_FAMILY_OTHER_BLUES,
215    T1_BLEND_FORCE_BOLD,
216
217    /*# never remove */
218    T1_BLEND_MAX
219
220  } T1_Blend_Flags;
221
222  /* */
223
224
225  /*# backwards compatible definitions */
226#define t1_blend_underline_position   T1_BLEND_UNDERLINE_POSITION
227#define t1_blend_underline_thickness  T1_BLEND_UNDERLINE_THICKNESS
228#define t1_blend_italic_angle         T1_BLEND_ITALIC_ANGLE
229#define t1_blend_blue_values          T1_BLEND_BLUE_VALUES
230#define t1_blend_other_blues          T1_BLEND_OTHER_BLUES
231#define t1_blend_standard_widths      T1_BLEND_STANDARD_WIDTH
232#define t1_blend_standard_height      T1_BLEND_STANDARD_HEIGHT
233#define t1_blend_stem_snap_widths     T1_BLEND_STEM_SNAP_WIDTHS
234#define t1_blend_stem_snap_heights    T1_BLEND_STEM_SNAP_HEIGHTS
235#define t1_blend_blue_scale           T1_BLEND_BLUE_SCALE
236#define t1_blend_blue_shift           T1_BLEND_BLUE_SHIFT
237#define t1_blend_family_blues         T1_BLEND_FAMILY_BLUES
238#define t1_blend_family_other_blues   T1_BLEND_FAMILY_OTHER_BLUES
239#define t1_blend_force_bold           T1_BLEND_FORCE_BOLD
240#define t1_blend_max                  T1_BLEND_MAX
241
242
243  /* maximum number of Multiple Masters designs, as defined in the spec */
244#define T1_MAX_MM_DESIGNS     16
245
246  /* maximum number of Multiple Masters axes, as defined in the spec */
247#define T1_MAX_MM_AXIS        4
248
249  /* maximum number of elements in a design map */
250#define T1_MAX_MM_MAP_POINTS  20
251
252
253  /* this structure is used to store the BlendDesignMap entry for an axis */
254  typedef struct  PS_DesignMap_
255  {
256    FT_Byte    num_points;
257    FT_Long*   design_points;
258    FT_Fixed*  blend_points;
259
260  } PS_DesignMapRec, *PS_DesignMap;
261
262  /* backwards-compatible definition */
263  typedef PS_DesignMapRec  T1_DesignMap;
264
265
266  typedef struct  PS_BlendRec_
267  {
268    FT_UInt          num_designs;
269    FT_UInt          num_axis;
270
271    FT_String*       axis_names[T1_MAX_MM_AXIS];
272    FT_Fixed*        design_pos[T1_MAX_MM_DESIGNS];
273    PS_DesignMapRec  design_map[T1_MAX_MM_AXIS];
274
275    FT_Fixed*        weight_vector;
276    FT_Fixed*        default_weight_vector;
277
278    PS_FontInfo      font_infos[T1_MAX_MM_DESIGNS + 1];
279    PS_Private       privates  [T1_MAX_MM_DESIGNS + 1];
280
281    FT_ULong         blend_bitflags;
282
283    FT_BBox*         bboxes    [T1_MAX_MM_DESIGNS + 1];
284
285    /* since 2.3.0 */
286
287    /* undocumented, optional: the default design instance;   */
288    /* corresponds to default_weight_vector --                */
289    /* num_default_design_vector == 0 means it is not present */
290    /* in the font and associated metrics files               */
291    FT_UInt          default_design_vector[T1_MAX_MM_DESIGNS];
292    FT_UInt          num_default_design_vector;
293
294  } PS_BlendRec, *PS_Blend;
295
296
297  /* backwards-compatible definition */
298  typedef PS_BlendRec  T1_Blend;
299
300
301  /*************************************************************************/
302  /*                                                                       */
303  /* <Struct>                                                              */
304  /*    CID_FaceDictRec                                                    */
305  /*                                                                       */
306  /* <Description>                                                         */
307  /*    A structure used to represent data in a CID top-level dictionary.  */
308  /*                                                                       */
309  typedef struct  CID_FaceDictRec_
310  {
311    PS_PrivateRec  private_dict;
312
313    FT_UInt        len_buildchar;
314    FT_Fixed       forcebold_threshold;
315    FT_Pos         stroke_width;
316    FT_Fixed       expansion_factor;
317
318    FT_Byte        paint_type;
319    FT_Byte        font_type;
320    FT_Matrix      font_matrix;
321    FT_Vector      font_offset;
322
323    FT_UInt        num_subrs;
324    FT_ULong       subrmap_offset;
325    FT_Int         sd_bytes;
326
327  } CID_FaceDictRec;
328
329
330  /*************************************************************************/
331  /*                                                                       */
332  /* <Struct>                                                              */
333  /*    CID_FaceDict                                                       */
334  /*                                                                       */
335  /* <Description>                                                         */
336  /*    A handle to a @CID_FaceDictRec structure.                          */
337  /*                                                                       */
338  typedef struct CID_FaceDictRec_*  CID_FaceDict;
339
340  /* */
341
342
343  /* backwards-compatible definition */
344  typedef CID_FaceDictRec  CID_FontDict;
345
346
347  /*************************************************************************/
348  /*                                                                       */
349  /* <Struct>                                                              */
350  /*    CID_FaceInfoRec                                                    */
351  /*                                                                       */
352  /* <Description>                                                         */
353  /*    A structure used to represent CID Face information.                */
354  /*                                                                       */
355  typedef struct  CID_FaceInfoRec_
356  {
357    FT_String*      cid_font_name;
358    FT_Fixed        cid_version;
359    FT_Int          cid_font_type;
360
361    FT_String*      registry;
362    FT_String*      ordering;
363    FT_Int          supplement;
364
365    PS_FontInfoRec  font_info;
366    FT_BBox         font_bbox;
367    FT_ULong        uid_base;
368
369    FT_Int          num_xuid;
370    FT_ULong        xuid[16];
371
372    FT_ULong        cidmap_offset;
373    FT_Int          fd_bytes;
374    FT_Int          gd_bytes;
375    FT_ULong        cid_count;
376
377    FT_Int          num_dicts;
378    CID_FaceDict    font_dicts;
379
380    FT_ULong        data_offset;
381
382  } CID_FaceInfoRec;
383
384
385  /*************************************************************************/
386  /*                                                                       */
387  /* <Struct>                                                              */
388  /*    CID_FaceInfo                                                       */
389  /*                                                                       */
390  /* <Description>                                                         */
391  /*    A handle to a @CID_FaceInfoRec structure.                          */
392  /*                                                                       */
393  typedef struct CID_FaceInfoRec_*  CID_FaceInfo;
394
395
396  /*************************************************************************/
397  /*                                                                       */
398  /* <Struct>                                                              */
399  /*    CID_Info                                                           */
400  /*                                                                       */
401  /* <Description>                                                         */
402  /*   This type is equivalent to @CID_FaceInfoRec.  It is deprecated but  */
403  /*   kept to maintain source compatibility between various versions of   */
404  /*   FreeType.                                                           */
405  /*                                                                       */
406  typedef CID_FaceInfoRec  CID_Info;
407
408
409  /************************************************************************
410   *
411   * @function:
412   *    FT_Has_PS_Glyph_Names
413   *
414   * @description:
415   *    Return true if a given face provides reliable PostScript glyph
416   *    names.  This is similar to using the @FT_HAS_GLYPH_NAMES macro,
417   *    except that certain fonts (mostly TrueType) contain incorrect
418   *    glyph name tables.
419   *
420   *    When this function returns true, the caller is sure that the glyph
421   *    names returned by @FT_Get_Glyph_Name are reliable.
422   *
423   * @input:
424   *    face ::
425   *       face handle
426   *
427   * @return:
428   *    Boolean.  True if glyph names are reliable.
429   *
430   */
431  FT_EXPORT( FT_Int )
432  FT_Has_PS_Glyph_Names( FT_Face  face );
433
434
435  /************************************************************************
436   *
437   * @function:
438   *    FT_Get_PS_Font_Info
439   *
440   * @description:
441   *    Retrieve the @PS_FontInfoRec structure corresponding to a given
442   *    PostScript font.
443   *
444   * @input:
445   *    face ::
446   *       PostScript face handle.
447   *
448   * @output:
449   *    afont_info ::
450   *       Output font info structure pointer.
451   *
452   * @return:
453   *    FreeType error code.  0~means success.
454   *
455   * @note:
456   *    The string pointers within the font info structure are owned by
457   *    the face and don't need to be freed by the caller.
458   *
459   *    If the font's format is not PostScript-based, this function will
460   *    return the `FT_Err_Invalid_Argument' error code.
461   *
462   */
463  FT_EXPORT( FT_Error )
464  FT_Get_PS_Font_Info( FT_Face      face,
465                       PS_FontInfo  afont_info );
466
467
468  /************************************************************************
469   *
470   * @function:
471   *    FT_Get_PS_Font_Private
472   *
473   * @description:
474   *    Retrieve the @PS_PrivateRec structure corresponding to a given
475   *    PostScript font.
476   *
477   * @input:
478   *    face ::
479   *       PostScript face handle.
480   *
481   * @output:
482   *    afont_private ::
483   *       Output private dictionary structure pointer.
484   *
485   * @return:
486   *    FreeType error code.  0~means success.
487   *
488   * @note:
489   *    The string pointers within the font info structure are owned by
490   *    the face and don't need to be freed by the caller.
491   *
492   *    If the font's format is not PostScript-based, this function will
493   *    return the `FT_Err_Invalid_Argument' error code.
494   *
495   */
496  FT_EXPORT( FT_Error )
497  FT_Get_PS_Font_Private( FT_Face     face,
498                          PS_Private  afont_private );
499
500  /* */
501
502
503FT_END_HEADER
504
505#endif /* __T1TABLES_H__ */
506
507
508/* END */
Note: See TracBrowser for help on using the repository browser.