ڊj#`dZddlmZmZddlmZdZdZdZdd Z d Z d Z dd Z dd Z ddZy)z]Utility functions useful for writers or QR Code objects. DOES NOT belong to the public API. )chainrepeat)consts)get_default_border_size get_borderget_symbol_sizecheck_valid_scalecheck_valid_bordermatrix_to_lines matrix_itermatrix_iter_verbosec(|\}}|dkDr||k(rdSdS)z Returns the default border size (quiet zone) for the provided version. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. :rtype: int ) matrix_sizewidthheights P/var/www/io.vulcan-creative.com/venv/lib/python3.12/site-packages/segno/utils.pyrrs$ ME6 u15A5c ||St|S)a& Returns `border` if not ``None``, otherwise the default border size for the provided QR Code. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. :param border: The size of the quiet zone or ``None``. :type border: int or None :rtype: int r)rborders rrr s'6Q-D[-QQrNcZ| t|}|\}}|d|zz }|d|zz }||z||zfS)a Returns the symbol size (width x height) with the provided border and scaling factor. :param tuple(int, int) matrix_size: Tuple of width and height of the matrix. :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) rr)rscalerrrs rr r .sK ~(5ME6 QZE a&jF 5=&5. ((rc,|dkrtd|dy)z Raises a :py:exc:`ValueError` iff `scale` is negative or zero. :param scale: Scaling factor. :type scale: float or int rz.The scale must not be negative or zero. Got: ""N) ValueError)rs rr r Fs& zI%PQRSSrcN|#t||k7s|dkrtd|dyy)z Raises a :py:exc:`ValueError` iff `border` is negative. :param int border: Indicating the size of the quiet zone. Nrz8The border must not a non-negative integer value. Got: "r)intr )rs rr r Qs< s6{f4 STZS[[\]^^9Crc#K||z}d}|D]B}||}}||z }|D]#}||k7r|s ||f||ff|}|dz }|s|dz }|}%|s7||f||ffd}Dyw)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) matrixxyincbylast_bitrowx1x2bits rr r [sJAH AB U  C3s1gAw&& !GBaH  q'B7" "H s AAAc#v Kt|ttt||}|\ }dg z}t | |zt | ||z}}|D]U}d|cxkr|krnn||n| t t j  fd|D} tdD]} | Wyw)al 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 tuple(int, int) matrix_size: Tuple of width and height of the matrix. :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 rc3\K|]#}td|cxkrkrnn|nd%yw)rNr).0jrrrs r zmatrix_iter..s*'l[\qA~~qt3PU(V'ls),N) r r"r rrangetupler from_iterabler) r$rrrr border_row width_range height_rangeir)sr2rs ` @@rr r zsv JEe  V ,FME6J %vguv~ >vgvX^@_K a&F1IjE'''l`k'llme$ AI sB4B9c# Kddlm}t|tt t ||}|\  k(xrdk |j  dd |j   fd t| |zt| |z}}|D]@ ttj fd|D}tdD]}|Byw) 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 tuple(int, int) matrix_size: Tuple of width and height of the matrix. :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)encoderF)reserve_regions add_timingcd|cxkrkr.ntjSd|cxkr krntjS||}s||}|dk7r#tjtjf|SrY dkDrT|dkr dz |cxkr dz ksndz |cxkrdz kr+nn(|dkr#tjtjf|S|dz k(r|dk(rtj Ss*|dk(rd|cxkr dz ks-n|dk(rd|cxkrdz ksnr7|dk(r|dkDs |dk(r(|dkDr#tj tjf|S|dk(r|dkss| d z kDs|dk(r2|dks s+|dz kDr#tjtjf|S|dkr|dkss| dz kDss0|dz kDr(|dkr#tjtjf|S|dkr|dkss| dz kDss|dz kDr|dkrtjStjtjf|StjS) Nrr)  )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) r:r1val alignment_valalignment_matrixris_micro is_squarer$rs rget_bitz$matrix_iter_verbose..get_bits` ?F?D)) )E !A~~D)) )C)A,C 0 3A 6  C'"??AcAcderssA%"*q"<519"< & a <&1* <Q & 9 96;S;STUXYY ?qAv!11116a!.?eai.?Q!VPQTUPbX^abXbPb qAv!a%Q!VA00&2I2IJ3OOQAE(q52:~QAE(q6A:~00&2I2IJ3OOA1q5a%!)m$VaZAE88&:Y:YZ[^__A1q5a%!)m$!fqj.QU,,,**F,A,AB3G G)) )rc3DK|]}t|yw)Nr/)r0r1r]r:rs rr3z&matrix_iter_verbose..s'Zwq!}e(D'Zs N) segnor=r r"r r make_matrixadd_alignment_patternsr4r5rr6r)r$rrrr=r8r9r)r;rZr]rr:r[r\rs` ` @@@@@@@rrrs(v JEe  V ,FME6I'URZH**5&%\a*b ""#3UFC$*$*L!&vguv~ >vgvX^@_K E'''Zk'ZZ[e$ AI sCC*)rN)r)__doc__ itertoolsrrr__all__rrr r r r r rrrrrfsE $ 1 6 R)0T_>:Jr