← Back to branch summary

~ubuntu-branches/ubuntu/wily/hedgewars/wily

« back to all changes in this revision

Viewing changes to misc/libfreetype/include/freetype/ftmm.h

  • Committer: Package Import Robot
  • Author(s): Dmitry E. Oboukhov
  • Date: 2011-09-23 10:16:55 UTC
  • mfrom: (1.2.11 upstream)
  • Revision ID: package-import@ubuntu.com-20110923101655-3977th2gc5n0a3pv
Tags: 0.9.16-1
* New upstream version.
 + Downloadable content! Simply click to install any content.
   New voices, hats, maps, themes, translations, music, scripts...
   Hedgewars is now more customisable than ever before! As time goes
   by we will be soliciting community content to feature on this page,
   so remember to check it from time to time. If you decide you want
   to go back to standard Hedgewars, just remove the Data directory
   from your Hedgewars config directory.
 + 3-D rendering! Diorama-like rendering of the game in a variety
   of 3D modes. Let us know which ones work best for you, we didn't
   really have the equipment to test them all.
 + Resizable game window.
 + New utilities! The Time Box will remove one of your hedgehogs
   from the game for a while, protecting from attack until it returns,
   somewhere else on the map. Land spray will allow you to build bridges,
   seal up holes, or just make life unpleasant for your enemies.
 + New single player: Bamboo Thicket, That Sinking Feeling, Newton and
   the Tree and multi-player: The Specialists, Space Invaders,
   Racer - scripts! And a ton more script hooks for scripters
 + New twists on old weapons. Drill strike, seduction and fire have
   been adjusted. Defective mines have been added, rope can attach to
   hogs/crates/barrels again, grenades now have variable bounce (use
   precise key + 1-5). Portal gun is now more usable in flight and
   all game actions are a lot faster.
 + New theme - Golf, dozens of new community hats and a new
   localised Default voice, Ukranian.

Show diffs side-by-side

added added

removed removed

Lines of Context:
misc/libfreetype/include/freetype/ftmm.h
 
1
/***************************************************************************/
 
2
/*                                                                         */
 
3
/*  ftmm.h                                                                 */
 
4
/*                                                                         */
 
5
/*    FreeType Multiple Master font interface (specification).             */
 
6
/*                                                                         */
 
7
/*  Copyright 1996-2001, 2003, 2004, 2006, 2009 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
#ifndef __FTMM_H__
 
20
#define __FTMM_H__
 
21
 
 
22
 
 
23
#include <ft2build.h>
 
24
#include FT_TYPE1_TABLES_H
 
25
 
 
26
 
 
27
FT_BEGIN_HEADER
 
28
 
 
29
 
 
30
  /*************************************************************************/
 
31
  /*                                                                       */
 
32
  /* <Section>                                                             */
 
33
  /*    multiple_masters                                                   */
 
34
  /*                                                                       */
 
35
  /* <Title>                                                               */
 
36
  /*    Multiple Masters                                                   */
 
37
  /*                                                                       */
 
38
  /* <Abstract>                                                            */
 
39
  /*    How to manage Multiple Masters fonts.                              */
 
40
  /*                                                                       */
 
41
  /* <Description>                                                         */
 
42
  /*    The following types and functions are used to manage Multiple      */
 
43
  /*    Master fonts, i.e., the selection of specific design instances by  */
 
44
  /*    setting design axis coordinates.                                   */
 
45
  /*                                                                       */
 
46
  /*    George Williams has extended this interface to make it work with   */
 
47
  /*    both Type~1 Multiple Masters fonts and GX distortable (var)        */
 
48
  /*    fonts.  Some of these routines only work with MM fonts, others     */
 
49
  /*    will work with both types.  They are similar enough that a         */
 
50
  /*    consistent interface makes sense.                                  */
 
51
  /*                                                                       */
 
52
  /*************************************************************************/
 
53
 
 
54
 
 
55
  /*************************************************************************/
 
56
  /*                                                                       */
 
57
  /* <Struct>                                                              */
 
58
  /*    FT_MM_Axis                                                         */
 
59
  /*                                                                       */
 
60
  /* <Description>                                                         */
 
61
  /*    A simple structure used to model a given axis in design space for  */
 
62
  /*    Multiple Masters fonts.                                            */
 
63
  /*                                                                       */
 
64
  /*    This structure can't be used for GX var fonts.                     */
 
65
  /*                                                                       */
 
66
  /* <Fields>                                                              */
 
67
  /*    name    :: The axis's name.                                        */
 
68
  /*                                                                       */
 
69
  /*    minimum :: The axis's minimum design coordinate.                   */
 
70
  /*                                                                       */
 
71
  /*    maximum :: The axis's maximum design coordinate.                   */
 
