FreeType » Docs » Core API » Mac Specific Interface
Mac Specific Interface¶
Synopsis¶
The following definitions are only available if FreeType is compiled on a Macintosh.
FT_New_Face_From_FOND¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_New_Face_From_FOND( FT_Library  library,
                         Handle      fond,
                         FT_Long     face_index,
                         FT_Face    *aface )
                       FT_DEPRECATED_ATTRIBUTE;
Create a new face object from a FOND resource.
inout
| library | A handle to the library resource. | 
input
| fond | A FOND resource. | 
| face_index | Only supported for the -1 ‘sanity check’ special case. | 
output
| aface | A handle to a new face object. | 
return
FreeType error code. 0 means success.
example
This function can be used to create FT_Face objects from fonts that are installed in the system as follows.
  fond  = GetResource( 'FOND', fontName );
  error = FT_New_Face_From_FOND( library, fond, 0, &face );
FT_GetFile_From_Mac_Name¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_GetFile_From_Mac_Name( const char*  fontName,
                            FSSpec*      pathSpec,
                            FT_Long*     face_index )
                          FT_DEPRECATED_ATTRIBUTE;
Return an FSSpec for the disk file containing the named font.
input
| fontName | Mac OS name of the font (e.g., Times New Roman Bold). | 
output
| pathSpec | FSSpec to the file. For passing to  | 
| face_index | Index of the face. For passing to  | 
return
FreeType error code. 0 means success.
FT_GetFile_From_Mac_ATS_Name¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_GetFile_From_Mac_ATS_Name( const char*  fontName,
                                FSSpec*      pathSpec,
                                FT_Long*     face_index )
                              FT_DEPRECATED_ATTRIBUTE;
Return an FSSpec for the disk file containing the named font.
input
| fontName | Mac OS name of the font in ATS framework. | 
output
| pathSpec | FSSpec to the file. For passing to  | 
| face_index | Index of the face. For passing to  | 
return
FreeType error code. 0 means success.
FT_GetFilePath_From_Mac_ATS_Name¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_GetFilePath_From_Mac_ATS_Name( const char*  fontName,
                                    UInt8*       path,
                                    UInt32       maxPathSize,
                                    FT_Long*     face_index )
                                  FT_DEPRECATED_ATTRIBUTE;
Return a pathname of the disk file and face index for given font name that is handled by ATS framework.
input
| fontName | Mac OS name of the font in ATS framework. | 
output
| path | Buffer to store pathname of the file. For passing to  | 
| maxPathSize | Lengths of the buffer  | 
| face_index | Index of the face. For passing to  | 
return
FreeType error code. 0 means success.
FT_New_Face_From_FSSpec¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_New_Face_From_FSSpec( FT_Library     library,
                           const FSSpec  *spec,
                           FT_Long        face_index,
                           FT_Face       *aface )
                         FT_DEPRECATED_ATTRIBUTE;
Create a new face object from a given resource and typeface index using an FSSpec to the font file.
inout
| library | A handle to the library resource. | 
input
| spec | FSSpec to the font file. | 
| face_index | The index of the face within the resource. The first face has index 0. | 
output
| aface | A handle to a new face object. | 
return
FreeType error code. 0 means success.
note
FT_New_Face_From_FSSpec is identical to FT_New_Face except it accepts an FSSpec instead of a path.
FT_New_Face_From_FSRef¶
Defined in FT_MAC_H (freetype/ftmac.h).
  FT_EXPORT( FT_Error )
  FT_New_Face_From_FSRef( FT_Library    library,
                          const FSRef  *ref,
                          FT_Long       face_index,
                          FT_Face      *aface )
                        FT_DEPRECATED_ATTRIBUTE;
Create a new face object from a given resource and typeface index using an FSRef to the font file.
inout
| library | A handle to the library resource. | 
input
| spec | FSRef to the font file. | 
| face_index | The index of the face within the resource. The first face has index 0. | 
output
| aface | A handle to a new face object. | 
return
FreeType error code. 0 means success.
note
FT_New_Face_From_FSRef is identical to FT_New_Face except it accepts an FSRef instead of a path.