roundTools: Tools for rounding floats

Various round-to-integer helpers.

fontTools.misc.roundTools.noRound(value)[source]
fontTools.misc.roundTools.otRound(value)[source]

Round float value to nearest integer towards +Infinity.

The OpenType spec (in the section on “normalization” of OpenType Font Variations) defines the required method for converting floating point values to fixed-point. In particular it specifies the following rounding strategy:

for fractional values of 0.5 and higher, take the next higher integer; for other fractional values, truncate.

This function rounds the floating-point value according to this strategy in preparation for conversion to fixed-point.

Parameters:

value (float) – The input floating-point value.

Returns

float: The rounded value.

fontTools.misc.roundTools.maybeRound(v, tolerance, round=<function otRound>)[source]
fontTools.misc.roundTools.roundFunc(tolerance, round=<function otRound>)[source]
fontTools.misc.roundTools.nearestMultipleShortestRepr(value: float, factor: float) → str[source]

Round to nearest multiple of factor and return shortest decimal representation.

This chooses the float that is closer to a multiple of the given factor while having the shortest decimal representation (the least number of fractional decimal digits).

For example, given the following:

>>> nearestMultipleShortestRepr(-0.61883544921875, 1.0/(1<<14))
'-0.61884'

Useful when you need to serialize or print a fixed-point number (or multiples thereof, such as F2Dot14 fractions of 180 degrees in COLRv1 PaintRotate) in a human-readable form.

Parameters:
  • value (value) – The value to be rounded and serialized.

  • factor (float) – The value which the result is a close multiple of.

Returns:

A compact string representation of the value.

Return type:

str