72
  /*                                                                       */
 
73
  typedef struct  FT_MM_Axis_
 
74
  {
 
75
    FT_String*  name;
 
76
    FT_Long     minimum;
 
77
    FT_Long     maximum;
 
78
 
 
79
  } FT_MM_Axis;
 
80
 
 
81
 
 
82
  /*************************************************************************/
 
83
  /*                                                                       */
 
84
  /* <Struct>                                                              */
 
85
  /*    FT_Multi_Master                                                    */
 
86
  /*                                                                       */
 
87
  /* <Description>                                                         */
 
88
  /*    A structure used to model the axes and space of a Multiple Masters */
 
89
  /*    font.                                                              */
 
90
  /*                                                                       */
 
91
  /*    This structure can't be used for GX var fonts.                     */
 
92
  /*                                                                       */
 
93
  /* <Fields>                                                              */
 
94
  /*    num_axis    :: Number of axes.  Cannot exceed~4.                   */
 
95
  /*                                                                       */
 
96
  /*    num_designs :: Number of designs; should be normally 2^num_axis    */
 
97
  /*                   even though the Type~1 specification strangely      */
 
98
  /*                   allows for intermediate designs to be present. This */
 
99
  /*                   number cannot exceed~16.                            */
 
100
  /*                                                                       */
 
101
  /*    axis        :: A table of axis descriptors.                        */
 
102
  /*                                                                       */
 
103
  typedef struct  FT_Multi_Master_
 
104
  {
 
105
    FT_UInt     num_axis;
 
106
    FT_UInt     num_designs;
 
107
    FT_MM_Axis  axis[T1_MAX_MM_AXIS];
 
108
 
 
109
  } FT_Multi_Master;
 
110
 
 
111
 
 
112
  /*************************************************************************/
 
113
  /*                                                                       */
 
114
  /* <Struct>                                                              */
 
115
  /*    FT_Var_Axis                                                        */
 
116
  /*                                                                       */
 
117
  /* <Description>                                                         */
 
118
  /*    A simple structure used to model a given axis in design space for  */
 
119
  /*    Multiple Masters and GX var fonts.                                 */
 
120
  /*                                                                       */
 
121
  /* <Fields>                                                              */
 
122
  /*    name    :: The axis's name.                                        */
 
123
  /*               Not always meaningful for GX.                           */
 
124
  /*                                                                       */
 
125
  /*    minimum :: The axis's minimum design coordinate.                   */
 
126
  /*                                                                       */
 
127
  /*    def     :: The axis's default design coordinate.                   */
 
128
  /*               FreeType computes meaningful default values for MM; it  */
 
129
  /*               is then an integer value, not in 16.16 format.          */
 
130
  /*                                                                       */
 
131
  /*    maximum :: The axis's maximum design coordinate.                   */
 
132
  /*                                                                       */
 
133
  /*    tag     :: The axis's tag (the GX equivalent to `name').           */
 
134
  /*               FreeType provides default values for MM if possible.    */
 
135
  /*                                                                       */
 
136
  /*    strid   :: The entry in `name' table (another GX version of        */
 
137
  /*               `name').                                                */
 
138
  /*               Not meaningful for MM.                                  */
 
139
  /*                                                                       */
 
140
  typedef struct  FT_Var_Axis_
 
141
  {
 
142
    FT_String*  name;
 
143
 
 
144
    FT_Fixed    minimum;
 
145
    FT_Fixed    def;
 
146
    FT_Fixed    maximum;
 
147
 
 
148
    FT_ULong    tag;
 
149
    FT_UInt     strid;
 
150
 
 
151
  } FT_Var_Axis;
 
152
 
 
153
 
 
154
  /*************************************************************************/
 
155
  /*                                                                       */
 
156
  /* <Struct>                                                              */
 
157
  /*    FT_Var_Named_Style                                                 */
 
158
  /*                                                                       */
 
159
  /* <Description>                                                         */
 
160
  /*    A simple structure used to model a named style in a GX var font.   */
 
161
  /*                                                                       */
 
162
  /*    This structure can't be used for MM fonts.                         */
 
163
  /*                                                                       */
 
164
  /* <Fields>                                                              */
 
165
  /*    coords :: The design coordinates for this style.                   */
 
166
  /*              This is an array with one entry for each axis.           */
 
167
  /*                                                                       */
 
168
  /*    strid  :: The entry in `name' table identifying this style.        */
 
169
  /*                                                                       */
 
170
  typedef struct  FT_Var_Named_Style_
 
171
  {
 
172
    FT_Fixed*  coords;
 
173
    FT_UInt    strid;
 
174
 
 
175
  } FT_Var_Named_Style;
 
