o &zh`D @sbdZddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z gdZeeZGd d d eZGd d d eZGd ddZGdddejZGdddejZejejejejejejiZeddGddde Zdededededef ddZdededededef dd Z eddGd!d"d"e Z!eddGd#d$d$e Z"dS)%z!Layout utilities (to be expanded)N) dataclass)Fraction)OptionalUnion)ConfigurableMixin)ConfigurationError) LayoutErrorBoxSpecificationErrorBoxConstraints AxisAlignmentMargins InnerScalingSimpleBoxLayoutRule Positioningcs&eZdZdZdeffdd ZZS)rz+Indicates an error in a layout computation.msgcs||_tj|g|RdSN)rsuper__init__)selfrargs __class__S/var/www/html/kangema/venv/lib/python3.10/site-packages/pyhanko/pdf_utils/layout.pyrszLayoutError.__init__)__name__ __module__ __qualname____doc__strr __classcell__rrrrrsrcs,eZdZdZddeeffdd ZZS)r z4Raised when a box constraint is over/underspecified.Nrcstj|pdddS)Nz%box constraint is over/underspecified)r)rr)rrrrrr%szBoxSpecificationError.__init__r)rrrrrrrrrrrrr "s r c@seZdZUdZeeed<eeed<eeed<eed<   dde ee dfde ee dfd eefd d Z d d Z e defddZejddZe defddZe defddZejddZe defddZe defddZe defddZdS)r a)Represents a box of potentially variable width and height. Among other uses, this can be leveraged to produce a variably sized box with a fixed aspect ratio. If width/height are not defined yet, they can be set by assigning to the :attr:`width` and :attr:`height` attributes. _width_height_ar_fully_specifiedNwidthheight aspect_ratiocCs|durt|nd}|durt|nd}||_||_d}d|_|dur-|dur-|dur-dS|durD|durD|dur;tt|||_d}n"|durf||_|durYtt|||_n |durftt|||_||_dS)NFT)intr r!r"r rroundr#)rr$r%r& int_width int_heightfully_specifiedrrrr7s(  zBoxConstraints.__init__cCs|jdur|jdurt|j|j|_d|_dS|jdurB|jdur/t|j|j|_d|_dS|jdurDt|j|j|_d|_dSdSdS)NT)r r!rr"r#r'rrrr _recalculateUs      zBoxConstraints._recalculatereturncC|jdur|jSt)z :return: The width of the box. :raises BoxSpecificationError: if the box's width could not be determined. N)r r r,rrrr$a zBoxConstraints.widthcC |jdur||_|dStr)r r-r rr$rrrr$n  cC |jduS)z :return: ``True`` if the box currently has a well-defined width, ``False`` otherwise. N)r r,rrr width_definedv zBoxConstraints.width_definedcCr/)z :return: The height of the box. :raises BoxSpecificationError: if the box's height could not be determined. N)r!r r,rrrr%r0zBoxConstraints.heightcCr1r)r!r-r rr%rrrr%r3cCr4)z :return: ``True`` if the box currently has a well-defined height, ``False`` otherwise. N)r!r,rrrheight_definedr6zBoxConstraints.height_definedcCr/)z :return: The aspect ratio of the box. :raises BoxSpecificationError: if the box's aspect ratio could not be determined. N)r"r r,rrrr&r0zBoxConstraints.aspect_ratiocCr4)z :return: ``True`` if the box currently has a well-defined aspect ratio, ``False`` otherwise. N)r"r,rrraspect_ratio_definedr6z#BoxConstraints.aspect_ratio_defined)NNN)rrrrrr'__annotations__rboolrfloatrr-propertyr$setterr5r%r8r&r9rrrrr )sB           r c@sNeZdZdZeZ eZ eZ eZ e de ddfddZ dS)r z(Class representing a scaling convention. config_strr.cCs@ztjtjtjtjd|WStytd|dw)a  Convert from a configuration string. :param config_str: A string: 'none', 'stretch-fill', 'stretch-to-fit', 'shrink-to-fit' :return: An :class:`.InnerScaling` value. :raise ConfigurationError: on unexpected string inputs. )nonez stretch-fillzstretch-to-fitz shrink-to-fit'zs' is not a valid inner scaling setting; valid values are 'none', 'stretch-fill', 'stretch-to-fit', 'shrink-to-fit'.)r NO_SCALING STRETCH_FILLSTRETCH_TO_FIT SHRINK_TO_FITlowerKeyErrorr)clsr?rrr from_configs   zInnerScaling.from_configN) rrrrenumautorBrCrDrE classmethodrrIrrrrr sr c@s|eZdZdZeZ eZ eZ e de ddfddZ e de ddfddZ e dd Zd ed edefd d ZdS)r z;Class representing one-dimensional alignment along an axis. align_strr.cC<ztjtjtjd|WStytd|dw)a Convert from a horizontal alignment config string. :param align_str: A string: 'left', 'mid' or 'right'. :return: An :class:`.AxisAlignment` value. :raise ConfigurationError: on unexpected string inputs. )leftmidrightrAzO' is not a valid horizontal alignment; valid values are 'left', 'mid', 'right'.r ALIGN_MIN ALIGN_MID ALIGN_MAXrFrGrrHrMrrr from_x_align   zAxisAlignment.from_x_aligncCrN)a  Convert from a vertical alignment config string. :param align_str: A string: 'bottom', 'mid' or 'top'. :return: An :class:`.AxisAlignment` value. :raise ConfigurationError: on unexpected string inputs. )bottomrPtoprAzM' is not a valid vertical alignment; valid values are 'bottom', 'mid', 'top'.rRrVrrr from_y_align rXzAxisAlignment.from_y_aligncCst|Sr)_alignment_oppositesr,rrrflipped#szAxisAlignment.flipped container_len inner_lenc Cstd|||}|tjkr|||S|tjkr|S||kr2td|d|d|d|d |S|tjkrA||d}||St)NlengthzContent box width/height z is too wide for container size z with margins (, z); post_margin will be ignored) r effectiver rUrSloggerwarningrT TypeError)rr^r_ pre_margin post_margineffective_max_len inner_offsetrrralign's,     zAxisAlignment.alignN)rrrrrJrKrSrTrUrLrrWr[r=r]r'rkrrrrr s* r T)frozenc@sBeZdZUdZeed< eed< eed< eed< ddZdS) rzP Class describing the position and scaling of an object in a container. x_posy_posx_scaley_scalecCsd|j|j|j|jfS)z Convenience method to convert this :class:`.Positioning` into a PDF ``cm`` operator. :return: A byte string representing the ``cm`` operator corresponding to this :class:`.Positioning`. s%g 0 0 %g %g %g cm)rorprmrnr,rrras_cm^s  zPositioning.as_cmN)rrrrr'r:r<rqrrrrrLs  r alignment container_boxinner_nat_widthrgrhcC*|jr ||j|||S||||_|Sr)r5rkr$)rrrsrtrgrhrrr _aln_widtho  rvinner_nat_heightcCrur)r8rkr%)rrrsrxrgrhrrr _aln_heightrwrycs~eZdZUdZdZeed<dZeed<dZeed<dZ eed<e ddZ e d d Z d d Zd dZe fddZZS)r z"Class describing a set of margins.rrOrQrZrYcCst||||S)z Return a set of uniform margins. :param num: The uniform margin to apply to all four sides. :return: ``Margins(num, num, num, num)`` )r )rHnumrrruniforms zMargins.uniformc Cs:|||}|dkrtd|d|d|d|d |S)z4Internal helper method to compute effective margins.rz Margins (raz) too wide for container  .)r)dim_namer^preposteffrrrrcs zMargins.effectivecCtd||j|jS)a& Compute width without margins. :param width: The container width. :return: The width after subtracting the left and right margins. :raises LayoutError: if the container width is too short to accommodate the margins. r$)r rcrOrQr2rrreffective_width zMargins.effective_widthcCr)a+ Compute height without margins. :param height: The container height. :return: The height after subtracting the top and bottom margins. :raises LayoutError: if the container height is too short to accommodate the margins. r%)r rcrYrZr7rrreffective_heightrzMargins.effective_heightcs$t|tr ttd|}t|S)N)rOrQrZrY) isinstancelistdictziprrI)rH config_dictrrrrIs  zMargins.from_config)rrrrrOr'r:rQrZrYrLr{ staticmethodrcrrrIrrrrrr s          r c@s~eZdZUdZeed< eed< eZeed< ej Z eed< e ddZ ded dfd d Z d ed eded efddZdS)rzk Class describing alignment, scaling and margin rules for a box positioned inside another box. x_aligny_alignmarginsinner_content_scalingcCs~|dtj}t|trt|}||d<|dtj}t|tr&t|}||d<|dd}|dur=t||d<dSdS)Nrrr) getr rTrrrWr[r rI)rHrrrscalingrrrprocess_entriess      z#SimpleBoxLayoutRule.process_entries new_marginsr.cCst|j|j||jdS)N)rrrr)rrrr)rrrrrsubstitute_marginss z&SimpleBoxLayoutRule.substitute_marginsrsrtrxc Cs|j}|j}d}}|tjkrO|jrO|jrO||j}||j } |dkr)||nd}|dkr3| |nd}|tj krBt ||}}n |tj krOt ||d}}t |j||||j|j} t|j||||j|j} t| | ||dS)a Position and possibly scale a box within a container, according to this layout rule. :param container_box: :class:`.BoxConstraints` describing the container. :param inner_nat_width: The inner box's natural width. :param inner_nat_height: The inner box's natural height. :return: A :class:`.Positioning` describing the scaling & position of the lower left corner of the inner box. r)rmrnrorp)rrr rBr5r8rr$rr%rDminrErvrrOrQryrrYrZr) rrsrtrxrrrorp eff_width eff_heightrmrnrrrfit sF     zSimpleBoxLayoutRule.fitN)rrrrr r:r rr rErrLrrr r'rrrrrrrs,  r)#rrJlogging dataclassesr fractionsrtypingrrpyhanko.config.apirpyhanko.config.errorsr__all__ getLoggerrrd ValueErrorrr r Enumr r rTrSrUr\rr'rvryr rrrrrs`      /c"  F