FreeType-2.1.10 API Reference

Multiple Masters

Synopsis

FT_MM_AxisFT_Get_MM_Var
FT_Multi_MasterFT_Set_MM_Design_Coordinates
FT_Var_AxisFT_Set_Var_Design_Coordinates
FT_Var_Named_StyleFT_Set_MM_Blend_Coordinates
FT_MM_VarFT_Set_Var_Blend_Coordinates
FT_Get_Multi_Master


The following types and functions are used to manage Multiple Master fonts, i.e. the selection of specific design instances by setting design axis coordinates.

George Williams has extended this interface to make it work with both Type 1 Multiple Masters fonts, and GX distortable (var) fonts. Some of these routines only work with MM fonts, others will work with both types. They are similar enough that a consistent interface makes sense.


FT_MM_Axis


  typedef struct  FT_MM_Axis_
  {
    FT_String*  name;
    FT_Long     minimum;
    FT_Long     maximum;

  } FT_MM_Axis;


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

This structure can't be used for GX var fonts.


fields
name

The axis's name.

minimum

The axis's minimum design coordinate.

maximum

The axis's maximum design coordinate.


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 used to model the axes and space of a Multiple Masters font.

This structure can't be used for GX var fonts.


fields
num_axis

Number of axes. Cannot exceed 4.

num_designs

Number of designs; should ne normally 2^num_axis even though the Type 1 specification strangely allows for intermediate designs to be present. This number cannot exceed 16.

axis

A table of axis descriptors.


FT_Var_Axis


  typedef struct  FT_Var_Axis_
  {
    FT_String*  name;

    FT_Fixed    minimum;
    FT_Fixed    def;
    FT_Fixed    maximum;

    FT_ULong    tag;
    FT_UInt     strid;

  } FT_Var_Axis;


A simple structure used to model a given axis in design space for Multiple Masters and GX var fonts.


fields
name

The axis's name. Not always meaningful for GX.

minimum

The axis's minimum design coordinate.

def

The axis's default design coordinate. FreeType computes meaningful default values for MM; it is then an integer value, not in 16.16 format.

maximum

The axis's maximum design coordinate.

tag

The axis's tag (the GX equivalent to `name'). FreeType provides default values for MM if possible.

strid

The entry in `name' table (another GX version of `name'). Not meaningful for MM.


FT_Var_Named_Style


  typedef struct  FT_Var_Named_Style_
  {
    FT_Fixed*  coords;
    FT_UInt    strid;

  } FT_Var_Named_Style;


A simple structure used to model a named style in a GX var font.

This structure can't be used for MM fonts.


fields
coords

The design coordinates for this style. This is an array with one entry for each axis.

strid

The entry in `name' table identifying this style.


FT_MM_Var


  typedef struct  FT_MM_Var_
  {
    FT_UInt              num_axis;
    FT_UInt              num_designs;
    FT_UInt              num_namedstyles;
    FT_Var_Axis*         axis;
    FT_Var_Named_Style*  namedstyle;

  } FT_MM_Var;


A structure used to model the axes and space of a Multiple Masters or GX var distortable font.

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


fields
num_axis

The number of axes. The maximum value is 4 for MM; no limit in GX.

num_designs

The number of designs; should be normally 2^num_axis for MM fonts. Not meaningful for GX (where every glyph could have a different number of designs).

num_namedstyles

The number of named styles; only meaningful for GX which allows certain design coordinates to have a string ID (in the `name' table) associated with them. The font can tell the user that, for example, Weight=1.5 is `Bold'.

axis

A table of axis descriptors. GX fonts contain slightly more data than MM.

namedstyles

A table of named styles. Only meaningful with GX.


FT_Get_Multi_Master


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


Retrieves the Multiple Master descriptor of a given font.

This function can't be used with GX fonts.


input
face

A handle to the source face.

output
amaster

The Multiple Masters descriptor.

return

FreeType error code. 0 means success.


FT_Get_MM_Var


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


Retrieves the Multiple Master/GX var descriptor of a given font.


input
face

A handle to the source face.

output
amaster

The Multiple Masters descriptor. Allocates a data structure, which the user must free (a single call to FT_FREE will do it).

return

FreeType error code. 0 means success.


FT_Set_MM_Design_Coordinates


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


For Multiple Masters fonts, choose an interpolated font design through design coordinates.

This function can't be used with GX fonts.


inout
face

A handle to the source face.

input
num_coords

The number of design coordinates (must be equal to the number of axes in the font).

coords

An array of design coordinates.

return

FreeType error code. 0 means success.


FT_Set_Var_Design_Coordinates


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


For Multiple Master or GX Var fonts, choose an interpolated font design through design coordinates.


inout
face

A handle to the source face.

input
num_coords

The number of design coordinates (must be equal to the number of axes in the font).

coords

An array of design coordinates.

return

FreeType error code. 0 means success.


FT_Set_MM_Blend_Coordinates


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


For Multiple Masters and GX var fonts, choose an interpolated font design through normalized blend coordinates.


inout
face

A handle to the source face.

input
num_coords

The number of design coordinates (must be equal to the number of axes in the font).

coords

The design coordinates array (each element must be between 0 and 1.0).

return

FreeType error code. 0 means success.


FT_Set_Var_Blend_Coordinates


  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.