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

Last change on this file since 159 was 150, checked in by Eugene Romanenko, 15 years ago

update freetype to 2.2.1

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