176
 
 
177
 
 
178
  /*************************************************************************/
 
179
  /*                                                                       */
 
180
  /* <Struct>                                                              */
 
181
  /*    FT_MM_Var                                                          */
 
182
  /*                                                                       */
 
183
  /* <Description>                                                         */
 
184
  /*    A structure used to model the axes and space of a Multiple Masters */
 
185
  /*    or GX var distortable font.                                        */
 
186
  /*                                                                       */
 
187
  /*    Some fields are specific to one format and not to the other.       */
 
188
  /*                                                                       */
 
189
  /* <Fields>                                                              */
 
190
  /*    num_axis        :: The number of axes.  The maximum value is~4 for */
 
191
  /*                       MM; no limit in GX.                             */
 
192
  /*                                                                       */
 
193
  /*    num_designs     :: The number of designs; should be normally       */
 
194
  /*                       2^num_axis for MM fonts.  Not meaningful for GX */
 
195
  /*                       (where every glyph could have a different       */
 
196
  /*                       number of designs).                             */
 
197
  /*                                                                       */
 
198
  /*    num_namedstyles :: The number of named styles; only meaningful for */
 
199
  /*                       GX which allows certain design coordinates to   */
 
200
  /*                       have a string ID (in the `name' table)          */
 
201
  /*                       associated with them.  The font can tell the    */
 
202
  /*                       user that, for example, Weight=1.5 is `Bold'.   */
 
203
  /*                                                                       */
 
204
  /*    axis            :: A table of axis descriptors.                    */
 
205
  /*                       GX fonts contain slightly more data than MM.    */
 
206
  /*                                                                       */
 
207
  /*    namedstyles     :: A table of named styles.                        */
 
208
  /*                       Only meaningful with GX.                        */
 
209
  /*                                                                       */
 
210
  typedef struct  FT_MM_Var_
 
211
  {
 
212
    FT_UInt              num_axis;
 
213
    FT_UInt              num_designs;
 
214
    FT_UInt              num_namedstyles;
 
215
    FT_Var_Axis*         axis;
 
216
    FT_Var_Named_Style*  namedstyle;
 
217
 
 
218
  } FT_MM_Var;
 
219
 
 
220
 
 
221
  /* */
 
222
 
 
223
 
 
224
  /*************************************************************************/
 
225
  /*                                                                       */
 
226
  /* <Function>                                                            */
 
227
  /*    FT_Get_Multi_Master                                                */
 
228
  /*                                                                       */
 
229
  /* <Description>                                                         */
 
230
  /*    Retrieve the Multiple Master descriptor of a given font.           */
 
231
  /*                                                                       */
 
232
  /*    This function can't be used with GX fonts.                         */
 
233
  /*                                                                       */
 
234
  /* <Input>                                                               */
 
235
  /*    face    :: A handle to the source face.                            */
 
236
  /*                                                                       */
 
237
  /* <Output>                                                              */
 
238
  /*    amaster :: The Multiple Masters descriptor.                        */
 
239
  /*                                                                       */
 
240
  /* <Return>                                                              */
 
241
  /*    FreeType error code.  0~means success.                             */
 
242
  /*                                                                       */
 
243
  FT_EXPORT( FT_Error )
 
244
  FT_Get_Multi_Master( FT_Face           face,
 
245
                       FT_Multi_Master  *amaster );
 
246
 
 
247
 
 
248
  /*************************************************************************/
 
249
  /*                                                                       */
 
250
  /* <Function>                                                            */
 
251
  /*    FT_Get_MM_Var                                                      */
 
252
  /*                                                                       */
 
253
  /* <Description>                                                         */
 
254
  /*    Retrieve the Multiple Master/GX var descriptor of a given font.    */
 
255
  /*                                                                       */
 
256
  /* <Input>                                                               */
 
257
  /*    face    :: A handle to the source face.                            */
 
258
  /*                                                                       */
 
259
  /* <Output>                                                              */
 
260
  /*    amaster :: The Multiple Masters/GX var descriptor.                 */
 
261
  /*               Allocates a data structure, which the user must free    */
 
262
  /*               (a single call to FT_FREE will do it).                  */
 
263
  /*                                                                       */
 
264
  /* <Return>                                                              */
 
265
  /*    FreeType error code.  0~means success.                             */
 
266
  /*                                                                       */
 
267
  FT_EXPORT( FT_Error )
 
268
  FT_Get_MM_Var( FT_Face      face,
 
269
                 FT_MM_Var*  *amaster );
 
270
 
 
271
 
 
272
  /*************************************************************************/
 
273
  /*                                                                       */
 
274
  /* <Function>                                                            */
 
275
  /*    FT_Set_MM_Design_Coordinates                                       */
 
