h`D ddZddlZddlZddlmZddlmZddlmZm Z ddl m Z ddl m Z gdZejeZGd d eZGd d eZGd dZGddejZGddejZejejejejejejiZedGdde Zdededededef dZdededededef dZ edGdd e Z!edGd!d"e Z"dS)#z!Layout utilities (to be expanded)N) dataclass)Fraction)OptionalUnion)ConfigurableMixin)ConfigurationError) LayoutErrorBoxSpecificationErrorBoxConstraints AxisAlignmentMargins InnerScalingSimpleBoxLayoutRule Positioningc(eZdZdZdeffd ZxZS)r z+Indicates an error in a layout computation.msgcJ||_tj|g|RdSN)rsuper__init__)selfrargs __class__s T/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/pyhanko/pdf_utils/layout.pyrzLayoutError.__init__s/$t$$$$$$)__name__ __module__ __qualname____doc__strr __classcell__rs@rr r sJ55%C%%%%%%%%%%rr c6eZdZdZddeeffd ZxZS)r z4Raised when a box constraint is over/underspecified.NrcPt|pddS)Nz%box constraint is over/underspecified)r)rr)rrrs rrzBoxSpecificationError.__init__%s* SK$KLLLLLrr)rrrrrr rr!r"s@rr r "s_>>MMHSMMMMMMMMMMMrr ceZdZUdZeeed<eeed<eeed<eed< dde ee dfde ee dfd eefd Z d Z e d efd ZejdZe d efdZe d efdZejdZe d efdZe d efdZe d efdZdS)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_ratioc|t|nd}|t|nd}||_||_d}d|_|||dS|#|!|tt |||_d}nV|T||_|%tt ||z|_n&|$tt ||z |_||_dS)NFT)intr&r'r(r rroundr))rr*r+r, int_width int_heightfully_specifieds rrzBoxConstraints.__init__7s #("3CJJJ $*$6S[[[D  !   !3 8L F  "z'='++ :66DH"OO  %#DH%!% \(A"B"BCC &"5\)A#B#BCC /rcH|j/|j(t|j|j|_d|_dS|jb|j*t |j|jz|_d|_dS|j,t |j|jz |_d|_dSdSdS)NT)r&r'rr(r)r.rs r _recalculatezBoxConstraints._recalculateUs ; "t|'? T\::DH$(D ! ! ! X !|'!$,"9:: (,%%%("4;#9:: (,%%% " !)(rreturnc,|j|jSt)z :return: The width of the box. :raises BoxSpecificationError: if the box's width could not be determined. )r&r r4s rr*zBoxConstraints.widthas ; "; ' 'rcX|j||_|dStr)r&r5r rr*s rr*zBoxConstraints.widthns/ ; DK        ' 'rc|jduS)z :return: ``True`` if the box currently has a well-defined width, ``False`` otherwise. N)r&r4s r width_definedzBoxConstraints.width_definedvs{$&&rc,|j|jSt)z :return: The height of the box. :raises BoxSpecificationError: if the box's height could not be determined. )r'r r4s rr+zBoxConstraints.heights < #< ' 'rcX|j||_|dStr)r'r5r rr+s rr+zBoxConstraints.heights/ < !DL        ' 'rc|jduS)z :return: ``True`` if the box currently has a well-defined height, ``False`` otherwise. N)r'r4s rheight_definedzBoxConstraints.height_defineds|4''rc,|j|jSt)z :return: The aspect ratio of the box. :raises BoxSpecificationError: if the box's aspect ratio could not be determined. )r(r r4s rr,zBoxConstraints.aspect_ratios 8 8O' 'rc|jduS)z :return: ``True`` if the box currently has a well-defined aspect ratio, ``False`` otherwise. N)r(r4s raspect_ratio_definedz#BoxConstraints.aspect_ratio_definedsxt##r)NNN)rrrrrr.__annotations__rboolrfloatrr5propertyr*setterr;r+r@r,rCrrr r )s SM c] ( *.*.+/ 00S%%&0c5$&'0x( 0000< - - - (s ( ( (X ( \((\('t'''X' ( ( ( (X ( ]((](((((X( (h ( ( (X ($d$$$X$$$rr ceZdZdZejZ ejZ ejZ ejZ e de ddfdZ dS)rz(Class representing a scaling convention. config_strr6c tjtjtjtjd|S#t $rtd|dwxYw)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)clsrKs r from_configzInnerScaling.from_configs $/ , 9"."=!-!;    " "    $$J$$$  s AA A'N) rrrrenumautorOrPrQrR classmethodr rVrIrrrrs22J49;;L5TY[[N DIKKM S^[rrceZdZdZejZ ejZ ejZ e de ddfdZ e de ddfdZ e dZdededefd Zd S) r z;Class representing one-dimensional alignment along an axis. align_strr6c tjtjtjd|S#t $rt d|dwxYw)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. )leftmidrightrNzO' is not a valid horizontal alignment; valid values are 'left', 'mid', 'right'.r ALIGN_MIN ALIGN_MID ALIGN_MAXrSrTrrUr[s r from_x_alignzAxisAlignment.from_x_aligns %/$.&0oo ! !    $6I666   ;>Ac tjtjtjd|S#t $rt d|dwxYw)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. )bottomr^toprNzM' is not a valid vertical alignment; valid values are 'bottom', 'mid', 'top'.r`rds r from_y_alignzAxisAlignment.from_y_align s '1$.$.oo ! !    $6I666  rfct|Sr)_alignment_oppositesr4s rflippedzAxisAlignment.flipped#s #D))r container_len inner_lenc 6td|||}|tjkr||z |z S|tjkr|S||kr)t d|d|d|d|d |S|tjkr ||z dz}||zSt)NlengthzContent box width/height z is too wide for container size z with margins (, z); post_margin will be ignored) r effectiver rcraloggerwarningrb TypeError)rrnro pre_margin post_margineffective_max_len inner_offsets ralignzAxisAlignment.align's$-- mZ   =* * * !9,{: : ], , ,  * * * NNNINN"/NNNN"-NNN      ], , ,- 9a?L , ,rN)rrrrrWrXrarbrcrYr rerjrGrmr.r|rIrrr r sEE I I IS_[,S_[,**X* -0 rr T)frozencJeZdZUdZeed< eed< eed< eed< dZdS)rzP Class describing the position and scaling of an object in a container. x_posy_posx_scaley_scalec<d|j|j|j|jfzS)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)rrrrr4s ras_cmzPositioning.as_cm^s*% L L J J (   rN)rrrrr.rDrFrrIrrrrLsa JJJ JJJ NNN NNN     rr alignment container_boxinner_nat_widthrxrych|jr||j|||S||z|z|_|Sr)r;r|r*)rrrrxrys r _aln_widthrosK"  *k   . :[H rinner_nat_heightch|jr||j|||S||z|z|_|Sr)r@r|r+)rrrrxrys r _aln_heightrsL#  "2J     0*<{J rceZdZUdZdZeed<dZeed<dZeed<dZ eed<e dZ e dZ d Zd Ze fd ZxZS) r z"Class describing a set of margins.rr]r_rirhc&t||||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 )rUnums runiformzMargins.uniformssCc***rc Z||z |z }|dkrtd|d|d|d|d |S)z4Internal helper method to compute effective margins.rz Margins (rrz) too wide for container  .)r )dim_namernpreposteffs rrtzMargins.effectivesqc!D( 77/C//4////+///  rcPtd||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 rtr]r_r9s reffective_widthzMargins.effective_widths"  %DJGGGrcPtd||j|jS)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 rtrhrir>s reffective_heightzMargins.effective_heights"  64;IIIrct|trttd|}t |S)N)r]r_rirh) isinstancelistdictziprrV)rU config_dictrs rrVzMargins.from_configsN k4 ( ( 6 DDKww"";///r)rrrrr]r.rDr_rirhrYr staticmethodrtrrrVr!r"s@rr r s,,D#MMME3NNNCLLLFCOOO + +[ +\ H H H J J J0000[00000rr ceZdZUdZeed< eed< eZeed< ej Z eed< e dZ deddfd Z d ed ed edefd ZdS)rzk Class describing alignment, scaling and margin rules for a box positioned inside another box. x_aligny_alignmarginsinner_content_scalingc|dtj}t|trt|}||d<|dtj}t|trt|}||d<|dd}|t||d<dSdS)Nrrr) getr rbrr rerjrrV)rUrrrscalings rprocess_entriesz#SimpleBoxLayoutRule.process_entriess//)]-DEE gs # # :#0099G!( I//)]-DEE gs # # :#0099G!( I//"94@@  3?3K3K44K/ 0 0 0  r new_marginsr6cFt|j|j||jS)N)rrrr)rrrr)rrs rsubstitute_marginsz&SimpleBoxLayoutRule.substitute_marginss,"LL"&"<     rrrrcD|j}|j}dx}}|tjkr|jr|jr||j}||j } |dkr||z nd}|dkr| |z nd}|tj krt||x}}n#|tj krt||dx}}t|j|||z|j|j} t#|j|||z|j|j} t+| | ||S)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)rrrr)rrrrOr;r@rr*rr+rQminrRrrr]r_rrrhrir) rrrrrrrr eff_width eff_heightrrs rfitzSimpleBoxLayoutRule.fit sp*,,' |. . .+ /, / // 0CDDI 11-2FGGJ2AA1E1E_,,1 4Dq3H3H...a ,555$'$9$99''L666%(!$<$<<' L  g % L M    L  w & N K   ugw    rN)rrrrr rDr rrrRrrYrrr r.rrrIrrrrs wyyGW   +7*D<DDD[$ g :O    = %= =  =  = = = = = = rr)#rrWlogging dataclassesr fractionsrtypingrrpyhanko.config.apirpyhanko.config.errorsr__all__ getLoggerrru ValueErrorr r r Enumrr rbrarcrlrr.rrr rrIrrrs-'' !!!!!!""""""""000000444444     8 $ $%%%%%*%%%MMMMMKMMMH$H$H$H$H$H$H$H$V,,,,,49,,,^^^^^^DI^^^F]4]4]4 $     #   D  !          !          $C0C0C0C0C0C0C0C0L $r r r r r +r r r r r r