Function getVarFontInstance

Lib/pagebot/fonttoolbox/variablefontbuilder.py:167–193

The getVarFontInstance refers to the file of the source variable font. The nLocation is dictionary axis locations of the instance with values between (0, 1000), e.g. dict(wght=0, wdth=1000) or values between (0, 1), e.g. dict(wght=0.2, wdth=0.6). Set normalize to False if the values in

(fontOrPath, location, styleName=None, normalize=True,
        cached=True, lazy=True)

    return constrainedLocation

def getVarFontInstance(fontOrPath, location, styleName=None, normalize=True,
        cached=True, lazy=True):
    """The getVarFontInstance refers to the file of the source variable font.
    The nLocation is dictionary axis locations of the instance with values
    between (0, 1000), e.g. dict(wght=0, wdth=1000) or values between  (0, 1),
    e.g. dict(wght=0.2, wdth=0.6). Set normalize to False if the values in
    location already are matching the axis min/max of the font. If there is a
    [opsz] Optical Size value defined, then store that information in the
    font.info.opticalSize. The optional *styleName* overwrites the
    *font.info.styleName* of the *ttFont* or the automatic location name.

    TODO: move to fonttoolbox.objects.font?
    """
    if isinstance(fontOrPath, str):
        varFont = getFont(fontOrPath, lazy=lazy)
    else:
        varFont = fontOrPath
    if varFont is None: # Could not read the Variable Font on that path.
        return None
    path = generateInstance(varFont.path, location, targetDirectory=getInstancePath(),
                                      normalize=normalize, cached=cached, lazy=lazy)
    # Answer the generated Variable Font instance. Add [opsz] value if is defined in the location, otherwise None.
    instance = getFont(path, lazy=lazy)
    instance.info.opticalSize = location.get('opsz')
    instance.info.location = location
    instance.info.varStyleName = styleName
    return instance


def generateInstance(variableFontPath, location, targetDirectory,