
    jkee                         d Z ddlZddlZddlZ ej                  e      Zg dZd Zd Z	e	fdZ
e	fdZded	ed
efdZy)z#
Various round-to-integer helpers.
    N)noRoundotRound
maybeRound	roundFuncnearestMultipleShortestReprc                     | S N values    ;/usr/lib/python3/dist-packages/fontTools/misc/roundTools.pyr   r      s    L    c                 D    t        t        j                  | dz               S )a  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.
          ?)intmathfloorr   s    r   r   r      s    * tzz%#+&''r   c                 <     ||       }t        || z
        |k  r|S | S r	   )abs)v	toleranceroundroundeds       r   r   r   0   s&    AhG'A+&)37::r   c                 ~    | dk  rt        d      | dk(  rt        S | dk\  r|S t        j                  t        | |      S )Nr   z#Rounding tolerance must be positiver   r   r   )
ValueErrorr   	functoolspartialr   r   s     r   r   r   5   sC    1}>??A~CZ9EJJr   r   factorreturnc                    | syt        | |z        |z  } d|z  }| |z
  }| |z   }t        |      t        |      k7  rt        t        t	        |                   S d}||z  }||z  }t        |      t        |      k(  r||k7  sJ t        t        |            D ]  }||   ||   k7  s n |j                  d      }|k  sJ d||z
  z  }|| z  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.
    z0.0r   z%.8f.z%%.%df)r   r   strfloatr   lenrangefind)r   r   epslohifmtiperiods           r   r   r   B   s    . EFN#f,E
,C	B	B
2w#b'5u&''
C	rB	rBr7c"g"(**3r7^ a5BqE> WWS\FA::
a&j
!C;r   )__doc__r   r   logging	getLogger__name__log__all__r   r   r   r   r$   r#   r   r
   r   r   <module>r4      sg      g!(0 $+ ;
  ' 
K,u ,e , ,r   