)Ej xUddlZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZddlmZddlmZddlmZmZddlmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z( dd l)m*Z*dd l+m,Z,n#e-$rd \Z*Z,YnwxYw dd l.m/Z/n(#e-$r e j0d GddZ/YnwxYwddl1m2Z2m3Z3m4Z4ddl5m6Z6m7Z7m8Z8m9Z9ddl:m;Z;mZ>m?Z?m@Z@mAZAddlBmCZCmDZDmEZEmFZFddlGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOddlPmQZQddlRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[m\Z\m]Z]m^Z^m_Z_m`Z`maZambZbmcZcmdZdmeZemfZfmgZgmhZhmiZimjZjmkZkmlZlmmZmddlnmoZompZpmqZqmrZrddlsmtZtmuZumvZvmwZwmxZxmyZyddlzm{Z{m|Z|ddl}m~Z~ddlmZmZmZmZmZddlmZmZmZmZddlmZmZmZmZdd lmZdd!lmZdd"lmZmZmZmZmZmZmZmZmZdd#lmZdd$lmZdd%lmZdd&lmZmZdd'lmZmZdd(lmZmZmZmZmZdd)lmZmZdd*lmZmZdd+lmZdd,lmZmZdd-lmZmZmZmZmZmZmZmZe d.Ze$d/Zerdd0lmZdd1lmZdd2lmZdd3lmZd4ZeZd5d6d7d8d9d:Z ejeѦZeeӦjZed;z Zeed<<deajeajeajd=Zeeeeafed><Gd?d@eZ dLdAeeeefzdBeedCeeeffdDZdEeeefdCeeeffdFZGdGdHe{eZe>eje_dIdJiZgdKZdS)MN) defaultdict)contextmanager)datetimetimezone)wraps)splitext)PathPurePath) TYPE_CHECKINGAnyBinaryIOCallableIteratorLiteral NamedTupleOptional ParamSpecSequenceType TypeAliasTypeVarUnion ValuesViewcastoverload)pkcs12)signerNN)ImagezFPillow could not be imported - fpdf2 will not be able to add any imageceZdZdS)rN)__name__ __module__ __qualname__;C:\PYTHON\MyICR_Suite\python\Lib\site-packages\fpdf/fpdf.pyrr<s r%r)Action GoToAction URIAction)DEFAULT_ANNOT_FLAGSAnnotationDict PDFAnnotationPDFEmbeddedFile) BidiParagraphauto_detect_base_direction) WarnOnDeprecatedModuleAttributesdeprecated_parameterget_stack_levelsupport_deprecated_txt_arg)DrawingContextGraphicsContext GraphicsStyle PaintedPath)Color ColorInput DeviceCMYK DeviceGray DeviceRGBPoint Transformconvert_to_device_color)StandardSecurityHandler)AccessPermissionAlignAngleAnnotationFlagAnnotationNameAssociatedFileRelationshipCharVPosCornerDocumentComplianceEncryptionMethodFileAttachmentAnnotationNameMethodReturnValueOutputIntentSubTypePageLabelStyle PageLayoutPageModePageOrientation PathPaintRulePDFResourceType RenderStyle TextDirection TextEmphasisTextMarkupTypeTextModeWrapModeXPosYPos) FPDFExceptionFPDFPageFormatExceptionFPDFUnicodeEncodingExceptionPDFAComplianceError) CORE_FONTSCoreFontFontFace TextStyle TitleStyleTTFFont)GraphicsStateMixinStateStackType) HTML2FPDF) ImageCache ImageFilter ImageInfoRasterImageInfoVectorImageInfo)SUPPORTED_IMAGE_FILTERS get_img_info load_image preload_image)FragmentMultiLineBreakTextLineTotalPagesSubstitutionFragment)LinearizedOutputProducer)OutlineSection) ZOOM_CONFIGSOutputIntentDictionaryOutputProducer PDFICCProfilePDFPage PDFPageLabelResourceCatalog ResourceTypesstream_content_for_raster_image)Gradient) FPDFRecorder) Signature) StructElemStructureTreeBuilder)Percent SVGObject)DestinationXYZNamePDFArrayPDFDate PDFString)Tabledraw_box_borders) TextColumnsTextRegionMixin) Transition) UnicodeScriptget_unicode_script)FloatTolerance ImageTypeNumber NumberClassPaddingbuiltin_srgb2014_bytesget_parsed_unicode_rangeget_scale_factorPR)PrivateKeyTypes) Certificate) Type3Font)ViewerPreferencesz2.8.7)QO@g33333@) ףp=@r)gGz8z@r)di)ri)a3a4a5letterlegalfont FPDF_FONT_DIR)defaultsingle continuoustwoLAYOUT_ALIASESczeZdZUedeegdfed<eed<eed<e e zed<dZ eed<d Z e ed <dS) ToCPlaceholderFPDFNrender_function start_pageypage_orientationr'pagesTreset_page_indices)r!r"r#rlistrx__annotations__intfloatstrrRrrboolr$r%r&rrssvtN';.wrappers~Awf%% S9 S::i(( S-3JJ|,D,D S QRR Rr4"6"""r%)rrrrr)rrs` r& check_pagersS 2YY#qv##a#####Y# Nr%c+*eZdZUdZdZdZdZdZdZe j de j Z dZ d ZeZejd d d fdd deeefdeeefdeeeeeffded deeeefddf fdZedeeeezffdZde j!e"j#dfdedeede de$de%ddf dZ&dede'de'ddfd Z(d!eddfd"Z)ede*fd#Z+ede%fd$Z,edee-fd%Z.e.j/d&e-ezddfd'Z.ede0e1fd(Z2 dd)e3d*eed+eed,eed-ee4d.eeddfd/Z5edefd0Z6edefd1Z7ede$fd2Z8d3eddfd4Z9dd6ed7ed8eddfd9Z:d3eddfd:Z;d3eddfd;Ze%d3eddfd?Z>edeeeffd@Z?deezdAedBeddfdCZ@ ddEeezdFeddfdGZA ddHe%dIeeee'fdJeeeBzdKeedLeeddf dMZCedeeDfdNZEeEj/dOeeeDzddfdPZEdQe%ddfdRZFdSeddfdTZGdUeddfdVZHdWeddfdXZIdYeeJezddfdZZKd[eeJezddfd\ZLd]eddfd^ZMd_eddfd`ZNddaeeOddfdbZPdceddfddZQdeedfdgeddfdhZRdieddfdjZSddleddfdmZTeU ddneeeVzdoeedpee$ddfdqZW ddededse%dtedueeXdneeeVzdoeedpee$ddfdvZYddwZZ ddeezdeeeefzdse%dteedueeXdxe%ddfdyZ[ddzZ\dd{Z]de$fd|Z^defd}Z_ dd~e`eazezeJe`zde`de`ddfdZb dd~e`eazezeJe`zde`de`ddfdZc dd~e`eazezeJe`zedzeezefzde`de`ddfdZg ddede%de%defdZhdeddfdZideeejzekzefzeezddfdZlemeU ddee%deneofdZpemeUdeqdendfdZrdesfdZtemd=d=eujvdfdededeudee%denewf dZx ddeydee%de%ddfdZz ddedededdfdZ{dedededdfdZ|emdeneofdZ}deeweyfdddefdZ~eUdededededdf dZeU ddeJeeefde%de%deeezddf dZeU ddeJeeefde%deeezddfdZeU ddededededededdfdZeU ddededededeeezde%deddfdZdededededede%eeezdfzd~eddfdZ ddedededededeeddfdZeU ddededededeeezddf dZdedededededdf dZeU ddedededeeezddf dZeU ddedede$dededeeezddfdÄZeU ddedededede$dedeeezddfdȄZeU ddedededededeedede%de%de%deeezddfd̈́Z ddedededededeedede%deeezddfd΄Z ddeJeeefde%deeezddfdЄZedg ddddd=dҜdeededeeezdeeeJee$zee$e$fzzdeeeeeeffeeefzdee$de$ddfdلZ ddeedeee*fdeddfdۄZdeddfd܄Z ddeezdede%defd߄ZdeddfdZdeddfdZ ddeJede%ddfdZ ddedede$dEeezdeede$f dZdedefdZ ddee$dedede$dEeezdeedeezfdZ ddededededee$zdeede'defdZ ddeeeefdeedeedeeOdeedeede'defdZeUdddefdeezdededededeeezdeeezdfde'defdZeU ddedededededeeezde'defdZeU ddedeedeedeedeede'defdZeUdededededede'defdZem ddedeezdeeeefdeeOde'dendf dZemde'de'dendfdZeU ddeezdedeJedeeeefdeeOdee$de'defdZeU ddeJeeefdedeeeefdede'def dZeUeddedededdfd ZeU dd edeedeeddfd ZeUem dd edeedeedendfd ZeUem dÐd ededeedeedendf dZeUemdeeefd eezezdendfdZeUemdedendfdZeUemde'dendfdZ dĐdeedeedeedeedeedeedeedeeeeeefeeeffde'ddfdZddZede%fdZeUedddrd=d ejddrddejejf deedeededed ezd!ed d"eezde%deee$zd#e%de%d$eezd%eezde%fd&Zdd=ejejddrdddf d'edeedeee$fd$ed%ede%deee$zd#e%d(eed)e%de%fd*Zdededededdf d+Zdede%deJefd,Zdeede%deJefd-Z̐dd.ededeefd/Zdede%denefd0Zΐd1ede%fd2Zdede%fd3ZАdd4Zde%fd5Zemdendfd6Ze%Zee֐d7<eeZee֐d8<eZee֐d9<eezezeeefzeeefzeeefzeeeefzZee֐d:<eUeddrd=ejdddd dddejejejdejdd=fdedeededed ezd"eezde%d;e%dee$ezd!ed deݐd?e%d@eezd#e%d(e$eJe$zezdef(dAZeUeddrdrdejfdeededeee$zd=e%d>ede%f dBZeUdddddCddDddddejdf deedEeedFe%dGe$dHeedIe%dJeeezdKeedLeedMeed=ee%d>eedNee%defdOZ ddedeeezdeedededeed zdzdeee$zdSeedeedPeeeefdQe%deezfdRZ ddedEed.edeeezdeedededeee$zdSeedeedPeeeefdQe%defdSZdeezdededTeezdQe%def dUZ ddedVed.edeeezdeedededeee$zdSeedeedQe%defdWZdedEed.edededXedefdYZ ddeezejzekzezdPeeefdzdeeeekzezejzezdzeezffdZZd[eejzdeeeekzezejzezdzeezffd\Zemde'denefd]Zde'defd^ZeUddeeddfd_Zdefd`ZdeddfdaZdefdbZdeddfdcZdededdfddZdedefdeZddfddddejejffdgeezdheediedjeedkeedleeOdmeedeeezdfddfdnZeUddfddddejejffdoedpdqdrdseeאdrdiedjeedkeedleeOdmeedeeezdfddfdtZdduZdeeed5zfdvZdwedefdxZ ddedededeeezdef dyZ ddedededeeezdef dzZdeezddfd{ZeUe ddedededededdf d|ZeUe ddedededededdf dZeUemdededededendf dZeUemdededededendf dZeUemdeded~edendfdZ emdene fdZ emdene fdZ eU dʐde deאegdfde$de%de%ddf dZ ddedeedeedeedeedeedeeddfdZeUddede$de%ddfdZemdedendfdZemdedendfdZeUemde'de'denefdZe ddeddeedrde%deedefdZededdeejezejzde%deeddfdZedg ddeddeeejezejzde%deedeefdZxZS(rzPDF Generation classz**__z~~z--\z^\[([^][]+)\]\(([^()]+)\)(.*)$NTmmA4 DEPRECATED)enforce_compliance orientationunitrfont_cache_dirrrc|dkr(tjdttt d|_ d|_ i|_i|_ i|_ g|_ t|_ d|_d|_d|_|d|_d|_d|_d|_d|_d|_d|_t3|_d|_g|_d|_d|_d|_i|_ d|_!d|_"i|_#d |_$ d d d d |_%tM||_'d|_(d|_)d|_*d|_+d|_,d|_-d|_.d|_/d|_0|j1|_2|j3|_4|j5|_6d|_7tqddd|_9d|j'z |_:tvj<|_=t}||j'\|_?|_@|A||j?|j@|jB|_Cd|j'z }d|_Dd|_Ed|_Fd|_G|H|||jF|jGc|_D|_E|dz |_I|Jdd|z|Kdd|_Ld|_Md|_Nd|_OtjQtjS|_Td|_Ug|_Vd|_Wd|_X|rtjZ|nd|_[|j[r|j[j\dkr,|j[j]dkr|^dd|_|j[j\dkr#|j[j]dvr|^d|j[j\dkr%|j[j]dkr|^dd|__d|_`t|_btt|_ed|_fdS)ak Args: orientation (str): possible values are "portrait" (can be abbreviated "P") or "landscape" (can be abbreviated "L"). Default to "portrait". unit (str, int, float): possible values are "pt", "mm", "cm", "in", or a number. A point equals 1/72 of an inch, that is to say about 0.35 mm (an inch being 2.54 cm). This is a very common unit in typography; font sizes are expressed in this unit. If given a number, then it will be treated as the number of points per unit. (eg. 72 = 1 in) Default to "mm". format (str): possible values are "a3", "a4", "a5", "letter", "legal" or a tuple (width, height) expressed in the given unit. Default to "a4". font_cache_dir (Path or str): [**DEPRECATED since v2.5.1**] unused rzV"font_cache_dir" parameter is deprecated since v2.5.1, unused and will soon be removed stacklevelFrNTlatin-1 helveticacouriertimes)arial couriernew timesnewroman ddashgapphaseg/$?gbX<@g$@ fullwidthz1.3PDFAr'1.4)rz1.7z2.0)grrDeprecationWarningr3super__init__single_resources_objectrrlinksnamed_destinationsembedded_filesrj image_cache in_footer_in_unbreakable_lasthalias_nb_pages_angle xmp_metadata page_durationpage_transitionallow_images_transparencyoversized_imagesoversized_images_ratiorstruct_buildertoc_placeholder_outlinein_toc_rendering_toc_allow_page_insertion_toc_inserted_pages_output_intents _sign_keytitlesection_title_stylescore_fonts_encoding font_aliasesrr font_family font_style underline strikethrough font_size_ptfont_stretching char_spacing current_fontcurrent_font_is_set_on_pageDEFAULT_DRAW_COLOR draw_colorDEFAULT_FILL_COLOR fill_colorDEFAULT_TEXT_COLOR text_colorpage_backgrounddict dash_pattern line_widthrYFILL text_moderdw_ptdh_pt_set_orientationcur_orientationdef_orientationxrl_margint_margin set_marginsc_marginset_auto_page_breakset_display_mode _page_modeviewer_preferencescompress pdf_versionrnowrutc creation_date_security_handler_fallback_font_ids_fallback_font_exact_matchrender_color_fontsrJcoerce _complianceprofilepart_set_min_pdf_version_current_draw_context_record_text_quad_pointsr_resource_catalogrr_text_quad_pointsbuffer)rrrrrrmargin __class__s r&rz FPDF.__init__,sn, \ ) ) M6#*,,      ',$   *,     68%<<$    #)-&HL&'#2449=.0 %).&#$ CE$( :<!#, +!#$   "$''"#%"  ,1(111# aQa888$&.!"1!@!@ DJ k4:tzBBB#3$tv-     ((( %}    q6z222 k***.2  # %'/|HL'A'ADH-/*/'(,"   %&8 9 9 9    1'611d6F6Kq6P6P))%00016.'611d6F6Kv6U6U))%000'611d6F6Kq6P6P))%000?C"(-%2A2C2C:ET9J9J,0 r%c|jjSN)rP font_registryrs r&fontsz FPDF.fontss%33r%Fowner_password user_passwordencryption_method permissionsencrypt_metadatac|jr,|jjdkrtd|jjt |||||||_dS)a Activate encryption of the document content. Args: owner_password (str): mandatory. The owner password allows to perform any change on the document, including removing all encryption and access permissions. user_password (str): optional. If a user password is set, the content of the document will be encrypted and a password prompt displayed when a user opens the document. The document will only be displayed after either the user or owner password is entered. encryption_method (fpdf.enums.EncryptionMethod, str): algorithm to be used to encrypt the document. Defaults to RC4. permissions (fpdf.enums.AccessPermission): specify access permissions granted when the document is opened with user access. Defaults to ALL. encrypt_metadata (bool): whether to also encrypt document metadata (author, creation date, etc.). Defaults to False. rz7Encryption is now allowed for documents compliant with )rZr[ permissionr\r^N)rJrKr`labelrArE)rrZr[r\r]r^s r&set_encryptionzFPDF.set_encryptionss0    0 8F B B%b$JZJ`bb "9 )'"/- " " " r%textrrc|j|g|Ri|}|5||ddddS#1swxYwYdS)a8 Parse HTML and convert it to PDF. cf. https://py-pdf.github.io/fpdf2/HTML.html Args: text (str): HTML content to render image_map (function): an optional one-argument function that map `` "src" to new image URLs li_tag_indent (int): [**DEPRECATED since v2.7.9**] numeric indentation of `
  • ` elements - Set `tag_styles` instead dd_tag_indent (int): [**DEPRECATED since v2.7.9**] numeric indentation of `
    ` elements - Set `tag_styles` instead table_line_separators (bool): enable horizontal line separators in ``. Defaults to `False`. ul_bullet_char (str): bullet character preceding `
  • ` items in `
      ` lists. Can also be configured using the HTML `type` attribute of `
        ` tags. li_prefix_color (tuple, str, fpdf.drawing.DeviceCMYK, fpdf.drawing.DeviceGray, fpdf.drawing.DeviceRGB): color for bullets or numbers preceding `
      • ` tags. This applies to both `
          ` & `
            ` lists. heading_sizes (dict): [**DEPRECATED since v2.7.9**] font size per heading level names ("h1", "h2"...) - Set `tag_styles` instead pre_code_font (str): [**DEPRECATED since v2.7.9**] font to use for `
            ` & `` blocks - Set `tag_styles` instead
                        warn_on_tags_not_matching (bool): control warnings production for unmatched HTML tags. Defaults to `True`.
                        tag_indents (dict): [**DEPRECATED since v2.8.0**]
                            mapping of HTML tag names to numeric values representing their horizontal left indentation. - Set `tag_styles` instead
                        tag_styles (dict[str, fpdf.fonts.TextStyle]): mapping of HTML tag names to `fpdf.fonts.TextStyle` or `fpdf.fonts.FontFace` instances
                    N)HTML2FPDF_CLASS
            local_contextfeed)rrcrrhtml2pdfs     r&
            write_htmlzFPDF.write_htmls4(4'>t>>>v>>
            
            
            
            !
            !	 	 MM$	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 sA		A
            A
            versionc:t|j||_dSrV)maxrA)rrjs  r&rMzFPDF._set_min_pdf_version st/99r%ch|j}|jr|dz
            }|jr|dz
            }tj|S)zIThe current text emphasis: bold, italics, underline and/or strikethrough.SU)rr rrWrI)rrs  r&emphasisz
            FPDF.emphasis#sE_
            	#J>	#J":...r%c4|jduo|jjdkS)NTTF)r$typerXs r&is_ttf_fontzFPDF.is_ttf_font-s  ,P1B1G51PPr%c|jSrV)r>rXs r&	page_modezFPDF.page_mode1s
            r%rvctj||_|jtjkr|ddS|jtjkr|ddSdS)N1.61.5)rQrIr>USE_ATTACHMENTSrMUSE_OC)rrvs  r&rvzFPDF.page_mode5sn"/)44?h666%%e,,,,,
            _
            /
            /%%e,,,,,0
            /r%c4|jSrV)rvaluesrXs r&output_intentszFPDF.output_intents=s#**,,,r%subtypeoutput_condition_identifieroutput_condition
            registry_namedest_output_profileinfoc|j|jvrtd|jzdzt|||||||j|j<|ddS)aR
                    Adds desired Output Intent to the Output Intents array:
            
                    Args:
                        subtype (OutputIntentSubType, required): PDFA, PDFX or ISOPDF
                        output_condition_identifier (str, required): see the Name in
                            https://www.color.org/registry.xalter
                        output_condition (str, optional): see the Definition in
                            https://www.color.org/registry.xalter
                        registry_name (str, optional): "https://www.color.org"
                        dest_output_profile (PDFICCProfile, required/optional):
                            PDFICCProfile | None # (required  if
                            output_condition_identifier does not specify a standard
                            production condition; optional otherwise)
                        info (str, required/optional see dest_output_profile): human
                            readable description of profile
                    zadd_output_intent: subtype 'z' already exists.rN)valuer
            ValueErrorrzrM)rrrrrrrs       r&add_output_intentzFPDF.add_output_intentAs4=D000.>ATT
            /E'
            /
            /
            W]+	
            !!%(((((r%c0|j|jz
            |jz
            S)zT
                    Effective page width: the page width minus its horizontal margins.
                    )wr8r_marginrXs r&epwzFPDF.epwi
            v
            %
            55r%c0|j|jz
            |jz
            S)zT
                    Effective page height: the page height minus its vertical margins.
                    )hr9b_marginrXs r&ephzFPDF.ephprr%c*t|jS)a%
                    Returns the total pages of the document, at the time it is called.
            
                    Do not use this in `fpdf.fpdf.FPDF.header()` or `fpdf.fpdf.FPDF.footer()`,
                    as its value will not be the total page count.
                    Uses `{nb}` instead, _cf._ `fpdf.fpdf.FPDF.alias_nb_pages()`.
                    )lenrrXs r&pages_countzFPDF.pages_countws4:r%rSch|||||j|dS)z
                    Sets the document right, left, top & bottom margins to the same value.
            
                    Args:
                        margin (float): margin in the unit specified to FPDF constructor
                    N)r:r<auto_page_breakrrSs  r&
            set_marginzFPDF.set_margins9	
            (((  !5v>>>>>r%lefttoprightc|||j|ks|j|jkr||_||_|dkr|}||_dS)a
                    Sets the document left, top & optionally right margins to the same value.
                    By default, they equal 1 cm.
                    Also sets the current FPDF.y on the page to this minimum vertical position.
            
                    Args:
                        left (float): left margin in the unit specified to FPDF constructor
                        top (float): top margin in the unit specified to FPDF constructor
                        right (float): optional right margin in the unit specified to FPDF constructor
                    rN)set_left_marginrr9r)rrrrs    r&r:zFPDF.set_marginssX	
            T"""6C<<46T]22DF
            B;;E
            
            
            r%cX|j|ks|j|jkr||_||_dS)z
                    Sets the document left margin.
                    Also sets the current FPDF.x on the page to this minimum horizontal position.
            
                    Args:
                        margin (float): margin in the unit specified to FPDF constructor
                    N)r7r8rs  r&rzFPDF.set_left_margins/6F??df
            55DF
            
            
            r%c||_dS)z
                    Sets the document top margin.
            
                    Args:
                        margin (float): margin in the unit specified to FPDF constructor
                    N)r9rs  r&set_top_marginzFPDF.set_top_margin
            
            
            r%c||_dS)z
                    Sets the document right margin.
            
                    Args:
                        margin (float): margin in the unit specified to FPDF constructor
                    N)rrs  r&set_right_marginzFPDF.set_right_marginrr%rautocJ||_||_|j|jz
            |_dS)a
                    Set auto page break mode, and optionally the bottom margin that triggers it.
                    By default, the mode is on and the bottom margin is 2 cm.
            
                    Detailed documentation on page breaks: https://py-pdf.github.io/fpdf2/PageBreaks.html
            
                    Args:
                        auto (bool): enable or disable this mode
                        margin (float): optional bottom margin (distance from the bottom of the page)
                            in the unit specified to FPDF constructor
                    N)rrrpage_break_trigger)rrrSs   r&r<zFPDF.set_auto_page_breaks*&*%
            )-$-)?r%cd|jtjkr|j|jfn
            |j|jfS)zISJ-k:::t!9:;T UUU%%e,,,,,VUr%r@c||_dS)a
                    Activates or deactivates page compression.
            
                    When activated, the internal representation of each page is compressed
                    using the zlib/deflate method (FlateDecode), which leads to a compression ratio
                    of about 2 for the resulting document.
            
                    Page compression is enabled by default.
            
                    Args:
                        compress (bool): indicates if compression should be enabled
                    N)r@)rr@s  r&set_compressionzFPDF.set_compressionks!
            
            
            r%rc||_dS)aA
                    Defines the title of the document.
            
                    Most PDF readers will display it when viewing the document.
                    There is also a related `fpdf.prefs.ViewerPreferences` entry:
            
                        pdf.viewer_preferences = ViewerPreferences(display_doc_title=True)
            
                    Args:
                        title (str): the title
                    Nr)rrs  r&	set_titlezFPDF.set_titlezs
            
            
            r%langcF||_|r|ddSdS)a
                    A language identifier specifying the natural language for all text in the document
                    except where overridden by language specifications for structure elements or marked content.
                    A language identifier can either be the empty text string, to indicate that the language is unknown,
                    or a Language-Tag as defined in RFC 3066, "Tags for the Identification of Languages".
            
                    Args:
                        lang (str): the document main language
                    rN)rrM)rrs  r&set_langz
            FPDF.set_langs7		-%%e,,,,,	-	-r%subjectc||_dS)zz
                    Defines the subject of the document.
            
                    Args:
                        subject (str): the document main subject
                    N)r)rrs  r&set_subjectzFPDF.set_subjectsr%authorc||_dS)zt
                    Defines the author of the document.
            
                    Args:
                        author(str): the name of the author
                    N)r)rrs  r&
            set_authorzFPDF.set_authorsr%keywordsc||_dS)z
                    Associate keywords with the document
            
                    Args:
                        keywords (str): a space-separated list of words
                    N)r)rrs  r&set_keywordszFPDF.set_keywordss!
            
            
            r%creatorc||_dS)z
                    Defines the creator of the document.
                    This is typically the name of the application that generates the PDF.
            
                    Args:
                        creator (str): name of the PDF creator
                    N)r)rrs  r&set_creatorzFPDF.set_creatorsr%producerc||_dS)zProducer of documentN)r)rrs  r&set_producerzFPDF.set_producers
             
            
            
            r%datec|jrtdt|tst	dt||js|}||_dS)z:Sets Creation of Date time, or current time if None given.zB.set_creation_date() must always be called before .sign*() methodsz#date should be a datetime but is a N)	rr]rrrrstzinfo
            astimezonerD)rrs  r&set_creation_datezFPDF.set_creation_datesz>	T
            $))	PN$t**NNOOO{	%??$$D!r%rc|d|ddvrtd||_|r|ddSdS)Nz	 tagr)rrrM)rrs  r&set_xmp_metadatazFPDF.set_xmp_metadatasa,ss+++R
            )	-%%e,,,,,	-	-r%optrrctjdtt|dkrt	d|d||_dS)a
                    Defines a document option.
            
                    Args:
                        opt (str): name of the option to set
                        value (str) option value
            
                    .. deprecated:: 2.4.0
                        Simply set the `FPDF.core_fonts_encoding` property as a replacement.
                    zset_doc_option() is deprecated since v2.4.0 and will be removed in a future release. Simply set the `.core_fonts_encoding` property as a replacement.rrzUnknown document option ""N)rrrr3r]r)rrrs   r&set_doc_optionzFPDF.set_doc_optionsg	
            S
            &((	
            	
            	
            	
            ''' BC B B BCCC#(   r%image_filterc|tvr-td|ddttt||j_|dkr|ddSdS)a
                    Args:
                        image_filter (str): name of a the image filter to use
                            when embedding images in the document, or "AUTO",
                            meaning to use the best image filter given the images provided.
                            Allowed values: `FlateDecode` (lossless zlib/deflate compression),
                            `DCTDecode` (lossy compression with JPEG)
                            `LZWDecode` (Lempel-Ziv-Welch aka LZW compression)
                            and `JPXDecode` (lossy compression with JPEG2000).
            
                    [**NEW in 2.8.4**] Note that, when using `LZWDecode`, having NumPy installed
                    will improve performances, reducing execution time.
                    'z4' is not a supported image filter - Allowed values: r	JPXDecoderyN)rorjoinrrkrrrM)rrs  r&set_image_filterzFPDF.set_image_filters666ILII&(gg.E&F&FII
            )-[,(G(G%;&&%%e,,,,,'&r%{nb}aliasc||_dS)a5
                    Defines an alias for the total number of pages.
                    It will be substituted as the document is closed.
            
                    This is useful to insert the number of pages of the document
                    at a time when this number is not known by the program.
            
                    This substitution can be disabled for performances reasons, by calling `alias_nb_pages(None)`.
            
                    Args:
                        alias (str): the alias. Defaults to `"{nb}"`.
            
                    Notes
                    -----
            
                    When using this feature with the `FPDF.cell` / `FPDF.multi_cell` methods,
                    or the `.underline` / `.strikethrough` attributes of `FPDF` class,
                    the width of the text rendered will take into account the alias length,
                    not the length of the "actual number of pages" string,
                    which can causes slight positioning differences.
                    N)str_alias_nb_pages)rrs  r&r	zFPDF.alias_nb_pagess,#(r%label_stylelabel_prefixlabel_startc4d}|j|jvr%|j|j}n2|jdkr'|j|jdz
            }d}|s|s|r|rU||}||}|'|jr|jjs|}|rtj	|dnd}t|||}|j|j||dS)z
                    Enable `fpdf.output.PDFPageLabel` to be inserted on every page.
                    This will be displayed by some PDF readers to identify pages.
                    Nr'Tcase_sensitive)rrget_page_label	get_style
            get_prefixrr	get_startrOrIr~set_page_label)rrrrcurrent_page_labelnew_page_labels      r&rzFPDF.set_page_labelsH"9
            ""!%DI!6!E!E!G!G
            Y]]!%DIM!:!I!I!K!K	R,	R+	R!
            A&"4">">"@"@K'#5#@#@#B#BL&('-1-A-T'#5">">"@"@K%k$GGGG
            
            *+|[QQN
            49,,-?PPPPPr%rsameduration
            transitionc		<	|jrtdd|_|j}	|j}
            |j}|j}|j}
            |j}|j	}|j
            }|j}|j}|j
            o|jo|j|jjk}|jdkr|j
            r|r||jdkrdn#|j|j}d}|s|s|r+|rt+j|dnd}t/|||}|||||p|j|p|j||j|j|||jrt=|jt>ra|j |j|!dd|j"|j#d	t=|tHtJfsJ|j |j&n(|'|jdd|j"|j#|(d
            ||_|(||j)zdd|	r|*|	|
            ||
            |_|
            |j+kr;|
            9|(|
            ,-||_||j.kr;|9|(|,/||_	|j
            r|jr|0|j|kr(||_|(||j)zdd|	r|*|	|
            ||j|
            krB|
            @|
            |_|(|
            ,-|j|krB|@||_|(|,/||_	|d
            kr|1||dkr|2||tgdddkr+|4|d|d|ddSdS)u
                    Adds a new page to the document.
                    If a page is already present, the `FPDF.footer()` method is called first.
                    Then the page  is added, the current position is set to the top-left corner,
                    with respect to the left and top margins, and the `FPDF.header()` method is called.
            
                    Args:
                        orientation (str): "portrait" (can be abbreviated "P")
                            or "landscape" (can be abbreviated "L"). Default to "portrait".
                        format (str): "a3", "a4", "a5", "letter", "legal" or a tuple
                            (width, height). Default to "a4".
                        same (bool): indicates to use the same page format as the previous page.
                            Default to False.
                        duration (float): optional page’s display duration, i.e. the maximum length of time,
                            in seconds, that the page is displayed in presentation mode,
                            before the viewer application automatically advances to the next page.
                            Can be configured globally through the `.page_duration` FPDF property.
                            As of june 2021, onored by Adobe Acrobat reader, but ignored by Sumatra PDF reader.
                        transition (Transition child class): optional visual transition to use when moving
                            from another page to the given page during a presentation.
                            Can be configured globally through the `.page_transition` FPDF property.
                            As of june 2021, onored by Adobe Acrobat reader, but ignored by Sumatra PDF reader.
                        label_style (str or PageLabelStyle): Defines the numbering style for the numeric portion of each
                            page label. Possible values are:
                            - "D": Decimal Arabic numerals.
                            - "R": Uppercase Roman numerals.
                            - "r": Lowercase Roman numerals.
                            - "A": Uppercase letters (A to Z for the first 26 pages, followed by AA to ZZ, etc.).
                            - "a": Lowercase letters (a to z for the first 26 pages, followed by aa to zz, etc.).
                        label_prefix (str): Prefix string applied to the page label, preceding the numeric portion.
                        label_start (int): Starting number for the first page of a page label range.
                    zCA page cannot be added on a closed document, after calling output()FrNTr)new_pageFstylez2 J.2f wrrrrr)5rRr]r%rrpr!r/r'r)r+r"r#r.rrrrr_render_footerrrrOrIr~
            _beginpagerr
            _has_next_pagerr,rtupleset_fill_colorrectrrr=r<	colors255image_outrset_fontr&	serializeupperr(rheaderset_stretchingset_char_spacingr-_write_dash_pattern)rrrrrrrrrfamilyrpsizelwdcfctc
            stretchingr#r.in_toc_extra_pagerrs                      r&add_pagez
            FPDF.add_page>sV;	U
            ,1(!= 
            _
            _
            _
            _)
            ((
            !
            <.
            <	D0;;	
            9q==$"7=;L=!!!INNDD
            49(=(L(L(N(N		R,	R+	R%k$GGGG
            
            *+|[QQN	
            **.$.,,...
            		
            	
            	
            	
            49,,-?PPP
            	$.66
            ##T%9::		!Qc	:::!"y*&=>>>>>##R\222
            
            (FF	
            		%		R$&[(((()))	2MM&(D111
            (((R^IIbllnn**,,---
            (((R^IIbllnn**,,---%	$*H	KKMMM?b   DOIIdf,,,,---	2MM&(D111?b  R^ DOIIbllnn**,,---?b  R^ DOIIbllnn**,,---
            +++1!!,///4QAQ77777$$V$l5&9<;P
            
            
            
            
            87r%cd|_|jr(||||jr(||d|_dS)NTF)rr_push_local_stack_start_local_contextfooter_end_local_context_pop_local_stackrXs r&rzFPDF._render_footers	(
            ""$$$%%'''
            
            
            	$##%%%!!###r%r
            c|xjdz
            c_|jr5|jr.|xjdz
            c_t	|jdz|_d}|rKt
            t|||j}||j|j<|r|dn|j|j}|j	|_
            |j|_d|_
            d|_d|_|r|s|rt!d|d	|d
            |nF|rt#||jn
            |j|jf\}}	||p|j||	||j|jdS)Nr'T)contentsrrindexryrrrzInconsistent parameters: same=z but orientation=z format=)rrrrrrr}	bytearrayrMr8r7r9rrr"r#rrrr2r3r4r6set_dimensionsrr)
            rrrrrrr
            rrrs
                      r&rzFPDF._beginpages	
            		Q		 	T%C	$$)$$DJ!+DIH	)"!%i	D%)DJty!
            1))%000:di(D"	
            f
             iTiiKiiagii
            4:W///
            DJ?W
            *M>
            !!3t3]N
            
            
            	
            DIty11111r%cdS)a
                    Header to be implemented in your own inherited class
            
                    This is automatically called by `FPDF.add_page()`
                    and should not be called directly by the user application.
                    The default implementation performs nothing: you have to override this method
                    in a subclass to implement your own rendering logic.
            
                    Note that header rendering can have an impact on the initial
                    (x,y) position when starting to render the page content.
                    Nr$rXs r&rzFPDF.headerr%cdS)al
                    Footer to be implemented in your own inherited class.
            
                    This is automatically called by `FPDF.add_page()` and `FPDF.output()`
                    and should not be called directly by the user application.
                    The default implementation performs nothing: you have to override this method
                    in a subclass to implement your own rendering logic.
                    Nr$rXs r&r,zFPDF.footer!r5r%c|jS)zGet the current page numberrrXs r&page_nozFPDF.page_no+s
            yr%cJ|j|jS)z
                    Return the current page `fpdf.output.PDFPageLabel`.
                    This will be displayed by some PDF readers to identify pages.
                    `FPDF.set_page_label()` needs to be called first for those to be inserted.
                    )rr	get_labelrXs r&rzFPDF.get_page_label/sz$)$..000r%rgbct|||}||jkrR||_|jdkrB||jdSdSdS)a,
                    Defines the color used for all stroking operations (lines, rectangles and cell borders).
                    Accepts either a single greyscale value, 3 values as RGB components, a single `#abc` or `#abcdef` hexadecimal color string,
                    or an instance of `fpdf.drawing.DeviceCMYK`, `fpdf.drawing.DeviceRGB` or `fpdf.drawing.DeviceGray`.
                    The method can be called before the first page is created and the value is retained from page to page.
            
                    Args:
                        r (int, tuple, fpdf.drawing.DeviceGray, fpdf.drawing.DeviceRGB): if `g` and `b` are given, this indicates the red component.
                            Else, this indicates the grey level. The value must be between 0 and 255.
                        g (int): green component (between 0 and 255)
                        b (int): blue component (between 0 and 255)
                    rN)r@r'rrrr)rr<r=r>r's     r&set_draw_colorzFPDF.set_draw_color7~-Q155
            (((DOy1}}		O--//5577)(}r%ct|||}||jkrR||_|jdkrB||jdSdSdS)a/
                    Defines the color used for all filling operations (filled rectangles and cell backgrounds).
                    Accepts either a single greyscale value, 3 values as RGB components, a single `#abc` or `#abcdef` hexadecimal color string,
                    or an instance of `fpdf.drawing.DeviceCMYK`, `fpdf.drawing.DeviceRGB` or `fpdf.drawing.DeviceGray`.
                    The method can be called before the first page is created and the value is retained from page to page.
            
                    Args:
                        r (int, tuple, fpdf.drawing.DeviceGray, fpdf.drawing.DeviceRGB): if `g` and `b` are given, this indicates the red component.
                            Else, this indicates the grey level. The value must be between 0 and 255.
                        g (int): green component (between 0 and 255)
                        b (int): blue component (between 0 and 255)
                    rN)r@r)rrrr)rr<r=r>r)s     r&rzFPDF.set_fill_colorNrAr%c2t||||_dS)a
                    Defines the color used for text.
                    Accepts either a single greyscale value, 3 values as RGB components, a single `#abc` or `#abcdef` hexadecimal color string,
                    or an instance of `fpdf.drawing.DeviceCMYK`, `fpdf.drawing.DeviceRGB` or `fpdf.drawing.DeviceGray`.
                    The method can be called before the first page is created and the value is retained from page to page.
            
                    Args:
                        r (int, tuple, fpdf.drawing.DeviceGray, fpdf.drawing.DeviceRGB): if `g` and `b` are given, this indicates the red component.
                            Else, this indicates the grey level. The value must be between 0 and 255.
                        g (int): green component (between 0 and 255)
                        b (int): blue component (between 0 and 255)
                    N)r@r+)rr<r=r>s    r&set_text_colorzFPDF.set_text_colores42!Q::r%s
            normalizedmarkdownc|jstd|r|n||}td|||DS)a&
                    Returns the length of a string in user unit. A font must be selected.
                    The value is calculated with stretching and spacing.
            
                    Note that the width of a cell has some extra padding added to this width,
                    on the left & right sides, equal to the .c_margin property.
            
                    Args:
                        s (str): the string whose length is to be computed.
                        normalized (bool): whether normalization needs to be performed on the input string.
                        markdown (bool): indicates if basic markdown support is enabled
                    3No font set, you need to call set_font() beforehandc3>K|]}|VdSrV)	get_width.0frags  r&	z(FPDF.get_string_width..s=
            
            !%DNN
            
            
            
            
            
            r%)rr]normalize_textsum_preload_bidirectional_text)rrErFrGs    r&get_string_widthzFPDF.get_string_widthsy	W UVVV7AA!4!4Q!7!7
            
            )-)I)I!X)V)V
            
            
            
            
            	
            r%widthc||jkr5||_|jdkr%|||jzdddSdSdS)aF
                    Defines the line width of all stroking operations (lines, rectangles and cell borders).
                    By default, the value equals 0.2 mm.
                    The method can be called before the first page is created and the value is retained from page to page.
            
                    Args:
                        width (float): the width in user unit
                    rrrN)r/rrr)rrTs  r&set_line_widthzFPDF.set_line_widthsZDO###DOy1}}		UTV^333344444$#}r%
            backgroundct|ttjtt
            ttdfr,t|t
            r|j|_	dS||_	dStdt|)aD
                    Sets a background color or image to be drawn every time `FPDF.add_page()` is called, or removes a previously set background.
                    The method can be called before the first page is created and the value is retained from page to page.
            
                    Args:
                        background: either a string representing a file path or URL to an image,
                            an io.BytesIO containing an image as bytes, an instance of `PIL.Image.Image`, drawing.DeviceRGB
                            or a RGB tuple representing a color to fill the background with or `None` to remove the background
                    Nzkbackground must be of type str, io.BytesIO, PIL.Image.Image, drawing.DeviceRGB, tuple or None
                    got: )rrioBytesIOrr=rrsrr,r)rrWs  r&set_page_backgroundzFPDF.set_page_backgroundsbj%E4::N
            
            	*i00
            2'1';$$$'1$$$#:##
            r%debug_streamc#K|jtdt}||_	|Vd|_n#d|_wxYw|}|jt|j|j|j|j	|f}|j
            |}|j||j|
            ||ddS)z
                    Create a context for drawing paths on the current page.
            
                    If this context manager is called again inside of an active context, it will
                    raise an exception, as base drawing contexts cannot be nested.
                    N9cannot create a drawing context while one is already openr)rNr]r5_current_graphic_stylerPr>r7rrrrenderindex_stream_resourcesrrrM)rr\contextstarting_stylerender_argsrendereds      r&drawing_contextzFPDF.drawing_contexts%1K
            !""%,"	.MMM)-D&&D&----4466"$&$&!!FF
            "7>;/	
            55h	JJJ	
            		(!!%(((((	;	Ashadingc#@K|jtj||j|}|jtj||j}|d|d	dV|jJ||j	
            dS#|jJ||j	
            wxYw)zS
                    Create a context for using a shading pattern on the current page.
                    z
            /Pattern cs /z scnN)rPaddrTSHADINGrget_patternPATTERNrr'rr)rrhpatternpattern_names    r&use_patternzFPDF.use_patterns	
            ""?#:GTYOOO%%''-11#Wdi
            
            	
            		4,444555	;EEE?...IIdo//117799:::::?...IIdo//117799::::s
            CA	DcLt}|j|_|j|_|j|jkr|j|_|j|j	kr|j|_|j
            }|ddkr|ddkr|d|dfnd}||_|d|_|S)Nrrrr)
            r7rallow_transparencyr/stroke_widthr'r&stroke_colorr)r(r.stroke_dash_patternstroke_dash_phase)rgs	dash_infor.s    r&r_zFPDF._current_graphic_styles
            __ $ >
            /?d555"oBO?d555 OBM%	 A%%)E*:a*?*?v
            	% 011	".(1	r%r7r
            paint_rulec#K|5}t||}||j_|V||ddddS#1swxYwYdS)a
                    Create a path for appending lines and curves to.
            
                    Args:
                        x (float): Abscissa of the path starting point
                        y (float): Ordinate of the path starting point
                        paint_rule (PathPaintRule): Optional choice of how the path should
                            be painted. The default (AUTO) automatically selects stroke/fill based
                            on the path style settings.
                    )r7rN)rfr8r
            ryadd_item)rr7rryr\ctxtpaths       r&new_pathz
            FPDF.new_paths$
            !
            !
            #
            #	 ta(((D$.DJ!JJJMM$		 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 s7AA"Ar}copyc|5}|||ddddS#1swxYwYdS)a
                    Add a pre-constructed path to the document.
            
                    Args:
                        path (drawing.PaintedPath): the path to be drawn.
                        copy (bool): if true (the default), the path will be copied before being
                            added. This prevents modifications to a referenced object from
                            "retroactively" altering its style/shape and should be disabled with
                            caution.
                    N)rfr{)rr}r\rr|s     r&	draw_pathzFPDF.draw_path0s 
            !
            !
            #
            #	&tMM$%%%	&	&	&	&	&	&	&	&	&	&	&	&	&	&	&	&	&	&s
            9==rrrct|ttfr|dkstdt|ttfr|dkstdt|ttfr|dkstdt	t|t|t|}||jkr ||_||||dSdS)a
                    Set the current dash pattern for lines and curves.
            
                    Args:
                        dash (float): The length of the dashes in current units.
            
                        gap (float): The length of the gaps between dashes in current units.
                            If omitted, the dash length will be used.
            
                        phase (float): Where in the sequence to start drawing.
            
                    Omitting 'dash' (= 0) resets the pattern to a solid line.
                    rz.Dash length must be zero or a positive number.z-gap length must be zero or a positive number.z(Phase must be zero or a positive number.rN)rrrrr-r.r)rrrrrns     r&set_dash_patternzFPDF.set_dash_patternCs 4#u..	O4199MNNN3e--	N#((LMMM53,//	IEQJJGHHH$(t%**E%LL%
            %
            %
            d''' 'D$$T366666('r%c|rF|r(d||jzdd||jzdd||jzdd}nd||jzdd||jzdd}nd}||dS)N[z.3f z] z dz[] 0 d)rr)rrrrdstrs     r&rzFPDF._write_dash_patternbs	
            FX4$&=XXXsTV|XXX5$&=XXXXE4$&=EEEtv
            EEEED		$r%c#K|jtdt}||_	|Vd|_n#d|_wxYw|ddS)zq
                    Create a context for drawing paths for type 3 font glyphs, without writing on the current page.
                    Nr^r)rNr]r5rM)rrbs  r&glyph_drawing_contextzFPDF.glyph_drawing_contextls%1K
            !""%,"	.MMM)-D&&D&----!!%(((((rgrrcHd}|5}||t}|jt	dddd|f}|j|}|j|D]\}}|tjkr'|j	
            t||tjkr|j
            
            ||tjkr|j
            |	dddn#1swxYwY|S)z=
                    Add a pre-constructed path to the document.
                    rrr'N)rr{r7rPr>r`scan_streamrTX_OBJECTimages_usedrjrEXT_G_STATEgraphics_style_usedrm
            patterns_used)	rr}r
            output_streamr|rcrd
            resource_typeresource_ids	         r&draw_vector_glyphzFPDF.draw_vector_glyphsj 
            
            
            '
            '
            )
            )	8TMM$*__N&aK(DK5M.2.D.P.P//
            8
            8*
            {!O$<<<$(([)9)9::: O$???,00=== O$;;;&**;777
            8	8	8	8	8	8	8	8	8	8	8	8	8	8	8	80sC3DDDx1y1x2y2c
            |||jzdd|j|z
            |jzdd||jzdd|j|z
            |jzdddS)a
                    Draw a line between two points.
            
                    Args:
                        x1 (float): Abscissa of first point
                        y1 (float): Ordinate of first point
                        x2 (float): Abscissa of second point
                        y2 (float): Ordinate of second point
                    rr m  l SNrrr)rrrrrs     r&linez	FPDF.lines	
            		DF{R
            0
            0$&2+!7R
            0
            0TVR
            0
            0tv%/
            0
            0
            0	
            	
            	
            	
            	
            r%
            point_listfillpolygonr
            c|r(tjdtt|r|
            tj}nI|t	j|ntj}|r%|tjkrtd|d|d}|D]G}|	|d|j
            zdd	|j|d
            z
            |j
            zdd	|d}H|r|	d|	d	|jdS)
            a
                    Draws lines between two or more points.
            
                    Args:
                        point_list (list of tuples): List of Abscissa and Ordinate of
                                                    segments that should be drawn
                        fill (bool): [**DEPRECATED since v2.5.4**] Use `style="F"` or `style="DF"` instead
                        polygon (bool): If true, close path before stroking, to fill the inside of the polyline
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
            
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    zP"fill" parameter is deprecated since v2.5.4, use style="F" or style="DF" insteadrNz"Conflicting values provided: fill=z	 & style=mrrrr'lz h)
            rrrr3rUDFrIDrrrroperator)rrrrr
            rpoints       r&polylinez
            FPDF.polylinesO,	M:#*,,
            
            
            
            
            	EMNEE161BK&u---
            E
            .. OOOOO		EII8df$XXXDFU1X,=+GXXXhXX
            
            
            HH	IIdOOO		&en&&'''''r%c8|||d|dS)a
                    Outputs a polygon defined by three or more points.
            
                    Args:
                        point_list (list of tuples): List of coordinates defining the polygon to draw
                        fill (bool): [**DEPRECATED since v2.5.4**] Use `style="F"` or `style="DF"` instead
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
            
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    T)rrr
            N)r)rrrr
            s    r&rzFPDF.polygons$&	
            
            
            jtT
            GGGGGr%r'dash_lengthspace_lengthctjdtt|||||||||dS)a
                    Draw a dashed line between two points.
            
                    Args:
                        x1 (float): Abscissa of first point
                        y1 (float): Ordinate of first point
                        x2 (float): Abscissa of second point
                        y2 (float): Ordinate of second point
                        dash_length (float): Length of the dash
                        space_length (float): Length of the space between 2 dashes
            
                    .. deprecated:: 2.4.6
                        Use `FPDF.set_dash_pattern()` and the normal drawing operations instead.
                    zdashed_line() is deprecated since v2.4.6, and will be removed in a future release. Use set_dash_pattern() and the normal drawing operations instead.rN)rrrr3rr)rrrrrrrs       r&dashed_linezFPDF.dashed_linesy0	
            T
            &((	
            	
            	
            	
            	
            k<888		"b"b!!!r%rr
            round_corners
            corner_radiusc6|tj|ntj}|dur||||||||dS|||jzdd|j|z
            |jzdd||jzdd||jzdd|j	dS)a{
                    Outputs a rectangle.
                    It can be drawn (border only), filled (with no border) or both.
            
                    Args:
                        x (float): Abscissa of upper-left bounding box.
                        y (float): Ordinate of upper-left bounding box.
                        w (float): Width.
                        h (float): Height.
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
            
                        * `D` or empty string: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
            
                        round_corners (tuple of str, tuple of fpdf.enums.Corner, bool): Optional draw a rectangle with round corners.
                        Possible values are:
            
                        *`TOP_LEFT`: a rectangle with round top left corner
                        *`TOP_RIGHT`: a rectangle with round top right corner
                        *`BOTTOM_LEFT`: a rectangle with round bottom left corner
                        *`BOTTOM_RIGHT`: a rectangle with round bottom right corner
                        *`True`: a rectangle with all round corners
                        *`False`: a rectangle with no round corners
            
                        corner_radius: Optional radius of the corners
                    NFrr re )rUrIr_draw_rounded_rectrrrr)rr7rrrr
            rrs        r&rz	FPDF.rectsN.3->"5)))KM%%##Aq!Q}mTTTTTIItv:Q99TVaZ46$9Q99DF
            Q992;899(-99
            
            
            
            
            r%.c|}||kr|}|dkr|dz}||dzkr||z}||fx}	}
            ||z|f}||z||zf}|||zf}
            |durBtjjtjjtjjtjjf}t
            |trJtd|D}tj|vr||z|f}	|||zf}
            tj|vr||z|z
            |f}||z||zf}tj|vr||z||z|z
            f}||z|z
            ||zf}tj|vr||z||zf}
            |||z|z
            f}|	|	d|j
            zdd|j|	dz
            |j
            zdd	|	|d|j
            zdd|j|dz
            |j
            zdd
            tj|vr%|||zd|zz
            |d|zdd|	|d|j
            zdd|j|dz
            |j
            zdd
            tj|vr.|||zd|zz
            ||zd|zz
            d|zdd|	|
            d|j
            zdd|j|
            dz
            |j
            zdd
            tj|vr%||||zd|zz
            d|zdd
            |	|
            d|j
            zdd|j|
            dz
            |j
            zdd
            tj|vr|||d|zd
            d|	d|j
            dS)NrrTc3>K|]}tj|VdSrV)rIrI)rMrcs  r&rOz*FPDF._draw_rounded_rect..ns=7
            7
            "$FM"7
            7
            7
            7
            7
            7
            r%rrr' m liZh )rI	TOP_RIGHTrTOP_LEFTBOTTOM_RIGHTBOTTOM_LEFTrrrrrr_draw_arc_segmentr)rr7rrrr
            rr<minpoint_1point_8point_2point_4point_6round_corners_list_point_3_point_5_point_7s                  r&rzFPDF._draw_rounded_rectLs:q55C66aAa<<
            HAF"'q5!*q5!a%.a!e*D   &%#)"(	MmT22222167
            7
            (57
            7
            7
            2
            2
            
            1111uajG!a%jG?0001uqy!nGAq1u~H!3331ua!eai(GA	1q5)H"4441ua!enG1q519~H	
            		WQZ$&(UUU0Ctv/MUUUUVVV	
            		WQZ$&(UUU0Ctv/MUUUUVVV?000""1q51q5=!QUCCCC	
            		WQZ$&(UUU0Ctv/MUUUUVVV!333""1q51q5=!a%!a%-Q2NNN	
            		WQZ$&(UUU0Ctv/MUUUUVVV"444""1a!ea!emQUBDDD	
            		WQZ$&(UUU0Ctv/MUUUUVVV111""1aQS999	
            		'u~''(((((r%astart_angle	end_anglecdzdz|z|zdtdtfddtdtffd}dtdttffd	}dtdttffd
            }	||}
            ||}||
            kr|dtjzz
            }d}t	|tjt
            ||
            z
            dtjz|zz}
            ||
            z
            |
            z}tj|tjddtj	|dzdzzzd
            z
            zdz}|
            }||}|	|}t|
            D]}|}|}||z
            }||}|	|}|d||dzz|d
            ||d
            zzg}|d||dzz
            |d
            ||d
            zz
            g}||d|jzdd|j
            |d
            z
            |jzdd|d|jzdd|j
            |d
            z
            |jzdd|d|jzdd|j
            |d
            z
            |jzdd
            dS)z
                    Draw an arc segment as part of an existing path (no move, no style application).
                    Used internally for building complex shapes like rounded rectangles.
                    Nrdegrc&|tjzdzSNrmathpirs r&
            deg_to_radz*FPDF._draw_arc_segment..deg_to_rad=3&&r%anglec|dz}tjtj|ztj|z}|dkr|dtjzz
            }|SNhrrratan2sincosrretarr>rs  r&angle_to_paramz.FPDF._draw_arc_segment..angle_to_params_Jus{++E*TXe__q0$(5//A2EFFCQwwq47{"Jr%rcttj|z}tj|z}|z|zgSrVrrr)r	a_cos_eta	b_sin_etarr>cxcys   r&evaluatez(FPDF._draw_arc_segment..evaluates:DHSMM)IDHSMM)INBN33r%cjtj|z}tj|z}||gSrVrrr)r	a_sin_eta	b_cos_etarr>s   r&derivative_evaluatez3FPDF._draw_arc_segment..derivative_evaluates4DHSMM)IDHSMM)IJ	**r%rrr'rrr c)rrrrrceilabsrsqrttanrangerrr)rr7rrrrr>rrr	start_etaend_eta
            max_curvesnd_etaalphaeta2p2p2_prime_p1p1_primecontrol_point_1control_point_2rrrs   `  `                 @@@r&rzFPDF._draw_arc_segments
            9A	Q	Q
            U
            U	'E	'e	'	'	'	'	%	E									4%	4DK	4	4	4	4	4	4	4	4	4
            	+U	+tE{	+	+	+	+	+	+	+
            #N;//	 .++iq47{"G
            	#g	&9":":a$'kJ>V"WXX
            
            9$)49QTXeai5H5HA5M1M-M#N#NQR#RSVWW
            Xd^^&&t,,q		ABHEMD$B**400H!!uux{'::BqEEHUVKDWIJJ)-"Q%46(AIJJJ
            
            
            
            		r%c|tj|ntj}||||||jdS)a 
                    Outputs an ellipse.
                    It can be drawn (border only), filled (with no border) or both.
            
                    Args:
                        x (float): Abscissa of upper-left bounding box.
                        y (float): Ordinate of upper-left bounding box.
                        w (float): Width
                        h (float): Height
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
            
                        * `D` or empty string: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    N)rUrIr
            _draw_ellipser)rr7rrrr
            s      r&ellipsezFPDF.ellipsesD0.3->"5)))KM1aAu~66666r%rc||dzz}||dzz}|dz}|dz}	dtjddz
            z|z}
            dtjddz
            z|	z}|||z|jzdd|j|z
            |jzdd||z|jzdd|j|z
            |z|jzdd||
            z|jzdd|j|z
            |	z|jzdd||jzdd|j|z
            |	z|jzdd|||
            z
            |jzdd|j|z
            |	z|jzdd||z
            |jzdd|j|z
            |z|jzdd||z
            |jzdd|j|z
            |jzdd|||z
            |jzdd|j|z
            |z
            |jzdd||
            z
            |jzdd|j|z
            |	z
            |jzdd||jzdd|j|z
            |	z
            |jzdd|||
            z|jzdd|j|z
            |	z
            |jzdd||z|jzdd|j|z
            |z
            |jzdd||z|jzdd|j|z
            |jzdd|
            dS)	NrgUUUUUU?r'rrrrz c )rrrrr)rr7rrrrrrrxrylxlys            r&rzFPDF._draw_ellipses%QY
            QY
            U
            U
            dillQ&
            '"
            ,
            dillQ&
            '"
            ,		Gtv%KIITVb[DF,BKIIGtv%NII-1Vb[2-=,GNIIGtv%NII-1Vb[2-=,GNII;HII'+frkB&6$&%@HIII	
            	
            	
            	
            		Gtv%NKKTVb[2-=,GNKKGtv%NKK-1Vb[2-=,GNKKGtv%JKK-1Vb[DF,BJKKK	
            	
            	
            	
            		Gtv%NIITVb[2-=,GNIIGtv%NII-1Vb[2-=,GNII;HII&*frkB&6$&%@HIII	
            	
            	
            	
            		Gtv%NVVTVb[2-=,GNVVGtv%NVV-1Vb[2-=,GNVVGtv%UVV-1Vb[DF,BUVVKSVV	
            	
            	
            	
            	
            r%radiuscP|||z
            ||z
            d|zd|z|dS)ad
                    Outputs a circle.
                    It can be drawn (border only), filled (with no border) or both.
            
                    WARNING: This method changed parameters in [release 2.8.1](https://github.com/py-pdf/fpdf2/releases/tag/2.8.1)
            
                    Args:
                        x (float): Abscissa of upper-left bounding box.
                        y (float): Ordinate of upper-left bounding box.
                        radius (float): Radius of the circle.
                        style (str): Style of rendering. Possible values are:
            
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    rN)r)rr7rrr
            s     r&circlezFPDF.circle7s40	
            QZVQZVUKKKKKr%numSides	polyWidth
            rotateDegreesc
            |dz}||z}||z
            }	g}
            td|dzD]}||tjtjd|z|ztj|zzz|	|tjtjd|z|ztj|zzzf}|
            |||
            |dS)a
                    Outputs a regular polygon with n sides
                    It can be rotated
                    Style can also be applied (fill, border...)
            
                    Args:
                        x (float): Abscissa of upper-left bounding box.
                        y (float): Ordinate of upper-left bounding box.
                        numSides (int): Number of sides for polygon.
                        polyWidth (float): Width of the polygon.
                        rotateDegrees (float): Optional degree amount to rotate polygon.
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
            
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    rr'rrN)rrrradiansrappendr)
            rr7rrrrr
            rcenterXcenterYpointsirs
                         r&regular_polygonzFPDF.regular_polygonQs6Qf*f*,.q(Q,''	!	!AftxcHn122T\-5P5PP(($(cHn122T\-5P5PP##E
            
            MM%    	
            V5)))))r%r_inr_outcornersrotate_degreesctj|}g}	td|dzdzD]}}
            ||
            dzdkr|n|tj|zz}||
            dzdkr|n|tj|zz}|	||f|tjd|zz
            }~||	d|dS)a
                    Outputs a regular star with n corners.
                    It can be rotated.
                    It can be drawn (border only), filled (with no border) or both.
            
                    Args:
                        x (float): Abscissa of star's centre.
                        y (float): Ordinate of star's centre.
                        r_in (float): radius of internal circle.
                        r_out (float): radius of external circle.
                        corners (int): number of star's corners.
                        rotate_degrees (float): Optional degree amount to rotate star clockwise.
            
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Possible values are:
                        * `D`: draw border. This is the default value.
                        * `F`: fill.
                        * `DF` or `FD`: draw and fill.
                    rrr'rT)rr
            N)rrrrrrr)
            rr7rrrrrr
            thrrcorner_xcorner_ys
                         r&starz	FPDF.star}s:\.
            )
            )02
            q7Q;!+,,	.	.AQUaZZEETTXb\\IIHQUaZZEETTXb\\IIHx2333$,sW}---BB
            
            j$e
            <<<<.deg_to_radrr%rc|dz}tjtj|ztj|z}|dkr|dtjzz
            }|Srrrs  r&rz FPDF.arc..angle_to_params_Jus{++E*TXe__q0$(5//A2EFFCQwwq47{"Jr%rctj|z}tj|z}|zz|zz
            |zz|zzgSrVr)	rrrrr>	cos_thetarr	sin_thetas	   r&rzFPDF.arc..evaluatesaDHSMM)IDHSMM)IY**Y-BBY**Y-BB
            r%ctj|z}tj|z}|z|zz
            |z|zzgSrVr)rrrrr>r*r+s   r&rz%FPDF.arc..derivative_evaluates[DHSMM)IDHSMM)I
            Y&Y)>>
            Y&Y)>>
            r%rrrrr'rrrrrrz l )rUrIrrrrrrrrrrrrrrrrr)%rr7rrrrr>r"r#r$r%r
            rthetarrrrstart_pointrrrrrrrrrrrrendr*rrrr+s%   `  `                         @@@@@r&arczFPDF.arcsH.3->"5)))KM9A	Q	Q
            U
            U	'E	'e	'	'	'	'	%	E								
            ;''HUOO	HUOO		%	DK												U	tE{									#N;//	 .++	%W	11q47{"GG
            	%7i//TW$Ihy))	IIdfIIIDFRK46+AIIIIJJJIIq>DF*[[[$&;q>2ITV1S[[[[
            
            
            
            
            IIq>DF*[[[$&;q>2ITV1S[[[[
            
            
            
            
            	#g	&9":":a$'kJ>V"WXX
            
            9$)49QTXeai5H5HA5M1M-M#N#NQR#RSVWW
            Xd^^&&t,,q		ABHEMD$B**400H!!uux{'::BqEEHUVKDW&?STCU:UY]Y_9_fNN!utv~MNN-1Vbe^tv,EMNNNPST
            
            
            
            	 
            		/u~//00000		DF{XXX$&2+)?XXXXX			r%c
            
            D|||||||||dd|	dS)a
                    Outputs a solid arc. A solid arc combines an arc and a triangle to form a pie slice
                    It can be drawn (border only), filled (with no border) or both.
            
                    Args:
                        x (float): Abscissa of upper-left bounding box.
                        y (float): Ordinate of upper-left bounding box.
                        a (float): Semi-major axis.
                        b (float): Semi-minor axis, if None, equals to a (default: None).
                        start_angle (float): Start angle of the arc (in degrees).
                        end_angle (float): End angle of the arc (in degrees).
                        inclination (float): Inclination of the arc in respect of the x-axis (default: 0).
                        clockwise (bool): Way of drawing the arc (True: clockwise, False: counterclockwise) (default: False).
                        style (str): Style of rendering. Possible values are:
            
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    TN)r0)
            rr7rrrrr>r"r#r
            s
                      r&	solid_arczFPDF.solid_arc:	sE>	
            
            
            
            
            	
            	
            	
            	
            	
            r%closedc	|t|}|dvrtd|tj|ntj}|5}|d}|d|d}}t
            ||}	||	|d}
            |
            d|
            d}}|d}
            |
            d|
            d}}|dkr|d}|d|d}}t
            ||}tj	}|j
            r|js
            tj}n|jr|j
            stj
            }||j_||j_|dkr|||||||n |dkr|||||||||ddddS#1swxYwYdS)	u
                    Outputs a quadratic or cubic Bézier curve, defined by three or four coordinates.
            
                    Args:
                        point_list (list of tuples): List of Abscissa and Ordinate of
                                                    segments that should be drawn. Should be
                                                    three or four tuples. The first and last
                                                    points are the start and end point. The
                                                    middle point(s) are the control point(s).
                        closed (bool): True to draw the curve as a closed path, False (default)
                                                    for it to be drawn as an open path.
                        style (fpdf.enums.RenderStyle, str): Optional style of rendering. Allowed values are:
                        * `D` or None: draw border. This is the default value.
                        * `F`: fill
                        * `DF` or `FD`: draw and fill
                    rrzWpoint_list should contain 3 tuples for a quadratic curve or 4 tuples for a cubic curve.Nrr'rrr)rrrUrIrrfr8r{rSSTROKE_FILL_NONZEROis_drawis_fillSTROKEFILL_NONZEROr
            ry
            auto_closecurve_to)rrr3r
            rr|rrr
            dummy_pathrrrp3x3y3p4x4y4r}rules                     r&bezierzFPDF.bezierg	s+,Z2
            .3->"5)))KM
            
            !
            !
            #
            #)	 tABUBqEB$R,,JMM*%%%ABUBqEBABUBqEB{{]A1Br2&&D!4D}
            2U]
            2$+
            2u}
            2$1$(DJ!$*DJ!{{
            
            
            1
            
            b"b"b"555MM$S)	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 )	 sEF11F58F5)uniz2.5.1)
            unicode_range
            variationspalettecollection_font_numberr fnamerGrHrIrJc
            |stdtt|d}|dvrtd|dt	dt
            fD] }	|	|zr|	|z}
            n!td|||
            j}d}|t|}d	
            t|}td
            |Drtd||t|tst!dt#d
            |Dr8|D]!\}}
            ||||||
            ||"dS||}||jvs	|t*vr(t-jd|dt1dSt3||
            ||||||}||j|<|jr|jr|ddSdSdS)a!
                    Imports a TrueType or OpenType font and makes it available
                    for later calls to the `FPDF.set_font()` method.
            
                    You will find more information on the "Unicode" documentation page.
            
                    Args:
                        family (str): optional name of the font family. Used as a reference for `FPDF.set_font()`.
                            If not provided, use the base name of the `fname` font path, without extension.
                        style (str): font style. "" for regular, include 'B' for bold, and/or 'I' for italic.
                        fname (str): font file name. You can specify a relative or full path.
                            If the file is not found, it will be searched in `FPDF_FONT_DIR`.
                        unicode_range (Optional[Union[str, int, tuple, list]]): subset of Unicode codepoints to embed.
                            Accepts CSS-style strings (e.g. "U+1F600-1F64F, U+2600"), integers, tuples, or lists.
                            Defaults to None, which embeds the full cmap.
                        variations (dict[style, dict]): maps style to limits of axes for the variable font.
                        palette (int): optional palette index for color fonts (COLR/CPAL). Defaults to 0 (first palette).
                            Only applicable to fonts with CPAL table (color fonts).
                        collection_font_number (int): face index for TTC/OTC collections.
                    z"fname" parameter is requiredr')z.otbz.otfz.otcz.ttfz.ttcz.woffz.woff2z!Unsupported font file extension: z. add_font() used to accept .pkl file as input, but for security reasons this feature is deprecated since v2.5.1 and has been removed in v2.5.3..zTTF Font file not found: Nrc3K|]}|dvV	dSBINr$rMrs  r&rOz FPDF.add_font..	s'66fvT!666666r%z9Unknown style provided (only B & I letters are allowed): z.Variations, if specified, must be a dictionaryc3rK|]2\}}|dvot|tV3dS))rBIrPN)rrr-)rMkeyrs   r&rOz FPDF.add_font..	sWC		33O
            5$8O8Or%)r r
            rKrGrHrIrJz!Core font or font already added 'z': doing nothingrrx)rrrrr	rexistsFileNotFoundErrorstemrrsortedranyrr-rallitemsadd_fontrYrarrr3rfis_cffis_cid_keyedrM)rr r
            rKrGrHrIrJextparentfont_file_pathparsed_unicode_range	var_style	axes_dictfontkeyfont_objs                r&r]z
            FPDF.add_font	s@	><===s5zz""1%++--QQQ[C[[[
            Cyy-0	I	IF&&((
            !'%
            $$G$G$GHHH>#(F#$#;M#J#J u{{}}--..6666666	SESS
            
            !j$//
            R PQQQ","2"2"4"4
            -7,<,<,>,>		(IyMM%'#&3#, '/E"\\^^,U,,dj  Gz$9$9MMGMMM*,,
            
            
            
            
            F "	
            	
            '
            7?	-x4	-%%e,,,,,	-	-	-	-r%r!c|s|j}|}t|tr|j}dt
            |}td|Drtd|d|vrd|_
            |dd}nd|_
            d|vrd|_|dd}nd|_||j
            vrT||z|jvrHtjd|d	|j
            |d
            t"t%|j
            |}n.|dvr*|r(tjd
            |dt%d}|s|j}|j|kr'|j|krt+j|j|rdS||z}||jvr~|t.vrt1d|d|jr-|jjdkrt7d|jjdt;t=|jdz|||j|<||_||_||_|j||_d|_ dS)a;
                    Sets the font used to print character strings.
                    It is mandatory to call this method at least once before printing text.
            
                    Default encoding is not specified, but all text writing methods accept only
                    unicode for external fonts and one byte encoding for standard.
            
                    Standard fonts use `Latin-1` encoding by default, but Windows
                    encoding `cp1252` (Western Europe) can be used with
                    `self.core_fonts_encoding = encoding`.
            
                    The font specified is retained from page to page.
                    The method can be called before the first page is created.
            
                    Args:
                        family (str): name of a font added with `FPDF.add_font`,
                            or name of one of the 14 standard "PostScript" fonts:
                            Courier (fixed-width), Helvetica (sans serif), Times (serif),
                            Symbol (symbolic) or ZapfDingbats (symbolic)
                            If an empty string is provided, the current family is retained.
                        style (str, fpdf.enums.TextEmphasis): empty string (by default) or a combination
                            of one or several letters among B (bold), I (italic), S (strikethrough) and U (underline).
                            Bold and italic styles do not apply to Symbol and ZapfDingbats fonts.
                        size (float): in points. The default value is the current size.
                    rc3K|]}|dvV	dS)BISUNr$rQs  r&rOz FPDF.set_font..D
            s'88vV#888888r%z;Unknown style provided (only B/I/S/U letters are allowed): roTFrnzSubstituting font z by core font z< - This is deprecated since v2.7.8, and will soon be removedr)symbolzapfdingbatszBuilt-in font z6 only has a single 'style' and can't be bold or italicNzUndefined font: z3 - Use built-in fonts or FPDF.add_font() beforehandrz@Usage of base fonts is now allowed for documents compliant with z%. Use add_font() to embed a font filer')!rrrrWr
            rrYrrZrrreplacer rrYrrrr3r!rrequalrar]rJrKr`rarbrr$r%)rr r
            r!rfs     r&rz
            FPDF.set_font
            s>	&%Fe\**	 KEu{{}}--..88%88888	UeUU
            %<<!DNMM#r**EE"DN%<+K+KMOVOO4;LV;TOOO"*,,	
            
            
            
            &v.FF
            1
            1
            1e
            1M....*,,
            
            
            
            
            E	%$D
            &&5(($T%6==)
            F5.$*$$j((#HwHHH
            
            D$4$<$F$F)UW[WgWmUUU#+3tz??Q+>"O"ODJw"  Jw/+0(((r%cZtj|j|rdS||_d|_dS)zp
                    Configure the font size in points
            
                    Args:
                        size (float): font size in points
                    NF)rrnr!r%)rr!s  r&
            set_font_sizezFPDF.set_font_size
            s7 1488	F +0(((r%r!wrap_in_text_objectcd|jd|dd}|rd|d}|jtj|j|jd|_|S)z
                    Set font and size for current page.
                    This step is needed before adding text into page and not needed in set_font and set_font_size.
                    /Frr TfBT  ETT)rrPrjrTFONTrr%)rrr!rqsls     r&_set_font_for_pagezFPDF._set_font_for_page
            se1$&
            0
            0<
            0
            0
            0
            0	rB""?#7KKK+/(	r%spacingc||j|krdS||_|jdkr|d|dddSdS)a\
                    Sets horizontal character spacing.
                    A positive value increases the space between characters, a negative value
                    reduces it (which may result in glyph overlap).
                    By default, no spacing is set (which is equivalent to a value of 0).
            
                    Args:
                        spacing (float): horizontal spacing in document units
                    Nrrurz Tc ET)r#rr)rrzs  r&rzFPDF.set_char_spacing
            sX''F#9q==II/G////00000=r%r&c||j|krdS||_|jdkr|d|dddSdS)z
                    Sets horizontal font stretching.
                    By default, no stretching is set (which is equivalent to a value of 100).
            
                    Args:
                        stretching (float): horizontal stretching (scaling) in percents.
                    Nrrurz Tz ET)r"rr)rr&s  r&rzFPDF.set_stretching
            sX:--F)9q==II2J222233333=r%fallback_fontsexact_matchc(g}|D]~}d}|jD]]}|dddd|kr||vr||d}^|st	d|d||_||_dS)	a;
                    Allows you to specify a list of fonts to be used if any character is not available on the font currently set.
                    Detailed documentation: https://py-pdf.github.io/fpdf2/Unicode.html#fallback-fonts
            
                    Args:
                        fallback_fonts: sequence of fallback font IDs
                        exact_match (bool): when a glyph cannot be rendered uing the current font,
                            fpdf2 will look for a fallback font matching the current character emphasis (bold/italics).
                            If it does not find such matching font, and `exact_match` is True, no fallback font will be used.
                            If it does not find such matching font, and `exact_match` is False, a fallback font will still be used.
                            To get even more control over this logic, you can also override `FPDF.get_fallback_font()`
                    FrSrrTTzUndefined fallback font: z! - Use FPDF.add_font() beforehandN)rYrmrrr]rFrG)rr}r~fallback_font_ids
            fallback_fontfoundrfs       r&set_fallback_fontszFPDF.set_fallback_fonts
            s(*+		ME:
            !
            !??3++33C<<
            @S@S@U@UUU&777)00999 E
            #`
            ```
            #4*5'''r%nullrnamect|dkr|jn||j||jzz
            ||jz|}|/|r|rtd||j|<t|jdz}||j|<|S)a
                    Creates a new internal link and returns its identifier.
                    An internal link is a clickable area which directs to another place within the document.
            
                    The identifier can then be passed to the `FPDF.cell()`, `FPDF.write()`, `FPDF.image()`
                    or `FPDF.link()` methods.
            
                    If a name is provided, creates a named destination that can be referenced later.
                    Named destinations are more stable than plain links when pages are added or removed.
            
                    Args:
                        y (float): optional ordinate of target position.
                            The default value is 0 (top of page).
                        x (float): optional abscissa of target position.
                            The default value is 0 (top of page).
                        page (int): optional number of target page.
                            -1 indicates the current page, which is the default value.
                        zoom (float): optional new zoom level after following the link.
                            Currently ignored by Sumatra PDF Reader, but observed by Adobe Acrobat reader.
                        name (str, optional): Name for the destination. If provided, creates a named
                            destination in the PDF that can be referenced from other parts of the document
                            or from external documents.
                    rrrrNz.Destination name cannot be empty or whitespacer')	rrrrisspacerrrr)rrr7rrrlink
            link_indexs        r&add_linkz
            FPDF.add_link
            s@DII	AJ&TV	
            
            
            
            S4<<>>
            S !QRRR,0D#D)__q(
            !%
            :r%cj||jvr&td|j|jz|j|<d|S)as
                    Retrieves a named destination by its name and creates a link to it.
            
                    Args:
                        name (str): The name of the destination to retrieve.
            
                    Returns:
                        str: A string with format "#name" that can be used with cell(), write(), image(), or link()
            
                    Raises:
                        KeyError: If no destination exists with the given name
                    rr#)rrrr)rrs  r&get_named_destinationzFPDF.get_named_destinationsEt...-;1$)dfBT,U,U,UD#D)4zzr%rcV|rF|Dt|dkr|jn||j||jzz
            ||jz|}||j|<|S|J|j|}|dkr|jn||_|j||jzz
            |_||jz|_||_	|r||j|<|S|S)a
                    Defines the page and position a link points to.
            
                    Args:
                        link (int, optional): a link identifier returned by `FPDF.add_link()`.
                            If None and name is provided, will create or update a named destination.
                        y (float): optional ordinate of target position.
                            The default value is 0 (top of page).
                        x (float): optional abscissa of target position.
                            The default value is 0 (top of page).
                        page (int): optional number of target page.
                            -1 indicates the current page, which is the default value.
                        zoom (float): optional new zoom level after following the link.
                            Currently ignored by Sumatra PDF Reader, but observed by Adobe Acrobat reader.
                        name (str, optional): Name for the destination. If provided, creates or updates a named
                            destination in the PDF that can be referenced from other parts of the document
                            or from external documents.
                    Nrr)
            rrrrrrpage_numberrrr)	rrrr7rrrdestdestinations	         r&set_linkz
            FPDF.set_link's8	DL!!RZZ		TIDF
            *Z	D-1D#D)Kj&/3rzz$))t)a$&j0tv:	,7D#D)Kr%alt_textc
            d}d}	|rt|trp|drK|dd}
            |
            |jvr&t	d|j|jz|j|
            <t|
            d}	nct|}nS||j	vs#Jd|d	t|j	d
            |j	|}	|	jstd|dt	d||jz|j||jzz
            ||jz||jz||	d|}|j|j|||d||S)as
                    Puts a link annotation on a rectangular area of the page.
                    Text or image links are generally put via `FPDF.cell`,
                    `FPDF.write` or `FPDF.image`,
                    but this method can be useful for instance to define a clickable area inside an image.
            
                    Args:
                        x (float): horizontal position (from the left) to the left side of the link rectangle
                        y (float): vertical position (from the top) to the bottom side of the link rectangle
                        w (float): width of the link rectangle
                        h (float): height of the link rectangle
                        link: can be one of the following:
                            - a URL string to create an external link
                            - an integer returned by `FPDF.add_link`, defining an internal link to a page
                            - a named destination string prefixed with '#' (e.g., '#chapter1')
                        alt_text (str): optional textual description of the link, for accessibility purposes
                        border_width (int): thickness of an optional black border surrounding the link.
                            Not all PDF readers honor this: Acrobat renders it but not Sumatra.
                    Nrr'rrT)encryptzLink with an invalid index: z
             (doc #links=)zCannot insert link z with no page number assignedLink)r7rrTheightactionrz/Link)struct_typer)r)rr
            startswithrrrrrr*rrrrr,rradd_annotation_add_marked_content)rr7rrrrrrrr	dest_name
            link_annots            r&rz	FPDF.linkcs:'+59	$$$
            ??3''
            - $QRRI!(???=K49tv#5>>>/	:%Y===DD't__FFDJ&&&W$WWS__WWW'&&z$''$QdQQQ$	
            $&ji!df*$df*tv:	
            	
            	
            	
            
            	
            49,,Z888
            $$8$LLLr%	file_pathbytesbasenamemodification_date	mime_typeassociated_file_relationshipc	8|r|rtd|rtdt|}|d5}|}dddn#1swxYwY|j}|}	|+t
            j|	j	}n"|std|std|tj|dpd}|}|tj|nd}
            td	|jD}||vrt|d
            |jr|jjdkr|jjdkrt)d
            |jj|jjdks|jjdkr||jjp|dks'|dr't0d|jj|nt)|jjd|jjdvr|
            tj}
            t7d|||||
            d|}|j||d|S)az
                    Embed a file into the PDF as an attachment (and, for PDF/A-3 or PDF/A-4f, as an
                    Associated File).
            
                    Args:
                        file_path (str or Path): filesystem path to the existing file to embed
                        bytes (bytes): optional, as an alternative to file_path, bytes content of the file to embed
                        basename (str): optional, required if bytes is provided, file base name
                        creation_date (datetime): date and time when the file was created
                        modification_date (datetime): date and time when the file was last modified
                        desc (str): optional description of the file
                        mime_type: MIME type of the embedded content (e.g., "application/pdf", "text/csv", "image/png")
                        associated_file_relationship: For PDF/A-3/A-4f, the AF relationship to declare in the FileSpec
                            (e.g., "Data", "Source", "Alternative", "Supplement", or "Unspecified").
            
                        **kwargs:
                        desc (str): Optional human-readable description for the FileSpec.
                        creation_date (datetime): Original creation time of the file.
                        compress (bool): enabled zlib compression of the file - False by default
                        checksum (bool): insert a MD5 checksum of the file content - False by default
            
                    Returns: a PDFEmbeddedFile instance, with a .basename string attribute representing the internal file name
                    z+'bytes' cannot be provided with 'file_path'z.'basename' cannot be provided with 'file_path'rbNz2'bytes' is required if 'file_path' is not providedz5'basename' is required if 'file_path' is not providedrzapplication/octet-streamc3>K|]}|VdSrV)r)rMfiles  r&rOz"FPDF.embed_file..s;)
            )
             $DMMOO)
            )
            )
            )
            )
            )
            r%z' has already been embedded in this filerr'z$J$J$U$U$W$W!
            W !UVVV
             K!,X66q9W=WIOO%%	,7
            '-.JKKK	
            &))
            )
            (,(;)
            )
            )
            &
            &
            "111QQQRRR	M 0 8F B B$)))kSWScSikk$)) %**t/?/K/S!222x~~7G7G7P7P882NN_(. .+1uuu$.."*&@&LO'
            /+
            
            
            
            
            
            	
            ""=111!!%(((s	A**A.1A.flagscd|j|fi|}	|	dtd||jz|j||jzz
            ||jz||jz|	|rt
            j|nd|}
            |j|j	
            |
            |
            S)a5
                    Puts a file attachment annotation on a rectangular area of the page.
            
                    Args:
                        file_path (str or Path): filesystem path to the existing file to embed
                        x (float): horizontal position (from the left) to the left side of the link rectangle
                        y (float): vertical position (from the top) to the bottom side of the link rectangle
                        w (float): optional width of the link rectangle
                        h (float): optional height of the link rectangle
                        name (fpdf.enums.FileAttachmentAnnotationName, str): optional icon that shall be used in displaying the annotation
                        flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
                        bytes (bytes): optional, as an alternative to file_path, bytes content of the file to embed
                        basename (str): optional, required if bytes is provided, file base name
                        creation_date (datetime): date and time when the file was created
                        modification_date (datetime): date and time when the file was last modified
                        desc (str): optional description of the file
                        compress (bool): enabled zlib compression of the file - False by default
                        checksum (bool): insert a MD5 checksum of the file content - False by default
                    FFileAttachmentN)	file_specrr)rset_globally_enclosedr,rrrrLrIrrr)rrr7rrrrrrr
            annotations           r&file_attachment_annotationzFPDF.file_attachment_annotations>(	<BL-4T:::	
            	
            	
            
            	
            49,,Z888r%ctd||jz|j||jzz
            ||jz||jzf||rtj|ndd|}|j|j||S)u
                    Puts a text annotation on a rectangular area of the page.
            
                    Args:
                        x (float): horizontal position (from the left) to the left side of the link rectangle
                        y (float): vertical position (from the top) to the bottom side of the link rectangle
                        text (str): text to display
                        w (float): optional width of the link rectangle
                        h (float): optional height of the link rectangle
                        name (fpdf.enums.AnnotationName, str): optional icon that shall be used in displaying the annotation
                        flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
                        title (str): the text label that shall be displayed in the title bar of the annotation’s
                            pop-up window when open and active. This entry shall identify the user who added the annotation.
                    TextN)r0r)r,rrrFrIrrr)	rr7rrcrrrrrs	         r&text_annotationzFPDF.text_annotationDs2$
            JIDF
            "
            J
            J	
            04>&t,,,$	
            	
            	
            	
            
            	
            49,,Z888r%cf|jstd|js<|jJ|||j|j||j}||j}||j	}||
            |dd}|j|jJtd||j
            z|j||j
            zz
            ||j
            z||j
            zf|d|jd|jjd	|jd
            dd|}|j|j||S)
            a0
                    Puts a free text annotation on a rectangular area of the page.
            
                    Args:
                        text (str): text to display
                        x (float): optional horizontal position (from the left) to the left side of the link rectangle.
                            Default value: None, meaning the current abscissa is used
                        y (float): vertical position (from the top) to the bottom side of the link rectangle.
                            Default value: None, meaning the current ordinate is used
                        w (float): optional width of the link rectangle. Default value: None, meaning the length of text in user unit
                        h (float): optional height of the link rectangle. Default value: None, meaning an height equal
                            to the current font size
                        flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
                        color (tuple): a tuple of numbers in the range 0.0 to 1.0, representing a colour used for the annotation background
                        border_width (float): width of the annotation border
                    rINTFrFrGFreeText(z /Frrz Tf))r0default_appearance)rr]r%r$rryr!r7r	font_sizerSr'r,rrrrrrr)rrcr7rrrrrs        r&free_text_annotationzFPDF.free_text_annotationjso4	W UVVV/	U$000IId--d.?ARSSTTT9A9A9A9%%dte%LLA*t/@/L/LL#
            JIDF
            "
            J
            J	
            t4?#<#<#>#>tt4CTCVttY]Yjtttt	
            	
            	
            	
            
            	
            49,,Z888r%rcd}t|trd}t|||jz|j||jzz
            ||jz||jzfd|i|}|j|j||S)a
                    Puts an Action annotation on a rectangular area of the page.
            
                    Args:
                        action (fpdf.actions.Action): the action to add
                        x (float): horizontal position (from the left) to the left side of the link rectangle
                        y (float): vertical position (from the top) to the bottom side of the link rectangle
                        w (float): width of the link rectangle
                        h (float): height of the link rectangle
                    r(rr)rr)r,rrrrr)	rrr7rrrrannotation_action_typers	         r&
            add_actionzFPDF.add_actions"*fj))	,%+"#"
            JIDF
            "
            J
            J
            
            
            
            
            
            
            	
            49,,Z888r%	Highlightr'r'rrscolormodification_timec	+K|jrtdd|_dV|jD]\}}|j||f||||d|tt|_d|_dS)u/
                    Context manager that adds a single highlight annotation based on the text lines inserted
                    inside its indented block.
            
                    Args:
                        text (str): text of the annotation
                        title (str): the text label that shall be displayed in the title bar of the annotation’s
                            pop-up window when open and active. This entry shall identify the user who added the annotation.
                        type (fpdf.enums.TextMarkupType, str): "Highlight", "Underline", "Squiggly" or "StrikeOut".
                        color (tuple): a tuple of numbers in the range 0.0 to 1.0, representing a colour used for
                            the title bar of the annotation’s pop-up window. Defaults to yellow.
                        modification_time (datetime): date and time when the annotation was most recently modified
                    zhighlight() cannot be nestedTN)quad_pointsrrrF)rOr]rQr\add_text_markup_annotationrr)rrcrsrrrrrs        r&	highlightzFPDF.highlights,(	@ >???(,%
            !%!7!=!=!?!?				D++D+
            ("3
            
            
            
            
            
            
            "-T!2!2(-%%%r%c/Ktjdtt|j|i|5dVddddS#1swxYwYdS)Nz:add_highlight() has been renamed to highlight() in v2.5.5.r)rrrr3r)rrrs   r&
            add_highlightzFPDF.add_highlights
            H&((	
            	
            	
            	
            
            T^T
            ,V
            ,
            ,		EEE																		sA
            
            AArc|dtj|j}||j}||j}t
            |ddd}t
            |ddd}	t|ddd}
            t|ddd}t|f||	||
            |z
            ||	z
            |||d|}|j	|
            ||S)u
                    Adds a text markup annotation on some quadrilateral areas of the page.
            
                    Args:
                        type (fpdf.enums.TextMarkupType, str): "Highlight", "Underline", "Squiggly" or "StrikeOut"
                        text (str): text of the annotation
                        quad_points (tuple): array of 8 × n numbers specifying the coordinates of n quadrilaterals
                            in default user space that comprise the region in which the link should be activated.
                            The coordinates for each quadrilateral are given in the order: x1 y1 x2 y2 x3 y3 x4 y4
                            specifying the four vertices of the quadrilateral in counterclockwise order
                        title (str): the text label that shall be displayed in the title bar of the annotation’s
                            pop-up window when open and active. This entry shall identify the user who added the annotation.
                        color (tuple): a tuple of numbers in the range 0.0 to 1.0, representing a colour used for
                            the title bar of the annotation’s pop-up window. Defaults to yellow.
                        modification_time (datetime): date and time when the annotation was most recently modified
                        page (int): index of the page where this annotation is added
                    rxNrrr')r0r7rrTrrrr)rMrXrIrrDrrrlr,rr)
            rrsrcrrrrrx_miny_minx_maxy_maxrs
                         r&rzFPDF.add_text_markup_annotations8	
            !!%((($T**0$ $ 2<9DK1%&&K1%&&K1%&&K1%&&#
            %-5=/#
            
            
            
            
            	
            4''
            333r%coordsborder_widthctfd|Dd}t|ddd}t|ddd}t|ddd}	t|ddd}
            t	d	||
            |	|z
            |
            |z
            ||||d|}jj||S)
            u
                    Adds add an ink annotation on the page.
            
                    Args:
                        coords (tuple): an iterable of coordinates (pairs of numbers) defining a path
                        text (str): textual description
                        title (str): the text label that shall be displayed in the title bar of the annotation’s
                            pop-up window when open and active. This entry shall identify the user who added the annotation.
                        color (tuple): a tuple of numbers in the range 0.0 to 1.0, representing a colour used for
                            the title bar of the annotation’s pop-up window. Defaults to yellow.
                        border_width (float): thickness of the path stroke.
                    c3VK|]#\}}|jzj|z
            jzfV$dSrV)rr)rMr7rrs   r&rOz&FPDF.ink_annotation..8
            s?QQATVdfqjDF%:;QQQQQQr%r$rNrr'Ink)r7rrTrink_listr0rr)r)rQrrlr,rrr)rrrcrrrrrrrrrs`           r&ink_annotationzFPDF.ink_annotation#
            s*QQQQ&QQQSUVVHQTTN##HQTTN##HQTTN##HQTTN###
            %-5=%
            
            
            
            
            	
            49,,Z888r%c|jstd||}|jJ|js3|||j|jd||jzdd|j	|z
            |jzddg}|j
            tjkr'|
            d|j
            d|jdd|
            |j|d	|d
            kr|js|js|jr||dd
            }|d
            krb|jr*|
            |||||jr*|
            |||||jr'|j}|d|zz}|||||g}|j|jkrH|jJ|
            |j|r
            dg|z|zdgz}|d|dS)a
                    Prints a character string. The origin is on the left of the first character,
                    on the baseline. This method allows placing a string precisely on the page,
                    but it is usually easier to use the `FPDF.cell()`, `FPDF.multi_cell() or `FPDF.write()` methods.
            
                    Args:
                        x (float): abscissa of the origin
                        y (float): ordinate of the origin
                        text (str): string to print
                        txt (str): [**DEPRECATED since v2.7.6**] string to print
            
                    Notes
                    -----
            
                    `text()` lacks many of the features available in `FPDF.write()`,
                    `FPDF.cell()` and `FPDF.multi_cell()` like markdown and text shaping.
                    rINrurr Td Tr rrvrTFrg?qQ)rr]rPr$r%rryr!rrr1rYr0rr/encode_textrr rOrS
            _do_underline_do_strikethroughr_add_quad_pointsr)r+rrr)rr7rrcrxrrattr_ls        r&rcz	FPDF.textL
            s}(	W UVVV""4(( ,,,/	UIId--d.?ARSSTTTCAJCCCdfqjDF%:CCCC
            D>X]**IIE$.EEdoEEEEFFF
            		T&22488===>>>BJJDNJd.@J
            
            *
            %%dte%LLArzz>;IId00Aq99:::%?IId44Q1==>>>,
            2NS1W%%aAq111?do--?...MMT_6688>>@@BCCC	-"$u,B		#((2,,r%rctjdtt||j}||j}|jdkr|d||_|dkr|tj	dzz}tj
            |}tj|}||jz}|j
            |z
            |jz}d|dd	|dd	|dd	|dd	|d
            d	|d
            d|d
            d	|d
            d}||dSdS)
            zR
                    .. deprecated:: 2.1.0
                        Use `FPDF.rotation()` instead.
                    zrotate() can produces malformed PDFs and is deprecated since v2.1.0. It will be removed in a future release. Use the rotation() context manager instead.rNrrrq z.5Frz.2Fz cm 1 0 0 1 z cm)rrrr3r7rr
            rrrrrrr)	rrr7rcrErroutputs	         r&rotatezFPDF.rotate
            sm	
            >
            &((	
            	
            	
            	
            
            9A9A;!IIcNNNA::TWs]"EAATVB&1*&B2QK22QK22aRK22aK22bK22rK223122&(S1222
            
            IIf:r%c#K||j}||j}|tj|||5dVddddS#1swxYwYdS)a
                    Method to perform a rotation around a given center.
                    It must be used as a context-manager using `with`:
            
                        with rotation(angle=90, x=x, y=y):
                            pdf.something()
            
                    The rotation affects all elements which are printed inside the indented
                    context (with the exception of clickable areas).
            
                    Args:
                        angle (float): angle in degrees
                        x (float): abscissa of the center of the rotation
                        y (float): ordinate of the center of the rotation
            
                    Notes
                    -----
            
                    Only the rendering is altered. The `FPDF.get_x()` and `FPDF.get_y()` methods are
                    not affected, nor the automatic page break mechanism.
                    The rotation also establishes a local graphics state, so that any
                    graphics state settings changed within will not affect the operations
                    invoked after it has finished.
                    N)r7r	transformr?
            rotation_dabout)rrr7rs    r&rotationz
            FPDF.rotation
            s:
            9A9A
            ^^I0%88>>q!DD
            E
            E		EEE																		sA##A'*A'axayc	#Kd}||j}||j}ttt	j|tjdzz||}ttt	j|tjdzz||}|tj	||
            ||5dVddddS#1swxYwYdS)a
                    Method to perform a skew transformation originating from a given center.
                    It must be used as a context-manager using `with`:
            
                        with skew(ax=15, ay=15, x=x, y=y):
                            pdf.something()
            
                    The skew transformation affects all elements which are printed inside the indented
                    context (with the exception of clickable areas).
            
                    Args:
                        ax (float): angle of skew in the horizontal direction in degrees
                        ay (float): angle of skew in the vertical direction in degrees
                        x (float): abscissa of the center of the skew transformation
                        y (float): ordinate of the center of the skew transformation
                    lNr)r7rrlrrrrrr?shearingr)rrrr7rlim_vals      r&skewz	FPDF.skew
            s%29A9A
            TXbDGcM233W==x
            H
            H
            TXbDGcM233W==x
            H
            H
            ^^I.sRC88>>q!DD
            E
            E		EEE																		sC))C-0C-originc
            #RK|\}}	t|ttfr'ttj|j}nt|}n#t$rt|}YnwxYwtjtj	|dz}tj
            tj	|dz}|t||||dd
            ||5dVddddS#1swxYwYdS)a+
                    Method to perform a reflection transformation over a given mirror line.
                    It must be used as a context-manager using `with`:
            
                        with mirror(origin=(15,15), angle="SOUTH"):
                            pdf.something()
            
                    The mirror transformation affects all elements which are rendered inside the indented
                    context (with the exception of clickable areas).
            
                    Args:
                        origin (float, Sequence(float, float)): a point on the mirror line
                        angle: (fpdf.enums.Angle): the direction of the mirror line
                    rrN)rrrDrrIrrrrrrrr?r)rrrr7rr-rr>s        r&mirrorzFPDF.mirror
            s`&1	!%#u..
            %el511788e	!	!	!%LLEEE	!
            HT\%!),,--
            Xdl519--
            .
            ..
            ^^IaAr1a88>>q!DD
            E
            E		EEE																		s$AAA87A8
            DD #D rc#lK|5tj|j|jd|j}||z|z}|d\}}||dVddddS#1swxYwYdS)a
                    Apply a transformation matrix to the current graphics state.
                    This context manager isolates the transformation so it doesn't affect
                    rendering outside the 'with' block.
            
                    It automatically handles the conversion from FPDF's User Units (usually mm, top-left origin)
                    to PDF Device Units (points, bottom-left origin).
            
                    Args:
                        transform (fpdf.drawing_primitives.Transform): The transformation matrix to apply.
                    rN)	rfr?scalingr	translaterinverser`r)rruser_to_pdfadjusted_transformcommandrs      r&rzFPDF.transforms
            
            
            !
            !		#+DFTVG<<FFq$)TTK!,!4!4!6!6!B[!P+22488JGQIIgEEE
            																		sBB))B-0B-c+K|jrtd||jdi|dV||dS)a2
                    Creates a local graphics state, which won't affect the surrounding code.
                    This method must be used as a context manager using `with`:
            
                        with pdf.local_context():
                            set_some_state()
                            draw_some_stuff()
            
                    The affected settings are those controlled by GraphicsStateMixin and drawing.GraphicsStyle:
            
                    * allow_transparency
                    * auto_close
                    * blend_mode
                    * char_vpos
                    * char_spacing
                    * dash_pattern
                    * denom_lift
                    * denom_scale
                    * draw_color
                    * fill_color
                    * fill_opacity
                    * font_family
                    * font_size
                    * font_size_pt
                    * font_style
                    * font_stretching
                    * intersection_rule
                    * line_width
                    * nom_lift
                    * nom_scale
                    * paint_rule
                    * strikethrough
                    * stroke_cap_style
                    * stroke_join_style
                    * stroke_miter_limit
                    * stroke_opacity
                    * sub_lift
                    * sub_scale
                    * sup_lift
                    * sup_scale
                    * text_color
                    * text_mode
                    * text_shaping
                    * underline
            
                    Font size can be specified in document units with `font_size` or in points with `font_size_pt`.
            
                    Args:
                        **kwargs: key-values settings to set at the beginning of this context.
                    z@cannot create a local context inside an unbreakable() code blockNr$)rr]r*r+r-r.)rrs  r&rfzFPDF.local_context$sj	R
            	
               !!++F+++
            !!!r%rrr/r'r)r+r.c	d|	vr$|td|	d|jz}|	d=d}
            |	D]\}}|dvrtd|d|tjvr=|
            t}
            t|
            |||dkr|dg|d	vrt|||}td||
            rc|j|
            }
            |
            J|j	tj|
            |j|
            d
            |
            dn|
            d|||.||p|j||jn||p|j|||||||||||||t-|t.rU||d
            d|dd|dddS||d|d|ddSdS)z
                    This method starts a "q/Q" context in the page content stream,
                    and inserts operators in it to initialize all the PDF settings specified.
                    rNz0font_size & font_size_pt cannot be both provided)rtrvrurszUnsupported setting: zH - This can be controlled through dash_pattern / draw_color / line_width
            blend_moder)	char_vposr#r$
            denom_liftdenom_scaler"nom_lift	nom_scaler sub_lift	sub_scalesup_lift	sup_scaler1rrr%zq /z gsrrrrrr'r)rrr\r7MERGE_PROPERTIESsetattrrMrPregister_graphics_stylerjrTrrrrrrr!rVr@rrDrr-rr)rrrr!r/r'r)r+r.rrwrUrgs_names              r&r+zFPDF._start_local_contextcs$&  ' !STTT!+.7L{#
             ,,..%	@%	@JC!yCyyym444:&BC''',&&--e444&c5)))) !>!>!>???
            	,DDRHHG&&&"&&'BGTYWWWII(G((())))IIcNNN
            #%'MM/t/#-#5:1 1	
            
            
            !
            +++!
            +++!
            +++!
            +++#,--
            Y%% $$VQ// $$UA.. $$Wa00%%l1o|AUVXXXXX$#r%c0|ddS)zN
                    This method ends a "q/Q" context in the page content stream.
                    rN)rrXs r&r-zFPDF._end_local_contexts	
            		#r%c|jS)a
                    Whenever a page break condition is met, this `@property` method is called,
                    and the break is issued or not depending on the returned value.
            
                    The default implementation returns `self.auto_page_break`,
                    a value according to the mode selected by `FPDF.set_auto_page_break()`.
            
                    This method is called automatically and should not be called directly by the application.
            
                    Detailed documentation on page breaks: https://py-pdf.github.io/fpdf2/PageBreaks.html
                    )rrXs r&accept_page_breakzFPDF.accept_page_breaks
            ##r%borderrr'lnaligncenternew_xnew_yc
            >|jstdt|tst|trt	dt|t
            r(|dvr$t
            jdtd}tj
            |}tj
            |}tj
            |}|tj
            krt	d|dkr|d	krtj}tj}nQ|dkrtj}tj}n2|d
            krtj}tj}nt	d|dt
            jd
            |d|jd|jdt(t||}|jr|||
            n|||
            }
            ||jn|}|t7|
            d	d	|||d|||||||	|
            		S)a
            
                    Prints a cell (rectangular area) with optional borders, background color and
                    character string. The upper-left corner of the cell corresponds to the current
                    position. The text can be aligned or centered. After the call, the current
                    position moves to the selected `new_x`/`new_y` position. It is possible to put a link
                    on the text. A cell has an horizontal padding, on the left & right sides, defined by
                    the.c_margin property.
            
                    If automatic page breaking is enabled and the cell goes beyond the limit, a
                    page break is performed before outputting.
            
                    Args:
                        w (float): Cell width. Default value: None, meaning to fit text width.
                            If 0, the cell extends up to the right margin.
                        h (float): Cell height. Default value: None, meaning an height equal
                            to the current font size.
                        text (str): String to print. Default value: empty string.
                        border: Indicates if borders must be drawn around the cell.
                            The value can be either a number (`0`: no border ; `1`: frame)
                            or a string containing some or all of the following characters
                            (in any order):
                            `L`: left ; `T`: top ; `R`: right ; `B`: bottom. Default value: 0.
                        new_x (fpdf.enums.XPos, str): New current position in x after the call. Default: RIGHT
                        new_y (fpdf.enums.YPos, str): New current position in y after the call. Default: TOP
                        ln (int): **DEPRECATED since 2.5.1**: Use `new_x` and `new_y` instead.
                        align (fpdf.enums.Align, str): Set text alignment inside the cell.
                            Possible values are: `L` or empty string: left align (default value) ;
                            `C`: center; `X`: center around current x position; `R`: right align
                        fill (bool): Indicates if the cell background must be painted (`True`)
                            or transparent (`False`). Default value: False.
                        link (str): optional link to add on the cell, internal
                            (identifier returned by `FPDF.add_link`) or external URL.
                        center (bool): center the cell horizontally on the page.
                        markdown (bool): enable minimal markdown-like markup to render part
                            of text as bold / italics / strikethrough / underlined.
                            Supports `\` as escape character. Default to False.
                        txt (str): [**DEPRECATED since v2.7.6**] String to print. Default value: empty string.
            
                    Returns: a boolean indicating if page break was triggered
                    rIjParameter 'w' and 'h' must be numbers, not strings. You can omit them by passing string content with text=r!HInteger values for "border" parameter other than 1 are currently ignoredrr'zGcell() only produces one text line, justified alignment is not possiblerrr"Invalid value for parameter "ln" (z"), must be an int between 0 and 2.=The parameter "ln" is deprecated since v2.5.2. Instead of ln= use new_x=XPos.
            , new_y=YPos.rMNF
            text_widthnumber_of_spacesr#r	max_widthtrailing_nl)r%r&rrr$prevent_font_change)rr]rrrrrrr3r[rIr\rCJRIGHTTOPLMARGINNEXTLEFTrrrPrrR_preload_font_stylesr_render_styled_text_lineru)rrrrcr r"r#rrr$rGr%r&styled_txt_fragsline_heights               r&cellz	FPDF.cellsr	W UVVVa	As!3!3	J
            fc""	vV';';MZ*,,
            
            
            
            FE""E""U##EGY
            Qww
            q	q		 7777
            Ma&(aa:?*aaSXS]aaa#*,,
            
            
            
            
            ""4(( 
            ;D,,T8<<<**4::	
            )*	dnnq,, !""!
            
            
            
             (#-
            
            	
            r%	text_linepaddingr3cTt|tr)|dvr%tjdt	d}n9t|t
            r$t
            |drd}|	tdddd}	tdx}}|	j
            dkr|j}|	jdkr|j}|j
            }
            |
            s9t|jD]$\}}||dk}|
            |z
            }
            %|j}||jst%d	|
            |z|z}n|dkr|j|jz
            |jz
            }|r|j|j|z
            d
            zz|_n(|jt2jkr|xj|d
            zzc_d}|}|D]#}t9j|j|r|j}$||}||}g}|j }|j|	j
            z
            |z}|j|z|	jz|z}|j!|j"z
            |	j#z|z}|j!|j"|zz
            |	j$z
            |z}|r8|dkrdnd}|%|d
            d|d
            d||z
            d
            d||z
            d
            d|	n1|dkr+|%|d
            d|d
            d||z
            d
            d||z
            d
            dt|t
            rd|vr%|%|d
            d|d
            d|d
            d|d
            dd|vr%|%|d
            d|d
            d|d
            d|d
            dd|vr%|%|d
            d|d
            d|d
            d|d
            dd|vr%|%|d
            d|d
            d|d
            d|d
            d|j&r"|'|j|j"|||j}d}dx}}d} tPj)}!|j*}"|j+}#|j,}$|j-}%|j.}&|j/}'d}(|j0})|r|jt2j1kr	||z
            |
            z
            }*n*|jt2j2t2jfvr	||
            z
            d
            z}*n|}*||*z
            }d}+|jt2j3kr|j4r||z
            |z
            |
            z
            |j4z}+|%d|j|*z|zd
            d|j!|j"z
            d|zz
            d|zz
            |zd
            dg},g}-t|D]\}}t|tjr%|j6|j78||j9|)krF|j9})|)J|%|):;d}(|+r|j.dkr|+dz|j.z}n|+}|&|j.kr%|j.}&|%|j.d
            d|'|j/kr%|j/}'|%|j/d
            d|j<s|
            ro|j=}"|j+}#|j,}$|%d |"j>d|#d
            d!|j?@tjB|"j>|j7|jC}!n|j=x}"|_*|j+x}#|_+|j,x}$|_,|D|E|"|#|jC}!ns|"|j=ks!|#|j+ks|$|j,ks|!|jCkrG|j=}"|j+}#|j,}$|%|E|"|#d"|jC}!|jF}.|.| kr|%|.d
            d#|.} |j-tjHks|j-|%kr-|j-}%|%|j-d$|jId
            d%|J|||+|j|*z|z|j"d|zd|zzz|j!}/|/r|%|/||dk|+|jKLdzz}0|jMr.|,%|j|*z|z|0|j=|jf|jNr.|-%|j|*z|z|0|j=|jf|jOrE|O|j|*z|z|j"d|zzd|jzz
            |0|j|jO&|jPs|}||0z
            }|%d'|,rF|,D]C\}1}2}3}4|%|Q|1|j"d|zzd|4zz|2|3D|-rF|-D]C\}1}2}3}4|%|R|1|j"d|zzd|4zz|2|3D|r<|O|j|*z|j"d|zzd|jzz
            |
            |j||r|dksZ| dksT|!tPj)ksD|"|j*ks9|#|j+ks.|$|j,ks#|%|j-ks|(s|&|j.ks|'|j/krd(dS|d)}5ndS|}5|D|5|p|j|_T|tjVkr|xj|z
            c_n|tjWkr||_n|tjXkr||z|_n|tjYkr|r||z|z
            |_ng||_n_|tjZkr||d*zz|_nA|tj[kr
            |j|_n$|tj\kr|j|jz
            |_|tj^kr|xj"|z
            c_"|tj_kr|j`|_"|tjakr|j!|jbz
            |_"|S)+a
                    Prints a cell (rectangular area) with optional borders, background color and
                    character string. The upper-left corner of the cell corresponds to the current
                    position. The text can be aligned, centered or justified. After the call, the
                    current position moves to the requested new position. It is possible to put a
                    link on the text.
            
                    If automatic page breaking is enabled and the cell goes beyond the limit, a
                    page break is performed before outputting.
            
                    Args:
                        text_line (TextLine instance): Contains the (possibly empty) tuple of
                            fragments to render.
                        h (float): Cell height. Default value: None, meaning an height equal
                            to the current font size.
                        border: Indicates if borders must be drawn around the cell.
                            The value can be either a number (`0`: no border ; `1`: frame)
                            or a string containing some or all of the following characters
                            (in any order):
                            `L`: left ; `T`: top ; `R`: right ; `B`: bottom. Default value: 0.
                        new_x (fpdf.enums.XPos): New current position in x after the call.
                        new_y (fpdf.enums.YPos): New current position in y after the call.
                        fill (bool): Indicates if the cell background must be painted (`True`)
                            or transparent (`False`). Default value: False.
                        link (str): optional link to add on the cell, internal
                            (identifier returned by `FPDF.add_link`) or external URL.
                        center (bool): center the cell horizontally on the page.
                        padding (Padding or None): optional padding to apply to the cell content.
                            If padding for left and right is non-zero then c_margin is ignored.
                        prevent_font_change (bool): ensure no font settings (family / size / style)
                            change during this call.
            
                    Returns: a boolean indicating if page break was triggered
                    r!r)rr'LTRBNr)
            initial_cszA'text_line' must have fragments if 'text_line.text_width' is NonerrSfrrrz re SLrrTrgFrug?g333333?rTrz Tzz Tcrsrt)rqz Tsrr)r7rrrrETrz Qg@)crrrrr3rr
            issupersetrrrr;rr/	enumerate	fragmentsrKr1rrrr7r8rr#rCXget_ordered_fragmentsrgreater_thanr_perform_page_break_if_need_berrrrbottomrrOrrHLINEr$r!rr1r"r#r)rCr4r0rvrradd_text_substitutionr+rrr%rrrPrjrTrwrrryliftrYr0r/render_pdf_text
            characterscountrr rrtrrrrr[r5STARTENDWCONTCENTERr7RMARGINr\r8TMARGINr9BMARGINr)6rr?rr r%r&rrr$r@r3
            l_c_margin
            r_c_marginstyled_txt_widthrrNunscaled_widthr
            max_font_sizerJpage_break_triggeredrxrrrrrOops_starts_width
            current_wsfrag_wscurrent_liftcurrent_char_vposr$current_font_size_ptcurrent_font_stylecurrent_text_modecurrent_font_stretchingcurrent_char_spacingfill_color_changedlast_used_colordxword_spacing
            underlinesstrikethroughsrSr_text
            frag_widthstart_xrTrrrEs6                                                      r&r;zFPDF._render_styled_text_lineasY^fc""	vV';';MZ*,,
            
            
            
            FF
            
            $
            $	V)?)?)G)G	F?aAq))G"'((*
            Z<1J=AJ$/	3$Y%899
            3
            34!%16!B!B N2  9&
             W!:-
            :AA
            !VV&/A	]dhla%77DFF
            _
            '
            'FFa!eOFF 
            3355		/	/D*4>=II
            / $
            9A#BB1EEF%*!gm+q0v,1&DFQJ''.8A=	V!BIIWWWCWWWeDjWWWvczWWWSUWWXXXX
            q[[IITTTCTTTeDjTTTvczTTTTUUUfc""	Uf}}		TOOOOOODOOOvOOOOPPPf}}		TMMMMMMEMMMMMMMNNNf}}		UQQQQQQUQQQQQQQRRRf}}		TSSSSSSuSSS6SSSSTTT(	8!!$&$&!Q777&""
            W$M(#0!_ N"&"6#0"/_	%'))^&66UWeg$666**a/rMG"#L%'))i.H)
            NZ/2BB. /
            IIRtv{a'.RRFTVOcAg-m0CCqHQRRR
            
            
            PRJSUN$Y//l
            &l
            &4d$BCCFJty)??EEE?o55&*oO*666IIo7799??AABBB)-&+D$8C$?$?*S043GGGG*G*d.BBB.2.B+II!5>>>>???'4+<<<+/+<(II!2;;;;<<<7+7*;'+y/3/@,-1_*		"U|~"U"U8L"U"U"U"UVVV.22+0,.$)-1N))<@9Dt'8CGCTT,t/@?CN*T_		 33 , 4-1N)) DI--+t/@@@)T_<<(DN::$(9L+/+<()-&II//(0050)-%y<''II....///#'LNhm33~):::(,%IILLT_LLLLMMM-- FRK')FcAgm(;;<F
            &IIf%%%!^^ Av, 4?#8#8#=#==>
            >%%"w.
            DIt~V%"))"w.
            DIt~V9II&2+/&C!G,dn0DE$.!Y')!(J:%IIdOOO
            7A3GUD)II**#TVsQw%73?%KUTX
            
            7E3GUD)II..#TVsQw%73?%KUTX
            
            		FRKFQw .)%N	
            c!!3&&$
            554#444'4+<<<%88$66%7*d.BBB'4+<<<)")))HHRLLIIaLLL)4>DJFFaKFFF
            dj
             
             DFF
            dh
            
            w&DFF
            dj
             
             
            ! 7*Z7 
            dk
            !
            !w},DFF
            dl
            "
            "]DFF
            dl
            "
            "Vdm+DFDIFFaKFFDL  ]DFDL  Vdm+DF##r%c8|j|j||jz|j|z
            |jz||z|jz|j|z
            |jz||jz|j|z
            |z
            |jz||z|jz|j|z
            |z
            |jzgdSrV)rQrextendrrrr7rrrs     r&rzFPDF._add_quad_pointssty)00DF
            !tv%Q$& !tv%DF
            !a46)Q$& !a46)	
            	
            	
            	
            	
            	
            r%cn|js|||S|jdr
            |jdnt|}t||}|}|j|jd<g}|D](\}}||jd<||||z
            })t
            |S)zh "
                    Break the text into bidirectional segments and preload font styles for each fragment
                    r)rcbase_directionrr)rr:r0r/get_bidi_fragmentsr}r)	rrcrGr	paragraphdirectional_segmentsrJ	bidi_textbidi_directions	         r&rRz FPDF._preload_bidirectional_texts 	=,,T8<<< -
            2Dk**+D11	"t.)GGd4?c)GGGGGGr%rSrc3,K|]}|jdkVdS)rTNrrLs  r&rOz,FPDF._preload_font_styles..rr%rTc3,K|]}|jdkVdSrOrrLs  r&rOz,FPDF._preload_font_styles..s)HHt4?d*HHHHHHr%rPc3,K|]}|jdkVdS)rNrrLs  r&rOz,FPDF._preload_font_styles..
            s)FFT4?b(FFFFFFr%r)rrrr _parse_charsrrZrrYrr)rrcrGprev_font_styler<rrNs       r&r:zFPDF._preload_font_styless	77N/>	#s"O	#s"O !2!24!B!BCC	9DDIGG6FGGGGG
            )
            
            C
            (((GG6FGGGGG
            )
            
            C
            (((HH7GHHHHH
            *
            
            D
            )))FF5EFFFFF
            (
            
            B
            '''(
            K
            K Jt'7$/'IJ		MMM000DIr%charctj|fdjD}|sdStfd|Dd}|r|SjrdS|dS)z
                    Returns which fallback font has the requested glyph.
                    This method can be overridden to provide more control than the `select_mode` parameter
                    of `FPDF.set_fallback_fonts()` provides.
                    cVg|]%}tj|jv#|&Sr$)ordrYcmap)rMfont_idrrs  r&
            z*FPDF.get_fallback_font..s>
            
            
            4yyDJw/444
            444r%Nc3HK|]}j|jk|VdSrV)rYrp)rMrrprs  r&rOz)FPDF.get_fallback_font..#s7WWdD1A1Jh1V1VT1V1V1V1VWWr%r)rWrIrFnextrG)rrr
            fonts_with_charfont_with_matching_emphasisrps``   @r&get_fallback_fontzFPDF.get_fallback_fonts &u--
            
            
            
            
            2
            
            
            
            	4&*WWWWWoWWW'
            '
            #'	/..*	4q!!r%c	#K|sщjsʉjsÉjrt|jD]f\}}|dkr/tjjV|r*t|jVgdSt|jVdSgdj	vdj	vtjtjdddtffd}j
            r
            jj}ng}d}d}|r{|r!|djkr|dz
            }|dd}&|r|r|ddjjjjfv}	|	rO|dzdkrFt+|dz
            D]}
            jrr|Vdd}d}t+|D]}
            jd}|ddjjjjfv}|r|rd	}|d}t/|d}
            |
            t0jt0jfvrrr|V|
            jr|dt7jjkr}r|V}rdnd
            rdnd
            z|_	|_|_tj|jV|t7jd}|r|rrd|krt7|dks|d|krrr|V|ddjkr|ddjkr|ddjkr|ddjkr|dd}j|}|r|\}}}r|V}j|_j rtCj |_"	tG|}$|
            }n#tJ$rYnwxYwttM||j|Vpj
            r|ddkrtO|d|vrrdnd
            rdnd
            z}(|d|}|rd|kr'|d|dd}r|V||d|dd})rr|Vd|d|dd}|r|r|dz}|dkr|V|{|r0|r.t+|D]}
            jd}r|VdSdS)zSplit text into fragmentsrNrSrTrc~
            }rdndrdndz|_|_	|_rmddD}dddd}||_||_
            j|_ddt|
            j
            }g|S)NrSrrTc3"K|]
            }|dv|VdSrOr$)rMrs  r&rOz2FPDF._parse_chars..frag..Ps&PPaA$KKKKKKPPr%)_get_current_graphics_staterr rrrmrrYr$rsr)gstater
            r fragmentcurrent_fallback_fontcurrent_text_scriptin_bold
            in_italicsin_strikethroughin_underlinertxt_frags    r&rNzFPDF._parse_chars..fragIs5577F(/!7R:> F
            %&)4+K+K+M+Mtv4!A!A!C!CTVLLLLLF t.$/1
            !%d&8!9!9!$.11 $"	h													,	+0KKK
            B	!
            DGt'EEEa
            ABBx
            J
            #'8-062	0$ $	
            Q!(;(;":>22HH (FGGGG,5#)"&$&&LLL04-)*&!"Jz**DDAOOD$BCCCC
            RaR),2.	%I
            ".
            "!	q'K,T!W55K$%##
            ! 3!$&&LLL&1#&
            6#d566674;RRR%"dff!==??F07)?R)1r)F%, >?D)
            %)1")D)DTQ$q'[*@*@%"dffBQBx4#<<<&-+BQBx4#???)3^
            BQBx4#EEE/?+?(BQBx4#AAA+7'78D288>>181A1A.Iy$%"dff!==??F'+'CF$/,C 4--)"9~~$(MMtM$<$<		%"Y&	
            
            DGtOOCQLLK????J	$&&LLLLL		s%R
            RRrcF|j|z|jko|jo|jS)a
                    Let you know if adding an element will trigger a page break,
                    based on its height and the current ordinate (`y` position).
            
                    Detailed documentation on page breaks: https://py-pdf.github.io/fpdf2/PageBreaks.html
            
                    Args:
                        height (float): height of the section that would be added, e.g. a cell
            
                    Returns: a boolean indicating if a page break would occur
                    )rrrr)rrs  r&will_page_breakzFPDF.will_page_breaks2
            FVOd55
            'N"
            '&	
            r%c||rCtd|j|j||j|dSdS)Nz;Page break on page %d at y=%d for element of height %d > %dTF)rrdebugrrr_perform_page_breakrrs  r&rNz#FPDF._perform_page_break_if_need_besb""		LLM	'
            
            
            
            $$&&&4ur%c6|j}g}|rc|||||cd|_||d|t|D]<}|d|_|j
            di|=||_dS)z
                    Performs a page break, taking care to preserve self.x
                    and a potential existing `fpdf.fpdf.FPDF.local_context()`.
                    A call to `fpdf.fpdf.FPDF.will_page_break()` should be performed beforehand.
                    FT)rNr$)r7!_is_current_graphics_state_nestedrrr.r-r%r*r(reversedr+	as_kwargs)rr7gs_stackprev_gss    r&rzFPDF._perform_page_breaks&
            F*,4466	&OOD<<>>???!!###
            ##%%%
            4466	&,1(   
            
            4
               ))	=	=G""$$$27G/%D%<<(9(9(;(;<<<<r%c"|j|jkSrV)rrrXs r&rzFPDF._has_next_page,s$)++r%c#Kt|jtjsdVdSd|_|j|j|j|jf\}}}}|j|jj	p
            t}|	dV|t|dz|jdzD]
            }|j|=||_||j|j_	||||`dS#|t|dz|jdzD]
            }|j|=||_||j|j_	||||`wxYw)NcdSrVr$)rrs  r&z'FPDF._disable_writing..6sDr%r')rrtypes
            MethodTyperrr7rrannotsrr*r.rset_xy)r	prev_pageprev_pages_countprev_xprev_yrps       r&_disable_writingzFPDF._disable_writing/s$)U%566	
            EEEF00	IFF	7
            3	#VVDI&-;   	EEE!!###+a/1AA1EFF
            "
            "JqMM!DI+1DJty!(KK'''			
            !!###+a/1AA1EFF
            "
            "JqMM!DI+1DJty!(KK'''	MMMMs
            	C??A2E1MultiCellPageBreakResultMultiCellLinesResultMultiCellHeightResultMultiCellResultrmax_line_heightprint_shwrapmoderrctj|}tj|}|r(t	jdtt|s|rb|5|	||||||||	|
            |||
            ||dd|rtjn|||cdddS#1swxYwY|jstdt|tst|trt!dt#j|
            }
            t%j|}|	dkr|	d	krt"j}
            t$j}np|	d
            krt"j}
            t$j}nQ|	dkrt"j}
            t$j}n2|	dkrt"j}
            t$j}nt!d
            |	dt	jd|	d|
            jd|jdttt3j|}d}||j}|d	kr|j|jz
            |jz
            }|j|j}}||jz
            |j z
            x}}g}|j s|!|j"|js|!|j"|t2j#kr|xj|j z
            c_|xj|j$z
            c_|r;|t2j#kr
            |jdzn|j%|j&|z
            dzz|_|j}|'|}|(dd}|j)r|*||n|+||}|j,}|j-}|j.}d	}g}t_||||||} | 0}!|!+|!|!| 0}!|!+|stcgd	d	|||dg}|
            te|d
            kr|}"ntg||
            }"|p|}#d}ti|D]\}$}!|5||j6z}%|%rd}|xj|j$z
            c_|#r|$d	ks|%r|j}&|j6|j7z}'tq|j9|&z
            |'z
            |"z}(tg|(te||$z
            })tu||$|"zz
            |)|"z}*|j|t2j#kr|dznd	z
            }+tw||+|j z
            |j|j$z
            |+|z|jz|j|*z|j6z||r|j<nd|$te|d
            z
            k},|=|!|"|,r|
            nt"j|,r|nt$jd	d|td	|jd	|j |		||"z
            }|,s|t2j#kr||_||kr%|t$jkr|xj||z
            z
            c_|}|r|t$jkr|j}|d}-|-r5|-j>r.|t$j?t$jfvr|@|t$jkr||_n%|t$jkr|xj|j6z
            c_|r||_-||_,||_.|
            t"jkr|xj|jz
            c_n%|
            t"jkr|xj|j zc_tj|}d}.|tjAzr|.|fz
            }.|tjzr[g}/|D]P}!g}0|!jBD]}1|0C|1jD|/!dE|0Q|.|/fz
            }.|tjFzr|.||j$z|j6zfz
            }.te|.d
            kr|.d	S|.S)ab
                    This method allows printing text with line breaks. They can be automatic
                    (breaking at the most recent space or soft-hyphen character) as soon as the text
                    reaches the right border of the cell, or explicit (via the `\n` character).
                    As many cells as necessary are stacked, one below the other.
                    Text can be aligned, centered or justified. The cell block can be framed and
                    the background painted. A cell has an horizontal padding, on the left & right sides,
                    defined by the.c_margin property.
            
                    Args:
                        w (float): cell width. If 0, they extend up to the right margin of the page.
                        h (float): height of a single line of text.  Default value: None, meaning to use the current font size.
                        text (str): string to print.
                        border: Indicates if borders must be drawn around the cell.
                            The value can be either a number (`0`: no border ; `1`: frame)
                            or a string containing some or all of the following characters
                            (in any order):
                            `L`: left ; `T`: top ; `R`: right ; `B`: bottom. Default value: 0.
                        align (fpdf.enums.Align, str): Set text alignment inside the cell.
                            Possible values are:
                            `J`: justify (default value); `L` or empty string: left align;
                            `C`: center; `X`: center around current x position; `R`: right align
                        fill (bool): Indicates if the cell background must be painted (`True`)
                            or transparent (`False`). Default value: False.
                        split_only (bool): **DEPRECATED since 2.7.4**:
                            Use `dry_run=True` and `output=("LINES",)` instead.
                        link (str): optional link to add on the cell, internal
                            (identifier returned by `add_link`) or external URL.
                        new_x (fpdf.enums.XPos, str): New current position in x after the call. Default: RIGHT
                        new_y (fpdf.enums.YPos, str): New current position in y after the call. Default: NEXT
                        ln (int): **DEPRECATED since 2.5.1**: Use `new_x` and `new_y` instead.
                        max_line_height (float): optional maximum height of each sub-cell generated
                        markdown (bool): enable minimal markdown-like markup to render part
                            of text as bold / italics / strikethrough / underlined.
                            Supports `\` as escape character. Default to False.
                        print_sh (bool): Treat a soft-hyphen (\u00ad) as a normal printable
                            character, instead of a line breaking opportunity. Default value: False
                        wrapmode (fpdf.enums.WrapMode): "WORD" for word based line wrapping (default),
                            "CHAR" for character based line wrapping.
                        dry_run (bool): if `True`, does not output anything in the document.
                            Can be useful when combined with `output`.
                        output (fpdf.enums.MethodReturnValue): defines what this method returns.
                            If several enum values are joined, the result will be a tuple.
                        txt (str): [**DEPRECATED since v2.7.6**] string to print.
                        center (bool): center the cell horizontally on the page.
                        padding (float or Sequence): padding to apply around the text. Default value: 0.
                            When one value is specified, it applies the same padding to all four sides.
                            When two values are specified, the first padding applies to the top and bottom, the second to
                            the left and right. When three values are specified, the first padding applies to the top,
                            the second to the right and left, the third to the bottom. When four values are specified,
                            the paddings apply to the top, right, bottom, and left in that order (clockwise)
                            If padding for left or right ends up being non-zero then respective c_margin is ignored.
            
                    Center overrides values for horizontal padding
            
                    Using `new_x=XPos.RIGHT, new_y=XPos.TOP, maximum height=pdf.font_size` is
                    useful to build tables with multiline text in cells.
            
                    Returns: a single value or a tuple, depending on the `output` parameter value
                    zcThe parameter "split_only" is deprecated since v2.7.4. Use instead dry_run=True and output="LINES".rF)rrrcr r#rrr"rrGrr%r&rrrrr$r@NrIr(rrr'rrr*z"), must be an int between 0 and 3.r+r,r-rM
            r)r#rrr.T)rr%r&r rrr@r3rr$)GrnewrZrIrrrr3r
            multi_cellrMLINESrr]rrrr[r\r5r8r7r9r6rrCrrrr7rrrrr;rKrr8rrPrmrrRr:r$rrrtget_linerurrrIrNrOrrrrlrr)r;r2LASTr"
            PAGE_BREAKrJrzrUrHEIGHT)2rrrrcr r#rrrr"rrGrr%r&rrrr$r@rcrrmaximum_allowed_widthclearance_marginsnormalized_stringstyled_text_fragmentsprev_current_fontrprev_underlinetotal_height
            text_linesmulti_line_breakr?r=box_requiredtext_line_indexstart_of_new_pagetop_gap
            bottom_gaplines_before_break	num_lines
            box_heightr7is_last_line	last_linereturn_valueoutput_linesrUrNs2                                                  r&rzFPDF.multi_cell[s`	j+g&&?8,,	MD#*,,
            
            
            
            
            	j	&&((
            
            !$3%%%!$6@L,22f!#''
            
            
            
            
            
            
            
            
            
            
            
            
            
            
            
            ,	W UVVVa	As!3!3	J
            E""E""
            Qww
            	q	q		q
             7777
            Ma&(aa:?*aaSXS]aaa#*,,
            
            
            
            
            U##$9A
            66&/A
            %&
            $5$DD)+|	4$$T]333}	4$$T]333EGFFgl"FF'+	#uw..
            
            DMTXPQ\UVDV4V
            FVF""4(( LLr22 
            HD,,->III**+.sIr%)rrr)rr r%r&rr)rZrIrr]rrrrrPrmrrRr:rtr;rr7rrr8rrIr"r;r[rYr\r6r2)rrrcrrrrcrrrrfirst_widthr?
            full_widthrr
            r1s                @r&writez
            FPDF.writes-8?8,,	W UVVVa	H
            
            9A$ //55==dBGG 
            ED,,->FFF**+>1
            9//222AFFaKFF9A![))	B1a/@AAA	aA	;..q!Q::JAq!Q 	NT(^q%8%8%8((sD!Qdf(MMD8!Q1/tvRVRX
            
            
            	&H	&&&UX&FF
            *
            *		.)))
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            *
            IIn%%%	(IIaAq$'''""$d3i	
            	
            	
            "#
            "#
            sE''E+.E+img_infoc8|r|dd||\}}}}tj|}|tjkr
            |j|z
            dzS|tjkr|j|z
            |jz
            S|tjkr|jStd|)Nrrz*Unsupported 'x' value passed to .image(): )
            rrCrIrQrrrrEr8r)rr7rrr!rrs       r&rzFPDF.x_by_aligns	?!221aA>>JAq!QLOO<<FQJ!##<<6A:
            --<<= IaIIJJJr%svgc|js_|jrX|jrQtjdtt
            dt
            d|j|jg|_|dkr|dkr|jrn|jrgt|jtr|j|j	zdzn|j}t|jtr|j|j
            zdzn|j}n|jr
            |j\}}}}nt|trdn|}
            t|
            d|dks|dkrW|jr|jr|j|j}}n#|jr
            |j\}}}}ntd|dkr	||z|z}n||z|z}|,|
            ||j}|xj|z
            c_||j}t|t s||||||}t
            |}|r|||||\}}}}|d||d	
            \}}}|jJ|jt+j||z|_|j|j}}	|dd|	s|
            rG||	|
            5||d
            dddn#1swxYwYn||d
            |||n#|||wxYw|r||||||t7||S)NzI has no "viewBox", using its "width" & "height" as default "viewBox"r���r���r���zzT has no "viewBox" nor "height" / "width": w= and h= must be provided to FPDF.image()zY has no "viewBox" nor "height" / "width": w= and h= must be provided to FPDF.image()r'���T)r��rT��r��ignore_svg_top_attrsr��F)r��)r��r��)viewboxrT��r��r���r���r3���r���r���r���r��r��r��r��rN��r���r7��r���r��r��transform_to_rect_viewportr��r?���translationr��r��r��r��rn���)r���r��r#��r��r7��r���r��r��r��r��r��r��r��svg_id	svg_width
            svg_heightr}��old_xold_ys���                   r&���r��zFPDF._vector_image��s����{�	Fsy�	FSZ�	FM[*,,
            �
            �
            �
            �!88U1XXsy#*ECK66a1ffy�
            SZ�
            �"#)W55#CI(3..��"#*g66$CJ)C//�
            ��
             [
            1a$.tU$;$;E sss���!VVqAvvy�
            SZ�
            (+	3::		�
            .1k+1i o���Avv	MJ.
            NY.�
            9//222AFFaKFF9A![))�	B1a/@AAA!HH�	;..q!Q::JAq!Q331QT�4�
            �
            
            1d�~))))*?1*E*EEvtvu
            	&KK1�
            1�
            1�***JJ�5�5NN4eN4445�5�5�5�5�5�5�5�5�5�5�5�5�5�5�t%000KKu%%%%DKKu%%%%�	(IIaAq$'''aCCCCs0���41L�%K	=L�	K
            
            L�K
            L�Lr��c�����������	������L���|�j���������j��������}||z��||z��}	}d|�}
            t����������|d�������������������}t����������|d�������������������}|�j��������J�|||�j��������z��k����r||	|�j��������z��k����rt����������||z��||	z������������|�j��������z��}|�j������������������������������������������������������������d����������r"t����������	��������������������d|||||	|�����������nK|�j����������������������������������������dk����rt����������||�j��������z������������t����������|	|�j��������z������������f}|dxx���������dz��cc<���|d���������d	k����rq|�j��������j��������}
            |
            
            ��������������������������������D�]P\��\��}}}|t����������j��������k����r8|d
            ���������|v�r.|��������������������t#����������t$����������|d
            ������������������������������Q|��������������������|
            ����������}|rt#����������t(����������|����������}t����������|d�������������������}t����������|d�������������������}||z��|d	���������|d���������z��k�����ra|��������������������t-����������||pt/����������|����������|�j���������j��������|���������������������t������������������������������d|
            |d
            ���������|�����������|dxx���������dz
            ��cc<���nt)����������t-����������||pt/����������|����������|�j���������j��������|��������������������}t5����������|����������dz���|d
            <���d|d<���|||
            <���t������������������������������d|
            ||d
            ��������������������nt7����������d
            |�j�������������������|S�)Nzlowres-r��r��r���zOVERSIZED: Image %s with size %.1fx%.1fpx is rendered at size %.1fx%.1fpt. Set pdf.oversized_images = 'DOWNSCALE' to reduce embedded image size by a factor %.1f	downscaler��r'���r���r��z>OVERSIZED: Updated low-res image with name=%s id=%d to dims=%szAOVERSIZED: Generated new low-res image with name=%s dims=%s id=%dz/Invalid value for attribute .oversized_images: )r��imagesr���r��r��r��r���r��r��r��roundrP��resources_per_pager\��rT���r��remover���r���r���rm���updaterp���rq���r��r��r��r��)r���r��r��r��r��r��r��r0��width_in_ptheight_in_ptlowres_namefactorr��r2��r��rtyperesourcelowres_infolowres_wlowres_hs���                    r&���r��zFPDF._downscale_imageG��s����!($%Iq5y\&&&$s)$s)$000
            d9999L4#>>>>�AOQ%5669TT�
            �$**,,77??�C
            q� ����&,,..+==+(CCDD,)DDEE�X!#>Q&&)-)?)R&0B0H0H0J0J�B�B,
            EH O$<<<chAVAV$OODd3i,@,@AAA$jj55�&==D$T#Y//H$T#Y//H(*T!WtAw->>>( $ # 7z$'7'7 $ 0 = $	����\' I 	���NNNa'NNNN*$ 3:d#3#3 ,9 	��D�!$FaDI%&DN*.F;'LL[#S		����!]dF[]]���r%���c�����������������~����t����������j��������dt����������t���������������������������������t	����������|�j��������||����������S�)z
                    Read an image and load it into memory.
            
                    .. deprecated:: 2.7.7
                        Use `fpdf.image_parsing.preload_image` instead.
                    zFPDF.preload_image() is deprecated since v2.7.7 and will be removed in a future release. Use `fpdf.image_parsing.preload_image` instead.r���)r���r���r���r3���rr���r��)r���r��r��s���   r&���rr���zFPDF.preload_image��sQ�����	
            B�
            &((	
            �	
            �	
            �	
            �
            �
            �	
            r%���glyph_image_bytesc�����������������0����t����������|�j��������|d�����������S�)N)r��r��r��)rr���r��)r���r?��s���  r&���preload_glyph_imagezFPDF.preload_glyph_image��s'����
            �("
            �
            �
            �	
            r%���c��������������+�����K���|�j�����������������������������|�j������������������}�|�j��������dd|d|}|�j��������}|���������������������d|�d�����������|V��|�j��������|k����rt����������d����������|���������������������d�����������dS�)	
                    Can receive as named arguments any of the entries described in section 14.7.2 'Structure Hierarchy'
                    of the PDF spec: iD, a, c, r, lang, e, actualText
                    z/Figure)r��mcidz/P <> BDCz-A page jump occurred inside a marked sequenceEMCNr$���)r��next_mcid_for_pager���r��r��r]���)r���r���rD��struct_elemr���s���     r&���r��zFPDF._marked_sequence��s�������"55di@@.d.�
            !
            �
            06
            �
            �Y
            		,,,,---9
            "" OPPP		%r%���c����������������������|�j���������j��������dd|�j��������i|\��}}||�j��������|�j�����������������_��������|���������������������d�����������|S�)rC��r��r���r$���)r��add_marked_contentr���r���struct_parentsrM��)r���r���rG��spids���    r&���r��zFPDF._add_marked_content��se����
            �CD/B�
            �
            	
            %+
            �
            T�04
            49,!!%(((r%���c���������������������|�j���������|�_��������||�xj��������|z
            ��c_��������dS�|�j��������r|�xj��������|�j��������z
            ��c_��������dS�|�xj��������|�j��������z
            ��c_��������dS�)a��
                    Line Feed.
                    The current abscissa goes back to the left margin and the ordinate increases by
                    the amount passed as parameter.
            
                    Args:
                        h (float): The height of the break.
                            By default, the value equals the height of the last printed text line
                            (except when written by `.text()`). If no text has been written yet to
                            the document, then the current font height is used.
                    N)r8��r7��r���r��r��r��s���  r&���r"��zFPDF.ln��s[�����=FFaKFFFF
            [�	%FFdk!FFFFFFdn$FFFFr%���c���������������������|�j���������S�)z-Returns the abscissa of the current position.)r7��rX��s��� r&���get_xz
            FPDF.get_x��s	����v
            r%���c�����������������4����|dk����r|n	|�j���������|z���|�_��������dS�)z
                    Defines the abscissa of the current position.
                    If the value provided is negative, it is relative to the right of the page.
            
                    Args:
                        x (float): the new current abscissa
                    r���N)r��r7��)r���r7��s���  r&���set_xz
            FPDF.set_x��s!�����1ff$&1*r%���c�����������������<����|�j���������rt����������d����������|�j��������S�)z-Returns the ordinate of the current position.z?Using get_y() inside an unbreakable() code block is error-prone)r��r]���r���rX��s��� r&���get_yz
            FPDF.get_y��s+�����	Q��
            �v
            r%���c�����������������L����|�j���������|�_��������|dk����r|n	|�j��������|z���|�_��������dS�)z
                    Moves the current abscissa back to the left margin and sets the ordinate.
                    If the value provided is negative, it is relative to the bottom of the page.
            
                    Args:
                        y (float): the new current ordinate
                    r���N)r8��r7��r��r���)r���r���s���  r&���set_yz
            FPDF.set_y��s*�����1ff$&1*r%���c�����������������Z����|����������������������|�����������|���������������������|�����������dS�)a,��
                    Defines the abscissa and ordinate of the current position.
                    If the values provided are negative, they are relative respectively to the right and bottom of the page.
            
                    Args:
                        x (float): the new current abscissa
                        y (float): the new current ordinate
                    N)rT��rP��)r���r7��r���s���   r&���r��zFPDF.set_xy��s&�����	
            
            1
            
            
            
            
            1
            
            
            
            
            r%���c��������������������|�j���������sw|�j��������rp	�|��������������������|�j��������������������������������������d����������S�#�t����������$�r5}t����������|j��������||j�����������������|�j��������|�j��������z�������������|d}~ww�xY�w|S�)z7Check that text input is in the correct format/encodingr���)
            text_index	character	font_nameN)	rt��r��encodedecodeUnicodeEncodeErrorr_���startr��r��)r���rc��errors���   r&���rP��zFPDF.normalize_text+��s������	D$<�	
            {{4#;<<CCINNN%�
            �
            �
            2${"5;/".@���	
            �s���,=�
            A<0A77A<sha256
            pkcs_filepathpasswordhashalgocontact_infolocationsigning_timereasonc	��������������������t�����������st����������d����������t����������|d����������5�}	t����������j��������|	��������������������������������|����������\��}
            }}ddd�����������n#�1�swxY�w�Y���|J�|���������������������|
            ||||||||	��	���������dS�)aE��
                    Args:
                        pkcs_filepath (str): file path to a .pfx or .p12 PKCS12,
                            in the binary format described by RFC 7292
                        password (bytes-like): the password to use to decrypt the data.
                            `None` if the PKCS12 is not encrypted.
                        hashalgo (str): hashing algorithm used, passed to `hashlib.new`
                        contact_info (str): optional information provided by the signer to enable
                            a recipient to contact the signer to verify the signature
                        location (str): optional CPU host name or physical location of the signing
                        signing_time (datetime): optional time of signing
                        reason (str): optional signing reason
                        flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
                    Pendesive.signer not available - PDF cannot be signed - Try: pip install endesiver��N)	rU��certextra_certsrb��rc��rd��re��rf��r��)r���EnvironmentErrorr��r���load_key_and_certificatesr��sign)
            r���r`��ra��rb��rc��rd��re��rf��r��	pkcs_filerU��ri��rj��s
            ���             r&���sign_pkcs12zFPDF.sign_pkcs12:��s����8��	"b��
            �-
            &
            &�	)0NN$$h��
            #C{	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�		#%%�	�
            	
            �
            	
            �
            	
            �
            	
            �
            	
            s���,AA#&A#rU��r���ri��r���rj��c
            �����������������z���t�����������st����������d����������|�j��������rt����������d����������||�_��������||�_��������||ng�|�_��������||�_��������|p|�j��������|�_��������t����������dddddd|	dt����������||t����������|�j������������������|����������		��	��������}
            |�j��������|�j
            �������������������������������������|
            �����������dS�)
            a��
                    Args:
                        key: certificate private key
                        cert (cryptography.x509.Certificate): certificate
                        extra_certs (list[cryptography.x509.Certificate]): list of additional PKCS12 certificates
                        hashalgo (str): hashing algorithm used, passed to `hashlib.new`
                        contact_info (str): optional information provided by the signer to enable
                            a recipient to contact the signer to verify the signature
                        location (str): optional CPU host name or physical location of the signing
                        signing_time (datetime): optional time of signing
                        reason (str): optional signing reason
                        flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
                    rh��z).sign* methods should be called only onceNWidgetSigr���	signature)rc��rd��r��rf��)
            field_typer7��r���rT��r��r��r��r��)r���rk��r��r]���
            _sign_cert_sign_extra_certs_sign_hashalgorD��
            _sign_timer-���r���r���r���r���r��)r���rU��ri��rj��rb��rc��rd��re��rf��r��r��s���           r&���rm��z	FPDF.signm��s����:��	"b��
            �>�	M KLLL0;0GR&$0$FD4F")!$/**	��
            �
            �
            
             �	
            49,,Z88888r%���c����������������������j���������}|J��j���������j��������}}|j��������|j��������c�_���������_��������d�_�����������������������������|j���������j���������j�������������������|	����������������������j
            �������������������d�_��������|j��������|j��������z���dz
            ��}�j��������|k����rA�j��������s:�j��������|k����rdnd}d|�d}|d�j���������d	|j���������d
            z
            ��}t����������|�����������j��������rc�����������������������������������fdt!�����������j������������������D�������������}t#����������t%����������|��������������������}i�}t!����������|j��������dz����j��������t)����������|����������z���dz�������������D�]}	|	�j��������v�r-|���������������������j����������������������������|	���������������������|��������������������d����������x}
            �j��������|	<���|	||
            ��������������������������������<���|
            ��������������������|	�����������|j��������du�r|	|
            ��������������������������������_��������t)����������|����������dk����sJ�d
            t)����������|������������������������j����������������������������������������D�].}|j��������J�|��������������������|j������������������}|||_��������/�j
            ��������D�]X}
            |��������������������|
            j������������������}|:|
            j ��������!��������������������|����������|
            _ ��������||
            _��������|
            j"��������r||
            j"��������_#��������Y�j$��������j%��������}tM����������tN��������������������}|(��������������������������������D�]%\��\��}}}|��������������������||����������|f}|||<���&|�j$��������_%��������||c�_���������_��������d�S�)NTFr'���manyfewzKThe rendering function passed to FPDF.insert_toc_placeholder triggered too z page breaks: zToC ended on page z' while it was expected to span exactly z pagesc�����������������h����g�|�].}j�����������������������������t����������j�����������������������������/S�r$���)r���popr��)rM��r��r���s���  r&���r��z2FPDF._insert_table_of_contents..��s<�������45
            s4://��r%���r���z#new_pages: r8��))r��r���r���r���r��r4��r���r2��r3��r���r��r���r��r]���r��r��r��r���r��r��r��r��r}��r1��	set_indexr���r��str��r}��r��r���r��rm��rG��_page_numberrP��r2��r���r��r\��)r���tocpr��r��expected_final_pagetoo	error_msg	new_pages
            indices_remap
            page_indexr���r��	new_indexsectionr2��new_resources_per_pager��r��r:��rU��s���`                   r&���_insert_table_of_contentszFPDF._insert_table_of_contents��s���# Itv6	 OTV	46 $d3TZLLLT4=111 %"o
            :Q>9+++D4R+ I(;;;&&CyfiyyyIrdirr`d`jrrrrI	***#�0	O!!!���9>t?W9X9X��I�Xi0011I,.M#!#T%5I%F%J��
            :�
            :
            �++$$TZ^^J%?%?@@@09
            
            a0@0@@tz*-.8
            djjll+z****e33/9D'')),y>>Q&&&(Gs9~~(G(G&&&
            ))++�
            1�
            1'333)--d.>??	('0D$=�	
            �	
            )--g.ABB	(#*<#7#7Y#7#G#GGL*3G'*��&� +8�"&!7!J�C  �
            #�;M:R:R:T:T�
            7�
            76,mh$((kBBMR.6&s++8ND"5%v	4666r%���c���������������������dS�)aA��
                    This method can be overridden in inherited classes
                    in order to define a custom file identifier.
                    Its output must have the format "".
                    If this method returns a falsy value (None, empty string),
                    no /ID will be inserted in the generated PDF document.
                    r��r$���rX��s��� r&���file_idzFPDF.file_id��s	�����rr%���rR��c�����������������D���t����������j��������dd����������}|��������������������|�����������|�j��������r@|��������������������|�j����������������������������d������������������������������d���������������������|����������������������������������������������������������������}d|�d|�dS�)	Nmd5F)usedforsecurityz%Y%m%d%H%M%Sutf8<>)hashlibr��r4��rD��strftimerZ��	hexdigestr��)r���rR��id_hashhash_hexs���    r&���_default_file_idzFPDF._default_file_id��s�����+eU;;;v�	WNN4-66~FFMMfUUVVV$$&&,,..*8**x****r%���c���������������������||�j���������}|J�||�j��������z��dd|�j��������|z
            ��|j��������dz��|�j��������z��z���|�j��������z��dd||�j��������z��dd|j���������dz��|�j��������z��ddS�)zr
                    Draw an horizontal line under some text,
                    starting from (x, y) with a length equal to 'w'
                    Nr��r���� re f)r$��r���r��upr��utr!��r���r7��r���r��r���s���     r&���r��zFPDF._do_underline�������<$D46z �
            >�
            >
            TWt^dn<<FM
            >�
            >46z 
            >�
            >�x$!22=
            >�
            >�
            >	
            r%���c���������������������||�j���������}|J�||�j��������z��dd|�j��������|z
            ��|j��������dz��|�j��������z��z���|�j��������z��dd||�j��������z��dd|j���������dz��|�j��������z��ddS�)zt
                    Draw an horizontal line through some text,
                    starting from (x, y) with a length equal to 'w'
                    Nr��r��r��r��)r$��r���r��spr��ssr!��r��s���     r&���r��zFPDF._do_strikethrough��r��r%���c��������������������|�j���������rt����������d����������t����������|t��������������������s9t����������|t��������������������st	����������|����������}|��������������������d����������}|�j��������st����������d����������|�j��������|�j�����������������j��������}t����������|t��������������������r,|
            ��������������������|�����������|��������������������d�����������d�S�||dz���z
            ��}d�S�)NzGContent cannot be added on a finalized document, after calling output()latin1r���r�����
            )rR��r]���r���r��r���rZ��r���r���r0��r2��rz��r��)r���rE��
            page_contentss���   r&���r��z	FPDF._out)��s����;�	Y��
            �!U##�	#a%%�
            FF""Ay�	S QRRR
            49-6
            mY//�	'  ###  &&&&&QY&MMMr%���c�����������
            ������^���|dz��}|}dddddddd	d
            ddd
            d}|}	t����������|	����������dz��dk����rd|	�}	d|	���������������������������������d}	t����������dt����������|	����������d����������D�]}
            |	|
            ���������}|	|
            dz������������}||vrt����������d|�d����������||vrt����������d|�d����������d��������������������d�t����������||���������||�������������������D�����������������������}
            t
            ����������|
            ����������D�]6\��}}|dk����r|n|}|dz��dk����r|���������������������||||d�����������||z
            ��}7dS�)z/Barcode I2of5 (numeric), adds a 0 if odd lengthr���nnwwnwnnnwnwnnwwwnnnnnwnwwnwnnnwwnnnnnwwwnnwnnwnwnnnwn)0123456789AZr���r���r��AAZAr'���zChar "z" invalid for I25:z" invalid for I25: r���c��������������3���(���K���|�]
            \��}}|�|�V��d�S�rV��r$���)rM��cbcss���   r&���rO��z'FPDF.interleaved2of5..h��s?�������� &B2r�����r%���r��r��N)r��r���r��RuntimeErrorr��ziprI��r��)r���rc��r7��r���r��r��narrowwidebar_charcoder��char_bar
            char_spacer��	bar_indexr��r/��s���                 r&���interleaved2of5zFPDF.interleaved2of5;��s����Q�
            
            �
            
             �t99q=At::D�%DJJLL$$$q#d))Q''�	 �	 AAwHa!eJx''"#HH#H#H#HIII))"#KJ#K#K#KLLL�''��*-hx.@(:BV*W*W����C�$-S>>�
             �
             	4'+s{{VV
            �q=A%%IIaJ3777Z
             	 �	 r%���������?r��c��������������������||dz��d}|���������������������d����������r|��������������������d����������s"t����������j��������dt	���������������������������������i�dddd	d
            ddd
            ddddddddddddddddddd d!d"d#d$d%d&d'i�d(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;dd?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdT
            }|��������������������������������D�]r}||vrt
            ����������dU|�dV����������t����������||�������������������D�]8\��}	}
            |	dWz��dXk����r|���������������������||||
            ���������|d$�����������|||
            ���������z
            ��}9||dY���������z
            ��}sdZS�)[zBarcode 3of9r���)r��r��*zpCode 39 input must start and end with a '*' character to be valid. This method does not insert it automatically.r���r��	nnnwwnwnnr��	wnnwnnnnwr��	nnwwnnnnwr��	wnwwnnnnnr��	nnnwwnnnwr��	wnnwwnnnnr��	nnwwwnnnnr��	nnnwnnwnwr��	wnnwnnwnnr��	nnwwnnwnnr��	wnnnnwnnwrS��	nnwnnwnnwrQ��	wnwnnwnnnr��	nnnnwwnnwE	wnnnwwnnnr��	nnwnwwnnnG	nnnnnwwnwH	wnnnnwwnnrT��	nnwnnwwnnr4��	nnnnwwwnnK	wnnnnnnwwrE��	nnwnnnnwwM	wnwnnnnwnN	nnnnwnnwwO	wnnnwnnwnr���	nnwnwnnwnr��	nnnnnnwwwr���	wnnnnnwwnrn��	nnwnnnwwnrF��	nnnnwnwwnro��	wwnnnnnnwV	nwwnnnnnwW	wwwnnnnnnrK��	nwnnwnnnw	wwnnwnnnn	nwwnwnnnn	nwnnnnwnw	wwnnnnwnn	nwwnnnwnn	nwnnwnwnn	nwnwnwnnn	nwnwnnnwn	nwnnnwnwn	nnnwnwnwn)
            Yr��-rM��r��r��$/+%zInvalid char "z" for Code39r���r���r��N)	r��r��r���r���r3���r��r��rI��r��)r���rc��r7��r���r��r��dimcharsr��r��ds���           r&���code39zFPDF.code39v��s����AE""s##�	4==+=+=�	ME�+,,
            �
            �
            �
            -
            -
            -
            �
            -
            �
            	-
            
            �
            -
            �
            
            -
            �
            -
            �
            -
            �
            -
            �
            -
            �
            -
            �
            -
            �
            -
            �
            -
            �
            -
             �
            !-
            "�
            #-
            �-
            $�
            %-
            &�
            '-
            (�
            )-
            *�
            +-
            ,�
            --
            .�
            /-
            0�
            1-
            2�
            3-
            4�
            5-
            6�
            7-
            8�
            9-
            :�
            ;-
            <�
            =-
            >�
            ?-
            @�
            A-
            B�
            C-
            D�
            E-
            �-
            F�Y-
            �-
            �-
            `��	�	A~~"#CA#C#C#CDDD!%(++�
            �
            1q5A::IIaCFAs333SV
            SMAA	�	r%���c��������������#������K���|����������������������d||�j��������z��dd|�j��������|z
            ��|z
            ��|�j��������z��dd||�j��������z��dd||�j��������z��dd	�����������dV��|����������������������d�����������dS�)a}��
                    Context manager that defines a rectangular crop zone,
                    useful to render only part of an image.
            
                    Args:
                        x (float): abscissa of the clipping region top left corner
                        y (float): ordinate of the clipping region top left corner
                        w (float): width of the clipping region
                        h (float): height of the clipping region
                    r��r��r��z re W nNr��r��r{��s���     r&���	rect_clipzFPDF.rect_clip��s�������	
            		+QZW�+�+tvzA~&?W�+�+a$&jW�+�+tv:*+�+�+	
            �	
            �	
            �			#r%���c��������������#������K���|����������������������d�����������|���������������������||||d�����������dV��|����������������������d�����������dS�)a]��
                    Context manager that defines an elliptic crop zone,
                    useful to render only part of an image.
            
                    Args:
                        x (float): abscissa of the clipping region top left corner
                        y (float): ordinate of the clipping region top left corner
                        w (float): ellipse width
                        h (float): ellipse height
                    r��zW nNr��)r��r��r{��s���     r&���
            elliptic_clipzFPDF.elliptic_clip��sO�������	
            		#1aAu---
            		#r%���c��������������#���t���K���|����������������������||||����������5��dV��ddd�����������dS�#�1�swxY�w�Y���dS�)aF��
                    Context manager that defines a circular crop zone,
                    useful to render only part of an image.
            
                    Args:
                        x (float): abscissa of the clipping region top left corner
                        y (float): ordinate of the clipping region top left corner
                        r (float): radius of the clipping region
                    N)r��)r���r7��r���r<��s���    r&���
            round_clipzFPDF.round_clip��s�������
            
            1a
            +
            +�	�	EEE	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	s���-11c��������������#�����K���|�j���������|�j��������}}t����������|�d����������}d|_��������d|�_��������t
            ������������������������������d�����������|V��|j��������|z
            ��|j���������|z
            ��|�j��������z��z���}||z���|�j��������k����s|j���������|k����rbt
            ������������������������������d�����������|	���������������������������������|j
            �����������������������������������������|���������������������������������d|_��������d|�_��������t
            ������������������������������d�����������dS�)a��
                    Ensures that all rendering performed in this context appear on a single page
                    by performing page break beforehand if need be.
            
                    Detailed documentation on page breaks: https://py-pdf.github.io/fpdf2/PageBreaks.html
            
                    Notes
                    -----
            
                    Using this method means to duplicate the FPDF `bytearray` buffer:
                    when generating large PDFs, doubling memory usage may be troublesome.
                    Fr��TzStarting unbreakable blockz.Performing page jump due to unbreakable heightzEnding unbreakable blockN)
            r���r���r���rc��r��r��r��r��r��rewindpdfr��replayr���r��r��recordery_scrolls���     r&���unbreakablezFPDF.unbreakable��s������!Itv6	>>>(-%#1222:&(-)*Ctx)OOHt666(-):S:SLLIJJJOO�
            L,,...OO,0H)$/00000r%���c��������������#������K���|�j���������|�j��������}}t����������|�d����������}d|_��������|V��|j��������|z
            ��|j���������|z
            ��|�j��������z��z���}||z���|�j��������k����s|j���������|k����rd|_��������|���������������������������������dS�)z
                    All rendering performed in this context is made on a dummy FPDF object.
                    This allows to test the results of some operations on the global layout
                    before performing them "for real".
                    Fr��TN)r���r���r���rc��r��r��r��r��s���     r&���offset_renderingzFPDF.offset_rendering��s�������!Itv6	>>>(-%:&(-)*Ctx)OOHt666(-):S:S,0H)r%���render_toc_functionr���allow_extra_pagesr���c��������������������|dk�����rt����������d|�����������t����������|����������st����������dt����������|���������������������|�j��������rt����������d|�j��������j�������������������t����������||�j��������|�j	��������|�j
            ��������||����������|�_��������||�_��������t����������|����������D�]}|�
            ���������������������������������dS�)a��
                    Configure Table Of Contents rendering at the end of the document generation,
                    and reserve some vertical space right now in order to insert it.
                    At least one page break is triggered by this method.
            
                    Args:
                        render_toc_function (function): a function that will be invoked to render the ToC.
                            This function will receive 2 parameters: `pdf`, an instance of FPDF, and `outline`,
                            a list of `fpdf.outline.OutlineSection`.
                        pages (int): the number of pages that the Table of Contents will span,
                            including the current one that will. As many page breaks as the value of this argument
                            will occur immediately after calling this method.
                        allow_extra_pages (bool): If set to `True`, allows for an unlimited number of
                            extra pages in the ToC, which may cause discrepancies with pre-rendered
                            page numbers. For consistent numbering, using page labels to create a
                            separate numbering style for the ToC is recommended.
                        reset_page_indices (bool): Whether to reset the pages indices after the ToC. Default to True.
                    r'���z3'pages' parameter must be equal or greater than 1: z,The first argument must be a callable, got: zIA placeholder for the table of contents has already been defined on page N)r��callabler��rs��r��r]���r���r���r���r���r5��r��r��r��)r���r#��r���r$��r���r��s���      r&���insert_toc_placeholderzFPDF.insert_toc_placeholder%��s���4�199MeMM��
            �+,,�	ZtDW?X?XZZ��
            ��	> 0;>�>��
            � .IF 
             
            � 
            �*;&u�	'�	'A$$&&&&	'�	'r%���level0level1level2level3level4level5level6c�����������	����������t����������|||||||g����������D�]E\��}}	|	>t����������|	t��������������������st����������dt	����������|	���������������������|	|�j��������|<���FdS�)a��
                    Defines a style for section titles.
                    After calling this method, calls to `FPDF.start_section` will render section names visually.
            
                    Args:
                        level0 (TextStyle): style for the top level section titles
                        level1 (TextStyle): optional style for the level 1 section titles
                        level2 (TextStyle): optional style for the level 2 section titles
                        level3 (TextStyle): optional style for the level 3 section titles
                        level4 (TextStyle): optional style for the level 4 section titles
                        level5 (TextStyle): optional style for the level 5 section titles
                        level6 (TextStyle): optional style for the level 6 section titles
                    Nz0Arguments must all be TextStyle instances, got: )rI��r���rd���r��rs��r��)
            r���r(��r)��r*��r+��r,��r-��r.��r1��levels
            ���          r&���set_section_title_styleszFPDF.set_section_title_stylesX��s����2�&
            VVVVVVD
            �
            �	9�	9LE5� !%33�#X4PU;;XX���49)%0	9�	9r%���r0��strictc��������������������|dk�����rt����������d����������|rF|�j��������r?||�j��������d���������j��������dz���k����r&t����������d|�d|�j��������d���������j���������d����������t����������|�j��������|�j��������|�j��������|�j��������z��z
            ������������}d	}|�j��������r|�j��������|���������}|j	��������|�j
            ��������}|j	��������|�_
            ��������t����������j��������}t����������|j��������t����������t����������f����������rt����������j��������|j������������������}|���������������������|�j��������|�j��������|t(����������j��������t,����������j��������d
            t0����������j��������|t5����������|j��������pdt����������|j��������t8����������t:����������f����������r|j��������nd|j��������pd����������	��	��������}	|j	��������||�_
            ��������|	r|����������������������������������|� ��������������������|
            ����������5�}
            |
            }|�!��������������������|����������5��|���������������������|�j��������|�j��������||t(����������j��������t,����������j��������|j��������t����������j"��������k���������������d	d	d	�����������n#�1�swxY�w�Y���d	d	d	�����������n#�1�swxY�w�Y���|�j��������#��������������������tI����������|||�j��������||���������������������d	S�)a��
                    Start a section in the document outline.
                    If section_title_styles have been configured,
                    render the section name visually as a title.
            
                    Args:
                        name (str): section name
                        level (int): section level in the document outline. 0 means top-level.
                        strict (bool): whether to raise an exception if levels increase incorrectly,
                            for example with a level-3 section following a level-1 section.
                    r���z)"level" mut be equal or greater than zeror��r'���z+Incoherent hierarchy: cannot start a level z section after a level z oner��NT)r��r��rO��)	r��r��rc��r%��r&��r���r��r#��r@��r��)r��r��rc��r#��r%��r&��r$��)%r��r��r0��r���r���r��r���r���r��size_ptr!��rC���rE��r���r8��r���rI��r��r��r��r[���r7��r\���r8��rM���r��r���r9��r���r���r��r(��r��use_text_stylerQ��r��rx���)r���r��r0��r2��r��outline_struct_elem
            text_styleprev_font_size_ptr#��rc��rG��s���           r&���
            start_sectionzFPDF.start_section{��s����199HIII�	dm�	
            b0A0G!0K(K(Kyeyy\`\ijl\m\syyy��
            �diTY$&-HIII"$�/	259J!-$($5!$.$6!GE*-s|<<�
            :Z%899#'??(.li(3"+0q�&j&9C<HH
            ++%.3!���$3�$�$ &�!-%�!�$�
             
            
            &&T&22�
            k&1#((44�	�	OO(.!#"l"i)2eg=�$���	�	�	�	�	�	�	�	�	�	�	�	�	�	�	
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �	
            
            4	49LMM	
            �	
            �	
            �	
            �	
            s7���IAH8,I8H<	<I?H<	�IIIr7��c��������������#�����K���d�}|r|j���������r|���������������������|j��������������������|j��������rat����������|j��������t����������t
            ����������f����������r |�j��������}|j��������|�_��������|�j��������|�_��������n t������������������������������d|j�������������������|�	��������������������|����������5��d�V��d�d�d������������n#�1�swxY�w�Y���|r!|j
            ��������r|���������������������|j
            �������������������|||�_��������|�j��������|�_��������d�S�d�S�)Nz@Unsupported '%s' value provided as l_margin to .use_text_style())r9��r"��r8��r���r���r���r7��r��r��
            use_font_facer��)r���r7��
            prev_l_margins���   r&���r5��zFPDF.use_text_style��sO�����
            �	"�
            -
            +,,,"�	
            j1E3<@@�$(MM$.$7DM!]DFFLLZ"+���
            
            
            
            +
            +�	�	EEE	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	)*-�	)GGJ'((($)DM]DFFF�%$s���%B66B:=B:	font_facec��������������#�����K���|sdV��dS�|�j���������|�j��������|�j��������f}|���������������������|j��������p|�j���������|j��������|j��������j��������n|�j��������|j��������p|�j�������������������d|�_��������|�j	��������}|j
            ��������*|j
            ��������|�j	��������k����r|���������������������|j
            �������������������|�j��������}|j��������|�
            ��������������������|j�������������������dV��|j��������|J�|�
            ��������������������|�����������||�_	���������|�j��������|��dS�)a��
                    Sets the provided `fpdf.fonts.FontFace` in a local context,
                    then restore font settings back to they were initially.
                    This method must be used as a context manager using `with`:
            
                        with pdf.use_font_face(FontFace(emphasis="BOLD", color=255, size_pt=42)):
                            put_some_text()
            
                    Known limitation: in case of a page jump in this local context,
                    the temporary style may "leak" in the header() & footer().
                    NF)r��r��r!��r��r ��rp��r
            ��r4��r%��r+��r��rD��r)��r��)r���r=��	prev_fontprev_text_colorprev_fill_colors���     r&���r;��zFPDF.use_font_face��s4�������	EEEF%t8IJ	
            
            0 0�%1�"((_2!2	
            �	
            �	
            �,1(/?&9?do+M+M	000/+	 4555
            +"...000)
            y!!!!r%���c��������������/���Z���K���t����������|�g|R�i�|}|V��|���������������������������������dS�)ao��
                    Inserts a table, that can be built using the `fpdf.table.Table` object yield.
                    Detailed usage documentation: https://py-pdf.github.io/fpdf2/Tables.html
            
                    Args:
                        rows: optional. Sequence of rows (iterable) of str to initiate the table cells with text content.
                        align (str, fpdf.enums.Align): optional, default to CENTER. Sets the table horizontal position
                            relative to the page, when it's not using the full page width.
                        borders_layout (str, fpdf.enums.TableBordersLayout): optional, default to ALL. Control what cell
                            borders are drawn.
                        cell_fill_color (int, tuple, fpdf.drawing.DeviceCMYK, fpdf.drawing.DeviceGray, fpdf.drawing.DeviceRGB): optional.
                            Defines the cells background color.
                        cell_fill_mode (str, fpdf.enums.TableCellFillMode): optional. Defines which cells are filled
                            with color in the background.
                        col_widths (int, tuple): optional. Sets column width. Can be a single number or a sequence of numbers.
                        first_row_as_headings (bool): optional, default to True. If False, the first row of the table
                            is not styled differently from the others.
                        gutter_height (float): optional vertical space between rows.
                        gutter_width (float): optional horizontal space between columns.
                        headings_style (fpdf.fonts.FontFace): optional, default to bold.
                            Defines the visual style of the top headings row: size, color, emphasis...
                        line_height (number): optional. Defines how much vertical space a line of text will occupy.
                        markdown (bool): optional, default to False. Enable markdown interpretation of cells textual content.
                        text_align (str, fpdf.enums.Align): optional, default to JUSTIFY. Control text alignment inside cells.
                        v_align (str, fpdf.enums.VAlign): optional, default to CENTER. Control vertical alignment of cells content.
                        width (number): optional. Sets the table width.
                        wrapmode (fpdf.enums.WrapMode): "WORD" for word based line wrapping (default),
                            "CHAR" for character based line wrapping.
                        padding (number, tuple, Padding): optional. Sets the cell padding. Can be a single number or a sequence
                            of numbers, default:0
                            If padding for left or right ends up being non-zero then the respective c_margin is ignored.
                        outer_border_width (number): optional. The outer_border_width will trigger rendering of the outer
                            border of the table with the given width regardless of any other defined border styles.
                        num_heading_rows (number): optional. Sets the number of heading rows, default value is 1. If this value is not 1,
                            first_row_as_headings needs to be True if num_heading_rows>1 and False if num_heading_rows=0. For backwards compatibility,
                            first_row_as_headings is used in case num_heading_rows is 1.
                        repeat_headings (fpdf.enums.TableHeadingsDisplay): optional, indicates whether to print table headings on every page, default to 1.
                    N)r���r`��)r���r���r���tables���    r&���rC��z
            FPDF.table��s@������R�d,T,,,V,,
            r%���)	linearizeoutput_producer_classrD��rE��c��������������������d�S�rV��r$���r���r��rD��rE��s���    r&���r��zFPDF.output1��s	�����Cr%���c��������������������d�S�rV��r$���rG��s���    r&���r��zFPDF.output9��s	�����sr%���)r��z2.2.0c�������������������t����������j���������������������|�j��������sJ|�j��������dk����r|����������������������������������|����������������������������������|�j��������r|����������������������������������|�j��������r|�j	��������
            ��������������������������������D�]}|��������������������������������D�]}|j��������
            ��������������������|����������������������������������������������������d����������|��������������������t#����������|�j������������������������������������������������d��������������������|_��������|�j����������������������������������������D�]:\��}}t+����������|t,��������������������r |j��������r|j�����������������������������������������;|�j��������r|�j��������j��������dk����rt7����������|�j������������������dk����rA|���������������������t<����������j��������dddtA����������tC����������������������dd	����������d
            �����������|�j��������j"��������dk����rD|�j��������j#��������d
            k����r4t7����������|�j$������������������dk����rtK����������|�j��������j&���������d����������|rtN����������}�||�����������}|(��������������������������������|�_��������|ret+����������|t"����������tR����������j*��������f����������r(tW����������|����������,��������������������|�j�������������������n|-��������������������|�j�������������������dS�|�j��������S�)a��
                    Output PDF to some destination.
                    The method first calls [close](close.md) if necessary to terminate the document.
                    After calling this method, content cannot be added to the document anymore.
            
                    By default the bytearray buffer is returned.
                    If a `name` is given, the PDF is written to a new file.
            
                    Args:
                        name (str): optional File object or file path where to save the PDF under
                        output_producer_class (class): use a custom class for PDF file generation
                    r���r���r���sRGBzIEC 61966-2-1:1999zhttp://www.color.orgr���r=���)r0��r��	alternatez
            sRGB2014 (v2))r��r��r��r��r��r���r��z$ requires at least one embedded fileN).r���cache_clearrR��r���r(��r��r��r��r��r���r}��get_text_substitutionsr0��rm��get_placeholder_stringrZ��render_text_substitutionr���r��rY��r\��r���rf���
            color_fontload_glyphsrJ��rK��r��r��r��rN���r���r|���r���rL��r��r��r`���ra��rw���	bufferizeosPathLiker	���write_bytesr��)	r���r��rD��rE��r���substitution_itemr��r���output_producers	���         r&���r��zFPDF.outputA��s���*�	&((({�/	6yA~~
            
            !!!#�
            1..000&�
            
             J--//�	�	D-1-H-H-J-J��)(,
            (=(=-DDFFMM )��.FF #D$4 5 5�$fY//
            )�)
            
            � :++--�
            2�
            24dG,,�2�2O//111�
            D$4$<$F$Ft+,,11**+04:)=&<,9%;%=%=&1-�-�-
            �-�+����$)Q..(4;;D/00A55-+1WWW����
            A(@%33D99O)3355DK�	$bk 233�
            (T
            
            &&t{3333
            
            4;'''4{r%���)NNNNN)r��)r���)r���)TNNNNrV��)r��)NNN)r���r���Fr���NNNN)r���N)T)r��r��)FF)NT)r���r���r���)FFN)FN)r'���r'���)NFr���)r���N)Nr���FFFN)Nr���FN)Nr���N)Nr���r���)r���r���r��r��N)Nr���r���r��r��N)NNNNNN)r'���r'���N)NNNN)r��r��N)r��NN)r���r��r'���)r���r���)r���r���NN)NNNNNNNN)
            NNr���r���r���r���NNNF)	NNr���r���r���NNNF)NNr���r���r���NNF)r'���r��)r��r��)r'���FT)r���T(��r!���r"���r#���__doc__r��r��r��r��r��recompileDOTALLr��r��r��ri���re��rR���r��r���r���r���r��r���r���rJ���r���propertyr-��rb���rf���rY��rK���RC4rB���r[��r���r���rb��r���ri��rM��rW���rp��rt��rQ���rv��setterr���rz���r~��rN���r|���r��r��r��r��r��r:��r��r��r��r<��r��r4��r=��rV���r��rP���r��r��r��r��r��r���r��r��r��r��r���r��r��r��r��r	��r���rO���r��r���r(��r��r��r��r,��r9��r��r���r9���r@��r��r;���r<���r=���rD��rS��rV��r
            ���r���r[��r���r���r5���rf��r���rp��r7���r_��rS���AUTOr8���r~��r6���r��r��r��r��r��r��rU���r��r��r��r��rI���r��r��r��r��r
            ��r��r!��r0��r2��rE��r2���r
            ���r]��r��rp��ry��r��r��r��r��r��r���r��r,���r��r	���r��r.���r��r+���rL���rE���r��rF���r��r��r(���r��rX���r��r��r��r��r4���rc��r��r��r��rD���r��r?���r��rf��r:���r+��r-��r��rC���rE��r[���r5��r\���r6��r>��ru���r���r;��r��rs���rR��r:��r��r��r��rN��r��r��r��r��r���r���r���r��r��r��r4��r8��rZ���WORDrM���r��r��r��r���r
            ��r���rm���rn���r��r��r��r���r��r��rr���rA��r���r��r��r"��rN��rP��rR��rT��r��rP��PRINTLOCKEDro��rm��r��r��r2��r��r��r��r��r��r��r��r��r��r���r ��r"��r���rx���r'��rd���r1��r9��r5��rc���r;��r���rC��r���r{���r���r��rS��rT��
            __classcell__)rT��s���@r&���r���r�����s}7��������"$(! $ $$"*%F	RR"O�4C3K"&260<j0�HLj0�j0�j03/0j0�CJj0�c5../	j0
            � -j0�%U30B+B%CDj0�
            j0�j0�j0�j0�j0�j0X�4tCG!334�4�4�4�X4�(,.>.B/+/11!&
            $
            �$
            $
            � }$
            �,	$
            
            �$
            �
            $
            �
            $
            �$
            �$
            �$
            L s� 3� #� $� � � � <:C�:D�:�:�:�:�/,�/�/�/�X/�QT�Q�Q�Q�XQ�8H-����X�-8c>�-d�-�-�-�-�-
            +A B�-�-�-�X-�6:*.'+7;"&)�&)$&)�&.c]&)�#3-	&)
            � }&)�&m4
            &)�sm&)�
            &)�&)�&)�&)P�6U�6�6�6�X6�6U�6�6�6�X6�S����X?�?4�?�?�?�?��E�%�����&
            e�
            �
            �
            �
            �
            U�t����u�����@�@�@e�@D�@�@�@�@ �
            ue|)<�
            �
            �
            �X
            J?*J�J�	J
            �
            J�J�J�J,�#'�'Ek'�'�
            	'�'�'�'V�$(-137 $"&
            M
            �M
             M
            �4S>*M
            �C-/0	M
            
            �
            M
            �3-
            M
            �
            M
            �M
            �M
            �M
            ^�!Xj1�!�!�!�X!�-xj0@'A�-d�-�-�-�-
            
            !�
            !�
            !�
            !�
            !�
            !s�t����-S�-T�-�-�-�-3�4����x}!4�����!S8C=%8�!T�!�!�!�!3�4����!S�!T�!�!�!�!
            "�
            "hx&8�
            "D�
            "�
            "�
            "�
            "-S�-T�-�-�-�-)'*?"@�)�)QU�)�)�)�)0-S�-T�-�-�-�-.(�(C�(T�(�(�(�(0��7;&*%)	 Q� QcN23 Q�sm Q�c]	 Q
            �
             Q� Q� Q�Z QH�+/6:&*%)X�XX�X�	X
            �X�Z(
            X�cN23X�smX�c]X�
            X�X�X�Xv���(�,2�,2?*,2�eE5L)),2�	,2
            �5/,2�Z(
            ,2�,2�
            ,2�,2�,2�,2\����������1�1�1�1�1�WY�%#%(88=CMS	
            ���0�WY�%#%(88=CMS	
            ���D�;�;�
            
            
            �v
            �	
            
            �
            �
            
            ;�;�;�
            ;�;�;�;:�BG
            �
            
            "&
            :>
            	
            �
            �
            �
            .5E�5d�5�5�5�5"3>E#9I#Ee#TU	
            ���4�-1()�()$TN()	.	!()�()�()�Z�^()T�;8�;�;�;�;�Z�^; 
            ����4��$1$6'+ �  � �"	 
            �tn �
            +	
             � � �^ 4�(,	&�&&�tn&�	&
            �
            &�&�&�&(�?@7�77$)76;7	
            7�7�7�7>�E�%�D�����)x'?�)�)�)�^)&+67?J	���B�
            
            u�
            
            %�
            
            U�
            
            �
            
            $�
            
            �
            
            �
            
            �Z
            
            ��-1.(�.(U5%<01.(�.(�	.(
            �c)*.(�
            
            .(�.(�.(�Z.(`��-1	H�HU5%<01H�H�c)*	H
            �
            H�H�H�ZH(��" �" " �
            " �
            	" 
            �
            " �
            " �" �
            " �" �" �Z" H��.2# -�--�-�	-
            �-�c)*
            -�-�-�
            -�-�-�Z-^X)X)�X)�	X)
            �X)�
            X)�eFSL#$566X)�X)�
            X)�X)�X)�X)B�"K�KK�K�	K
            �K�
            K�E?K�
            K�K�K�KZ��.2
            7�77�7�	7
            �7�c)*
            7�
            7�7�7�Z74'
            '
             '
            %*'
            /4'
            @C'
            	
            '
            �'
            �'
            �'
            R��.2L�LL�L�	L
            �c)*L�
            
            L�L�L�ZL2�� !-1(*�(*(*�(*�	(*
            �(*�
            (*�c)*(*�
            (*�(*�(*�Z(*V��!"-1%=�%=%=�%=�	%=
            �%=�
            %=�%=�c)*%=�
            %=�%=�%=�Z%=N��""'#-1R�RR�R�	R
            �R�
            R�E?R�R�R� R�R�c)*R�
            R�R�R�ZRv�"-1+
            �+
            +
            �+
            �	+
            
            �+
            �
            +
            �E?+
            �+
            �+
            �c)*+
            �
            +
            �+
            �+
            �+
            `�-1	J �J U5%<01J �J �c)*	J 
            �
            J �J �J �J X�+,--�!%*.	h-�PTOS!%&'h-�h-�h-
            h-�h-�h'	h-� hsSy5c?/J&K KL
            h-�T#tCJ'7"784U
            ;KKLh-�#h-�!$h-�
            h-�h-�h-�.-h-X�!%*,	e1�e1
            e1�S,&'e1�	e1
            �
            e1�e1�e1�e1N
            1%�
            1D�
            1�
            1�
            1�
            1 �%)	� ��"	
            �
            
            ���"1�1$�1�1�1�1 4�44�4�4�4�4�BF6�6&sm6:>6	
            6�6�6�6B�""
            0�00�0�	0
            �Ek0�sm
            0�
            
            0�0�0�0d#�#����0�#"":�:sm:�:�	:
            �:�ck
            :�sm:�
            #	:�:�:�:F�#'I�II�I�	I
            �I�Ci
            I�3-I�I�
            I�I�I�IZ�15!%"&04#'6:d�dE#t),-d�d�3-	d
            �$H-d�C=
            d�'/smd�d�
            d�d�d�dL��=A2E-�-:-�-�	-
            �-�
            -�3c9:-�^c)3./-�-�
            -�-�-�Z-^��/3#�##�#�	#
            �#�
            #�~+,#�#�
            #�#�#�Z#J��"!!!
            3�33�E?3�E?	3
            �E?3�E?
            3�3�
            3�3�3�Z3j�!&+05:?DPS	���Z8��&1,504$.�$.$.�s"$.�UE5()	$.
            �$H-$.�
            $.�
            $$.�$.�$.�^$.L�3�#�(4.����^��-604"2�2s"2�2�e_	2
            �UE5()2�$H-
            2�sm2�2�
            2�2�2�Z2h��,5&�&ue|,-&�&�UE5()	&
            �&�
            &�
            &�&�&�Z&P�/ �/ e�/ �/ S�/ $�/ �/ �/ � �Z/ b�LP"�""'":B5/"	
            "�"�"�Z"H�LP �  ' :B5/ 	$ � � �^�Z D��!!��
            �E?	
            �E?�
            $
            ���^�ZB�E5L)27#+2E	$���^�ZB�9�$����^�Z(�; c�; htn�; �; �; �^�Z; ~�&*$((,&*+/+/+/�
            fY�fYc]fY�SMfY�uo	fY
            �UOfY�Z(
            fY�Z(fY�Z(fY�%ue+,d3:.>>?
            fY�fY�
            fY�fY�fY�fYP����$4�$�$�$�X$��"!&'$0"W$& J H}
            �}
            E?}
            �E?}
            �	}
            
            �
            #}
            �
            L!
            }
            �U{}
            �}
            �sSy!}
            �}
            �}
            �Tz}
            �Tz}
            �
            }
            �}
            �}
            � �Z}
            D�""#jh$&%)$)`$�`$`$�E?`$�c3h	`$
            �`$�
            `$�`$�sSy!`$�`$�'"`$�"`$�
            `$�`$�`$�`$D
            %�
            E�
            e�
            �
            $�
            �
            �
            �
              #' 	(	 � � � 0) SM) -1) 	(	) �) �) �) V"�"c�"#�"x}�"�"�"�"0C�C�C(9K�C�C�C�CJ
            e�
            �
            �
            �
            �
            $�$�������8,�,�,�,�,�(4.����^:�+/i...&*3i)///',9,,,�	!
            	
            	 �(*>>
            ?	@�(*??
            @		A
            �$&;;
            <	=�(*>@UU
            V
            	W�Y�����"&'"W $($0+/ J I%]*;*F12)J�JJ�E?J�	J
            �
            #J�U{
            J�J�J�sSy!J�
            L!J�"%J�J�J�TzJ�TzJ �!J"�#J$�''%J&�'J(�x}$w.)J*�
            +J�J�J� �ZJX
            ��"$&%]
            R$�R$E?R$�R$�sSy!	R$
            �R$�
            R$�
            R$�R$�R$� �ZR$h��#!$"$,2'($($(#('/}.33
            �3
            sm3
            �c]3
            �	3
            
            �3
            �
            3
            �3
            �US[)3
            �e_3
            �5/3
            �5/3
            �4.3
            �8$3
            �&d^3
            �
            3
            �3
            �3
            �Z3
            p�&*!35$&#"&.2"'j
            �j
            j
            �EEM"j
            �E?	j
            
            �j
            �
            j
            �GL))D0j
            �sSy!j
            �}j
            �3-j
            �uUE\*+j
            � j
            �
            ?	*j
            �j
            �j
            �j
            b�&*!$&#"&.2"'7�77�7�	7
            �EEM"7�E?
            7�7�7�sSy!7�}7�3-7�uUE\*+7� 7�
            7�7�7�7rK3;K�K�	K
            �"O3K� 
            K�
            K�K�K�K0�&*!$&#"&"'XD�XDXD�XD�	XD
            �EEM"XD�E?
            XD�XD�XD�sSy!XD�}XD�3-XD� XD�
            XD�XD�XD�XDtZZ�Z�	Z
            �Z�
            Z�Z�
            Z�Z�Z�Z~�,0
            �
            EkH$u,t3
            �E5L!D(
            �
            EE!H,t3d:/)	+
            	
            �
            �
            �
            <	
            UX5E�	
            %EE!H,t3d:/)	+K�	
            �	
            �	
            �	
            ��*1E����^ 
            C�
            J�
            �
            �
            �
            �%�%HUO�%t�%�%�%�Z%(u����-u�-�-�-�-�-u����	-u�	-�	-�	-�	-�	-
            �
            %�
            D�
            �
            �
            �
            
            3�
            3�
            �
            �
            �
            $�%) &*"&+/ $ !3
            1
            �1
            Tz1
            �5/1
            �	1
            
            �sm1
            �3-
            1
            �x(1
            �
            1
            �^c)3./1
            �
            1
            �1
            �1
            �1
            f�
            �6: &*"&+/ $ !3
            99�99
            '
            (99�99�d=12	99
            �99�sm
            99�3-99�x(99�
            99�^c)3./99�
            99�99�99�Z99vB.�B.�B.�B.H#"34����+y�+S�+�+�+�+"�RV
            �
            
             
            %*
            2:8g;M2N
            	
            �
            �
            �
            $�RV
            �
            
             
            %*
            2:8g;M2N
            	
            �
            �
            �
            "'cEk�'d�'�'�'�'$�FH7 �7 7 !7 &+7 057 >C7 	
            7 �7 �7 � �Z7 r�HID�DD!D&+D05D@ED	
            D�D�D� �ZDL�5�U�u��8D>����^�Z(�u��5�U�xPT~����^�Z �E�e��(4.����^�Z�1Xl3�1�1�1�^1>�
            (<"8�
            �
            �
            �^
            ��"'#'0'�0'%vtN/C&Dd&JK0'�0'� 	0'
            �!0'�
            
            0'�0'�0'�Z0'j�'+&*&*&*&*&*!9�!9!9�#!9�#	!9
            �#!9�#
            !9�#!9�#!9�
            !9�!9�!9�!9F�F
            �F
            #�F
            c�F
            t�F
            t�F
            �F
            �F
            �ZF
            P�#�#x~�#�#�#�^#.�%"x�%"HTN�%"�%"�%"�^%"N�)3�)#�)(5/�)�)�)�^�Z)V��')� 6D��wr{#�	
            � $N3�
            
            ���X�
            � 6D��BK$$x/�	
            � $N3�
            
            ���X�,-..�=?L� 6DL�L�LsR[--89L�	L
            � $N3L�
            )	
            L�L�L�/.L�L�L�L�Lr%���r���zFPDF.add_highlightF)
            r���r[���r\���r���rl���rm���rn���rY���re���r���rV��)r��rY��loggingr��r��rS��rY��sysr��r���collectionsr���
            contextlibr���r���r���	functoolsr���os.pathr���pathlibr	���r
            ���typingr���r���r
            ���r���r���r���r���r���r���r���r���r���r���r���r���r���r���,cryptography.hazmat.primitives.serializationr���endesiver���r��	PIL.Imager���r���actionsr(���r)���r*���annotationsr+���r,���r-���r.���bidir/���r0���deprecationr1���r2���r3���r4���drawingr5���r6���r7���r8���drawing_primitivesr9���r:���r;���r<���r=���r>���r?���r@���
            encryptionrA���enumsrB���rC���rD���rE���rF���rG���rH���rI���rJ���rK���rL���rM���rN���rO���rP���rQ���rR���rS���rT���rU���rV���rW���rX���rY���rZ���r[���r\���errorsr]���r^���r_���r`���rY��ra���rb���rc���rd���re���rf���graphics_staterg���rh���htmlri���image_datastructuresrj���rk���rl���rm���rn���
            image_parsingro���rp���rq���rr���
            line_breakrs���rt���ru���rv���
            linearizationrw���outlinerx���r��ry���rz���r{���r|���r}���r~���r���r���r���rn��r���r��r���rm��r���structure_treer���r���r#��r���r���syntaxr���r���r���r���r���rC��r���r���text_regionr���r���transitionsr���unicode_scriptr���r���utilr���r���r���r���r���r���r���r���r���r���/cryptography.hazmat.primitives.asymmetric.typesr���cryptography.x509r���font_type_3r���prefsr���FPDF_VERSION__version__r���	getLoggerr!���r��__file__resolvera��HEREr���r���SINGLE_PAGE
            ONE_COLUMNTWO_COLUMN_LEFTr���r-��r���r���r��r���r���r���r���modulesrT��__pdoc____all__r$���r%���r&���r�����sd
            ����				�������				�				�
            
            
            
            ���#�#�#�#�#�#�%�%�%�%�%�%�'�'�'�'�'�'�'�'�������������"�"�"�"�"�"�"�"�������������������������������������( CCCCCC� � � NFFFF 	
            �
            �
            �
            HMP��
            �
            �
            �
            �
            �
            �
            �
            �
            �
            
            �3�2�2�2�2�2�2�2�2�2������������<�;�;�;�;�;�;�;������������Q�P�P�P�P�P�P�P�P�P�P�P	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�0�/�/�/�/�/���������������������������������������������������������:������������R�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�Q�>�>�>�>�>�>�>�>������������������������������������������4�3�3�3�3�3�#�#�#�#�#�#
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �
            �������"�"�"�"�"�"�������<�<�<�<�<�<�<�<�#�#�#�#�#�#�#�#�F�F�F�F�F�F�F�F�F�F�F�F�F�F�*�*�*�*�*�*�*�*�5�5�5�5�5�5�5�5�#�#�#�#�#�#�=�=�=�=�=�=�=�=	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�	�IcNNGCLL�)OOOOOO------&&&&&&((((((�
            
            
            
            ��+�
            	8	$	$tH~~&Vm
            t�#�#�#$'%	3�3S(:../���$�$�$�$�$Z�$�$�$�=A(S�(S%u%%(S*25/(S
            5%<(S�(S�(S�(SV
            8AqD>�
            hq!tn�
            �
            �
            �
             pa�pa�pa�pa�pa�pa�pa�palC�#CH���
            !%(��s$���9B�
            BBB�"CC