5172
+ − 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 */