U Dv fe @srdZddlZddlZddlZeeZdddddgZddZd dZ e fd dZ e fd dZ e e e d d dZdS)z# Various round-to-integer helpers. NnoRoundotRound maybeRound roundFuncnearestMultipleShortestReprcCs|SNvaluerr=/tmp/pip-unpacked-wheel-qlge9rch/fontTools/misc/roundTools.pyrscCstt|dS)aRound 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. Args: value (float): The input floating-point value. Returns float: The rounded value. ?)intmathfloorr rrr rscCs ||}t|||kr|S|Sr)abs)v toleranceroundZroundedrrr r0scCs8|dkrtd|dkrtS|dkr(|Stjt||dS)Nrz#Rounding tolerance must be positiver rr) ValueErrorr functoolspartialrrrrr r5s)r factorreturncCs|sdSt|||}d|}||}||}t|t|krPttt|Sd}||}||}t|t|kr|||ksttt|D]}||||krqq|d}||kstd||}||S)a"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. Args: value (value): The value to be rounded and serialized. factor (float): The value which the result is a close multiple of. Returns: str: A compact string representation of the value. z0.0r z%.8f.z%%.%df) rr strfloatrlenAssertionErrorrangefind)r rZepslohifmtiZperiodrrr rBs&   )__doc__rrlogging getLogger__name__log__all__rrrrrrrrrrr s