source: trunk/poppler/freetype-2.1.10/include/freetype/t1tables.h @ 2

Last change on this file since 2 was 2, checked in by Eugene Romanenko, 16 years ago

First import

File size: 15.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.                                                          */
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  /*# backwards compatible definitions */
198#define t1_blend_underline_position   T1_BLEND_UNDERLINE_POSITION
199#define t1_blend_underline_thickness  T1_BLEND_UNDERLINE_THICKNESS
200#define t1_blend_italic_angle         T1_BLEND_ITALIC_ANGLE
201#define t1_blend_blue_values          T1_BLEND_BLUE_VALUES
202#define t1_blend_other_blues          T1_BLEND_OTHER_BLUES
203#define t1_blend_standard_widths      T1_BLEND_STANDARD_WIDTH
204#define t1_blend_standard_height      T1_BLEND_STANDARD_HEIGHT
205#define t1_blend_stem_snap_widths     T1_BLEND_STEM_SNAP_WIDTHS
206#define t1_blend_stem_snap_heights    T1_BLEND_STEM_SNAP_HEIGHTS
207#define t1_blend_blue_scale           T1_BLEND_BLUE_SCALE
208#define t1_blend_blue_shift           T1_BLEND_BLUE_SHIFT
209#define t1_blend_family_blues         T1_BLEND_FAMILY_BLUES
210#define t1_blend_family_other_blues   T1_BLEND_FAMILY_OTHER_BLUES
211#define t1_blend_force_bold           T1_BLEND_FORCE_BOLD
212#define t1_blend_max                  T1_BLEND_MAX
213
214
215  /* maximum number of Multiple Masters designs, as defined in the spec */
216#define T1_MAX_MM_DESIGNS     16
217
218  /* maximum number of Multiple Masters axes, as defined in the spec */
219#define T1_MAX_MM_AXIS        4
220
221  /* maximum number of elements in a design map */
222#define T1_MAX_MM_MAP_POINTS  20
223
224
225  /* this structure is used to store the BlendDesignMap entry for an axis */
226  typedef struct  PS_DesignMap_
227  {
228    FT_Byte    num_points;
229    FT_Long*   design_points;
230    FT_Fixed*  blend_points;
231
232  } PS_DesignMapRec, *PS_DesignMap;
233
234  /* backwards-compatible definition */
235  typedef PS_DesignMapRec  T1_DesignMap;
236
237
238  typedef struct  PS_BlendRec_
239  {
240    FT_UInt          num_designs;
241    FT_UInt          num_axis;
242
243    FT_String*       axis_names[T1_MAX_MM_AXIS];
244    FT_Fixed*        design_pos[T1_MAX_MM_DESIGNS];
245    PS_DesignMapRec  design_map[T1_MAX_MM_AXIS];
246
247    FT_Fixed*        weight_vector;
248    FT_Fixed*        default_weight_vector;
249
250    PS_FontInfo      font_infos[T1_MAX_MM_DESIGNS + 1];
251    PS_Private       privates  [T1_MAX_MM_DESIGNS + 1];
252
253    FT_ULong         blend_bitflags;
254
255    FT_BBox*         bboxes    [T1_MAX_MM_DESIGNS + 1];
256
257  } PS_BlendRec, *PS_Blend;
258
259
260  /* backwards-compatible definition */
261  typedef PS_BlendRec  T1_Blend;
262
263
264  typedef struct  CID_FaceDictRec_
265  {
266    PS_PrivateRec  private_dict;
267
268    FT_UInt        len_buildchar;
269    FT_Fixed       forcebold_threshold;
270    FT_Pos         stroke_width;
271    FT_Fixed       expansion_factor;
272
273    FT_Byte        paint_type;
274    FT_Byte        font_type;
275    FT_Matrix      font_matrix;
276    FT_Vector      font_offset;
277
278    FT_UInt        num_subrs;
279    FT_ULong       subrmap_offset;
280    FT_Int         sd_bytes;
281
282  } CID_FaceDictRec, *CID_FaceDict;
283
284
285  /* backwards-compatible definition */
286  typedef CID_FaceDictRec  CID_FontDict;
287
288
289  typedef struct  CID_FaceInfoRec_
290  {
291    FT_String*      cid_font_name;
292    FT_Fixed        cid_version;
293    FT_Int          cid_font_type;
294
295    FT_String*      registry;
296    FT_String*      ordering;
297    FT_Int          supplement;
298
299    PS_FontInfoRec  font_info;
300    FT_BBox         font_bbox;
301    FT_ULong        uid_base;
302
303    FT_Int          num_xuid;
304    FT_ULong        xuid[16];
305
306    FT_ULong        cidmap_offset;
307    FT_Int          fd_bytes;
308    FT_Int          gd_bytes;
309    FT_ULong        cid_count;
310
311    FT_Int          num_dicts;
312    CID_FaceDict    font_dicts;
313
314    FT_ULong        data_offset;
315
316  } CID_FaceInfoRec, *CID_FaceInfo;
317
318
319  /*************************************************************************/
320  /*                                                                       */
321  /* <Struct>                                                              */
322  /*    CID_Info                                                           */
323  /*                                                                       */
324  /* <Description>                                                         */
325  /*   This type is equivalent to CID_FaceInfoRec.  It is deprecated but   */
326  /*   kept to maintain source compatibility between various versions of   */
327  /*   FreeType.                                                           */
328  /*                                                                       */
329  typedef CID_FaceInfoRec  CID_Info;
330
331  /* */
332
333
334 /************************************************************************
335  *
336  * @function:
337  *    FT_Has_PS_Glyph_Names
338  *
339  * @description:
340  *    Return true if a given face provides reliable Postscript glyph
341  *    names.  This is similar to using the @FT_HAS_GLYPH_NAMES macro,
342  *    except that certain fonts (mostly TrueType) contain incorrect
343  *    glyph name tables.
344  *
345  *    When this function returns true, the caller is sure that the glyph
346  *    names returned by @FT_Get_Glyph_Name are reliable.
347  *
348  * @input:
349  *    face ::
350  *       face handle
351  *
352  * @return:
353  *    Boolean.  True if glyph names are reliable.
354  */
355  FT_EXPORT( FT_Int )
356  FT_Has_PS_Glyph_Names( FT_Face  face );
357
358
359 /************************************************************************
360  *
361  * @function:
362  *    FT_Get_PS_Font_Info
363  *
364  * @description:
365  *    Retrieve the @PS_FontInfoRec structure corresponding to a given
366  *    Postscript font.
367  *
368  * @input:
369  *    face ::
370  *       Postscript face handle.
371  *
372  * @output:
373  *    afont_info ::
374  *       Output font info structure pointer.
375  *
376  * @return:
377  *    FreeType error code.  0 means success.
378  *
379  * @note:
380  *    The string pointers within the font info structure are owned by
381  *    the face and don't need to be freed by the caller.
382  *
383  *    If the font's format is not Postscript-based, this function will
384  *    return the FT_Err_Invalid_Argument error code.
385  */
386  FT_EXPORT( FT_Error )
387  FT_Get_PS_Font_Info( FT_Face          face,
388                       PS_FontInfoRec  *afont_info );
389
390
391 /************************************************************************
392  *
393  * @function:
394  *    FT_Get_PS_Font_Private
395  *
396  * @description:
397  *    Retrieve the @PS_PrivateRec structure corresponding to a given
398  *    Postscript font.
399  *
400  * @input:
401  *    face ::
402  *       Postscript face handle.
403  *
404  * @output:
405  *    afont_private ::
406  *       Output private dictionary structure pointer.
407  *
408  * @return:
409  *    FreeType error code.  0 means success.
410  *
411  * @note:
412  *    The string pointers within the font info structure are owned by
413  *    the face and don't need to be freed by the caller.
414  *
415  *    If the font's format is not Postscript-based, this function will
416  *    return the FT_Err_Invalid_Argument error code.
417  */
418  FT_EXPORT( FT_Error )
419  FT_Get_PS_Font_Private( FT_Face         face,
420                          PS_PrivateRec  *afont_private );
421
422 /* */
423
424
425
426FT_END_HEADER
427
428#endif /* __T1TABLES_H__ */
429
430
431/* END */
Note: See TracBrowser for help on using the repository browser.