shadowfacts/fonttools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[qu2cu] Improve docs

Browse Source
This commit is contained in:
Behdad Esfahbod 2023-02-20 10:41:13 -07:00
parent 90a2a80524
commit 789f45d4ee
1 changed files with 19 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Lib/fontTools/qu2cu/qu2cu.py
View File

@ -27,6 +27,7 @@ from collections import namedtuple
from typing import ( from typing import (
List, List,
Tuple, Tuple,
Union,
) )
@ -168,23 +169,32 @@ def add_implicit_on_curves(p):
return q return q
Point = Union[Tuple[float, float], complex]
def quadratic_to_curves( def quadratic_to_curves(
quads: List[List[Tuple[float, float]]], quads: List[List[Point]],
max_err: float = 0.5, max_err: float = 0.5,
all_cubic: bool = False, all_cubic: bool = False,
) -> List[Tuple[Tuple[float, float], ...]]: ) -> List[Tuple[Point, ...]]:
"""Converts a connecting list of quadratic splines to a list of quadratic """Converts a connecting list of quadratic splines to a list of quadratic
and cubic curves. and cubic curves.
A quadratic spline is specified as a list of points, each of which is A quadratic spline is specified as a list of points. Either each point is
a 2-tuple of X,Y coordinates. The first and last points are on-curve points a 2-tuple of X,Y coordinates, or each point is a complex number with
and the rest are off-curve points, with an implied on-curve point in the real/imaginary components representing X,Y coordinates.
middle between every two consequtive off-curve points.
The first and last points are on-curve points and the rest are off-curve
points, with an implied on-curve point in the middle between every two
consequtive off-curve points.
Returns: Returns:
The output is a list of tuples. Each tuple is either of length three, for The output is a list of tuples of points. Points are represented
a quadratic curve, or four, for a cubic curve. Each curve's last point in the same format as the input, either as 2-tuples or complex numbers.
is the same as the next curve's first point.
Each tuple is either of length three, for a quadratic curve, or four,
for a cubic curve. Each curve's last point is the same as the next
curve's first point.
Args: Args:
quads: quadratic splines quads: quadratic splines