← Back to branch summary

~ubuntu-branches/ubuntu/vivid/emscripten/vivid

« back to all changes in this revision

Viewing changes to tests/freetype/include/freetype/ftmac.h

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2013-05-02 13:11:51 UTC
  • Revision ID: package-import@ubuntu.com-20130502131151-q8dvteqr1ef2x7xz
Tags: upstream-1.4.1~20130504~adb56cb
Import upstream version 1.4.1~20130504~adb56cb

Show diffs side-by-side

added added

removed removed

Lines of Context:
tests/freetype/include/freetype/ftmac.h
 
1
/***************************************************************************/
 
2
/*                                                                         */
 
3
/*  ftmac.h                                                                */
 
4
/*                                                                         */
 
5
/*    Additional Mac-specific API.                                         */
 
6
/*                                                                         */
 
7
/*  Copyright 1996-2001, 2004, 2006, 2007 by                               */
 
8
/*  Just van Rossum, 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
/***************************************************************************/
 
20
/*                                                                         */
 
21
/* NOTE: Include this file after <freetype/freetype.h> and after any       */
 
22
/*       Mac-specific headers (because this header uses Mac types such as  */
 
23
/*       Handle, FSSpec, FSRef, etc.)                                      */
 
24
/*                                                                         */
 
25
/***************************************************************************/
 
26
 
 
27
 
 
28
#ifndef __FTMAC_H__
 
29
#define __FTMAC_H__
 
30
 
 
31
 
 
32
#include <ft2build.h>
 
33
 
 
34
 
 
35
FT_BEGIN_HEADER
 
36
 
 
37
 
 
38
/* gcc-3.4.1 and later can warn about functions tagged as deprecated */
 
39
#ifndef FT_DEPRECATED_ATTRIBUTE
 
40
#if defined(__GNUC__)                                               && \
 
41
    ((__GNUC__ >= 4) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 1)))
 
42
#define FT_DEPRECATED_ATTRIBUTE  __attribute__((deprecated))
 
43
#else
 
44
#define FT_DEPRECATED_ATTRIBUTE
 
45
#endif
 
46
#endif
 
47
 
 
48
 
 
49
  /*************************************************************************/
 
50
  /*                                                                       */
 
51
  /* <Section>                                                             */
 
52
  /*    mac_specific                                                       */
 
53
  /*                                                                       */
 
54
  /* <Title>                                                               */
 
55
  /*    Mac Specific Interface                                             */
 
56
  /*                                                                       */
 
57
  /* <Abstract>                                                            */
 
58
  /*    Only available on the Macintosh.                                   */
 
59
  /*                                                                       */
 
60
  /* <Description>                                                         */
 
61
  /*    The following definitions are only available if FreeType is        */
 
62
  /*    compiled on a Macintosh.                                           */
 
63
  /*                                                                       */
 
64
  /*************************************************************************/
 
65
 
 
66
 
 
67
  /*************************************************************************/
 
68
  /*                                                                       */
 
69
  /* <Function>                                                            */
 
70
  /*    FT_New_Face_From_FOND                                              */
 
71
  /*                                                                       */
 
72
  /* <Description>                                                         */
 
73
  /*    Create a new face object from a FOND resource.                     */
 
74
  /*                                                                       */
 
75
  /* <InOut>                                                               */
 
76
  /*    library    :: A handle to the library resource.                    */
 
77
  /*                                                                       */
 
78
  /* <Input>                                                               */
 
79
  /*    fond       :: A FOND resource.                                     */
 
80
  /*                                                                       */
 
81
  /*    face_index :: Only supported for the -1 `sanity check' special     */
 
82
  /*                  case.                                                */
 
83
  /*                                                                       */
 
84
  /* <Output>                                                              */
 
85
  /*    aface      :: A handle to a new face object.                       */
 
86
  /*                                                                       */
 
87
  /* <Return>                                                              */
 
88
  /*    FreeType error code.  0~means success.                             */
 
89
  /*                                                                       */
 
90
  /* <Notes>                                                               */
 
91
  /*    This function can be used to create @FT_Face objects from fonts    */
 
92
  /*    that are installed in the system as follows.                       */
 
93
  /*                                                                       */
 
94
  /*    {                                                                  */
 
95
  /*      fond = GetResource( 'FOND', fontName );                          */
 
96
  /*      error = FT_New_Face_From_FOND( library, fond, 0, &face );        */
 
