Normalizers

fontParts.base.normalizers.normalizeFileFormatVersion(value)

Normalizes a font’s file format version.

• value must be a type-int.
• Returned value will be a int.

Kerning

fontParts.base.normalizers.normalizeKerningKey(value)

Normalizes kerning key.

• value must be a tuple or list.
• value must contain only two members.
• value items must be String.
• value items must be at least one character long.
• Returned value will be a two member tuple of unencoded unicode strings.

fontParts.base.normalizers.normalizeKerningValue(value)

Normalizes kerning value.

• value must be an Integer/Float.
• Returned value is the same type as input value.

Groups

fontParts.base.normalizers.normalizeGroupKey(value)

Normalizes group key.

• value must be a String.
• value must be least one character long.
• Returned value will be an unencoded unicode string.

fontParts.base.normalizers.normalizeGroupValue(value)

Normalizes group value.

• value must be a list.
• value items must normalize as glyph names with normalizeGlyphName.
• Returned value will be a tuple of unencoded unicode strings.

Features

fontParts.base.normalizers.normalizeFeatureText(value)

Normalizes feature text.

• value must be a String.
• Returned value will be an unencoded unicode string.

Lib

fontParts.base.normalizers.normalizeLibKey(value)

Normalizes lib key.

• value must be a String.
• value must be at least one character long.
• Returned value will be an unencoded unicode string.

fontParts.base.normalizers.normalizeLibValue(value)

Normalizes lib value.

• value must not be None.
• Returned value is the same type as the input value.

Layers

fontParts.base.normalizers.normalizeLayerOrder(value, font)

Normalizes layer order.

** value must be a tuple or list. * value items must normalize as layer names with

normalizeLayerName.

• value must contain layers that exist in font.
• value must not contain duplicate layers.
• Returned tuple will be unencoded unicode strings for each layer name.

fontParts.base.normalizers.normalizeLayerName(value)

Normalizes layer name.

• value must be a String.
• value must be at least one character long.
• Returned value will be an unencoded unicode string.

Glyphs

fontParts.base.normalizers.normalizeGlyphOrder(value)

Normalizes glyph order.

** value must be a tuple or list. * value items must normalize as glyph names with

normalizeGlyphName.

• value must not repeat glyph names.
• Returned value will be a tuple of unencoded unicode strings.

Identification

fontParts.base.normalizers.normalizeGlyphName(value)

Normalizes glyph name.

• value must be a String.
• value must be at least one character long.
• Returned value will be an unencoded unicode string.

fontParts.base.normalizers.normalizeGlyphUnicodes(value)

Normalizes glyph unicodes.

• value must be a list.
• value items must normalize as glyph unicodes with normalizeGlyphUnicode.
• value must not repeat unicode values.
• Returned value will be a tuple of ints.

fontParts.base.normalizers.normalizeGlyphUnicode(value)

Normalizes glyph unicode.

• value must be an int or hex (represented as a string).
• value must be in a unicode range.
• Returned value will be an int.

Metrics

fontParts.base.normalizers.normalizeGlyphWidth(value)

Normalizes glyph width.

• value must be a Integer/Float.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeGlyphLeftMargin(value)

Normalizes glyph left margin.

• value must be a Integer/Float or None.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeGlyphRightMargin(value)

Normalizes glyph right margin.

• value must be a Integer/Float or None.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeGlyphHeight(value)

Normalizes glyph height.

• value must be a Integer/Float.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeGlyphBottomMargin(value)

Normalizes glyph bottom margin.

• value must be a Integer/Float or None.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeGlyphTopMargin(value)

Normalizes glyph top margin.

• value must be a Integer/Float or None.
• Returned value is the same type as the input value.

Contours

fontParts.base.normalizers.normalizeContour(value)

Normalizes contour.

• value must be a instance of BaseContour
• Returned value is the same type as the input value.

Points

fontParts.base.normalizers.normalizePointType(value)

Normalizes point type.

• value must be an string.

• value must be one of the following:

  move

  line

  offcurve

  curve

  qcurve

• Returned value will be an unencoded unicode string.

fontParts.base.normalizers.normalizePointName(value)

Normalizes point name.

• value must be a String.
• value must be at least one character long.
• Returned value will be an unencoded unicode string.

Segments

fontParts.base.normalizers.normalizeSegmentType(value)

Normalizes segment type.

