a Sic#@sdZddlmZmZddlmZmZzeZWne y>Yn0ddl m Z dZ ddZ d d Zdd d ZddZddZdddZdddZdddZd S)z]Utility functions useful for writers or QR Code objects. DOES NOT belong to the public API. )absolute_importunicode_literals)chainrepeat)consts)get_default_border_size get_borderget_symbol_sizecheck_valid_scalecheck_valid_bordermatrix_to_lines matrix_itermatrix_iter_verbosecCs|dkr dSdS)z Returns the default border size (quiet zone) for the provided version. :param int version: 1 .. 40 or a Micro QR Code version constant. :rtype: int r)versionrrG/var/www/html/django/DPS/env/lib/python3.9/site-packages/segno/utils.pyrsrcCs|dur |St|S)a Returns `border` if not ``None``, otherwise the default border size for the provided QR Code. :param int version: 1 .. 40 or a Micro QR Code version constant :param border: The size of the quiet zone or ``None``. :type border: int or None :rtype: int Nr)rborderrrrr %s r NcCsP|durt|}|dkr$|ddn|ddd}|d|7}||9}||fS)a Returns the symbol size (width x height) with the provided border and scaling factor. :param int version: A version constant. :param scale: Indicates the size of a single module (default: 1). The size of a module depends on the used output format; i.e. in a PNG context, a scaling factor of 2 indicates that a module has a size of 2 x 2 pixel. Some outputs (i.e. SVG) accept floating point values. :type scale: int or float :param int border: The border size or ``None`` to specify the default quiet zone (4 for QR Codes, 2 for Micro QR Codes). :rtype: tuple (width, height) Nrrr r)rscalerdimrrrr 3s $ r cCs|dkrtd|dS)z Raises a :py:exc:`ValueError` iff `scale` is negative or zero. :param scale: Scaling factor. :type scale: float or int rz2The scale must not be negative or zero. Got: "{0}"N) ValueErrorformat)rrrrr Ksr cCs.|dur*t||ks|dkr*td|dS)z Raises a :py:exc:`ValueError` iff `border` is negative. :param int border: Indicating the size of the quiet zone. Nrz}||krP|sP||f||ffV|}|d7}|sd|d7}|}q*|r||f||ffVd}qdS)a Converts the `matrix` into an iterable of ((x1, y1), (x2, y2)) tuples which represent a sequence (horizontal line) of dark modules. The path starts at the 1st row of the matrix and moves down to the last row. :param matrix: An iterable of bytearrays. :param x: Initial position on the x-axis. :param y: Initial position on the y-axis. :param incby: Value to move along the y-axis (default: 1). :rtype: iterable of (x1, y1), (x2, y2) tuples rrNr) matrixxyincbyZlast_bitrowx1x2bitrrrr bs   r c #st|ttt||}t|ddd\}dg}t| |}|D]^}d|krj|krvnn||n|ttfdd|D}t dD] } |VqqRdS)aG Returns an iterator / generator over the provided matrix which includes the border and the scaling factor. If either the `scale` or `border` value is invalid, a :py:exc:`ValueError` is raised. :param matrix: An iterable of bytearrays. :param int version: A version constant. :param int scale: The scaling factor (default: ``1``). :param int border: The border size or ``None`` to specify the default quiet zone (4 for QR Codes, 2 for Micro QR Codes). :raises: :py:exc:`ValueError` if an illegal scale or border value is provided rrrrc3s8|]0}td|krkr(nn|ndVqdS)rNr.0jrrwidthrr zmatrix_iter..N) r rr r r rangetupler from_iterabler) rrrrheightZ border_row size_rangeir"srr+rrs  $ rc#sddlm}t|ttt|}tddd\dk|jddd|fddt | |}|D]:t t fd d |D}t d D] }|Vqqd S) a Returns an iterator / generator over the provided matrix which includes the border and the scaling factor. This iterator / generator returns different values for dark / light modules and therefor the different parts (like the finder patterns, alignment patterns etc.) are distinguishable. If this information isn't necessary, use the :py:func:`matrix_iter()` function because it is much cheaper and faster. If either the `scale` or `border` value is invalid, a py:exc:`ValueError` is raised. :param matrix: An iterable of bytearrays. :param int version: A version constant. :param int scale: The scaling factor (default: ``1``). :param int border: The border size or ``None`` to specify the default quiet zone (4 for QR Codes, 2 for Micro QR Codes). :raises: :py:exc:`ValueError` if an illegal scale or border value is provided r)encoderrr&F)reserve_regions add_timingcsd|krkrnnvd|kr2krnnZ||}s||}|dkrltjtjf|Sdkr|dkrd|krdksnd|krdkrnn|dkrtjtjf|S|dkr|dkrtjSsB|dkrd|krdkspn|dkrBd|kr@dkspnr|dkr\|dksp|dkr|dkrtjtjf|S|dkr|dksЈs|dks|dkr|dksЈs|dkrtjtj f|S|dkr|dks&s|dks&s6|dkr6|dkr6tj tj f|S|dkr^|dks|s^|dks|s|dkr|dkrtj Stj tjf|StjSdS) Nrr r )rTYPE_ALIGNMENT_PATTERN_LIGHTTYPE_ALIGNMENT_PATTERN_DARKTYPE_VERSION_LIGHTTYPE_VERSION_DARKTYPE_DARKMODULETYPE_TIMING_LIGHTTYPE_TIMING_DARKTYPE_FORMAT_LIGHTTYPE_FORMAT_DARKTYPE_FINDER_PATTERN_LIGHTTYPE_FINDER_PATTERN_DARKTYPE_SEPARATORTYPE_DATA_LIGHTTYPE_DATA_DARKTYPE_QUIET_ZONE)r5r*valZ alignment_val)alignment_matrixr3is_microrrr-rrget_bitsr8  & V( ( ( z$matrix_iter_verbose..get_bitc3s|]}t|VqdS)Nr'r()rQr5rrrr.r/z&matrix_iter_verbose..N)segnor7r rr r r make_matrixadd_alignment_patternsr0r1rr2r)rrrrr7r4r"r6r) rOrQr3r5rPrrrr-rrs   & r)rN)r)rN)rN)__doc__ __future__rr itertoolsrrxranger0 NameErrorr__all__rr r r r r rrrrrr s