97
  /*    }                                                                  */
 
98
  /*                                                                       */
 
99
  FT_EXPORT( FT_Error )
 
100
  FT_New_Face_From_FOND( FT_Library  library,
 
101
                         Handle      fond,
 
102
                         FT_Long     face_index,
 
103
                         FT_Face    *aface )
 
104
                       FT_DEPRECATED_ATTRIBUTE;
 
105
 
 
106
 
 
107
  /*************************************************************************/
 
108
  /*                                                                       */
 
109
  /* <Function>                                                            */
 
110
  /*    FT_GetFile_From_Mac_Name                                           */
 
111
  /*                                                                       */
 
112
  /* <Description>                                                         */
 
113
  /*    Return an FSSpec for the disk file containing the named font.      */
 
114
  /*                                                                       */
 
115
  /* <Input>                                                               */
 
116
  /*    fontName   :: Mac OS name of the font (e.g., Times New Roman       */
 
117
  /*                  Bold).                                               */
 
118
  /*                                                                       */
 
119
  /* <Output>                                                              */
 
120
  /*    pathSpec   :: FSSpec to the file.  For passing to                  */
 
121
  /*                  @FT_New_Face_From_FSSpec.                            */
 
122
  /*                                                                       */
 
123
  /*    face_index :: Index of the face.  For passing to                   */
 
124
  /*                  @FT_New_Face_From_FSSpec.                            */
 
125
  /*                                                                       */
 
126
  /* <Return>                                                              */
 
127
  /*    FreeType error code.  0~means success.                             */
 
128
  /*                                                                       */
 
129
  FT_EXPORT( FT_Error )
 
130
  FT_GetFile_From_Mac_Name( const char*  fontName,
 
131
                            FSSpec*      pathSpec,
 
132
                            FT_Long*     face_index )
 
133
                          FT_DEPRECATED_ATTRIBUTE;
 
134
 
 
135
 
 
136
  /*************************************************************************/
 
137
  /*                                                                       */
 
138
  /* <Function>                                                            */
 
139
  /*    FT_GetFile_From_Mac_ATS_Name                                       */
 
140
  /*                                                                       */
 
141
  /* <Description>                                                         */
 
142
  /*    Return an FSSpec for the disk file containing the named font.      */
 
143
  /*                                                                       */
 
144
  /* <Input>                                                               */
 
145
  /*    fontName   :: Mac OS name of the font in ATS framework.            */
 
146
  /*                                                                       */
 
147
  /* <Output>                                                              */
 
148
  /*    pathSpec   :: FSSpec to the file. For passing to                   */
 
149
  /*                  @FT_New_Face_From_FSSpec.                            */
 
150
  /*                                                                       */
 
151
  /*    face_index :: Index of the face. For passing to                    */
 
152
  /*                  @FT_New_Face_From_FSSpec.                            */
 
153
  /*                                                                       */
 
154
  /* <Return>                                                              */
 
155
  /*    FreeType error code.  0~means success.                             */
 
156
  /*                                                                       */
 
157
  FT_EXPORT( FT_Error )
 
158
  FT_GetFile_From_Mac_ATS_Name( const char*  fontName,
 
159
                                FSSpec*      pathSpec,
 
160
                                FT_Long*     face_index )
 
161
                              FT_DEPRECATED_ATTRIBUTE;
 
162
 
 
163
 
 
164
  /*************************************************************************/
 
165
  /*                                                                       */
 
166
  /* <Function>                                                            */
 
167
  /*    FT_GetFilePath_From_Mac_ATS_Name                                   */
 
168
  /*                                                                       */
 
169
  /* <Description>                                                         */
 
170
  /*    Return a pathname of the disk file and face index for given font   */
 
171
  /*    name which is handled by ATS framework.                            */
 
172
  /*                                                                       */
 
173
  /* <Input>                                                               */
 
174
  /*    fontName    :: Mac OS name of the font in ATS framework.           */
 
175
  /*                                                                       */
 
176
  /* <Output>                                                              */
 
177
  /*    path        :: Buffer to store pathname of the file.  For passing  */
 
178
  /*                   to @FT_New_Face.  The client must allocate this     */
 
179
  /*                   buffer before calling this function.                */
 
180
  /*                                                                       */
 
181
  /*    maxPathSize :: Lengths of the buffer `path' that client allocated. */
 
