roundTools: Tools for rounding floats
Various round-to-integer helpers.
- 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.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