OAi؆SrSSKJr SSKrSSKJrJr SSKJr SSK J r SSK J r SSK Jr SS KJr SS KJr SS KJr SS KJr SS KJrJrJr SSKJr SSKJr SSKJ r J!r!J"r"J#r#J$r$ \RJ"\&5r'\"S/SQ5r(\("SSSS5r)\("SSSS5r*\("SSSS5r+\("SSSS5r,\("SSSS5r-\("SSSS5r.\("SSSS5r/\("SSSS5r0"SS\5r1"SS\5r2"SS\25r3"SS\25r4"SS\35r5S+Sjr6S,S jr7"S!S"5r8\ "S#S$55r9"S%S&5r:"S'S(5r;"S)S*5r[UR R5U:aUR RUnU$[RUR R;a"UR RRnU$[S5nU$)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)rvrVrSrWintrjgetr FirstCharWidthslen MissingWidthrr )r4char char_codewidths r-unscaled_char_widthSimpleFont.unscaled_char_widths dC ;;s#D dE " "7D3tyy}}T^^Q?@@ ;;$)) #DII,<,<(= (III$$Y/E    $))":": :II,,99E AJE r,c&[S5nX- U-$)arConvert 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 r4rr6glyph_space_ratios r- convert_widthSimpleFont.convert_widths$$DM)X55r,c&[S5nX-U- $)zHConvert width from text space back to glyph space, scaling by font size.rr rs r-convert_width_reverse SimpleFont.convert_width_reverses $DM)X55r,cp[RUR;a [S5e[ URR[5(a%UR XRR5$[ URR[ 5(a[RURR;abURUURRRURRR[R55$[RURR;a [S5eUR XRRR5$[S[URR535e)zEncode 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 encodingzUnsupported encoding type: ) rEncodingrjr]rv _encode_namedr Differences_encode_diffmapr BaseEncodingrwrxrRs r-rSSimpleFont.encodes@ == )&C  dii(($ / /%%dII,>,>? ? dii((* 5 5499#5#55++II&&22II&&**4+<+<=    (:(::)G%%dII,>,>,K,KL L5d499;M;M6N5OPQQr,ctU[R:Xa [S5eU[R:XaUR S5$U[R :XaUR S5$U[R :Xa [S5eU[R:XaUR S5$[SU5e)Nz!Cannot encode to StandardEncodingcp1252 mac_romanz"Cannot encode to MacExpertEncodingpdfdoc_pikepdfzUnknown encoding:) rStandardEncodingr]WinAnsiEncodingrSMacRomanEncodingMacExpertEncodingPDFDocEncodingrn)r4r5encodings r-rSimpleFont._encode_nameds t,, ,&&IJ J t++ +;;x( ( t,, ,;;{+ + t-- -&&JK K t** *;;/0 0,h77r,cURc[U5Ul[5nUHnXPR;a URURU5 M2Ub"UR UR XS55 MWUR 5(aUR[U55 M[RS[U5S35 M g)NzNo mapping for z in current encoding; skipped) _diffmap_cache_differences_map_lookup bytearrayappendextendrisasciiordlogwarningrepr)r4r5diffmap base_encodingresultrs r-rSimpleFont._encode_diffmap+s    &"9'"BD D*** d11$78* d00EF c$i( od4j\9VWXr,r) char_spacing word_spacingcSn[S5n[U[5(aURU5nUH$nXPR U5U-- nXv:XdM XT- nM& UR XR5$)aGet 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 )rrvrVrSrr)r4r5r6rrr ascii_spacebytes r-r7SimpleFont.text_width<sr,#h dC ;;t$DD --d3lB BE"%!!%22r,)rrj)rjr)rzrr{rrBrhrC)rB int | Decimal)rBr )rzint | bytes | strrBr )r)rrr6rrBrrU)r5rVrrN)r5rVrrrz Name | None) r5r@r6rrrrrrBr)r$r%r&r'r(__annotations__rro classmethodr}r=rXrIrLrOrrrrSrrr7r+r#r,r-rhrhs8 N   ,// 00 ,?@6"6.;6 6,?@6"6.;6 6R:8(GKYY"'Y8CY(#$"3 '(&' "3"3 "3 $ "3 $ "3 "3"3r,rhc#h# SnUH&n[U[5(a X4v US- nM$UnM( g7f)a0Parses 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`. rrN)rvr)rcountervalues r-_parse_differences_mapras;G eT " ". qLGG s02c0n[U5Hup#X![[U5'M U$![a% [R S[U535 MNf=f)a_Convert 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: )rrrVKeyErrorrr)rdiffindexrzs r-rr}sd D-g6  R49%c$i0 17 K R KKDSYKP Q Rs.+AAcL\rSrSrSrSrS'SjrS(SjrSrSr S)Sjr S r S r S*S jr S+S jrS rS,SjrS-SjrS-SjrS-SjrS)SjrS.SjrS/SjrS0SjrS1SjrS0SjrS2SjrSrSrSrSrS3SjrS4Sjr S4Sjr!S r"S5S!jr#S6S#jr$S7S$jr%S8S%jr&S&r'g")9ContentStreamBuilderizContent stream builder.c"[5Ulgz Initialize.N)r_streamrHs r-roContentStreamBuilder.__init__s  { r,cHU=R[U/5S-- slg)N )rrr4insts r-_appendContentStreamBuilder._appends .v6>> r,c[U[5(a U=RUR- slgU=RUS-- slg)zAppend another content stream.rN)rvrr)r4others r-rContentStreamBuilder.extends4 e1 2 2 LLEMM )L LLEEM )Lr,cR[/[S55nURU5 U$)Save the graphics state.qrrrrs r-pushContentStreamBuilder.push#'HSM: T r,cR[/[S55nURU5 U$)zRestore the graphics state.Qrrs r-popContentStreamBuilder.poprr,cf[UR[S55nURU5 U$)zConcatenate matrix.cmr shorthandrrr4matrixrs r-rContentStreamBuilder.cms)'(8(8(4.I T r,cR[/[S55nURU5 U$)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_textContentStreamBuilder.begin_texts%(HTN; T r,cR[/[S55nURU5 U$)zEnd text object.ETrrs r-end_textContentStreamBuilder.end_texts#'HTN; T r,cd[U[US9/[S55nURU5 U$)Begin marked content sequence.)MCIDBDC)rrrr)r4mctypemcidrs r-begin_marked_content_proplist2ContentStreamBuilder.begin_marked_content_proplists2' ZT* +Xe_  T r,cT[U/[S55nURU5 U$)rBMCr)r4rrs r-begin_marked_content)ContentStreamBuilder.begin_marked_contents%'(5/B T r,cR[/[S55nURU5 U$)zEnd marked content sequence.EMCrrs r-end_marked_content'ContentStreamBuilder.end_marked_contents#'HUO< T r,cT[X/[S55nURU5 U$)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)r4fontsizers r- set_text_font"ContentStreamBuilder.set_text_fonts'( htnE T r,cT[U/[S55nURU5 U$)a2Set 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. Tcrr4rrs r-set_text_char_spacing*ContentStreamBuilder.set_text_char_spacings'(? T r,cT[U/[S55nURU5 U$)a>Set 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_spacing*ContentStreamBuilder.set_text_word_spacing'(? T r,cT[U/[S55nURU5 U$)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_leading%ContentStreamBuilder.set_text_leadings'(? T r,cf[UR[S55nURU5 U$)zSet 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_matrix$ContentStreamBuilder.set_text_matrixs+((8(8(4.I T r,cT[U/[S55nURU5 U$)Set text rendering mode.Trr)r4moders r-set_text_rendering'ContentStreamBuilder.set_text_renderings%'? T r,cT[U/[S55nURU5 U$)Set text horizontal scaling.Tzr)r4scalers r-set_text_horizontal_scaling0ContentStreamBuilder.set_text_horizontal_scaling s%'$@ T r,cz[[[U5/5/[S55nUR U5 U$)zNShow text. The text must be encoded in character codes expected by the font. TJ)rrrrrr4encodedrs r- show_textContentStreamBuilder.show_text&s4(w/@)A(BHTNS T r,ct[[SU55/[S55nURU5 U$)aShow 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. c3f# UH'n[U[5(a [U5OUv M) g7fr)rvrWr).0parts r- >ContentStreamBuilder.show_text_with_kerning..Cs)RW$JtU$;$;F4LERWs/1r2)rrrr)r4partsrs r-show_text_with_kerning+ContentStreamBuilder.show_text_with_kerning5sD(RW  TN   T r,cf[[U5/[S55nURU5 U$)zAdvance 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. 'rrrrr3s r-show_text_line#ContentStreamBuilder.show_text_lineLs,((98C=I T r,ch[X#[U5/[S55nURU5 U$)a;Advance 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. "rB)r4r4rrrs r-show_text_line_with_spacing0ContentStreamBuilder.show_text_line_with_spacingXs3(  98C=  T r,cT[X/[S55nURU5 U$)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)r4dxdyrs r- move_cursor ContentStreamBuilder.move_cursoris'((4.A T r,cR[/[S55nURU5 U$)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_line)ContentStreamBuilder.move_cursor_new_linezs%(HTN; T r,cR[/[S55nURU5 U$)Stroke and close path.srrs r-stroke_and_close%ContentStreamBuilder.stroke_and_closerr,cR[/[S55nURU5 U$)rSfrrs r-fillContentStreamBuilder.fillrr,cV[XX4/[S55nURU5 U$)zAppend rectangle to path.rer)r4xywhrs r-append_rectangle%ContentStreamBuilder.append_rectangles''q htnE T r,cV[XU/[S55nURU5 U$)zSet RGB stroke color.RGrr4rgbrs r-set_stroke_color%ContentStreamBuilder.set_stroke_color''q 8D>B T r,cV[XU/[S55nURU5 U$)zSet RGB fill color.rgrres r-set_fill_color#ContentStreamBuilder.set_fill_colorrkr,cT[U/[S55nURU5 U$)Set line width.r_r)r4rrs r-set_line_width#ContentStreamBuilder.set_line_widths%'#? T r,c[X/[S55[X4/[S55/nURUS5 URUS5 U$)z Draw line.mlrrr)r4x1y1x2y2instss r-lineContentStreamBuilder.linesR %bXx} = $bXx} =  U1X U1X r,NcUc/n[U[[-5(aX4nSn[X/[ S55nUR U5 U$) Set dashes.rd)rvrfloatrrr)r4arrayphasers r- set_dashesContentStreamBuilder.set_dashessL =E eS5[ ) )NEE' F T r,cT[U/[S55nURU5 U$)zDraw XObject. Add instructions to render an XObject. The XObject must be defined in the document. Args: name: Name of XObject Dor)r4rzrs r- draw_xobject!ContentStreamBuilder.draw_xobjectrr,c,[UR5$)zBuild content stream.)rWrrHs r-buildContentStreamBuilder.buildsT\\""r,)r)rr)rzContentStreamBuilder | bytesrr)rrrr)rr)rrrint | float | Decimal)rr)r(r)r.r)r4rW)r=zbytes | int | float | Decimal)r4rWrrrr)r]rr^rr_rr`r)rfrrgrrhr)rwrrxrryrrzrNr)rzr)rBrW)(r$r%r&r'r(rorrrrrrrrrr rrrrr#r)r/r5r>rCrGrMrPrUrYrarirnrrr|rrrr+r#r,r-rrs!#?*           . ,/?B""         #r,rc.\rSrSr%SrS\S'S\S'Srg) LoadedImageizWLoaded image. This class is used to track images that have been loaded into a canvas. rrzz Image.Imageimager#N)r$r%r&r'r(rr+r#r,r-rrs J r,rc\rSrSrSrSSSjjrSSjrSSjrSrSr SS jr SS jr SS jr S r S rSr\SS.SSjj5rSSjrSrg)_CanvasAccessoriz;Contains all drawing methods class for drawing on a Canvas.Nc6XlUbUO/UlSUlgr_cs_images _stack_depth)r4csimagess r-ro_CanvasAccessor.__init__s!'!3v r,cURURURpCnURR X#U5 U$)zSet stroke color.)rrrrrir4colorrfrgrhs r- stroke_color_CanvasAccessor.stroke_colors2))U[[%**a !!!* r,cURURURpCnURR X#U5 U$)zSet fill color.)rrrrrnrs r- fill_color_CanvasAccessor.fill_colors2))U[[%**a a( r,c<URRU5 U$)rq)rrr)r4rs r- line_width_CanvasAccessor.line_widths & r,crURRXX45 URR5 U$)z"Draw line from (x1,y1) to (x2,y2).)rr|rU)r4rwrxryrzs r-r|_CanvasAccessor.lines)  bb% !!# r,cURRXX45 U(aURR5 U$URR5 U$)zDDraw optionally filled rectangle at (x,y) with width w and height h.)rrarYrU)r4r]r^r_r`rYs r-rect_CanvasAccessor.rectsD !!!-  HHMMO  HH % % ' r,c 4UR[USSXRU5S9 [U[[-5(a[ R "U5nUR5 URS:XaURS5nURS;a[SUR35e[R"SS9n[Xa5nURRU5 UR R#U5 S S S 5 U$!,(df  U$=f) z.Draw image at (x,y) with width w and height h.rrPRGB)1LrzUnsupported image mode: Im)prefixN) save_staterrvr rVropenr}r(convertrnrrandomrrrrr)r4rr]r^rheightrzlis r- draw_image_CanvasAccessor.draw_image s __uaFq A_ B%,, 5) JJLzzS  e,zz!22 #;EJJ GGBK   s:<c<URRU5 U$)z>Concatenate a new transformation matrix to the current matrix.)rrr4rs r-r_CanvasAccessor.cm?s  F r,rr)rr)rr)rYbool)rzPath | str | Image.Image)r5Text)rz Matrix | Noner)r$r%r&r'r(rorrrr|rrrrrrrrrr+r#r,r-rrsXE          04  r,rc^\rSrSrSrS SjrS Sjr\S Sj5rSSjr SSjr SS jr S r g)CanvasiEa*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|Xl[R"5UlURR US9Ul[ [ 5[ 5S9UR l[5Ul /Ul [URUR5Ul URR5 g)zInitialize a canvas.) page_size)r/XObjectN)rrnew_pdfadd_blank_page_pager Resourcesrrrr _accessordor)r4rs r-roCanvas.__init__Osx"GGI YY-- -B )z|Z\R ')*, (4<<@  r,c|URUR5URRRU'g)zAdd a font to the page.N)r=rrrr/)r4 resource_namers r-add_fontCanvas.add_fontZs)37==3K !!-0r,cUR$)z,Do operations on the current graphics state.)rrHs r-r Canvas.do^s~~r,c URRURR5URRURR URR S;a[RO[R[R[RURR S:XaSS9$SS9$)N)rrrr)WidthHeight ColorSpacerbrcBitsPerComponent) r make_streamrtobytesrrr(r DeviceGray DeviceRGBrr)r4rs r- _save_imageCanvas._save_imagecsyy$$ HH   ((..88??#%88==J#>DNNJJ"$((--3"6Q%  =>%  r,cURR5 URRS:wa[R S5 UR RURR55URl URH?nURU5URRRUR 'MA [#5nUR R%U5 UR'S5 [(R*"U5nURR-5 U$)z'Render the canvas as a single page PDF.rzNGraphics state stack is not empty when page saved - rendering may be incorrect)rrrrrrrrrrrContentsrrrrrzr saveseekrrr)r4rbiors r-to_pdf Canvas.to_pdfps  >> & &! + KK- #ii33DHHNN4DE ,,B484D4DR4HDJJ ( ( 1i s  #   r,Nc@UR5RX5$r)r_repr_mimebundle_)r4includeexcludes r-rCanvas._repr_mimebundle_s{{}..w@@r,)rrrrrr)rztuple[int | float, int | float])rrrr/)rBr)rr)rBr)NN) r$r%r&r'r(rorrXrrrrr+r#r,r-rrEs6 L  (Ar,rch\rSrSrSr\R 4SjrS SjrSr S Sjr SSjr Sr S r S rg )riz3Text object for rendering text on a pikepdf canvas.cb[5UlURR5 Xlgr)rrr _direction)r4 directions r-ro Text.__init__s!') #r,c<URRX5 U$)zSet font and size.)rr)r4rrs r-r Text.fonts t* r,c<URRU5 U$)r&)rr))r4r(s r- render_modeText.render_modes ##D) r,c<URRU5 U$)zSet text matrix.)rr#rs r-text_transformText.text_transforms   ( r,c[U[5(aSURS5-nOUnUR[R :XaUR RU5 U$UR R[R5 UR RU5 UR R5 U$)a%Show 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) rvrVrSrr r)rr5rr ReversedCharsr )r4r5r4s r-show Text.shows dC !DKK $;;GG ??m// / HH  w '   HH ) )$*<*< = HH  w ' HH ' ' ) r,c<URRU5 U$)r,)rr/)r4r.s r- horiz_scaleText.horiz_scales ,,U3 r,c<URRX5 U$)z Move cursor.)rrM)r4r]r^s r-rMText.move_cursors Q" r,)rrN)rrrrr)r5r@)r$r%r&r'r(r r)rorrrr r rMr+r#r,r-rrs1=!.!2!2$    * r,r)rr)rrrBdict)=r( __future__rloggingabcrr collectionsr contextlibr dataclassesrdecimalr enumr ior pathlibr PILr pikepdf._corerrr pikepdf._datarpikepdf.modelsrpikepdf.objectsrrrrr getLoggerr$rrBLACKWHITEBLUECYANGREEN DARKGREENMAGENTAREDr r/rErZrhrrrrrrrr#r,r-r)ss1"#"%!??.1EE ! 7=> aAq aAq Q1a Q1a aAq !S!Q  1a  Aq!Q7D7 3 <AdA:  2Y3Y3x8&B#B#J   aaH@A@AF55r,