276
  /*                                                                       */
 
277
  /* <Description>                                                         */
 
278
  /*    For Multiple Masters fonts, choose an interpolated font design     */
 
279
  /*    through design coordinates.                                        */
 
280
  /*                                                                       */
 
281
  /*    This function can't be used with GX fonts.                         */
 
282
  /*                                                                       */
 
283
  /* <InOut>                                                               */
 
284
  /*    face       :: A handle to the source face.                         */
 
285
  /*                                                                       */
 
286
  /* <Input>                                                               */
 
287
  /*    num_coords :: The number of design coordinates (must be equal to   */
 
288
  /*                  the number of axes in the font).                     */
 
289
  /*                                                                       */
 
290
  /*    coords     :: An array of design coordinates.                      */
 
291
  /*                                                                       */
 
292
  /* <Return>                                                              */
 
293
  /*    FreeType error code.  0~means success.                             */
 
294
  /*                                                                       */
 
295
  FT_EXPORT( FT_Error )
 
296
  FT_Set_MM_Design_Coordinates( FT_Face   face,
 
297
                                FT_UInt   num_coords,
 
298
                                FT_Long*  coords );
 
299
 
 
300
 
 
301
  /*************************************************************************/
 
302
  /*                                                                       */
 
303
  /* <Function>                                                            */
 
304
  /*    FT_Set_Var_Design_Coordinates                                      */
 
305
  /*                                                                       */
 
306
  /* <Description>                                                         */
 
307
  /*    For Multiple Master or GX Var fonts, choose an interpolated font   */
 
308
  /*    design through design coordinates.                                 */
 
309
  /*                                                                       */
 
310
  /* <InOut>                                                               */
 
311
  /*    face       :: A handle to the source face.                         */
 
312
  /*                                                                       */
 
313
  /* <Input>                                                               */
 
314
  /*    num_coords :: The number of design coordinates (must be equal to   */
 
315
  /*                  the number of axes in the font).                     */
 
316
  /*                                                                       */
 
317
  /*    coords     :: An array of design coordinates.                      */
 
318
  /*                                                                       */
 
319
  /* <Return>                                                              */
 
320
  /*    FreeType error code.  0~means success.                             */
 
321
  /*                                                                       */
 
322
  FT_EXPORT( FT_Error )
 
323
  FT_Set_Var_Design_Coordinates( FT_Face    face,
 
324
                                 FT_UInt    num_coords,
 
325
                                 FT_Fixed*  coords );
 
326
 
 
327
 
 
328
  /*************************************************************************/
 
329
  /*                                                                       */
 
330
  /* <Function>                                                            */
 
331
  /*    FT_Set_MM_Blend_Coordinates                                        */
 
332
  /*                                                                       */
 
333
  /* <Description>                                                         */
 
334
  /*    For Multiple Masters and GX var fonts, choose an interpolated font */
 
335
  /*    design through normalized blend coordinates.                       */
 
336
  /*                                                                       */
 
337
  /* <InOut>                                                               */
 
338
  /*    face       :: A handle to the source face.                         */
 
339
  /*                                                                       */
 
340
  /* <Input>                                                               */
 
341
  /*    num_coords :: The number of design coordinates (must be equal to   */
 
342
  /*                  the number of axes in the font).                     */
 
343
  /*                                                                       */
 
344
  /*    coords     :: The design coordinates array (each element must be   */
 
345
  /*                  between 0 and 1.0).                                  */
 
346
  /*                                                                       */
 
347
  /* <Return>                                                              */
 
348
  /*    FreeType error code.  0~means success.                             */
 
349
  /*                                                                       */
 
350
  FT_EXPORT( FT_Error )
 
351
  FT_Set_MM_Blend_Coordinates( FT_Face    face,
 
352
                               FT_UInt    num_coords,
 
353
                               FT_Fixed*  coords );
 
354
 
 
355
 
 
356
  /*************************************************************************/
 
357
  /*                                                                       */
 
358
  /* <Function>                                                            */
 
359
  /*    FT_Set_Var_Blend_Coordinates                                       */
 
360
  /*                                                                       */
 
361
  /* <Description>                                                         */
 
362
  /*    This is another name of @FT_Set_MM_Blend_Coordinates.              */
 
363
  /*                                                                       */
 
364
  FT_EXPORT( FT_Error )
 
365
  FT_Set_Var_Blend_Coordinates( FT_Face    face,
 
366
                                FT_UInt    num_coords,
 
367
                                FT_Fixed*  coords );
 
368
 
 
369
 
 
370
  /* */
 
371
 
 
372
 
 
373
FT_END_HEADER
 
374
 
 
375
#endif /* __FTMM_H__ */
 
376
 
 
377
 
 
378
/* END */