Index

CDTEngineV8

FontGetMMAxisInfo

This function returns the number of multiple-master design axes, base designs and design instances in the specified font.

Parameters

ParameterDescription

font_index

Font index of the font or font instance in the Font Catalog.

dim

Pointer to a variable that will hold the number of multiple-master base designs in the font referenced by font_index. If you do not wish to receive this value, you may set dim to DV_NULL.

inst_count

Pointer to a variable that will hold the number of multiple-master design instances in the font referenced by font_index. If you do not wish to receive this value, you may set inst_count to DV_NULL. This parameter will be described in the future.

Return Value

The return value represents the number of multiple-master design axes in the font referenced by font_index. If the referenced font is a single-master font, the return value is always 0. If the referenced font, however, is a multiple-master font (in D-Type, Adobe Type 1 or Variable OpenType format) the return value is a positive number.

Comments

Modern multiple-master fonts (that come in Variable OpenType and D-Type format) have a positive number of design axes but do not have a fixed number of base designs that can be interpreted by end-user applications. For those fonts, the number of design axes will be returned as a positive number but the number of base designs will be returned as 1.

Legacy multiple-master fonts (that come in Adobe Type 1 and D-Type format) have a positive number of design axes and a fixed number of base designs that is usually 2, 4, 8 or 16 (i.e. a multiple of 2). This is because their base designs are typically organized in groups of 2, where each group represents one design axis such as weight, width, optical size etc. In those fonts each base design represents one extreme in the dynamic range of possible instances along the design axis. For example, if one of the design axes is width, the base designs typically represent the narrowest possible and widest possible design for this font. Virtually all multiple-master Adobe Type 1 fonts and some D-Type fonts are organized in this way.

For single-master fonts (in any format), the number of design axes will be returned as 0 while the number of base designs will be returned as 1.



 

Index