Multiple Masters - FreeType-2.10.1 API Reference

@@ -166,12 +168,12 @@

- FreeType-2.10.1 API Reference + FreeType-2.10.4 API Reference

- + Synopsis
- + FT_MM_Axis
- + FT_Multi_Master
- + FT_Var_Axis
- + FT_Var_Named_Style
- + FT_MM_Var
- + FT_Get_Multi_Master
- + FT_Get_MM_Var
- + FT_Done_MM_Var
- + FT_Set_MM_Design_Coordinates
- + FT_Set_Var_Design_Coordinates
- + FT_Get_Var_Design_Coordinates
- + FT_Set_MM_Blend_Coordinates
- + FT_Get_MM_Blend_Coordinates
- + FT_Set_Var_Blend_Coordinates
- + FT_Get_Var_Blend_Coordinates
- + FT_Set_MM_WeightVector
- + FT_Get_MM_WeightVector
- + FT_VAR_AXIS_FLAG_XXX
- + FT_Get_Var_Axis_Flags
- + FT_Set_Named_Instance @@ -1113,8 +1115,8 @@
- - OpenType Validation + + TrueTypeGX/AAT Validation
- - TrueTypeGX/AAT Validation + + OpenType Validation

- + Synopsis
- + FT_MM_Axis
- + FT_Multi_Master
- + FT_Var_Axis
- + FT_Var_Named_Style
- + FT_MM_Var
- + FT_Get_Multi_Master
- + FT_Get_MM_Var
- + FT_Done_MM_Var
- + FT_Set_MM_Design_Coordinates
- + FT_Set_Var_Design_Coordinates
- + FT_Get_Var_Design_Coordinates
- + FT_Set_MM_Blend_Coordinates
- + FT_Get_MM_Blend_Coordinates
- + FT_Set_Var_Blend_Coordinates
- + FT_Get_Var_Blend_Coordinates
- + FT_Set_MM_WeightVector
- + FT_Get_MM_WeightVector
- + FT_VAR_AXIS_FLAG_XXX
- + FT_Get_Var_Axis_Flags

- + FT_Set_Named_Instance @@ -1352,17 +1354,14 @@

Besides Adobe MM fonts, the interface supports Apple's TrueType GX and OpenType variation fonts. Some of the routines only work with Adobe MM fonts, others will work with all three types. They are similar enough that a consistent interface makes sense.

FT_MM_Axis¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  typedef struct  FT_MM_Axis_
+  typedef struct  FT_MM_Axis_
   {
     FT_String*  name;
     FT_Long     minimum;
     FT_Long     maximum;
 
   } FT_MM_Axis;
-

-

+

A structure to model a given axis in design space for Multiple Masters fonts.

This structure can't be used for TrueType GX or OpenType variation fonts.

@@ -1384,17 +1383,14 @@

FT_Multi_Master¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  typedef struct  FT_Multi_Master_
+  typedef struct  FT_Multi_Master_
   {
     FT_UInt     num_axis;
     FT_UInt     num_designs;
     FT_MM_Axis  axis[T1_MAX_MM_AXIS];
 
   } FT_Multi_Master;
-

-

+

A structure to model the axes and space of a Multiple Masters font.

This structure can't be used for TrueType GX or OpenType variation fonts.

@@ -1416,9 +1412,7 @@

FT_Var_Axis¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  typedef struct  FT_Var_Axis_
+  typedef struct  FT_Var_Axis_
   {
     FT_String*  name;
 
@@ -1430,8 +1424,7 @@
     FT_UInt     strid;
 
   } FT_Var_Axis;
-

-

+

A structure to model a given axis in design space for Multiple Masters, TrueType GX, and OpenType variation fonts.

fields

@@ -1464,17 +1457,14 @@

FT_Var_Named_Style¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  typedef struct  FT_Var_Named_Style_
+  typedef struct  FT_Var_Named_Style_
   {
     FT_Fixed*  coords;
     FT_UInt    strid;
     FT_UInt    psid;   /* since 2.7.1 */
 
   } FT_Var_Named_Style;
-

-

+

A structure to model a named instance in a TrueType GX or OpenType variation font.

This structure can't be used for Adobe MM fonts.

@@ -1496,9 +1486,7 @@

FT_MM_Var¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  typedef struct  FT_MM_Var_
+  typedef struct  FT_MM_Var_
   {
     FT_UInt              num_axis;
     FT_UInt              num_designs;
@@ -1507,8 +1495,7 @@
     FT_Var_Named_Style*  namedstyle;
 
   } FT_MM_Var;
-

-

+

A structure to model the axes and space of an Adobe MM, TrueType GX, or OpenType variation font.

Some fields are specific to one format and not to the others.

@@ -1537,13 +1524,10 @@

FT_Get_Multi_Master¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_Multi_Master( FT_Face           face,
                        FT_Multi_Master  *amaster );
-

-

+

Retrieve a variation descriptor of a given Adobe MM font.

This function can't be used with TrueType GX or OpenType variation fonts.

@@ -1570,13 +1554,10 @@

FT_Get_MM_Var¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_MM_Var( FT_Face      face,
                  FT_MM_Var*  *amaster );
-

-

+

Retrieve a variation descriptor for a given font.

This function works with all supported variation formats.

@@ -1603,13 +1584,10 @@

FT_Done_MM_Var¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Done_MM_Var( FT_Library   library,
                   FT_MM_Var   *amaster );
-

-

+

Free the memory allocated by FT_Get_MM_Var.

input

@@ -1627,14 +1605,11 @@

FT_Set_MM_Design_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_MM_Design_Coordinates( FT_Face   face,
                                 FT_UInt   num_coords,
                                 FT_Long*  coords );
-

-

+

For Adobe MM fonts, choose an interpolated font design through design coordinates.

This function can't be used with TrueType GX or OpenType variation fonts.

@@ -1668,14 +1643,11 @@

FT_Set_Var_Design_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_Var_Design_Coordinates( FT_Face    face,
                                  FT_UInt    num_coords,
                                  FT_Fixed*  coords );
-

-

+

Choose an interpolated font design through design coordinates.

This function works with all supported variation formats.

@@ -1709,14 +1681,11 @@

FT_Get_Var_Design_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_Var_Design_Coordinates( FT_Face    face,
                                  FT_UInt    num_coords,
                                  FT_Fixed*  coords );
-

-

+

Get the design coordinates of the currently selected interpolated font.

This function works with all supported variation formats.

@@ -1749,14 +1718,11 @@

FT_Set_MM_Blend_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_MM_Blend_Coordinates( FT_Face    face,
                                FT_UInt    num_coords,
                                FT_Fixed*  coords );
-

-

+

Choose an interpolated font design through normalized blend coordinates.

This function works with all supported variation formats.

@@ -1790,14 +1756,11 @@

FT_Get_MM_Blend_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_MM_Blend_Coordinates( FT_Face    face,
                                FT_UInt    num_coords,
                                FT_Fixed*  coords );
-

-

+

Get the normalized blend coordinates of the currently selected interpolated font.

This function works with all supported variation formats.

@@ -1830,28 +1793,22 @@

FT_Set_Var_Blend_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_Var_Blend_Coordinates( FT_Face    face,
                                 FT_UInt    num_coords,
                                 FT_Fixed*  coords );
-

-

+

This is another name of FT_Set_MM_Blend_Coordinates.

FT_Get_Var_Blend_Coordinates¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_Var_Blend_Coordinates( FT_Face    face,
                                 FT_UInt    num_coords,
                                 FT_Fixed*  coords );
-

-

+

This is another name of FT_Get_MM_Blend_Coordinates.

since

@@ -1861,14 +1818,11 @@

FT_Set_MM_WeightVector¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_MM_WeightVector( FT_Face    face,
                           FT_UInt    len,
                           FT_Fixed*  weightvector );
-

-

+

For Adobe MM fonts, choose an interpolated font design by directly setting the weight vector.

This function can't be used with TrueType GX or OpenType variation fonts.

@@ -1906,14 +1860,11 @@

FT_Get_MM_WeightVector¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_MM_WeightVector( FT_Face    face,
                           FT_UInt*   len,
                           FT_Fixed*  weightvector );
-

-

+

For Adobe MM fonts, retrieve the current weight vector of the font.

This function can't be used with TrueType GX or OpenType variation fonts.

@@ -1949,11 +1900,8 @@

FT_VAR_AXIS_FLAG_XXX¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-#define FT_VAR_AXIS_FLAG_HIDDEN  1
-

#define FT_VAR_AXIS_FLAG_HIDDEN  1
+

A list of bit flags used in the return value of FT_Get_Var_Axis_Flags.

values

@@ -1971,14 +1919,11 @@

FT_Get_Var_Axis_Flags¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Get_Var_Axis_Flags( FT_MM_Var*  master,
                          FT_UInt     axis_index,
                          FT_UInt*    flags );
-

-

+

Get the ‘flags’ field of an OpenType Variation Axis Record.

Not meaningful for Adobe MM fonts (*flags is always zero).

@@ -2011,13 +1956,10 @@

FT_Set_Named_Instance¶

Defined in FT_MULTIPLE_MASTERS_H (freetype/ftmm.h).

-  FT_EXPORT( FT_Error )
+  FT_EXPORT( FT_Error )
   FT_Set_Named_Instance( FT_Face  face,
                          FT_UInt  instance_index );
-

-

+

Set or change the current named instance.

input

@@ -2045,6 +1987,7 @@ + @@ -2099,13 +2042,13 @@ @@ -2115,9 +2058,9 @@

- + - +