• value must be a String.
• value must be one of the following:

move

line

curve

qcurve

• Returned value will be an unencoded unicode string.

BPoints

fontParts.base.normalizers.normalizeBPointType(value)

Normalizes bPoint type.

• value must be an string.

• value must be one of the following:

  corner

  curve

• Returned value will be an unencoded unicode string.

Components

Anchors

fontParts.base.normalizers.normalizeAnchorName(value)

Normalizes anchor name.

• value must be a String or None.
• value must be at least one character long if String.
• Returned value will be an unencoded unicode string or None.

Note

fontParts.base.normalizers.normalizeGlyphNote(value)

Normalizes Glyph Note.

• value must be a String.
• Returned value is an unencoded unicode string

Guidelines

fontParts.base.normalizers.normalizeGuidelineName(value)

Normalizes guideline name.

• value must be a String.
• value must be at least one character long.
• Returned value will be an unencoded unicode string.

Generic

Positions

fontParts.base.normalizers.normalizeX(value)

Normalizes x coordinate.

• value must be an Integer/Float.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeY(value)

Normalizes y coordinate.

• value must be an Integer/Float.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeCoordinateTuple(value)

Normalizes coordinate tuple.

• value must be a tuple or list.
• value must have exactly two items.
• value items must be an Integer/Float.
• Returned value is a tuple of two values of the same type as the input values.

fontParts.base.normalizers.normalizeBoundingBox(value)

Normalizes bounding box.

• value must be an tuple or list.
• value must have exactly four items.
• value items must be Integer/Float.
• xMin and yMin must be less than or equal to the corresponding xMax, yMax.
• Returned value will be a tuple of four float.

Identification

fontParts.base.normalizers.normalizeIndex(value)

Normalizes index.

• value must be an int or None.
• Returned value is the same type as the input value.

fontParts.base.normalizers.normalizeIdentifier(value)

Normalizes identifier.

• value must be an String or None.
• value must not be longer than 100 characters.
• value must not contain a character out the range of 0x20 - 0x7E.
• Returned value is an unencoded unicode string.

fontParts.base.normalizers.normalizeColor(value)

Normalizes Color.

• value must be an tuple or list.
• value must have exactly four items.
• value color components must be between 0 and 1.
• Returned value is a tuple containing four float values.

Interpolation

fontParts.base.normalizers.normalizeInterpolationFactor(value)

Normalizes interpolation factor.

• value must be an Integer/Float, tuple or list.
• If value is a tuple or list, it must have exactly two items. These items must be instances of Integer/Float.
• Returned value is a tuple of two float.

Transformations

fontParts.base.normalizers.normalizeTransformationMatrix(value)

Normalizes transformation matrix.

• value must be an tuple or list.
• value must have exactly six items. Each of these items must be an instance of Integer/Float.
• Returned value is a tuple of six float.

fontParts.base.normalizers.normalizeTransformationOffset(value)

Normalizes transformation offset.

• value must be an tuple.
• value must have exactly two items. Each item must be an instance of Integer/Float.
• Returned value is a tuple of two float.

fontParts.base.normalizers.normalizeTransformationSkewAngle(value)

Normalizes transformation skew angle.

• value must be an Integer/Float, tuple or list.
• If value is a tuple or list, it must have exactly two items. These items must be instances of Integer/Float.
• value items must be between -360 and 360.
• If the value is negative, it is normalized by adding it to 360
• Returned value is a tuple of two float between 0 and 360.

fontParts.base.normalizers.normalizeTransformationScale(value)

Normalizes transformation scale.

• value must be an Integer/Float, tuple or list.
• If value is a tuple or list, it must have exactly two items. These items must be instances of Integer/Float.
• Returned value is a tuple of two floats.

Files

fontParts.base.normalizers.normalizeFilePath(value)

Normalizes file path.

• value must be a String.
• Returned value is an unencoded unicode string

Standard

fontParts.base.normalizers.normalizeBoolean(value)

Normalizes a boolean.

• value must be an int with value of 0 or 1, or a bool.
• Returned value will be a boolean.

fontParts.base.normalizers.normalizeRounding(value)

Normalizes rounding.

Python 2 and Python 3 handing the rounding of halves (0.5, 1.5, etc) differently. This normalizes rounding to be the same (Python 3 style) in both environments.

• value must be an Integer/Float
• Returned value is a int