Ngb! .dZddlmZmZmZmZmZddlmZddl m Z ddl m Z m Z mZmZmZdedefd Zd edefd Zd edefd Zd edefd Zde dedefdZdededefdZdede de ddfdZdedede ddfdZdede deeeee ffdZdS)u Page labels are shown by PDF viewers as "the page number". A page has a numeric index, starting at 0. Additionally, the page has a label. In the most simple case: label = index + 1 However, the title page and the table of contents might have Roman numerals as page labels. This makes things more complicated. Example 1 --------- >>> reader.root_object["/PageLabels"]["/Nums"] [0, IndirectObject(18, 0, 139929798197504), 8, IndirectObject(19, 0, 139929798197504)] >>> reader.get_object(reader.root_object["/PageLabels"]["/Nums"][1]) {'/S': '/r'} >>> reader.get_object(reader.root_object["/PageLabels"]["/Nums"][3]) {'/S': '/D'} Example 2 --------- The following is a document with pages labeled i, ii, iii, iv, 1, 2, 3, A-8, A-9, ... 1 0 obj << /Type /Catalog /PageLabels << /Nums [ 0 << /S /r >> 4 << /S /D >> 7 << /S /D /P ( A- ) /St 8 >> % A number tree containing % three page label dictionaries ] >> ... >> endobj §12.4.2 PDF Specification 1.7 and 2.0 ===================================== Entries in a page label dictionary ---------------------------------- The /S key: D Decimal Arabic numerals R Uppercase Roman numerals r Lowercase Roman numerals A Uppercase letters (A to Z for the first 26 pages, AA to ZZ for the next 26, and so on) a Lowercase letters (a to z for the first 26 pages, aa to zz for the next 26, and so on) )IteratorListOptionalTuplecast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectis_null_or_nonenumreturncgddtdttffd }dt ||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3rKD]0\}}t||\}}||zV|||zz}|dkrdS1dS)Nr)divmod)rdecimal roman_reprx_romans N/var/www/html/ai-engine/env/lib/python3.11/site-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_num[sk#(   GZ#w''DAqq. 7Q; Caxx   )intrstrjoinlist)rr0r.s @r/number2uppercase_roman_numeralr7Jsh   E sx} 774 #'' ( ((r1numbercDt|SN)r7lowerr8s r/number2lowercase_roman_numeralr=fs )& 1 1 7 7 9 99r1c|dkrtddttdtddzD}d}|dkr+|dz}|dkrd}||dz |z}||z}|dz}|dk+|S) NrzExpecting a positive numberc,g|]}t|S)chr).0is r/ z+number2uppercase_letter..ms>>>1A>>>r1AZrr2) ValueErrorrangeord)r8alphabetrep remainders r/number2uppercase_letterrNjs {{6777>>c#hhC1 = =>>>H C 1**RK >>Iy1}%+)2 1** Jr1cDt|Sr:)rNr;r<s r/number2lowercase_letterrPzs "6 * * 0 0 2 22r1dictionary_objectindexcptt|d}d}d}d}|t|krd||}||dz}|dzt|krn(||dz|krn|dz }|t|kdddtt t td}t|tst|dzS| dd}| d d }||| d ||z |zzS) N/NumsrrcdS)Nr2r@ns r/z%get_label_from_nums..sr1c t|Sr:)r4rWs r/rYz%get_label_from_nums..s Ar1)Nz/Dz/Rz/rz/Az/az/Stz/Pr2z/S) rr len get_objectr7r=rNrP isinstancedictr4get) rQrRnumsrCvalue start_indexmstartprefixs r/get_label_from_numsrf~s?  .w7 8 8D A EK c$ii--1g QU &&(( q5CII    A;    Q c$ii--l,,%%   A eT " "519~~ IIeQ  E YYtR F &Aeiioo&u{':U'BCC CCr1readerctt|j}d|vrt|dzStt|d}d|vrt ||Sd|vrt |dtsd}|dkrttt|d}|D]}ttt|d}|d|cxkr |dkrVnDt| dds|dz }|dkrtd |}nt ||cSn|dktd |d tt|dzS) z See 7.9.7 "Number Trees". Args: reader: The PdfReader index: The index of the page Returns: The label of the page, e.g. "iv" or "4". z /PageLabelsrrTz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr4r\rfr]r rr3rr_NotImplementedErrorr __name__)rgrRroot number_treelevelkidskidlimitss r/ index2labelrss  &"4 5 5DD  519~~'m)<)G)G)I)IJJK+";666+jW1Ez&R&Rckk-. G0DEED  d3iY88!9222222222*3777D+A+ABB   C<<"5 D##'* .sE:::::3 +ckk.J%JJJHUUU uqy>>r1keyrar`Nc|t|dzdkrtdt|}|dkr)|||dz kr|dz }|dkr|||dz k|t|kr|||kr |||dz<dS|||||dz|dS)z Insert a key, value pair in a Nums array. See 7.9.7 "Number Trees". Args: key: number key of the entry value: value of the entry nums: Nums array to modify rUr6A nums like array must have an even number of elementsrN)r[rHinsert)rtrar`rCs r/ nums_insertrxs  4yy1}QRRR D A q&&SDQK'' E q&&SDQK'' 3t99}}QQU  As AE5!!!!!r1 page_index_toct|dzdkrtd||krtd||dz}|t|krW|||krO|||||t|kr|||kIdSdSdSdS)a Remove all entries in a number tree in a range after an entry. See 7.9.7 "Number Trees". Args: key: number key of the entry before the range page_index_to: The page index of the upper limit of the range nums: Nums array to modify rUrrvz/page_index_to must be greater or equal than keyN)r[rHrRpop)rtryr`rCs r/nums_clear_ranger|s  4yy1}QRRRsJKKK 3!A c$ii--DG}44     c$ii--DG}4444----44r1ct|dzdkrtd||dz}|t|kr||||dzfSdS)z Return the (key, value) pair of the entry after the given one. See 7.9.7 "Number Trees". Args: key: number key of the entry nums: Nums array rUrrvr)NN)r[rHrR)rtr`rCs r/ nums_nextr~ sg 4yy1}QRRR 3!A3t99}}Qa!e%%|r1)__doc__typingrrrrr _protocolsr _utilsr genericr r r rrr3r4r7r=rNrPrfrsrxr|r~r@r1r/rsH::x98888888888888,,,,,,""""""))))))8:3:3:::: C C     3C3C3333!D+;!DC!DC!D!D!D!DH.,.S.S....b" " " " """"<   6   8L !8,<#= =>r1