o e  @sddlZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z mZddlmZddlmZddlmZmZmZmZmZmZmZmZmZmZddlmZm Z dd l!m"Z"dd l#m$Z$m%Z%m&Z&dd l'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.dd l/m0Z0dd l/m1Z2ddl/m3Z3ddl/m4Z5ddl/m6Z7ddl/m8Z8m9Z9m:Z:m;Z;mddl/m?Z@ddl/mAZBddl/mCZDddl/mEZEmFZFddlGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPmQZQmRZRmSZSmTZTmUZUmVZVmWZWmXZXmYZYmZZZm[Z[ddlm\Z\m]Z]m^Z^m_Z_m`Z`maZambZbecedZee9dZfeFdZgGdddZhdeeeiefeiejeefdeUfddZkd eQd!eid"eeelelelfeidfd#emd$emdeYf d%d&ZnGd'd(d(ehZodS))N)md5)BufferedReaderBufferedWriterBytesIOFileIO)Path) TracebackType) AnyCallableDequeDictListOptionalTupleTypeUnioncast) PageObject _VirtualList) PdfReader)_alg33_alg34_alg35) StrByteType StreamType_get_max_pdf_version_headerb_deprecate_bookmarkdeprecate_with_replacementlogger_warning)AnnotationDictionaryAttributes)CatalogAttributes)CatalogDictionary)Core)EncryptionDictAttributes)FieldDictionaryAttributes FieldFlag"FileSpecificationDictionaryEntriesGoToActionArgumentsInteractiveFormDictEntries)PageAttributes)PagesAttributes)StreamAttributes) TrailerKeys)TypFitArgumentsUserAccessPermissions)AnnotationBuilder ArrayObject BooleanObjectByteStringObject ContentStreamDecodedStreamObject DestinationDictionaryObject FloatObjectIndirectObject NameObject NullObject NumberObject PdfObjectRectangleObject StreamObjectTextStringObject TreeObjectcreate_string_object hex_to_rgb)BorderArrayTypeFitType LayoutTypeOutlineItemType PagemodeType ZoomArgsType ZoomArgTypeic@s eZdZdZddeddfddZddd Zd eee d ee d ee ddfd dZ e de fddZejde ddfddZdeedefddZdedefddZdedefddZdedeeegdfddfddZddd Zdeddfd!d"Zdeddfd#d$Zdded&eddfd'd(Zdded&eddfd)d*Z dd+eed,eedefd-d.Zd,edefd/d0Z defd1d2Z!defd3d4Z"e de#efd5d6Z$ dd7ee%d8ee%defd9d:Z& dd7ee%d8ee%defd;d<Z'   %dd7ee(j)d8ee(j)d&edefd=d>Z*   %dd7ee(j)d8ee(j)d&edefd?d@Z+dAe,ddfdBdCZ-dAe,ddfdDdEZ.dFe,dGe/e,e fddfdHdIZ0dJe,dKe/e,e fddfdLdMZ1 ddNe2dOeeegdfddfdPdQZ3 ddNe2dOeeegdfddfdRdSZ4e5fdedTe6e,efdUe7ddfdVdWZ8e5fdedTe6e,efdUe7ddfdXdYZ9dNe2ddfdZd[Z:dNe2ddfd\d]Z; ddNe2dOeeegdfddfd^d_Z< ddNe2dOeeegdfddfd`daZ=ddbe>fdce,ddee,dee?dfe@ddf dgdhZAdieBddfdjdkZCdie/eDefdeEe?e/eFeGeHeIfffdldmZJdieBde#efdndoZKdieBdpe#edefdqdrZLdieBddfdsdtZMdue6e,efddfdvdwZNdue6e,efddfdxdyZOdze/ePeQeReSeeTeeUeVeWf ddfd{d|ZXdGedefd}d~ZYdedefddZZdedefddZ[de\fddZ]de\fddZ^dePfddZ_dePfddZ` dde/ee\fde/de\efdefddZa dde/ee\fde/de\efdefddZb ddedee\defddZceddd ddeedee\defddZfeddd ddeedee\defddZgeddd ddeedee\defddZh   dde,dede/de\efdee/eEe%e%e%fe,fde?de?deidejdefddZk   dde,dede/de\efdeeEe%e%e%fde?de?deidejdefddZl   dde,dede/de\efdeeEe%e%e%fde?de?deidejdefddZmdddZndedefddZodedefddZpde,dedefddZqde,dedefddZrdddZsdddZtdde?ddfddZu dde?ddfddZvdde?ddfddZw dde?ddfddZx ddede,deydeePddf ddƄZz ddede,deydeePddf ddȄZ{  ddededeydeePdeidejddfdd˄Z|  ddededeydeePdeidejddfdd̈́Z}dZ~deefddЄZdeefdd҄Zde/eTefddfddՄZdeddfddׄZe deefddلZejdeddfddلZe deefdd܄Zejdeddfdd܄ZdZdeefddZdeefddZdeddfddZdeddfddZe deefddZejdeddfddZe deefddZejdeddfddZd+ede6e,efddfddZdS) PdfWriterz This class supports writing PDF files out, given pages produced by another class (typically :class:`PdfReader`). fileobjreturnNcCsd|_g|_i|_t}|ttjtdttjt dttj t i| ||_ t}|tdttjddi| ||_t}|ttjttjttj|j id|_||_||_d|_dS)Ns%PDF-1.3z/Pagesrz /ProducerZPyPDF2zutf-16beF)_header_objects _idnum_hashr8updater;PATYPECOUNTr=KIDSr2 _add_object_pagesrCcodecs BOM_UTF16_BEencode_infoCOZCATALOGZPAGES_root _root_objectrN with_as_usage)selfrNpagesinforootrf>D:\Projects\ConvertPro\env\Lib\site-packages\PyPDF2/_writer.py__init__s:     zPdfWriter.__init__cCs d|_|S)z+Store that writer is initialized by 'with'.T)rarbrfrfrg __enter__szPdfWriter.__enter__exc_typeexc tracebackcCs|jr ||jdSdS)zWrite data to the fileobj.N)rNwrite)rbrkrlrmrfrfrg__exit__szPdfWriter.__exit__cCs|jS)z Header of the PDF document that is written. This should be something like b'%PDF-1.5'. It is recommended to set the lowest version that supports all features which are used within the PDF file. rPrirfrfrg pdf_headers zPdfWriter.pdf_header new_headercCs ||_dSNrp)rbrrrfrfrgrqs objcCs|j|tt|jd|S)Nr)rQappendr:lenrbrtrfrfrgrXs zPdfWriter._add_objectidocCs"|j|kr td|j|jdS)Nzpdf must be selfr)pdf ValueErrorrQidnumrbrxrfrfrg get_objects zPdfWriter.get_objectcCtdd||S)zU .. deprecated:: 1.28.0 Use :meth:`get_object` instead. getObjectr})rr}r|rfrfrgr  zPdfWriter.getObjectpageactioncCstt|tjtjks J|jdur&|jj}t|tr| }t |j||_|j |t tj <||}tt||j }||tj|tt|tj}t|d|t tj<dS)Nr)rstrrTrUr^ZPAGEryrq isinstancer\rrYr;PARENTrXr8r}rWintrVr=)rbrrotherZpage_indrcZ page_countrfrfrg _add_pages   zPdfWriter._add_pagec Csz,|j}tj|vr|jttjtt|jd|ittj }t d|jtj|<WdSt yG}zt dt|WYd}~dSd}~ww)NrTz&set_need_appearances_writer() catch : )r`r#Z ACRO_FORMrSr;r:rvrQr*ZNeedAppearancesr3 Exceptionloggererrorrepr)rbcatalogZneed_appearancesrlrfrfrgset_need_appearances_writers    z%PdfWriter.set_need_appearances_writercCs||tjdS)a& Add a page to this PDF file. The page is usually acquired from a :class:`PdfReader` instance. :param PageObject page: The page to add to the document. Should be an instance of :class:`PageObject` N)rlistrurbrrfrfrgadd_pages zPdfWriter.add_pagecCtdd||dS)zS .. deprecated:: 1.28.0 Use :meth:`add_page` instead. addPagerN)rrrrfrfrgr  zPdfWriter.addPagerindexcs||fdddS)a Insert a page in this PDF file. The page is usually acquired from a :class:`PdfReader` instance. :param PageObject page: The page to add to the document. :param int index: Position at which the page will be inserted. cs ||Srs)insert)lprrfrgs z'PdfWriter.insert_page..N)rrbrrrfrrg insert_pageszPdfWriter.insert_pagecCtdd|||dS)zV .. deprecated:: 1.28.0 Use :meth:`insert_page` instead. insertPagerN)rrrrfrfrgrs zPdfWriter.insertPage page_number pageNumbercCsr|dur|dur tdtddd|}|dur |dur tdttttf||j}tt|t j |S)z Retrieve a page by number from this PDF file. :param int page_number: The page number to retrieve (pages begin at zero) :return: the page at the index given by *page_number* Nz)Please only use the page_number parameterzget_page(pageNumber)zget_page(page_number)4.0.0zPlease specify the page_number) rzrrr rr r}rYrrTrW)rbrrrcrfrfrgget_page%s zPdfWriter.get_pagecCr~)zd .. deprecated:: 1.28.0 Use :code:`writer.pages[page_number]` instead. getPagezwriter.pages[page_number])rr)rbrrfrfrgr<rzPdfWriter.getPagecCs*ttttf||j}t|tdS)Nz/Count)rr rr r}rYrr;)rbrcrfrfrg_get_num_pagesEszPdfWriter._get_num_pagescCtdd|S)z\ .. deprecated:: 1.28.0 Use :code:`len(writer.pages)` instead. getNumPageszlen(writer.pages))rrrirfrfrgrI zPdfWriter.getNumPagescCst|j|jS)zNProperty that emulates a list of :class:`PageObject`.)rrrrirfrfrgrcRszPdfWriter.pageswidthheightcCst|||}|||S)a Append a blank page to this PDF file and returns it. If no page size is specified, use the size of the last page. :param float width: The width of the new page expressed in default user space units. :param float height: The height of the new page expressed in default user space units. :return: the newly appended page :raises PageSizeNotDefinedError: if width and height are not defined and previous page does not exist. )rcreate_blank_pager)rbrrrrfrfrgadd_blank_pageWs zPdfWriter.add_blank_pagecCtdd|||S)zY .. deprecated:: 1.28.0 Use :meth:`add_blank_page` instead. addBlankPager)rr)rbrrrfrfrgrj  zPdfWriter.addBlankPagecCsX|dus|dur|d|kr|j|}|jj}|jj}t|||}||||S)a8 Insert a blank page to this PDF file and returns it. If no page size is specified, use the size of the last page. :param float width: The width of the new page expressed in default user space units. :param float height: The height of the new page expressed in default user space units. :param int index: Position to add the page. :return: the newly appended page :raises PageSizeNotDefinedError: if width and height are not defined and previous page does not exist. Nr)rrcZmediaboxrrrrr)rbrrrZoldpagerrfrfrginsert_blank_pageus   zPdfWriter.insert_blank_pagecCtdd||||S)zZ .. deprecated:: 1.28.0 Use :meth:`insertBlankPage` instead. insertBlankPager)rr)rbrrrrfrfrgrs zPdfWriter.insertBlankPage javascriptc Cst}|ttjtdtdtdtdtd|di||}tt}t}|tdttt j t t ||gii|||j td|tt j |idS) a Add Javascript which will launch upon opening this PDF. :param str javascript: Your Javascript. >>> output.add_js("this.print({bUI:true,bSilent:false,bShrinkToFit:true});") # Example: This will launch the print window when the PDF is opened. z/Action/Sz /JavaScriptz/JS()z /OpenActionN)r8rSr;rTrUrXruuiduuid4CANAMESr2rCr`)rbrjsZjs_indirect_objectZjs_string_nameZ js_name_treerfrfrgadd_jss2        zPdfWriter.add_jscCr~)zQ .. deprecated:: 1.28.0 Use :meth:`add_js` instead. addJSr)rr)rbrrfrfrgrrzPdfWriter.addJSfilenamedatacCst}|||ttjtdit}|td|it}|ttjtdttjt |ttj |it}|tt j t t ||git}|td|i|jtt j |idS)a Embed a file inside the PDF. :param str filename: The filename to display. :param str data: The data in the file. Reference: https://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/PDF32000_2008.pdf Section 7.11.3 z /EmbeddedFile/Fz /Filespecz/EmbeddedFilesN)r6set_datarSr;rTrUr8r(FrCZEFrrr2r`)rbrrZ file_entryZef_entryZfilespecZembedded_files_names_dictionaryZembedded_files_dictionaryrfrfrgadd_attachments4       zPdfWriter.add_attachmentfnamefdatacCr)zY .. deprecated:: 1.28.0 Use :meth:`add_attachment` instead. addAttachmentr)rr)rbrrrfrfrgr$rzPdfWriter.addAttachmentreaderafter_page_appendcCsXt|j}t|j}t|D]}|j|}|||j||}t|r)||qdS)a Copy pages from reader to writer. Includes an optional callback parameter which is invoked after pages are appended to the writer. :param PdfReader reader: a PdfReader object from which to copy page annotations to this writer object. The writer's annots will then be updated :param Callable[[PageObject], None] after_page_append: Callback function that is invoked after each page is appended to the writer. Signature includes a reference to the appended page (delegates to append_pages_from_reader). The single parameter of the callback is a reference to the page just appended to the document. N)rvrcrangercallable)rbrrZreader_num_pagesZwriter_num_pagesZrpagenumZ reader_pageZ writer_pagerfrfrgappend_pages_from_reader/s     z"PdfWriter.append_pages_from_readercCr)zc .. deprecated:: 1.28.0 Use :meth:`append_pages_from_reader` instead. appendPagesFromReaderrN)rrrbrrrfrfrgrNs zPdfWriter.appendPagesFromReaderfieldsflagscCs|tj|vrtdtdStt|tjD]m}|tj|}i}tj|vr0|tj}|D]S}| t j |kro| t j dkrR| ttjt||i| tt jt||i|rn| tt jt|iq2| t j |kr| tt jt||iq2qdS)a Update the form field values for a given page from a fields dictionary. Copy field texts and values from fields to page. If the field links to a parent object, add the information to the parent. :param PageObject page: Page reference from PDF writer where the annotations and field data will be updated. :param dict fields: a Python dictionary of field names (/T) and text values (/V) :param int flags: An integer (0 to 7). The first bit sets ReadOnly, the second bit sets Required, the third bit sets NoExport. See PDF Reference Table 8.70 for details. z No fields to update on this pageNz/Btn)rPGANNOTSr __name__rrvr}rgetr&TZFTrSr;r!ZASVrAZFfr=)rbrrrjZ writer_annotZwriter_parent_annotfieldrfrfrgupdate_page_form_field_values[sV        z'PdfWriter.update_page_form_field_valuescCr)zh .. deprecated:: 1.28.0 Use :meth:`update_page_form_field_values` instead. updatePageFormFieldValuesr)rr)rbrrrrfrfrgrs z#PdfWriter.updatePageFormFieldValuescCstt|jtj|_dS)z Copy the reader document root to the writer. :param reader: PdfReader from the document root should be copied. N)rr8trailerTKROOTr`rbrrfrfrgclone_reader_document_rootsz$PdfWriter.clone_reader_document_rootcCr)ze .. deprecated:: 1.28.0 Use :meth:`clone_reader_document_root` instead. cloneReaderDocumentRootrN)rrrrfrfrgrsz!PdfWriter.cloneReaderDocumentRootcCs|||||dS)a) Create a copy (clone) of a document from a PDF file reader :param reader: PDF file reader instance from which the clone should be created. :param Callable[[PageObject], None] after_page_append: Callback function that is invoked after each page is appended to the writer. Signature includes a reference to the appended page (delegates to append_pages_from_reader). The single parameter of the callback is a reference to the page just appended to the document. N)rrrrfrfrgclone_document_from_readers z$PdfWriter.clone_document_from_readercCr)ze .. deprecated:: 1.28.0 Use :meth:`clone_document_from_reader` instead. cloneDocumentFromReaderrN)rrrrfrfrgrs z!PdfWriter.cloneDocumentFromReaderTuser_pwd owner_pwd use_128bitpermissions_flagcCsv|dur|}|rd}d}td}nd}d}td}|}tt||||} ttttd} ttttd} t | | f|_ |dkrWt || || \} } n|dks]Jt |||| || d\} } t }td |ttj<t||td <|dkrt|d |ttj<t||ttj<t| |ttj<t| |ttj<t||ttj<|||_| |_dS) a Encrypt this PDF file with the PDF Standard encryption handler. :param str user_pwd: The "user password", which allows for opening and reading the PDF file with the restrictions provided. :param str owner_pwd: The "owner password", which allows for opening the PDF files without any restrictions. By default, the owner password is the same as the user password. :param bool use_128bit: flag as to whether to use 128bit encryption. When false, 40bit encryption will be used. By default, this flag is on. :param unsigned int permissions_flag: permissions as described in TABLE 3.20 of the PDF 1.7 specification. A bit value of 1 means the permission is grantend. Hence an integer value of -1 will set all flags. Bit position 3 is for printing, 4 is for modifying content, 5 and 6 control annotations, 9 for form fields, 10 for extraction of text and graphics. Ng0@rg@utf8Fz /Standardz/V)rr4rrrtimer\digestrandomr2_IDrrr8r;SAZFILTERr=ZLENGTHEDROUPrX_encrypt _encrypt_key)rbrrrrrrevZkeylenrrZID_1ZID_2rkeyencryptrfrfrgrs:    zPdfWriter.encryptstreamcCst|drd|jvrtd|jdt|js||j|_||j| |}| ||}| || t d|ddS)NmodebzFile to write to is not in binary mode. It may not be written to correctly.z startxref z %%EOF )hasattrrr namerr_rXr`_sweep_indirect_references _write_header_write_xref_table_write_trailerrnr)rbrobject_positions xref_locationrfrfrg write_streams    zPdfWriter.write_streamcCsXd}|dkrtd|dt|ttfrt|d}d}|||jr(|||fS)ae Write the collection of pages added to this object out as a PDF file. :param stream: An object to write the file to. The object can support the write method and the tell method, similar to a file object, or be a file path, just like the fileobj, just named it stream to keep existing workflow. FrMzOutput(stream=z ) is empty.wbT)rzrrrrrraclose)rbrZmy_filerfrfrgrn5s   zPdfWriter.writec Cs g}||jd|dt|jD]y\}}|j|}|dur|d}|||tt|dd}t|dr||j j krt d|ddd}t dddd }|j ||}t|t|j d ksnJt|} | dtd t|j d }||||d q|S) N s% rs 0 obj rz10 iz0>5z f z n )r rnrrvrQ)rbrrroffsetrfrfrgrgs   zPdfWriter._write_xref_tablecCs|dt}|ttjtt|jdttj |j ttj |j it |dr2|j|ttj<t |dr?|j|ttj<||ddS)Nstrailer rrr)rnr8rSr;rSIZEr=rvrQrr_INFOr]rrIDrZENCRYPTr)rbrrrfrfrgrps     zPdfWriter._write_trailerinfoscCs@i}t|D] \}}t||t|<q||j|dS)z Add custom metadata to the output. :param dict infos: a Python dictionary where each key is a field and each value is your new metadata. N)ritemsrCr;r}r]rS)rbrargsrvaluerfrfrg add_metadataszPdfWriter.add_metadatacCr)zW .. deprecated:: 1.28.0 Use :meth:`add_metadata` instead. addMetadatarN)rr)rbrrfrfrgrrzPdfWriter.addMetadatarecCsrt}g}d}g}d}|||||ft|r|\}}}}t|ttfrD|D]\}} || |||dur>||gngfq,n"t|t rf| |}t ||vrf|t ||| ddgft|ttfrt|t rz| ||}g} |||kr|gdd|D} |||<| D]} |j| d} | dur| } | dur| |j| <qt|sdSdS)NcSsg|]}|qSrf) hash_value).0Z grant_parentrfrfrg sz8PdfWriter._sweep_indirect_references..) collectionsdequerurvpoprr2r8rr:_resolve_indirect_objectrr}r@rXrrR)rbrestackZ discoveredparentZ grant_parentsZ key_or_idrrrZ update_hashesZold_hashZ indirect_refZindirect_ref_objrfrfrgrsX    z$PdfWriter._sweep_indirect_referencescCst|jdr|jjjrtd|jjj|j|}|dur0td|jj d|dt t }| }||j vr>|j |S|j|krNt |jd||j |<n|||j |<|j |S)z Resolves indirect object to this pdf indirect objects. If it is a new object then it is added to self._objects and new idnum is given and generation is always 0. rzI/O operation on closed file: NzUnable to resolve [z: z], returning NullObject insteadr)rryrclosedrzrr}r __class__rr<rrRr:r{rX)rbrZreal_objrrfrfrgr"s      z"PdfWriter._resolve_indirect_objectcCs0|j|d}t|d|}||ksJ|SNrr)rQrr:r})rbrtr{refrfrfrg get_references zPdfWriter.get_referencecCr~)zX .. deprecated:: 1.28.0 Use :meth:`get_reference` instead. getReferencer))rr)rwrfrfrgr*rzPdfWriter.getReferencecCs|tj|jvr'tt|jtj}|j|d}t|d|}||ks%J|St}| i| |}||jt tj<|Sr') r^ZOUTLINESr`rrBrQrr:r}rSrXr;)rboutliner{Z outline_refrfrfrgget_outline_roots    zPdfWriter.get_outline_rootcCr)z[ .. deprecated:: 1.28.0 Use :meth:`get_outline_root` instead. getOutlineRootr,)rr,rirfrfrgr-&rzPdfWriter.getOutlineRootcCsttj|jvrt|jtjtrtt|jtj}|j|d}t|d|}| |ks.Jtj |vrtt|tj trttt|tj }|j|d}t|d|}| |ksYJtj|vrhtt |tj}|St }||t tj<|St}| |}||t tj <t }||t tj<|St}| |}||jt tj<t}| |}||t tj <t }||t tj<|Sr')rrr`rr8rrQrr:r}ZDESTSr2r;rX)rbnamesr{Z names_refZdestsZ dests_refndrfrfrgget_named_dest_root/sB        zPdfWriter.get_named_dest_rootcCr)z^ .. deprecated:: 1.28.0 Use :meth:`get_named_dest_root` instead. getNamedDestRootr0)rr0rirfrfrgr1VrzPdfWriter.getNamedDestRootdestr$cCs8|dur|}tt|}||}||||Srs)r,rrBr}rXZ add_child)rbr2r$dest_refrfrfrgadd_outline_item_destination_s   z&PdfWriter.add_outline_item_destinationcCr)zf .. deprecated:: 2.9.0 Use :meth:`add_outline_item_destination` instead. add_bookmark_destinationr4rr4rbr2r$rfrfrgr5ms  z"PdfWriter.add_bookmark_destinationcCr)zg .. deprecated:: 1.28.0 Use :meth:`add_outline_item_destination` instead. addBookmarkDestinationr4r6r7rfrfrgr8|s z PdfWriter.addBookmarkDestination outline_item)bookmarkc Cst}t|D] \}}||tt|<q ||d|vrGt}tt|d}t|D] \}}||tt|<q/||}||td<| ||S)N/A) rBrrr;rrSr8rrXr4) rbr9r$Zoutline_item_objectkvrZa_dict action_refrfrfrgadd_outline_item_dicts    zPdfWriter.add_outline_item_dictcCr)z_ .. deprecated:: 2.9.0 Use :meth:`add_outline_item_dict` instead. add_bookmark_dictr?rr?rbr9r$rfrfrgr@ zPdfWriter.add_bookmark_dictcCr)z` .. deprecated:: 1.28.0 Use :meth:`add_outline_item_dict` instead. addBookmarkDictr?rArBrfrfrgrDrCzPdfWriter.addBookmarkDictF/FittitlepagenumcolorbolditalicfitrcGst|} dd|D} ttd|d| t|g| R} |tttj| jttjtdi} t | ||||} |durA| }| | |S)a Add an outline item (commonly referred to as a "Bookmark") to this PDF file. :param str title: Title to use for this outline item. :param int pagenum: Page number this outline item will point to. :param parent: A reference to a parent outline item to create nested outline items. :param tuple color: Color of the outline item's font as a red, green, blue tuple from 0.0 to 1.0 or as a Hex String (#RRGGBB) :param bool bold: Outline item font is bold :param bool italic: Outline item font is italic :param str fit: The fit of the destination page. See :meth:`add_link()` for details. cSs"g|] }|dur tnt|qSrs)r<r=)rarfrfrgrsz.PdfWriter.add_outline_item../z outline item/GoToN) r=r7r;rXr8r)D dest_arrayS_create_outline_itemr,r4)rbrFrGr$rHrIrJrKrpage_refZ zoom_argsr2r>r9rfrfrgadd_outline_items,  zPdfWriter.add_outline_itemc G(tdd|j|||||||g|RS)zZ .. deprecated:: 2.9.0 Use :meth:`add_outline_item` instead. add_bookmarkrTrrT rbrFrGr$rHrIrJrKrrfrfrgrV zPdfWriter.add_bookmarkc GrU)z[ .. deprecated:: 1.28.0 Use :meth:`add_outline_item` instead. addBookmarkrTrWrXrfrfrgrZrYzPdfWriter.addBookmarkcCstd)NzIThis method is not yet implemented. Use :meth:`add_outline_item` instead.)NotImplementedErrorrirfrfrg add_outlineszPdfWriter.add_outlinecCs(||}|}||d|g|S)N/Title)rXr0extend)rbr2r3r/rfrfrgadd_named_destination_objects z&PdfWriter.add_named_destination_objectcCr~)zg .. deprecated:: 1.28.0 Use :meth:`add_named_destination_object` instead. addNamedDestinationObjectr_)rr_)rbr2rfrfrgr`s z#PdfWriter.addNamedDestinationObjectcCsv||jtj|}t}|ttjt |tt j t dgttj tdi||}|}|||g|S)Ni:rN)r}rYrTrWr8rSr;r)rOr2r/ZFIT_Hr=rQrXr0r^)rbrFrGrSr2r3r/rfrfrgadd_named_destination)s  zPdfWriter.add_named_destinationcCr)z` .. deprecated:: 1.28.0 Use :meth:`add_named_destination` instead. addNamedDestinationra)rra)rbrFrGrfrfrgrb:rzPdfWriter.addNamedDestinationcCsRtt||j}tt|tj}|D]}tt||}tj|vr&|tj=qdS)z.Remove links and annotations from this output.N) rr8r}rYr2rTrWrr)rbpg_dictrcrrSrfrfrg remove_linksEs zPdfWriter.remove_linkscCr)zW .. deprecated:: 1.28.0 Use :meth:`remove_links` instead. removeLinksrd)rrdrirfrfrgreNrzPdfWriter.removeLinksignore_byte_string_objectcCsftt||j}tt|tj}d}|D]}tt||}|d}t|ts/t||}g}d} |j D]n\} } | dvrO| d} |rNt| t sNt | d<n6| dkrd| d} |rct| t sct | d<n!| dkrt t | dD]} |rt| d| t st | d| <qp| d krd } | d krd} | r| |vrq6| d krq6| | | fq6||_ |td|qd S)z Remove images from this output. :param bool ignore_byte_string_object: optional parameter to ignore ByteString Objects. )scmwJjMdsriisgsWbsSfFnmlcvyhBsDossh /ContentsFsTj'r"rTJqTQsreN)rr8r}rYr2rTrWrr5 operationsrArrvru __setitem__r;)rbrfrcrcZjump_operatorsrrScontentZ _operationsZ seq_graphicsoperandsoperatortextrrfrfrg remove_imagesWsX       zPdfWriter.remove_imagesignoreByteStringObjectcCr~)zX .. deprecated:: 1.28.0 Use :meth:`remove_images` instead. removeImagesr)rrrbrrfrfrgr  zPdfWriter.removeImagesc Csttt||j}ttt|tj}|D]}tt||}|d}t |t s/t ||}|j D]|\}}|dvrX|d} |sKt | t rJt |d<q2t | t t frWt |d<q2|dkrz|d} |smt | t rlt |d<q2t | t t fryt |d<q2|dkrtt|dD]'} |st |d| t rt |d| <qt |d| t t frt |d| <qq2|td|qdS)z Remove text from this output. :param bool ignore_byte_string_object: optional parameter to ignore ByteString Objects. r{r|rr~rrN)rr8r}rYr r:rTrWrrr5rrAr4rrvrr;) rbrfrcrcrrSrrrrrrfrfrg remove_textsN         zPdfWriter.remove_textcCr~)zV .. deprecated:: 1.28.0 Use :meth:`remove_text` instead. removeTextr)rrrrfrfrgrrzPdfWriter.removeTexturirectborderc Cs|||jtj|}ttttf||}|dur=dd|ddD}t|dkr` or array of four integers specifying the clickable rectangular area ``[xLL, yLL, xUR, yUR]``, or string in the form ``"[ xLL yLL xUR yUR ]"``. :param ArrayObject border: if provided, an array describing border-drawing properties. See the PDF spec for details. No border will be drawn if this argument is omitted. NcSg|]}t|qSrfr;rnrfrfrgrz%PdfWriter.add_uri..rcSrrfrrrfrfrgrrrrz/URI/Linkz/Hz/Ir;)r}rYrTrWrr rr rvr2rur=rr;r?r8rSrAr!rrrZSubtyperZRectZBorderrX) rbrGrrrZ page_linkrSZ border_arrZ dash_patternZlnk2ZlnkZlnk_refrfrfrgadd_urisJ            zPdfWriter.add_uricCstdd|||||S)zR .. deprecated:: 1.28.0 Use :meth:`add_uri` instead. addURIr)rr)rbrGrrrrfrfrgr)s zPdfWriter.addURIpagedestcGsttddt|tr|dd}tdd|dD}n t|tr%nt|}tj|||||d}|j||d S) Nadd_link+add_annotation(AnnotationBuilder.link(...))rcSs g|] }t|dkrt|qSr)rvfloat)rnumrfrfrgrH z&PdfWriter.add_link..r)rrtarget_page_indexrKfit_args)r annotation) rrrstripr?splitr1linkadd_annotation)rbrGrrrrKrrrfrfrgr8s&   zPdfWriter.add_linkcGs&tddd|j|||||g|RS)zS .. deprecated:: 1.28.0 Use :meth:`add_link` instead. addLinkrr)rr)rbrGrrrrKrrfrfrgrXszPdfWriter.addLink)z /NoLayoutz /SinglePagez /OneColumnz/TwoColumnLeftz/TwoColumnRightz /TwoPageLeftz /TwoPageRightcC(z tt|jdWStyYdSw)N /PageLayout)rrGr`KeyErrorrirfrfrg_get_page_layoutu  zPdfWriter._get_page_layoutcCr)Y .. deprecated:: 1.28.0 Use :py:attr:`page_layout` instead. getPageLayout page_layout)rrrirfrfrgr{rzPdfWriter.getPageLayoutlayoutcCsPt|ts||jvrtddd|jftt|}|jtd|idS)a Set the page layout. :param str layout: The page layout to be used. .. list-table:: Valid ``layout`` arguments :widths: 50 200 * - /NoLayout - Layout explicitly not specified * - /SinglePage - Show one page at a time * - /OneColumn - Show one column at a time * - /TwoColumnLeft - Show pages in two columns, odd-numbered pages on the left * - /TwoColumnRight - Show pages in two columns, odd-numbered pages on the right * - /TwoPageLeft - Show two pages at a time, odd-numbered pages on the left * - /TwoPageRight - Show two pages at a time, odd-numbered pages on the right zLayout should be one of: rMrN)rr;_valid_layoutsr joinrr`rSrbrrfrfrg_set_page_layouts  zPdfWriter._set_page_layoutcCr~)rzwriter.setPageLayout(val)zwriter.page_layout = val)rrrrfrfrg setPageLayouts zPdfWriter.setPageLayoutcC|S)a Page layout property. .. list-table:: Valid ``layout`` values :widths: 50 200 * - /NoLayout - Layout explicitly not specified * - /SinglePage - Show one page at a time * - /OneColumn - Show one column at a time * - /TwoColumnLeft - Show pages in two columns, odd-numbered pages on the left * - /TwoColumnRight - Show pages in two columns, odd-numbered pages on the right * - /TwoPageLeft - Show two pages at a time, odd-numbered pages on the left * - /TwoPageRight - Show two pages at a time, odd-numbered pages on the right )rrirfrfrgrszPdfWriter.page_layoutcC||dSrs)rrrfrfrgrcCtdd|jS)r pageLayoutrrrrirfrfrgr zPdfWriter.pageLayoutcCtdd||_dS)rrrNrrrfrfrgr  )z/UseNonez /UseOutlinesz /UseThumbsz /FullScreenz/UseOCz/UseAttachmentscCr)N /PageMode)rrIr`rrirfrfrg_get_page_moderzPdfWriter._get_page_modecCr)W .. deprecated:: 1.28.0 Use :py:attr:`page_mode` instead. getPageMode page_mode)rrrirfrfrgrrzPdfWriter.getPageModercCsRt|tr|}n||jvrtdd|jtt|}|jtd|idS)rzMode should be one of: z, rN)rr; _valid_modesr rrr`rS)rbrZ mode_namerfrfrg set_page_modes  zPdfWriter.set_page_modecCr)rzwriter.setPageMode(val)zwriter.page_mode = valN)rrrbrrfrfrg setPageMode rzPdfWriter.setPageModecCr)a Page mode property. .. list-table:: Valid ``mode`` values :widths: 50 200 * - /UseNone - Do not show outline or thumbnails panels * - /UseOutlines - Show outline (aka bookmarks) panel * - /UseThumbs - Show page thumbnails panel * - /FullScreen - Fullscreen view * - /UseOC - Show Optional Content Group (OCG) panel * - /UseAttachments - Show attachments panel )rrirfrfrgrszPdfWriter.page_modecCrrs)rrrfrfrgr)rcCr)rpageModerrrrirfrfrgr-rzPdfWriter.pageModecCr)rrrNrrrfrfrgr7rrcCsttt|}||jd||td<|j|}|jdur&t|td<|jdus-J| ddkr\td|vr\tt |td}t td|d|d g|d R}|j |td<| |}|j|dS) Nz/Kidsz/Pz/Annotsz/Subtyperz/Destz /LinkNamerrKr)rr8_pdf_objectifyr}rYr;rc annotationsr2rdictr7rPrXru)rbrrto_addrtmpr2Zind_objrfrfrgrAs$   zPdfWriter.add_annotation)rM)rOrL)rONr)NN)NNrrs)NNFFrE)F)NrE)r __module__ __qualname____doc__rrhrjrr BaseExceptionrropropertybytesrqsetterr>r:rXr}rrr r rrrrrrrrrrrr rcrrrdecimalDecimalrrrrrrrrrrrOPTIONAL_READ_WRITE_FIELDr r'rrrrrrALL_DOCUMENT_PERMISSIONSboolr0rrrrrrrrrrnrrrrrr2r3r8r9r;r=rAr<rr"r)r*rBr,r-r0r1r4r5r8rrHr?r@rDrFrKrTrVrZr\r_r`rarbrdrerrrrr?rrrrrrGrrrrrrrrIrrrrrrrrfrfrfrgrL{sj (                  + R   "   E     :      P#  '                6          N  -  H  %   !       " rLrtrOcCst|tr|St|tr&t}|D]\}}t|}t|}|||<q|St|trrr8rr;rrr2rur startswithrArrr9r[type)rtrrrZname_keyZ casted_valueZarrelrfrfrgrZs.      rr>rFrHrJrIcst}|td|tdt|i|r4t|trt|}td|tdt fdd|Di|s8|rQd}|r@|d7}|rF|d 7}|td t |i|S) Nr;r]z1.00000z/Ccs g|] }tt|qSrf)r9rrquantize)rcprecrfrgrrz(_create_outline_item..rrrr) rBrSr;rCrrrDrrr2r=)r>rFrHrJrIr9Z format_flagrfrrgrRvs0   rRcs*eZdZdededdffdd ZZS) PdfFileWriterrkwargsrONcs tddtj|i|dS)NrrL)rsuperrh)rbrrr&rfrgrhs zPdfFileWriter.__init__)rrrr rh __classcell__rfrfrrgrs"r)prZrrloggingrr rrhashlibriorrrrpathlibrtypesrtypingr r r r r rrrrrZ_pagerr_readerrZ _securityrrr_utilsrrrrrrr constantsr!r"rr#r$r^r%rr&r'r(r)r*r+rr,rTr-rr.rr/r0Zgenericr1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrK getLoggerrrrrrLrrrrrrRrrfrfrfrgs|   0 $        X$ *l #