' 4j~dZddlZddlmZmZddlmZddlmZm Z m Z m Z m Z m Z mZmZddlmZmZmZmZddlmZdd lmZmZdd lmZdd lmZmZdd lm Z erdd l!m"Z"ddlm#Z#m$Z$ddl%m&Z&ddlm'Z'Gdde Z(GddeZ)Gdde Z*GddZ+GddZ,GddZ-GddeZ.Gdd e.Z/Gd!d"eZ0Gd#d$e/e0Z1y)%zJ Usage documentation at: N)ABCabstractmethod) TracebackType) TYPE_CHECKINGAny NamedTupleOptionalSequenceTypeUnioncast)AlignWrapModeXPosYPos) FPDFException)RasterImageInfoVectorImageInfo) preload_image) FORM_FEEDMultiLineBreak)get_scale_factor)FPDF)FragmentTextLine) SVGObject) ImageDatac"eZdZUeed<eed<y)ExtentsleftrightN)__name__ __module__ __qualname__float__annotations__=/DATA/.local/lib/python3.12/site-packages/fpdf/text_region.pyr r $s K Lr)r cdeZdZdZdededdffd Zdedddfd Zdeddefd Z d d Z xZ S) TextRegionMixinz>Mix-in to be added to FPDF() in order to support text regions.argskwargsreturnNcRd|_|jt| |i|yN)%_TextRegionMixin__current_text_regionclear_text_regionsuper__init__)selfr-r. __class__s r*r5zTextRegionMixin.__init__,s)=A"   $)&)r)region TextRegionParagraphCollectorMixinc&td||_y)Nr:)r r2r6r8s r*register_text_regionz$TextRegionMixin.register_text_region1s&*,%?"r)c |j|k(Sr1r2r=s r*is_current_text_regionz&TextRegionMixin.is_current_text_region6s))V33r)cd|_yr1r@r6s r*r3z!TextRegionMixin.clear_text_region;s %)"r)r/N) r#r$r%__doc__rr5r r>boolrAr3 __classcell__r7s@r*r,r,)s^H*c*S*T* @CD@ @ 4CD4 4 *r)r,cBeZdZUdZded<ded<dZeed<dZeed<y ) LineWrapperzConnects each TextLine with the Paragraph it was written to. This allows to access paragraph specific attributes like top/bottom margins when rendering the line. rline Paragraph paragraphF first_line last_lineN)r#r$r%rEr'rNrFrOr(r)r*rJrJ?s) JItr)rJc<eZdZdeddeddeddfdZdefd Zy) Bulletbullet_fragmentsr text_linerbullet_r_marginr/Nc<||_||_||_d|_y)NF) fragmentsrSr_margin rendered_flag)r6rRrSrTs r*r5zBullet.__init__Ls" 0@"' #(r)cRd}|jD]}||jz }|SNr)rV get_width)r6fragments_widthfrags r*get_fragments_widthzBullet.get_fragments_widthWs,!"NND t~~/ /O#r))r#r$r%r r r&r5r^r(r)r*rQrQKsC )":. )J' ) )  )Ur)rQc>eZdZ d deddeeezdeedededed eed ed ed ee d efdZ defdZ d!dZ dee edeedeeddfdZd"dedeeezddfdZd ed edeeededffdZd"deeddfdZdedeefdZy)#rLNr8r9 text_align line_height top_margin bottom_marginindentrT bullet_stringskip_leading_spaceswrapmodefirst_line_indentc ||_|j|_d|_|rutj|} | tj tj tjtjfvrtd| jd| |_||j|_ n||_ ||_ ||_ ||_| |_| |jj |_nt#j| |_g|_|%dt'dz|jj(z }|rD|j+||} t-| t.sJt1| d| d||_| |_yd|_| |_y)NAText_align must be 'LEFT', 'CENTER', 'RIGHT', or 'JUSTIFY', not ''.mmrr)_regionpdfr`rcoerceLCRJ ValueErrorvaluerarbrcrdrfrgr_text_fragmentsrkgenerate_bullet_frags_and_tl isinstancetuplerQbulletrh)r6r8r`rarbrcrdrTrerfrgrhtext_align_convbullet_frags_and_tls r*r5zParagraph.__init___sm !::+/ %*\\*%=Ouww%''&JJ WXgXmXmWnnpq.DO  %11D *D $* #6   LL11DM$OOH5DM13  " "24"88488::EO "&"C"C# 159 99,2#A&(;A(>-DK "3DK!2r)r/cd|jd|jd|jd|jd|jd|j dt |jdS) NzParagraph(text_align=z, line_height=z , top_margin=z, bottom_margin=z, skip_leading_spaces=z , wrapmode=z, #text_fragments=))r`rarbrcrfrglenrwrCs r*__str__zParagraph.__str__s|#DOO#4N4CSCSBTTabfbqbqars"0011GH`H`Gaalmqmzmzl{| #D$8$8 9:! = r)c|Sr1r(rCs r* __enter__zParagraph.__enter__s r)exc_type exc_value tracebackc8|jjyr1)rn end_paragraphr6rrrs r*__exit__zParagraph.__exit__s ""$r)textlinkc,|jjs td|jj|j dd}|jj |d}|r|D] }||_ |jj|y)N3No font set, you need to call set_font() beforehand Fmarkdown) ro font_familyrnormalize_textreplace_preload_font_stylesrrwextend)r6rrnormalized_stringrVr]s r*writezParagraph.writesxx## UV V HH33D9AA$K HH ) )!E *   !  " ##I.r)rrc |sy|jj|}|jjs td|jj |d}d}|D]}||j z }t ||jj |jj|j|z |z z|jjf|jxs(|jjxstj|j|j|jxs|jj}|j!}||fS)NrFrr) max_widthmarginsalignrgrarf)rorrrrr[rrnc_marginrdr`rrqrgrarfget_line)r6rerTrRr\r]bullet_line_breakbullet_text_lines r*ryz&Paragraph.generate_bullet_frags_and_tls0// > xx## UV V HH ) ) *   "#$D t~~/ /O%* ll,,!!T[[?%B_%TU!!//GT\\%<%<G]](( $ 8 8!0||//  -557!111r)hcB|jjs td|#|jj|jz}|jj ddd}||j z|j_|jj|y)Nr Frr) rorr font_sizerarrxgraphics_state font_size_ptrwappend)r6rfragments r*lnz Paragraph.lnsxx## UV V 9""T%5%55A8800 51    018::~, ##H-r)print_shc g}t|j|jj|jj |j z|jj f|j|jxs(|jjxstj||j|j|jxs|jj }g|_|j}d}|2|jt!|||d}|j}|2|r-|d}t!|j"||j$d}||d<|S)N)rrrhrrrgrarfT)rNF)rNrO)rrwrnr[rorrdrhr`rrqrgrarfrrrJrKrN)r6r text_linesmulti_line_breakrSrNlasts r* build_lineszParagraph.build_liness2(* )  ll,,XX&&4dhh6G6GH"44//GT\\%<%<G]](( $ 8 8!0||//   "$--/  #   k)TjQ RJ(113I# b>D 4DOOtD"JrNr)) NNrrrNrFNr)r/rLr1)r#r$r%r r strrr&rFrr5rrr BaseExceptionrrintrr{r ryrlistrJrr(r)r*rLrL^s-1'+ +/$)'+#$33=>33S5[)33e_ 33  33  3333"%3333"338$33!33j  %4 ./%M*%M* %  % /# /XcCi%8 /D /2 2382 %,hz.BBC D2@ .HUO .t .DT+->r)rLceZdZ ddeddedeeezdeedeeded ed ed ed eee zd eedeeddfdZ ddZ dedededee e zfdZy)ImageParagraphNr8r9namerwidthheight fill_widthkeep_aspect_ratiorbrcrtitlealt_textr/c ||_||_d|_|rftj|} | tj tj tjfvrtd| jd| |_||_ ||_ ||_ ||_ ||_| |_| |_| |_| |_d|_d|_||_y)Nz1Align must be 'LEFT', 'CENTER', or 'RIGHT', not 'rk)r8rrrrprqrrrsrurvrrrrrbrcrrrimginforK)r6r8rrrrrrrbrcrrr align_convs r*r5zImageParagraph.__init__s  &* e,J%''577EGG!<< G HXHXGYY[\$DJ  $!2$*    (,AE $( r)ct|jjj|j\|_|_|_|Sr1)rr8ro image_cacherrrrCs r* build_linezImageParagraph.build_line's9*7 KKOO ' '* & 48TY r)col_left col_width max_heightc|j tdt|jt}t dx}}|j r |j }n>t t|jd|jjjz }|jr |j}nTt t|jd|jjjz }||kDs |jr|}n|}|j s||zz }||kDry|} |jrN|jtjk(r | ||z z } n(|jtjk(r | ||z dz z } |r|jjj!|j"t d|j$t t|j| d|||j&|j(|j*|j, } | St.r(t|j$t0s |j$J|jjj3|j"|j$t t4|j| d|||j&|j(|j*d|j, } | S) Nz;ImageParagraph.build_line() must be called before render().rrwrlr) rsvgrxyrrrrrr) rrrrrrrrrrdimsr)r RuntimeErrorrzrr&rr r8rorxrrrrrsrr _vector_imagerrrrrrrr _raster_imager) r6rrris_svgnative_hrrnative_wr return_infos r*renderzImageParagraph.render/sE 99 M DII7Qx1 ;; AE499S>2T[[__5F5FFH :: A"5$))C.9DKKOO  ::zzUWW$Y]"uww&i!mq((  --[$((3otyy9**!]]&*&<&<.    !$((I6488;O OO KKOO ) )YYHH/4995YYjj"&"8"8 *   r) NNNFFrrNNN)r/r)r#r$r%r rr rr&rFrr5rrrrr(r)r*rrs  (,!%"& "' $(#"&$)=>$)$)e $ $)  $)  $)$) $)$)$)sSy!$)}$)3-$) $)LGG*/G=BG /O3 4Gr)rc*eZdZdddddddddddded eed eezd ed ed edee deedededdffdZ d1dZ dee e dee deeddfdZd2dZ d3d edeeezddfdZd3deeddfdZ d4d eed eed edeedeed eed!eed"eedee d#eedefd$Zd2d%Z d5d&ed'eeezd(eed)eed*ed+edededeeezd,eed-eeddfd.Zed2d/Zed)edefd0ZxZS)6r;NLEFTg?F)rr`rarrfrgrimg_fill_widthrorr-rr`rarrfrgrrr.r/c8||_tj||_|jtjtj tj tjfvr#td|jjd||_ ||_ |tj|ntj|_||_g|_d|_t% |L|g| i| |r|j)||r|j+|| yy)Nrjrk)r)rorrpr`rqrrrsrtrurvrarrCHARrgrf _paragraphs_active_paragraphr4r5rimage) r6rorr`rarrfrgrrr-r.r7s r*r5z ParagraphCollectorMixin.__init__zs,,z2 ??577EGGUWWegg"F FSTXTcTcTiTiSjjlm '  )1)=HOOH %8== $7 =?04 .t.v.  JJt   JJs~J 6 r)cD|jj|r#td|jjd|jj |_|jjd|j_|jj||S)NzUnable to enter the same z context recursively.r) rorArr7r#page_page_push_local_stackr>rCs r*rz!ParagraphCollectorMixin.__enter__s| 88 * *4 0+DNN,C,C+DDYZ XX]]  ""$  %%d+ r)rrrc|jj|j|j_|jj |j yr1)ror3rr_pop_local_stackrrs r*rz ParagraphCollectorMixin.__exit__s< ""$   !!# r)c|jdk(r td|jEt||j|j}|j j |d|_yy)NEXPLICITzaConflicts with active paragraph. Either close the current paragraph or write your text inside it.)r8r`rfAUTOrrrLr`rfrr)r6ps r*_check_paragraphz(ParagraphCollectorMixin._check_paragraphsn  ! !Z /s   ! ! )??$($<$<A    # #A &%+D " *r)rc|jt|jdtr|jdj |yyNr)rrzrrLr)r6rrs r*rzParagraphCollectorMixin.writesC  d&&r*I 6   R & &t , 7r)rc|jt|jdtr|jdj |yyr)rrzrrLr)r6rs r*rzParagraphCollectorMixin.lnsA  d&&r*I 6   R # #A & 7r)rbrcrdrerTrhc  |jdk(r tdt||xs |j||xs |j| |xsd|xsd|xsd| xsd|xsd| } |j j | d|_| S)a~ Args: text_align (Align, optional): the horizontal alignment of the paragraph. line_height (float, optional): factor by which the line spacing will be different from the font height. (Default: by region) top_margin (float, optional): how much spacing is added above the paragraph. No spacing will be added at the top of the paragraph if the current y position is at (or above) the top margin of the page. (Default: 0.0) bottom_margin (float, optional): those two values determine how much spacing is added below the paragraph. No spacing will be added at the bottom if it would result in overstepping the bottom margin of the page. (Default: 0.0) indent (float, optional): determines the indentation of the paragraph. (Default: 0.0) bullet_string (str, optional): determines the fragments and text lines of the bullet. (Default: "") bullet_r_margin (float, optional): determines the spacing between the bullet and the bulleted line skip_leading_spaces (float, optional): removes all space characters at the beginning of each line. (Default: False) wrapmode (WrapMode): determines the way text wrapping is handled. (Default: None) first_line_indent (float, optional): left spacing before first line of text in paragraph. rUnable to nest paragraphs.rr) r8r`rarfrgrbrcrdrhrerTr) r6r`rarfrbrcrdrerTrgrhrs r*rMz!ParagraphCollectorMixin.paragraphs:  ! !Z / <= = !4T__# 3 Ot7O7O!Q',1;Q/41'-2+  "!+r)c@|js tdd|_y)NzNo active paragraph to end.)rrrCs r*rz%ParagraphCollectorMixin.end_paragraphs%% => >!%r)rrrrrrrrc |jdk(r td|jr|jt|||||||||| | |  } |jj | y)Nrr) rrrrrrbrcrrr)rrrrrr) r6rrrrrrrbrcrrrrs r*rzParagraphCollectorMixin.imagesw  ! !Z / <= =  ! !      !/!'  "r)cyr1r(rCs r*rzParagraphCollectorMixin.render&s!r)cyr1r()r6rs r*r[z!ParagraphCollectorMixin.get_width)s14r))r/r;rDr1) NNFrrrrNNrr)r#r$r%rr rrr&rFrr5rr rrrrrrrrLrMrrrrr[rGrHs@r*r;r;ys #"( $)'+!$ 7  7 7sm 7 %K 7  7 7" 78$ 7c] 7 7 7  7D  4 ./ M* M*    ,"%)--sSy!-  -'HUO't''+'+$)&')*"#')+/'+-..UO.e_." . UO .   .. }."%.8$.$E?. .`&(,!%"& "' $(#"& # #e $ # #  #  #  # # #sSy! #} #3- #  #D!!44%44r)r;ceZdZdZdededeeeffdZdedee e zfdZ de ee zd ed edefd Zde ee zfd ZddZdedefdZy )r:z3Abstract base class for all text region subclasses.rrr/ct)aZ Return the horizontal extents of the current line. Columnar regions simply return the boundaries of the column. Regions with non-vertical boundaries need to check how the largest font-height in the current line actually fits in there. For that reason we include the current y and the line height. NotImplementedError)r6rrs r*current_x_extentszTextRegion.current_x_extents0s "##r)rMcj|jrV|jj|jjkDr)|jxj|jz c_|j |jjd\}}|jj |jj z }||jjz }|j|||z |}|rI|j}|r;|jj|z|kr|jxj|z c_|SrZ) rbrort_marginrrb_marginrrc)r6rMr col_rightbottomrrenderedmargins r*_render_image_paragraphz"TextRegion._render_image_paragraph:s   DHHJJ1B1B$B HHJJ).. .J"44TXXZZC)dhh///dhhjj( ##Hi(.BJO ,,F488::.&8 f$ r)rtoprc |sy||j_d}d}d}|D]}t|tr|j |r|dz }+n|j }d} |j } | j} |jD]} | jsd} n| rp|jrd| sb| jrV|jj|jjkDr)|jxj| jz c_|jj|jz|kDr|}n|xsd}|j}|j|jjd\} }|jj| ks|jj|k\r| |j_|jxj| j z c_| r| j"s| j%| j&z}|jxj|zc_| j(J|jj+| j(| j(jdt,j.t0j2dd| _|jxj|z c_|jxj|j z c_|jj+||jdt,j.t0j4d|jxj|j zc_|jxj| j zc_|j6rU| j8}|rG| rE|jj|z|kr)|jxj| j8z c_|dz }|j:sn|r|d|=|xsdS)NrrFT)rbordernew_xnew_yfill)rorrzrrrKrMr|rV charactersrNrbrrrrrdrXr^rWrS_render_styled_text_linerrrTOPNEXTrOrctrailing_form_feed)r6rrrprev_line_heightlast_line_heightrendered_lines tl_wrapperrS text_rendered cur_paragraph cur_bulletr]rrbullet_indent_shiftrs r*_render_column_lineszTextRegion._render_column_linesIs(  "#,0$J*n5// ;"a'N&OO % * 4 4 *11 %//D(, 0 ""--&%00 TXX%6%66HHJJ-":"::J88:: 0 0069'7$#3#8q #,#3#3 &*&<&&>"668:;N;NN(HHJJ"55J%//;;;HH55",,$..55 "ii"hh" 604J,HHJJ"55J i... 11&&)))) 2 i...  m222 ''*88F-TXXZZ&5HF4R m&A&AA !#//I%J ?N?+$1$r)cg}|jD]c}t|tr"|j}|j |5|j |j }|sS|j|e|Sr1)rrzrrrrrr)r6rrMrK cur_liness r* collect_lineszTextRegion.collect_linessm9; ))I)^4 ++-!!$'%11$--@  !!),*r)Nctr1rrCs r*rzTextRegion.renders !##r)c|j|jj|\}}|jj|kDr/|jj|kr|jj}||z }|Sr1)rrorr)r6rstartendress r*r[zTextRegion.get_widthsZ++DHHJJ? s 88:: $((**s"2HHJJEEk r)rD)r#r$r%rEr&r{rrr rrrrrJrrrr[r(r)r*r:r:-s=$5$%$E%,>**+, %w&?vRI tU+ r)) r#r$r%rEr'rr r&r5r#rGrHs@r*r r s}4 K %)$( *  * *5/ * 5/ *  *  *,HUO,HUO,PT,r)r ceZdZdddddddeded ed ed ed d ffdZdfd ZddZ de e e zdeded d fdZ ddZdeded eeeffdZxZS) TextColumnsr F)ncolsgutterbalancerorr-r)r*r+r.r/Nct ||g|i|d|_||_||_|j j |j jz }||dz |zz |z }|j j} t| | |zg|_ td|D]2} | ||zz } |jjt| | |z4t|jj|jj|_y)Nrr)r4r5 _cur_column_ncolsr+r%r"r!r _colsrangermaxrorr_first_page_top) r6ror)r*r+r-r.total_wrc_left_r7s r*r5zTextColumns.__init__s .t.v.  ,,$$t||'8'88 V33u< ""ffy&89: q%A i&( (F JJ  gffy.@A B! #488#4#4dhhjjAr)c t|t|jj|jj |_|jr9d|_|j|jj|j_ |SrZ) r4rr1rorrr2r+r-r/r!r)r6r7s r*rzTextColumns.__enter__sc "488#4#4dhhjjA << D D$4$45::DHHJ r)c|jr@t|jdtr#|jdjty|jty)z?End the current column and continue at the top of the next one.rN)rrzrLrrrCs r* new_columnzTextColumns.new_columnsD    4+;+;B+? K   R & &y 1 JJy !r)rrrcd}|jj}|jr|}|sytd|D}||jz }||z } || krjd}||z}t j t||jz dz} |djjxsd} | | z} | |kDr|| z}||kDr|}d}t|j|jD]} |sy| |jk7r| |_ |jdd\}}|jj|ks|jj|k\r||j_ |r?| |jdz k(r-|jj|jjz }|j!||||jj|kDs|jj}||j_y)z?Rendering a set of lines in one or several columns on one page.FNc3PK|]}|jjxsd yw)rN)rKr).0ls r* z1TextColumns._render_page_lines..s!DAQVV]]/a/s$&Tg?rr)rorr+sumr.mathceilrrKrr0r-rrrrr)r6rrr balancingnext_y page_bottom tot_height col_height avail_heightlines_per_columnfirst_line_height mult_heightcrrs r*_render_page_lineszTextColumns._render_page_liness  <<!KDDDJ#dkk1J!C HixxzzH$ i(?% Q4;;?3dhh&7&77  % %j#v >xxzzF"6 r)c|jsy|j}|sy|jj|jjz }t |jj |jj}|j||||rd|jj|jj}|syd|_ |j||jj||rcyyrZ) rrrorrr1rrrK_perform_page_break_if_need_ber-)r6rrCfirst_page_top page_breaks r*rzTextColumns.render1s '')  hhjj488#4#44 TXX.. ;  NKH@@ J D   # #J K Hr)rrcB|j|j\}}||fSr1)r/r-)r6rrr!r"s r*rzTextColumns.current_x_extentsEs$jj!1!12 eU{r))r/r'rD)r#r$r%rrr&rFr5rr8rrrJrKrr{rrGrHs@r*r'r's  B BB B  B  BB B."2+5622 2  2hI(5%E%,r[s #   /.!B(1". j *c*, * &__Dvvrq5cq5hF(FR,,>r*/rr)