statisticsPen
Pen calculating area, center of mass, variance and standard-deviation, covariance and correlation, and slant, of glyph shapes.
- class fontTools.pens.statisticsPen.StatisticsControlPen(glyphset=None)[source]
Bases:
StatisticsBase
,BasePen
Pen calculating area, center of mass, variance and standard-deviation, covariance and correlation, and slant, of glyph shapes, using the control polygon only.
Note that if the glyph shape is self-intersecting, the values are not correct (but well-defined). Moreover, area will be negative if contour directions are clockwise.
- exception MissingComponentError
Bases:
KeyError
Indicates a component pointing to a non-existent glyph in the glyphset.
- args
- with_traceback()
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- addComponent(glyphName, transformation)
Transform the points of the base glyph and draw it onto self.
- addVarComponent(glyphName, transformation, location)
Add a VarComponent sub glyph. The ‘transformation’ argument must be a DecomposedTransform from the fontTools.misc.transform module, and the ‘location’ argument must be a dictionary mapping axis tags to their locations.
- closePath()
Close the current sub path. You must call either pen.closePath() or pen.endPath() after each sub path.
- curveTo(*points)
Draw a cubic bezier with an arbitrary number of control points.
The last point specified is on-curve, all others are off-curve (control) points. If the number of control points is > 2, the segment is split into multiple bezier segments. This works like this:
Let n be the number of control points (which is the number of arguments to this call minus 1). If n==2, a plain vanilla cubic bezier is drawn. If n==1, we fall back to a quadratic segment and if n==0 we draw a straight line. It gets interesting when n>2: n-1 PostScript-style cubic segments will be drawn as if it were one curve. See decomposeSuperBezierSegment().
The conversion algorithm used for n>2 is inspired by NURB splines, and is conceptually equivalent to the TrueType “implied points” principle. See also decomposeQuadraticSegment().
- endPath()
End the current sub path, but don’t close it. You must call either pen.closePath() or pen.endPath() after each sub path.
- lineTo(pt)
Draw a straight line from the current point to ‘pt’.
- property log
- moveTo(pt)
Begin a new sub path, set the current point to ‘pt’. You must end each sub path with a call to pen.closePath() or pen.endPath().
- qCurveTo(*points)
Draw a whole string of quadratic curve segments.
The last point specified is on-curve, all others are off-curve points.
This method implements TrueType-style curves, breaking up curves using ‘implied points’: between each two consequtive off-curve points, there is one implied point exactly in the middle between them. See also decomposeQuadraticSegment().
The last argument (normally the on-curve point) may be None. This is to support contours that have NO on-curve points (a rarely seen feature of TrueType outlines).
- skipMissingComponents = True
- class fontTools.pens.statisticsPen.StatisticsPen(glyphset=None)[source]
Bases:
StatisticsBase
,MomentsPen
Pen calculating area, center of mass, variance and standard-deviation, covariance and correlation, and slant, of glyph shapes.
Note that if the glyph shape is self-intersecting, the values are not correct (but well-defined). Moreover, area will be negative if contour directions are clockwise.
- exception MissingComponentError
Bases:
KeyError
Indicates a component pointing to a non-existent glyph in the glyphset.
- args
- with_traceback()
Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.
- addComponent(glyphName, transformation)
Transform the points of the base glyph and draw it onto self.
- addVarComponent(glyphName, transformation, location)
Add a VarComponent sub glyph. The ‘transformation’ argument must be a DecomposedTransform from the fontTools.misc.transform module, and the ‘location’ argument must be a dictionary mapping axis tags to their locations.
- closePath()
Close the current sub path. You must call either pen.closePath() or pen.endPath() after each sub path.
- curveTo(*points)
Draw a cubic bezier with an arbitrary number of control points.
The last point specified is on-curve, all others are off-curve (control) points. If the number of control points is > 2, the segment is split into multiple bezier segments. This works like this:
Let n be the number of control points (which is the number of arguments to this call minus 1). If n==2, a plain vanilla cubic bezier is drawn. If n==1, we fall back to a quadratic segment and if n==0 we draw a straight line. It gets interesting when n>2: n-1 PostScript-style cubic segments will be drawn as if it were one curve. See decomposeSuperBezierSegment().
The conversion algorithm used for n>2 is inspired by NURB splines, and is conceptually equivalent to the TrueType “implied points” principle. See also decomposeQuadraticSegment().
- endPath()
End the current sub path, but don’t close it. You must call either pen.closePath() or pen.endPath() after each sub path.
- lineTo(pt)
Draw a straight line from the current point to ‘pt’.
- property log
- moveTo(pt)
Begin a new sub path, set the current point to ‘pt’. You must end each sub path with a call to pen.closePath() or pen.endPath().
- qCurveTo(*points)
Draw a whole string of quadratic curve segments.
The last point specified is on-curve, all others are off-curve points.
This method implements TrueType-style curves, breaking up curves using ‘implied points’: between each two consequtive off-curve points, there is one implied point exactly in the middle between them. See also decomposeQuadraticSegment().
The last argument (normally the on-curve point) may be None. This is to support contours that have NO on-curve points (a rarely seen feature of TrueType outlines).
- skipMissingComponents = True