+
+ + +
+
+
+ +
+
+
+ + + + + +
+
+ + + +

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 FT_New_Face_From_FSSpec.

+
face_index +

Index of the face. For passing to FT_New_Face_From_FSSpec.

+
+ +

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 FT_New_Face_From_FSSpec.

+
face_index +

Index of the face. For passing to FT_New_Face_From_FSSpec.

+
+ +

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 FT_New_Face. The client must allocate this buffer before calling this function.

+
maxPathSize +

Lengths of the buffer path that client allocated.

+
face_index +

Index of the face. For passing to FT_New_Face.

+
+ +

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.

+
+ + + + + + + + + + +
+
+
+