.~hS$dZddlmZmZddlmZmZ eZddl m Z dZ dZ dZdd Zd Zd Zdd ZddZddZy #e $rY,wxYw)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_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 T/var/www/peopleoo.sandbox-dev.co.uk/venv/lib/python3.12/site-packages/segno/utils.pyr r s$ 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 rr r &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 4sK ~(5ME6 QZE a&jF 5=&5. ((rcB|dkrtdj|y)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)rs rr r Ls( zMTTUZ[\\rcd|.t||k7s|dkrtdj|yy)z Raises a :py:exc:`ValueError` iff `border` is negative. :param int border: Indicating the size of the quiet zone. Nrzzmatrix_iter..s*'l[\qA~~qt3PU(V'ls),N) r r$r r rangetupler from_iterabler) r&rrrr border_row width_range height_rangeir+sr4rs ` @@rrrsv 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<r3val 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'"??AcAcderss1ua!;%!)!;%{Q;!;A & 9 96;S;STUXYY ?qAv!111!q&Q->UQY->AFqSTOaW]`aWaOaQ!VAaAE00&2I2IJ3OOAv1q5a%"*nAv1q5Q!^00&2I2IJ3OO1u!a%Q]#FQJ1q588&:Y:YZ[^__1u!a%Q]#VaZAE,,,**F,A,AB3G G)) )rc3DK|]}t|yw)Nr1)r2r3r_r<rs rr5z&matrix_iter_verbose..s'Zwq!}e(D'Zs N) segnor?r r$r r make_matrixadd_alignment_patternsr6r7rr8r)r&rrrr?r:r;r+r=r\r_rr<r]r^rs` ` @@@@@@@rrrs(v JEe  V ,FME6I'URZH**5&%\a*b ""#3[A$*$*L!&vguv~ >vgvX^@_K E'''Zk'ZZ[e$ AI sCC))rN)r)__doc__ __future__rr itertoolsrrxranger6 NameErrorr__all__r r r r r rrrrrrrksi 9# E 1 6 R)0]h>:JW  s;AA