182
  /*                                                                       */
 
183
  /*    face_index  :: Index of the face.  For passing to @FT_New_Face.    */
 
184
  /*                                                                       */
 
185
  /* <Return>                                                              */
 
186
  /*    FreeType error code.  0~means success.                             */
 
187
  /*                                                                       */
 
188
  FT_EXPORT( FT_Error )
 
189
  FT_GetFilePath_From_Mac_ATS_Name( const char*  fontName,
 
190
                                    UInt8*       path,
 
191
                                    UInt32       maxPathSize,
 
192
                                    FT_Long*     face_index )
 
193
                                  FT_DEPRECATED_ATTRIBUTE;
 
194
 
 
195
 
 
196
  /*************************************************************************/
 
197
  /*                                                                       */
 
198
  /* <Function>                                                            */
 
199
  /*    FT_New_Face_From_FSSpec                                            */
 
200
  /*                                                                       */
 
201
  /* <Description>                                                         */
 
202
  /*    Create a new face object from a given resource and typeface index  */
 
203
  /*    using an FSSpec to the font file.                                  */
 
204
  /*                                                                       */
 
205
  /* <InOut>                                                               */
 
206
  /*    library    :: A handle to the library resource.                    */
 
207
  /*                                                                       */
 
208
  /* <Input>                                                               */
 
209
  /*    spec       :: FSSpec to the font file.                             */
 
210
  /*                                                                       */
 
211
  /*    face_index :: The index of the face within the resource.  The      */
 
212
  /*                  first face has index~0.                              */
 
213
  /* <Output>                                                              */
 
214
  /*    aface      :: A handle to a new face object.                       */
 
215
  /*                                                                       */
 
216
  /* <Return>                                                              */
 
217
  /*    FreeType error code.  0~means success.                             */
 
218
  /*                                                                       */
 
219
  /* <Note>                                                                */
 
220
  /*    @FT_New_Face_From_FSSpec is identical to @FT_New_Face except       */
 
221
  /*    it accepts an FSSpec instead of a path.                            */
 
222
  /*                                                                       */
 
223
  FT_EXPORT( FT_Error )
 
224
  FT_New_Face_From_FSSpec( FT_Library     library,
 
225
                           const FSSpec  *spec,
 
226
                           FT_Long        face_index,
 
227
                           FT_Face       *aface )
 
228
                         FT_DEPRECATED_ATTRIBUTE;
 
229
 
 
230
 
 
231
  /*************************************************************************/
 
232
  /*                                                                       */
 
233
  /* <Function>                                                            */
 
234
  /*    FT_New_Face_From_FSRef                                             */
 
235
  /*                                                                       */
 
236
  /* <Description>                                                         */
 
237
  /*    Create a new face object from a given resource and typeface index  */
 
238
  /*    using an FSRef to the font file.                                   */
 
239
  /*                                                                       */
 
240
  /* <InOut>                                                               */
 
241
  /*    library    :: A handle to the library resource.                    */
 
242
  /*                                                                       */
 
243
  /* <Input>                                                               */
 
244
  /*    spec       :: FSRef to the font file.                              */
 
245
  /*                                                                       */
 
246
  /*    face_index :: The index of the face within the resource.  The      */
 
247
  /*                  first face has index~0.                              */
 
248
  /* <Output>                                                              */
 
249
  /*    aface      :: A handle to a new face object.                       */
 
250
  /*                                                                       */
 
251
  /* <Return>                                                              */
 
252
  /*    FreeType error code.  0~means success.                             */
 
253
  /*                                                                       */
 
254
  /* <Note>                                                                */
 
255
  /*    @FT_New_Face_From_FSRef is identical to @FT_New_Face except        */
 
256
  /*    it accepts an FSRef instead of a path.                             */
 
257
  /*                                                                       */
 
258
  FT_EXPORT( FT_Error )
 
259
  FT_New_Face_From_FSRef( FT_Library    library,
 
260
                          const FSRef  *ref,
 
261
                          FT_Long       face_index,
 
262
                          FT_Face      *aface )
 
263
                        FT_DEPRECATED_ATTRIBUTE;
 
264
 
 
265
  /* */
 
266
 
 
267
 
 
268
FT_END_HEADER
 
269
 
 
270
 
 
271
#endif /* __FTMAC_H__ */
 
272
 
 
273
 
 
274
/* END */