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

Last change on this file since 251 was 251, checked in by Eugene Romanenko, 13 years ago

PDF plugin: freetype library updated to version 2.3.5

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