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
orlist
. - 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 unencodedunicode
strings.
- value must be a
-
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 unencodedunicode
strings.
- value must be a
Features¶
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.
- value must not be
Layers¶
-
fontParts.base.normalizers.
normalizeLayerOrder
(value, font)¶ Normalizes layer order.
** value must be a
tuple
orlist
. * value items must normalize as layer names with- value must contain layers that exist in font.
- value must not contain duplicate layers.
- Returned
tuple
will be unencodedunicode
strings for each layer name.
Glyphs¶
-
fontParts.base.normalizers.
normalizeGlyphOrder
(value)¶ Normalizes glyph order.
** value must be a
tuple
orlist
. * value items must normalize as glyph names with- value must not repeat glyph names.
- Returned value will be a
tuple
of unencodedunicode
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.
- value must be a
-
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.
- value must be a instance of
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.
Segments¶
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¶
Note¶
Guidelines¶
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
orlist
. - 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.
- value must be a
-
fontParts.base.normalizers.
normalizeBoundingBox
(value)¶ Normalizes bounding box.
- value must be an
tuple
orlist
. - 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
.
- value must be an
Identification¶
-
fontParts.base.normalizers.
normalizeIndex
(value)¶ Normalizes index.
- value must be an
int
orNone
. - Returned value is the same type as the input value.
- value must be an
Interpolation¶
-
fontParts.base.normalizers.
normalizeInterpolationFactor
(value)¶ Normalizes interpolation factor.
- value must be an Integer/Float,
tuple
orlist
. - If value is a
tuple
orlist
, it must have exactly two items. These items must be instances of Integer/Float. - Returned value is a
tuple
of twofloat
.
- value must be an Integer/Float,
Transformations¶
-
fontParts.base.normalizers.
normalizeTransformationMatrix
(value)¶ Normalizes transformation matrix.
- value must be an
tuple
orlist
. - value must have exactly six items. Each of these items must be an instance of Integer/Float.
- Returned value is a
tuple
of sixfloat
.
- value must be an
-
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 twofloat
.
- value must be an
-
fontParts.base.normalizers.
normalizeTransformationSkewAngle
(value)¶ Normalizes transformation skew angle.
- value must be an Integer/Float,
tuple
orlist
. - If value is a
tuple
orlist
, 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 twofloat
between 0 and 360.
- value must be an Integer/Float,
-
fontParts.base.normalizers.
normalizeTransformationScale
(value)¶ Normalizes transformation scale.
- value must be an Integer/Float,
tuple
orlist
. - If value is a
tuple
orlist
, it must have exactly two items. These items must be instances of Integer/Float. - Returned value is a
tuple
of twofloat
s.
- value must be an Integer/Float,
Files¶
Standard¶
-
fontParts.base.normalizers.
normalizeBoolean
(value)¶ Normalizes a boolean.
- value must be an
int
with value of 0 or 1, or abool
. - Returned value will be a boolean.
- value must be an
-
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