Pf#bdZddlmZmZddlmZdZdZdZdd Z d Z d Z dd Z dd Z ddZdS)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,|\}}|dkr||krdndS)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 =/var/www/html/env/lib/python3.11/site-packages/segno/utils.pyrrs' ME6 u11A5c(||nt|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'66-D[-Q-QQrNcb|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) Nrr)rscalerrrs rr r /sN ~(55ME6 QZE a&jF 5=&5. ((rcV|dkr"td|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)rs rr r Gs2 zzMTTUZ[[\\\zrc|;t||ks|dkr$td|dSdS)z Raises a :py:exc:`ValueError` iff `border` is negative. :param int border: Indicating the size of the quiet zone. Nrzzmatrix_iter..sO'l'l[\qA~~~~~~~~~qtt3PU(V(V'l'l'l'l'l'lrN) r r"r rrangetupler from_iterabler) r$rrrr border_row width_range height_rangeir)sr2rs ` @@rr r {sv JJEe  V , ,FME6J %vguv~ > >vgvX^@_@_K a&F1IIjE''l'l'l'l'l'l`k'l'l'lllmme$$  AIIII rc#" Kddlm}t|tt t ||}|\  kodk | dd |   fd t| |zt| |z}}|D]H ttj fd|D}tdD]}|VIdS) 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_timingctd|cxkrkrnnd|cxkr kr nn||}s||}|dkrtjtjf|Sr[ dkrU|dkr dz |cxkr dz ksndz |cxkr dz kr'nn$|dkrtjtjf|S|dz kr|dkr tjSs0|dkrd|cxkr dz ks4n|dkrd|cxkr dz ksnr6|dkr|dks |dkr$|dkrtjtjf|S|dkr|dks"s | d z ks|dkr/|dks s'|dz krtjtj f|S|dkr|dkss | dz kss-|dz kr$|dkrtj tj f|S|dkr|dkss | dz kss|dz kr|dkr tj Stj tjf|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?????qA~~~~~~~~~)A,C 2 0 3A 6  C''"?AcderssZ1uua!;!;!;!;%!)!;!;!;!;%{Q;;;;!;;;;;A & 96;STUXYY ??qAvv!11 P!q&&Q->->->->UQY->->->->AFFqSTOaOaOaOaW]`aWaOaOaOaOaPb%&!VVAaAEE0&2IJ3OOAvv1q555a%"*nnAvv1q555Q!^^0&2IJ3OO1uu!a%%%Q]]#6C()FQJ1q558&:YZ[^__1uu!a%%%Q]]#6C)*VaZAEE,,*F,AB3G G) )rc3LK|]}t|VdS)Nr/)r0r1r]r:rs rr3z&matrix_iter_verbose..s7'Z'Zwwq!}}e(D(D'Z'Z'Z'Z'Z'ZrN) segnor=r r"r r make_matrixadd_alignment_patternsr4r5rr6r)r$rrrr=r8r9r)r;rZr]rr:r[r\rs` ` @@@@@@@rrrs(v JJEe  V , ,FME6I'URZH**5&%\a*bb ""#3UFCCC$*$*$*$*$*$*$*$*$*$*L!&vguv~ > >vgvX^@_@_K E''Z'Z'Z'Z'Z'Zk'Z'Z'ZZZ[[e$$  AIIII r)rN)r)__doc__ itertoolsrrr__all__rrr r r r r rrrrrfs $####### 1 666 R R R))))0]]]hhh>:JJJJJJr