HAiT! ,SrSSKJrJrJrJrJr SSKJr SSK J r SSK J r J r JrJrJr S\S\4S jrS \S\4S jrS \S\4S jrS \S\4S jrS\ S\S\4SjrS\S\S\4SjrS\S\ S\ SS4SjrS\S\S\ SS4SjrS\S\ S\\\\\ 44Sjrg)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_nonenumreturnc^/SQmS[S[[4U4SjjnSR[ U"U555$)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3h># TH'up[X5up4X#-v XU--nUS::dM' g g7f)Nr)divmod)rdecimal roman_reprx_romans N/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pypdf/_page_labels.py roman_num1number2uppercase_roman_numeral..roman_num[s=#( G#'DA. Q; Cax $)s&22)intrstrjoinlist)rr0r.s @r/number2uppercase_roman_numeralr7Js; E sx} 774 #' ((numberc4[U5R5$N)r7lowerr9s r/number2lowercase_roman_numeralr>fs )& 1 7 7 99r8cUS::a [S5e[[S5[S5S-5Vs/sHn[U5PM nnSnUS:a(US-nUS:XaSnX$S- U-nX-nUS-nUS:aM(U$s snf)NrzExpecting a positive numberAZrr2) ValueErrorrangeordchr)r9ialphabetrep remainders r/number2uppercase_letterrKjs {677 %c#hC1 => =1A =H> C 1*RK >I1}%+2 1* J?sA>c4[U5R5$r;)rKr<r=s r/number2lowercase_letterrMzs "6 * 0 0 22r8dictionary_objectindexc[[US5nSnSnSnU[U5:aNX#nX#S-R5nUS-[U5:XaO"X#S-U:aOUS- nU[U5:aMNSS[[ [ [S.n[U[5(d[US-5$URSS5nURS S 5nXURS 5"X- U-5-$) N/Numsrrcg)Nr2)r-s r/%get_label_from_nums..sr8c[U5$r;)r4)ns r/rUrVsAr8)Nz/Dz/Rz/rz/Az/az/Stz/Pr2z/S) rr len get_objectr7r>rKrM isinstancedictr4get) rNrOnumsrGvalue start_indexmstartprefixs r/get_label_from_numsrd~s  .w7 8D A EK c$i-g U &&( q5CI   A;   Q c$i-,,%%  A eT " "519~ IIeQ E YYtR F eiio&u':U'BC CCr8readerc[[UR5nSU;a[US-5$[[USR 55nSU;a [ X15$SU;a[ US[5(dSnUS:a[[[US5nUH{n[[[US5nUSUs=::a US::dM2O M6[URSS55(dUS- nUS:Xa [S 5eUn O[ Xa5s $ OUS:aM[S US 3[5 [US-5$) 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 /PageLabelsrrQz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr4rZrdr[r rr3rr]NotImplementedErrorr __name__)rerOroot number_treelevelkidskidlimitss r/ index2labelrqsN  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&R&Rck-. G0DEDd3iY8!9222*3777D+ABB  C<"5 D#'* .s::&+ck.A%JHU uqy>r8keyr_r^Nc0[U5S-S:wa [S5e[U5nUS:wa#XUS- ::aUS- nUS:wa XUS- ::aMU[U5:aXU:XaXUS-'gURX05 URUS-U5 g)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 rRr6A nums like array must have an even number of elementsrN)rYrCinsert)rrr_r^rGs r/ nums_insertrvs  4y1}QRR D A q&SQK' E q&SQK' 3t9}QQU  A AE5!r8 page_index_toc0[U5S-S:wa [S5eX:a [S5eURU5S-nU[U5:aFX#U::a=URU5 URU5 U[U5:a X#U::aM;gggg)z 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 rRrrtz/page_index_to must be greater or equal than keyN)rYrCrOpop)rrrwr^rGs r/nums_clear_rangerzs  4y1}QRRJKK 3!A c$i-DG}4     c$i-DG}4-4-r8c[U5S-S:wa [S5eURU5S-nU[U5:a XXS-4$g)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 rRrrtr)NN)rYrCrO)rrr^rGs r/ nums_nextr| sS 4y1}QRR 3!A3t9}!e%% r8)__doc__typingrrrrr _protocolsr _utilsr genericr r r rrr3r4r7r>rKrMrdrqrvrzr|rTr8r/rs1:x98,")))8:3:3: C C  3C3C3!D+;!DC!DC!DH.,.S.S.b" " " " "<   6   8L !8,<#= =>r8