37 lines
1.0 KiB
Python
37 lines
1.0 KiB
Python
|
"""
|
||
|
|
Various round-to-integer helpers.
|
||
|
|
"""
|
||
|
|
|
||
|
|
import math
|
||
|
|
import logging
|
||
|
|
|
||
|
|
log = logging.getLogger(__name__)
|
||
|
|
|
||
|
|
__all__ = [
|
||
|
|
"otRound",
|
||
|
|
]
|
||
|
|
|
||
|
|
def otRound(value):
|
||
|
|
"""Round float value to nearest integer towards ``+Infinity``.
|
||
|
|
|
||
|
|
The OpenType spec (in the section on `"normalization" of OpenType Font Variations <https://docs.microsoft.com/en-us/typography/opentype/spec/otvaroverview#coordinate-scales-and-normalization>`_)
|
||
|
|
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.
|
||
|
|
|
||
|
|
Args:
|
||
|
|
value (float): The input floating-point value.
|
||
|
|
|
||
|
|
Returns
|
||
|
|
float: The rounded value.
|
||
|
|
"""
|
||
|
|
# See this thread for how we ended up with this implementation:
|
||
|
|
# https://github.com/fonttools/fonttools/issues/1248#issuecomment-383198166
|
||
|
|
return int(math.floor(value + 0.5))
|
||
|
|
|