h5jBdZddlmZddlZddlmZmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZmZdd lmZmZmZddlmZddlmZddl m!Z!m"Z"m#Z#m$Z$m%Z%erddl&m'Z'ejPe)Z*edgdZ+e+ddddZ,e+ddddZ-e+ddddZ.e+ddddZ/e+ddddZ0e+ddddZ1e+ddddZ2e+ddddZ3GddeZ4GddeZ5Gdde5Z6Gdde5Z7Gdde6Z8d,d Z9d-d!Z:Gd"d#Z;e Gd$d%Z<Gd&d'Z=Gd(d)Z>Gd*d+Z?y).aLow-level module for generating PDF content streams. Most users should use another library such as reportlab for a more intuitive interface. In particular, it does not have a text layout engine and only has rudimentary font management. This module is useful if you need full manual control over how content streams are generated. OCRmyPDF, for example, uses this module to to generate OCR text with precise text positioning on the page in a way that isn't possible (or desirable) with reportlab or other libraries. ) annotationsN)ABCabstractmethod) namedtuple)contextmanager) dataclassDecimal)Enum)BytesIO)Path) TYPE_CHECKINGcast)ContentStreamInstructionMatrixPdf)CHARNAMES_TO_UNICODE)unparse_content_stream)Array DictionaryNameOperatorStringImageColor)redgreenbluealphag?ceZdZdZdZ dZy) TextDirectionzEnumeration for text direction.r!N)__name__ __module__ __qualname____doc__LTRRTLD/var/www/html/qr/venv/lib/python3.12/site-packages/pikepdf/canvas.pyr#r#5s) C% C6r,r#cReZdZdZe dddd ddZed dZy) FontzBase class for fonts.r char_spacing word_spacingcy)FEstimate the width of a text string when rendered with the given font.Nr+selftextfontsizer1r2s r- text_widthzFont.text_widthAr,cy)aNRegister the font. Create several data structures in the Pdf to describe the font. After registering the font, the returned object should be added to the /Resources dictionary of any page or Form XObject that uses the font. For example one might write: ```python page.Resources.Font[Name.Arial] = font.register(pdf) ``` The same object can be used for multiple pages or Form XObjects, since it is an indirect object. Returns a Dictionary suitable for insertion into a /Resources /Font dictionary. Nr+r6pdfs r-registerz Font.registerLr:r,Nr! r7 str | bytesr8float | int | Decimalr1 int | Decimalr2rCreturnrBr=rrDr)r%r&r'r(rr9r>r+r,r-r/r/>su+,U '(&' UU(U $ U $ U UU  r,r/cveZdZdZeeddZeeddZeeddZed dZ y) DimensionedFontzBase class for fonts that have dimensional information. Specifically, these fonts can provide leading and ascent/descent values, and encode strings to the encoding used by the font. .. versionadded:: 9.8.1 cy)zHDefault leading (line spacing) value for this font; 0 if not applicable.Nr+r6s r-leadingzDimensionedFont.leadingjr:r,cy)z.The max height of the font above the baseline.Nr+rIs r-ascentzDimensionedFont.ascentor:r,cy)z.The max height of the font below the baseline.Nr+rIs r-descentzDimensionedFont.descenttr:r,cy)z2Encode a string in the encoding used by this font.Nr+r6r7s r-encodezDimensionedFont.encodeyr:r,N)rDz Decimal | int)rDzDecimal | int | Noner7strrDbytes) r%r&r'r(propertyrrJrLrNrQr+r,r-rGrGassWW====AAr,rGc>eZdZdZ dddd ddZd dZy) HelveticaaHelvetica font. Helvetica is one of the 14 PDF standard fonts that can typically be counted on being present even if not embedded in the PDF document. However, starting with PDF 2.0, PDF processors are no longer guaranteed to have these fonts. See 9.6.2.2. rr0ct)r4)NotImplementedErrorr5s r-r9zHelvetica.text_widths "##r,c|jttjtjtj S)Register the font.)BaseFontTypeSubtype) make_indirectrrrWr/Type1r<s r-r>zHelvetica.registers2  YY    r,Nr?r@rE)r%r&r'r(r9r>r+r,r-rWrW~sS+, $ '(&' $ $( $ $ $ $ $  $ r,rWceZdZUdZded<dZddZeddZddZ e ddZ e dd Z e dd Z dd Z d dd Z d dd ZddZddZ d ddZ dddd d dZy)! SimpleFontaFont implementation designed to work with Type 1 Fonts and TrueType fonts. As described in section 9.6 of the PDF spec. See also section 9.8: Font Descriptors. The PDF spec also considers Type3 fonts to be "Simple Fonts", but Type3 fonts are not implemented here. rdataNctj|vs;|jtjtjtjfvr t d|||_y)z=Create a SimpleFont instance from a font resource dictionary.zDFont resource dictionary does not describe a Type1 or TrueType font:N)rr^r`MMType1TrueType ValueErrorrc)r6rcs r-__init__zSimpleFont.__init__sQ <zSimpleFont.registers  ++r,ctj|jjvr*t d|jjjSy)z!Returns leading for a SimpleFont.rCr)rLeadingrcFontDescriptorrrIs r-rJzSimpleFont.leadings: <<49933 3)A)A)I)IJ Jr,c^tt|jjjS)z Returns ascent for a SimpleFont.)rr rcryAscentrIs r-rLzSimpleFont.ascents!GTYY55<<==r,c^tt|jjjS)z!Returns descent for a SimpleFont.)rr rcryDescentrIs r-rNzSimpleFont.descents!GTYY55==>>r,ct|tr|j|}t|ttt frt |d}|jjtj}|| t |ndz }tj|jvrKt|jj|kDr)tt|jj|}|Stj|jj vr0tt|jj j}|Std}|S)zGet the (unscaled) width of the character, in glyph-space units. Args: char: The character to check. May be a char code, or a string containing a single character. r)rnrSrQrT bytearray memoryviewintrcgetr FirstCharWidthslenrr MissingWidthry)r6char first_char char_codewidths r-unscaled_char_widthzSimpleFont.unscaled_char_widths dC ;;t$D dUIz: ;tAw>2 J4JZPQR ;;$)) #DII,<,<(= (I$))"2"29"=>E    $))":": :$))":":"G"GHE AJE r,c(td}||z |zS)aConvert width from glyph space to text space, scaling by font size. Scaling based on the nominal height (see 9.2.2): "This standard is arranged so that the nominal height of tightly spaced lines of text is 1 unit. ... The standard-size font shall then be scaled to be usable." This means, essentially, that a font size of 1 means a character is 1 text-space unit high, and a font size of 12 is 12 text-space units high. Assuming no text scaling is in place (such as via the text matrix), and the PDF has not set a user-defined unit in the page dictionary, then text space units will be points (defined as 1/72 of an inch). r r6rr8glyph_space_ratios r- convert_widthzSimpleFont.convert_widths$$DM))X55r,c(td}||z|z S)zHConvert width from text space back to glyph space, scaling by font size.rr rs r-convert_width_reversez SimpleFont.convert_width_reverse s $DM))X55r,c@tj|jvr tdt |jjtr4|j |t t|jjSt |jjtrt t|jj}tj|vrT|jtj}|j|t t|jt d|Stj|vr td|j |t t|jStdt|jj)aEncode a string in the encoding used by this font. This currently only works with fonts that use the WinAnsiEncoding or the MacRomanEncoding. Differences maps are supported, though with a limited set of recognized character names. z1Cannot encode without explicitly defined encoding Name | NonezUnsupported encoding type: )rEncodingrcrYrn _encode_namedrr Differencesr BaseEncoding_encode_diffmaprrorp)r6r7 encoding_dict base_encodings r-rQzSimpleFont.encodesC == )&C  dii(($ /%%dDtyy7I7I,JK K dii((* 5 TYY-?-?@M=0 - 1 1$2C2C D ++ 9 9: 6   5)G%%dD}7Q7Q,RS S5d499;M;M6N5OPQQr,cj|tjk(r td|tjk(r|j dS|tj k(r|j dS|tj k(r td|tjk(r|j dStd|)Nz!Cannot encode to StandardEncodingcp1252 mac_romanz"Cannot encode to MacExpertEncodingpdfdoc_pikepdfzUnknown encoding:) rStandardEncodingrYWinAnsiEncodingrQMacRomanEncodingMacExpertEncodingPDFDocEncodingrg)r6r7encodings r-rzSimpleFont._encode_named4s t,, ,&&IJ J t++ +;;x( ( t,, ,;;{+ + t-- -&&JK K t** *;;/0 0,h77r,c|jt||_t}|D]}||jvr|j|j|0|"|j |j ||T|j r|jt|tjdt|d|S)NzNo mapping for z in current encoding; skipped) _diffmap_cache_differences_map_lookuprappendextendrisasciiordlogwarningrepr)r6r7diffmaprresultrs r-rzSimpleFont._encode_diffmapGs    &"9'"BD  YDt*** d11$78* d00}EF c$i( od4j\9VWX Y r,rr0c d}td}t|tr|j|}|D]$}||j ||zz }||k(s ||z }&t|t r t |}|j||S)akGet the width of the string. This is the width of the string when rendered with the current font, scaled by the given font size. Args: text: The string to check fontsize: The target font size in text-space units. (Assuming text space isn't being scaled, this means the font size in points.) char_spacing: Additional space that will be added between each character. May be negative. word_spacing: Additional space that will be added after each ASCII space character (' '). May be negative. r )rrnrSrQrfloatr r)r6r7r8r1r2r ascii_spacebytes r-r9zSimpleFont.text_widthYs, !#h dC ;;t$D &D T--d3lB BE{"% & h &x(H!!%22r,)rcr)rrrrsrrDrbrE)rDrC)rDr )rzint | bytes | strrDr r?)rrCr8rCrDrCrR)r7rSrrN)r7rSrrrrr@)r%r&r'r(__annotations__rrh classmethodrur>rUrJrLrNrrrrQrrr9r+r,r-rbrbs/ N   ,>> ?? 0?@6"6.;6 6,?@6"6.;6 6R>8(GK"'8C*+,$3 '(&' $3$3($3 $ $3 $ $3 $3r,rbc#lKd}|D])}t|tr ||f|dz }t|}+yw)aTParses a Differences map to ``(char_code, char_name)`` pairs. This procedure is as described in 9.6.5.1. Here, ``char_code`` refers to the byte value of the character as it would appear in a text content stream using this font; it is the PDF encoding, not the true unicode character code. The corresponding ``char_name`` refers to the name of the glyph. The name is used by Type1 and Type3 fonts to look up the actual glyph used from the font. A partial mapping of glyph names to true unicode characters is available at pikepdf._data.CHARNAMES_TO_UNICODE`. rr!N)rnrr)rcountervalues r-_parse_differences_maprsDG! eT "5. qLG%jG !s24ci}t|D]\}} ||tt|<|S#t$r$tj dt|YLwxYw)asConvert a Differences map (See 9.6.5.1) to a Python dict. The Python dict maps unicode characters to the character index value. The character index values are the byte values used in actual text content streams. If the difference map encodes characters whose names aren't recognized, they will be omitted from the final map, and a warning emitted. z*Unknown character name in difference map: )rrrSKeyErrorrr)rdiffindexrrs r-rrso D-g6R t R49D%c$i0 1R K R KKDSYKP Q Rs.*AAceZdZdZdZd%dZd&dZdZdZd'dZ dZ d Z d(d Z d)d Z d Zd*d Zd+dZd+dZd+dZd'dZd,dZd-dZd.dZd/dZd.dZ d0dZdZdZdZdZd1dZd2dZd2dZ dZ!d3d Z"d4d"Z#d5d#Z$d6d$Z%y!)7ContentStreamBuilderzContent stream builder.c"t|_yz Initialize.N)r_streamrIs r-rhzContentStreamBuilder.__init__s  { r,cH|xjt|gdzz c_y)N )rrr6insts r-_appendzContentStreamBuilder._appends .v6>> r,ct|tr |xj|jz c_y|xj|dzz c_y)zAppend another content stream.rN)rnrr)r6others r-rzContentStreamBuilder.extends1 e1 2 LLEMM )L LLEEM )Lr,cRtgtd}|j||S)Save the graphics state.qrrrrs r-pushzContentStreamBuilder.push#'HSM: T r,cRtgtd}|j||S)zRestore the graphics state.Qrrs r-popzContentStreamBuilder.poprr,cft|jtd}|j||S)zConcatenate matrix.cmr shorthandrrr6matrixrs r-rzContentStreamBuilder.cms)'(8(8(4.I T r,cRtgtd}|j||S)zBegin text object. All text operations must be contained within a text object, and are invalid otherwise. The text matrix and font are reset for each text object. Text objects may not be nested. BTrrs r- begin_textzContentStreamBuilder.begin_texts%(HTN; T r,cRtgtd}|j||S)zEnd text object.ETrrs r-end_textzContentStreamBuilder.end_texts#'HTN; T r,cjt|t|gtd}|j||S)Begin marked content sequence.)MCIDBDC)rrrr)r6mctypemcidrs r-begin_marked_content_proplistz2ContentStreamBuilder.begin_marked_content_proplists2' ZT* +Xe_  T r,cTt|gtd}|j||S)rBMCr)r6rrs r-begin_marked_contentz)ContentStreamBuilder.begin_marked_contents%'(5/B T r,cRtgtd}|j||S)zEnd marked content sequence.EMCrrs r-end_marked_contentz'ContentStreamBuilder.end_marked_contents#'HUO< T r,cVt||gtd}|j||S)aSet text font and size. This operator is mandatory in order to show text. Any text object which attempts to show text without first calling this operator is invalid. The font name must match an entry in the current resources dictionary. The font size is expressed in text-space units. Assuming no text scaling is in place, and the PDF has not set a user-defined unit in the page dictionary, then text space units will be points (defined as 1/72 of an inch). Tfr)r6fontsizers r- set_text_fontz"ContentStreamBuilder.set_text_fonts)(t htnE T r,cTt|gtd}|j||S)arSet the character spacing (Tc) for future text operations. This is a value, measured in unscaled text-space units, which will be used to adjust the spacing between characters. A value of 0 (the default) means that, for each rendered glyph, the cursor will advance only the actual width of the glyph. Positive values will result in additional space between characters, and negative values will cause glyphs to overlap. In vertical writing, the sign works opposite of what one might expect: a positive value shrinks the space, and a negative value increases it. Tcrr6rrs r-set_text_char_spacingz*ContentStreamBuilder.set_text_char_spacings'(? T r,cTt|gtd}|j||S)afSet the word spacing (Tw) for future text operations. This is a value, measured in unscaled text-space units, which will be added to the width of any ASCII space characters. In vertical writing, the sign works opposite of what one might expect: a positive value shrinks the space, and a negative value increases it. Twrrs r-set_text_word_spacingz*ContentStreamBuilder.set_text_word_spacing'(? T r,cTt|gtd}|j||S)zSet the leading value (TL) for future text operations. This is the vertical spacing between lines. Specifically, it is defined as the distance between the baseline of the previous line to the baseline of the next line. TLrrs r-set_text_leadingz%ContentStreamBuilder.set_text_leading#s'(? T r,cft|jtd}|j||S)aSet text matrix. The text matrix defines the conversion between text-space and page-space, in terms of both scaling and translation. If this matrix scales the text, then it redefines text-space units as being some scale factor of page-space units. Tmrrs r-set_text_matrixz$ContentStreamBuilder.set_text_matrix.s+((8(8(4.I T r,cTt|gtd}|j||S)Set text rendering mode.Trr)r6moders r-set_text_renderingz'ContentStreamBuilder.set_text_rendering9s%'? T r,cTt|gtd}|j||S)Set text horizontal scaling.Tzr)r6scalers r-set_text_horizontal_scalingz0ContentStreamBuilder.set_text_horizontal_scaling?s%'$@ T r,czttt|ggtd}|j ||S)z^Show text. The text must be encoded in character codes expected by the font. TJ)rrrrrr6encodedrs r- show_textzContentStreamBuilder.show_textEs4(w/@)A(BHTNS T r,ctttd|Dgtd}|j||S)a)Show text, with manual spacing (kerning) options. Arguments are either bytes, which represent the actual text to show, or numbers, which move the cursor. The units for the numbers are expressed in thousandths of a text-space unit (thus typically equivalent to a glyph-space unit). For horizontal writing, positive values move the cursor left, and negative right. For vertical writing, positive values move down and negative up. The text must be encoded in character codes expected by the font. c3VK|]!}t|tr t|n|#ywr)rnrTr).0parts r- z>ContentStreamBuilder.show_text_with_kerning..bs'JNJtU$;F4LEs')r)rrrr)r6partsrs r-show_text_with_kerningz+ContentStreamBuilder.show_text_with_kerningTsD(RW  TN   T r,cftt|gtd}|j||S)aAdvance to the next line and show text. The text must be encoded in character codes expected by the font. This is functionally equivalent to ``move_cursor_new_line()`` followed by ``show_text_string(encoded)``, but in a single operation. 'rrrrrs r-show_text_linez#ContentStreamBuilder.show_text_lineks,((98C=I T r,cjt||t|gtd}|j||S)acAdvance to the next line and show text. The text must be encoded in character codes expected by the font. This is functionally equivalent to ``set_text_char_spacing(char_spacing)`` and ``set_text_word_spacing()``, followed by ``move_cursor_new_line()`` and then ``show_text(encoded)``, all in a single operation. "r)r6rr2r1rs r-show_text_line_with_spacingz0ContentStreamBuilder.show_text_line_with_spacingws5( < 98C=  T r,cVt||gtd}|j||S)aMove cursor by the given offset, relative to the start of the current line. This operator modifies the both current text matrix and the text line matrix. This means that, in addition to moving the current cursor, the new cursor will also be defined as the start of a new line. The new position will be redefined as the new start of the line even if the y offset is 0; what to a user may look like a single line of text could be encoded in the PDF content stream as multiple "lines". It's not uncommon for PDFs to be written with every word as a separate "line", allowing the PDF writer to explicitly define the spacing between each word. Tdr)r6dxdyrs r- move_cursorz ContentStreamBuilder.move_cursors)(R(4.A T r,cRtgtd}|j||S)aMove cursor to the start of the next line. This moves down by the current leading value, and resets the x position back to the value it had at the beginning of the current line. This operator modifies the both current text matrix and the text line matrix. This means that, in addition to moving the current cursor, the new cursor will also be defined as the start of a new line. The value this operation moves the cursor is set using ``set_text_leading``. zT*rrs r-move_cursor_new_linez)ContentStreamBuilder.move_cursor_new_lines%(HTN; T r,cRtgtd}|j||S)Stroke and close path.srrs r-stroke_and_closez%ContentStreamBuilder.stroke_and_closerr,cRtgtd}|j||S)r(frrs r-fillzContentStreamBuilder.fillrr,cZt||||gtd}|j||S)zAppend rectangle to path.rer)r6xywhrs r-append_rectanglez%ContentStreamBuilder.append_rectangles+'Aq! htnE T r,cXt|||gtd}|j||S)zSet RGB stroke color.RGrr6rgbrs r-set_stroke_colorz%ContentStreamBuilder.set_stroke_color)'Aq 8D>B T r,cXt|||gtd}|j||S)zSet RGB fill color.rgrr7s r-set_fill_colorz#ContentStreamBuilder.set_fill_colorr<r,cTt|gtd}|j||S)Set line width.r2r)r6rrs r-set_line_widthz#ContentStreamBuilder.set_line_widths%'#? T r,ct||gtdt||gtdg}|j|d|j|d|S)z Draw line.mlrr!r)r6x1y1x2y2instss r-linezContentStreamBuilder.linesV %b"Xx} = $b"Xx} =  U1X U1X r,Nc|g}t|ttzr||f}d}t||gt d}|j ||S) Set dashes.rd)rnrrrrr)r6arrayphasers r- set_dasheszContentStreamBuilder.set_dashessM =E eS5[ )ENEE' F T r,cTt|gtd}|j||S)zDraw XObject. Add instructions to render an XObject. The XObject must be defined in the document. Args: name: Name of XObject Dor)r6rrrs r- draw_xobjectz!ContentStreamBuilder.draw_xobjectrr,c,t|jS)zBuild content stream.)rTrrIs r-buildzContentStreamBuilder.buildsT\\""r,)rr)rzContentStreamBuilder | bytesrr)rrrr)rr)rrrint | float | Decimal)rrX)rr)r r)rrT)rzbytes | int | float | Decimal)rrTr2rr1r)r0rr1rr2rr3r)r8rr9rr:r)rFrrGrrHrrIrNr)rrr)rDrT)&r%r&r'r(rhrrrrrrrrrrrrrrrrr rrrrr$r&r*r-r4r;r?rBrKrQrTrVr+r,r-rrs!#?*           . ,/?B""         #r,rc&eZdZUdZded<ded<y) LoadedImagezcLoaded image. This class is used to track images that have been loaded into a canvas. rrrz Image.ImageimageN)r%r&r'r(rr+r,r-r[r[s J r,r[ceZdZdZdddZddZddZdZdZddZ dd Z dd Z d Z d Z d ZeddddZddZy)_CanvasAccessorz;Contains all drawing methods class for drawing on a Canvas.Nc6||_||ng|_d|_yrY)_cs_images _stack_depth)r6csimagess r-rhz_CanvasAccessor.__init__s!'!3v r,c|j|j|j}}}|jj ||||S)zSet stroke color.)rrrr`r;r6colorr8r9r:s r- stroke_colorz_CanvasAccessor.stroke_colors6))U[[%**a1 !!!Q* r,c|j|j|j}}}|jj ||||S)zSet fill color.)rrrr`r?rfs r- fill_colorz_CanvasAccessor.fill_colors6))U[[%**a1 1a( r,c<|jj||S)rA)r`rB)r6rs r- line_widthz_CanvasAccessor.line_widths & r,cv|jj|||||jj|S)z"Draw line from (x1,y1) to (x2,y2).)r`rKr*)r6rFrGrHrIs r-rKz_CanvasAccessor.lines-  b"b"% !!# r,c|jj|||||r|jj|S|jj|S)zDDraw optionally filled rectangle at (x,y) with width w and height h.)r`r4r-r*)r6r0r1r2r3r-s r-rectz_CanvasAccessor.rectsH !!!Q1-  HHMMO  HH % % ' r,c ,|jt|dd|||5t|ttzrddlm}|j|}|j|jdk(r|jd}|jdvrtd|jtjd }t||}|jj!||j"j%|d d d |S#1swY|SxYw) z.Draw image at (x,y) with width w and height h.rrrPRGB)1LrszUnsupported image mode: Im)prefixN) save_staterrnr rSPILropenrurconvertrgrrandomr[rarr`rT) r6r\r0r1rheightrrrlis r- draw_imagez_CanvasAccessor.draw_image(s __uaFAq A_ B (%,%" 5) JJLzzS  e,zz!22 #;EJJ GGBK   s9;c<|jj||S)z>Concatenate a new transformation matrix to the current matrix.)r`rr6rs r-rz_CanvasAccessor.cm`s  F r,r)rcr)rgr)r-bool)r\zPath | str | Image.Image)r7Text)rz Matrix | NonerW)r%r&r'r(rhrhrjrlrKrorrrrrrrxrr+r,r-r^r^sXE     $    04  r,r^cJeZdZdZd dZd dZed dZd dZd dZ ddZ y)Canvasa>Canvas for rendering PDFs with pikepdf. All drawing is done on a pikepdf canvas using the ``.do`` property. This interface manages the graphics state of the canvas. A Canvas can be exported as a single page Pdf using ``.to_pdf``. This Pdf can then be merged into other PDFs or written to a file. c||_tj|_|jj ||_t t t |j _t|_ g|_ t|j|j|_ |jjy)zInitialize a canvas.) page_size)r/XObjectN)rrnew_pdfadd_blank_page_pager Resourcesrr`rar^ _accessordor)r6rs r-rhzCanvas.__init__psz"GGI YY-- -B )z|Z\R ')*, (4<<@  r,c||j|j|jjj|<y)zAdd a font to the page.N)r>rrrr/)r6 resource_namers r-add_fontzCanvas.add_font{s)37==3K !!-0r,c|jS)z,Do operations on the current graphics state.)rrIs r-rz Canvas.dos~~r,c |jj|jj|jj|jj |jj dvrtjntjtjtj|jj dk(rdSdS)N)rtrurtr!)WidthHeight ColorSpacer]r^BitsPerComponent) r make_streamr\tobytesrr}rr DeviceGray DeviceRGBrr)r6r~s r- _save_imagezCanvas._save_imagesyy$$ HH   ((..88??#%88==J#>DNNJJ"$((--3"6Q%  =>%  r,c~|jj|jjdk7rtj d|j j|jj|j_ |jD]>}|j||jjj|j <@t#}|j j%||j'dt)j*|}|jj-|S)z'Render the canvas as a single page PDF.rzNGraphics state stack is not empty when page saved - rendering may be incorrect)rrrrbrrrrr`rVrContentsrarrrrrr saveseekrrzr)r6r~biors r-to_pdfz Canvas.to_pdfs  >> & &! + KK- #ii33DHHNN4DE ,, IB484D4DR4HDJJ ( ( 1 Ii s  #   r,NcB|jj||Sr)r_repr_mimebundle_)r6includeexcludes r-rzCanvas._repr_mimebundle_s{{}..w@@r,)rztuple[int | float, int | float])rrrr/)rDr^)r~r[)rDr)NN) r%r&r'r(rhrrUrrrrr+r,r-rrfs6 L  (Ar,rcXeZdZdZej fdZd dZdZd dZ d dZ dZ dZ y ) rz3Text object for rendering text on a pikepdf canvas.cdt|_|jj||_yr)rr`r _direction)r6 directions r-rhz Text.__init__s#') #r,c>|jj|||S)zSet font and size.)r`r)r6rrs r-rz Text.fonts tT* r,c<|jj||S)r)r`r)r6rs r- render_modezText.render_modes ##D) r,c<|jj||S)zSet text matrix.)r`rrs r-text_transformzText.text_transforms   ( r,ct|trd|jdz}n|}|jtj k(r|j j||S|j jtj|j j||j j|S)aUShow text. The text must be encoded in character codes expected by the font. If a text string is passed, it will be encoded as UTF-16BE. Text rendering will not work properly if the font's character codes are not consistent with UTF-16BE. This is a rudimentary interface. You've been warned. szutf-16be) rnrSrQrr#r)r`rrr ReversedCharsr)r6r7rs r-showz Text.shows dC !DKK $;;GG ??m// / HH  w '   HH ) )$*<*< = HH  w ' HH ' ' ) r,c<|jj||S)r )r`r )r6r s r- horiz_scalezText.horiz_scales ,,U3 r,c>|jj|||S)z Move cursor.)r`r$)r6r0r1s r-r$zText.move_cursors Q" r,N)rrrrrW)r7rA) r%r&r'r(r#r)rhrrrrrr$r+r,r-rrs1=!.!2!2$    * r,r)rr)rrrDdict)@r( __future__rloggingabcrr collectionsr contextlibr dataclassesrdecimalr enumr ior pathlibr typingrr pikepdf._corerrr pikepdf._datarpikepdf.modelsrpikepdf.objectsrrrrrryr getLoggerr%rrBLACKWHITEBLUECYANGREEN DARKGREENMAGENTAREDr#r/rGrWrbrrrr[r^rrr+r,r-rs ##"%!&??.1EEg! 7=> aAq aAq Q1a Q1a aAq !S!Q  1a  Aq!Q7D7  3  FAdA: