OAiSrSSKJr SSKJr SSKJrJr SSKJ r SSK J r \"\ 5r \ "S5r\ "S5r\ "S 5r\ "S 5r"S S 5r\R&"54SS jjrg)z#Parsing the matrixes in a PDF file.) annotations) getLogger)MatrixPage)parse_content_stream)OperatorcmDoqQcv\rSrSrSr\R "54S SjjrSrSr S Sjr Sr \ S Sj5r S rg ) MatrixStackaTracks the CTM (current transformation matrix) in a PDF content stream. The CTM starts as the initial matrix and can be changed via the 'cm' (concatenate matrix) operator --> CTM = CTM x CM (with CTM and CM being 3x3 matrixes). Initial matrix is the identity matrix unless overridden. Furthermore can the CTM be stored to the stack via the 'q' operator. This save the CTM and subsequent 'cm' operators change a copy of that CTM --> 'q 1 0 0 1 0 0 cm' --> Copy CTM onto the stack and change the copy via 'cm' With the 'Q' operator the current CTM is replaced with the previous one from the stack. Error handling: 1. Popping from an empty stack results in CTM being set to the initial matrix 2. Multiplying with invalid operands sets the CTM to invalid 3. Multiplying an invalid CTM with a valid CM results in an invalid CTM 4. Stacking an invalid CTM results in a copy of that invalid CTM onto the stack --> All operations with an invalid CTM result in an invalid CTM --> The CTM is valid again when all invalid CTMs are popped off the stack c4XlUR/Ulg)z/Initializing the stack with the initial matrix.N_initial_matrix_stack)selfinitial_matrixs N/var/www/html/land-ocr/venv/lib/python3.13/site-packages/pikepdf/models/ctm.py__init__MatrixStack.__init__0s-,0,@,@+A cTURRURS5 g)z'Copying the current CTM onto the stack.N)rappendrs rstackMatrixStack.stack5s 4;;r?+rc[UR5S:dS5e[UR5S:XaUR/UlgURR5 g)aRemoving the current CTM from the stack. The stack is not permitted to underflow. If popped too many times, the CTM is set to the initial matrix. Some PDFs contain invalid content streams that would result in an underflow, therefore the initial matrix is used as a safe fallback. zcan't be emptyN)lenrrpoprs rr#MatrixStack.pop9sP4;;1$6&66$ t{{ q //0DK KKOO rcdURScgURSU-URS'g)z=Multiplies the CTM with `matrix`. The result is not returned.rNr)rmatrixs rmultiplyMatrixStack.multiplyGs- ;;r? " "kk"o6DKKOrc"SURS'g)z\Registers the occurence of an invalid CM. See `# Error handling` for further informations. Nrr&rs r(invalidate_current_transformation_matrix4MatrixStack.invalidate_current_transformation_matrixNs  Brc URS$)zDReturns the current transformation matrix or `None` if it's invalid.rr&rs rctmMatrixStack.ctmUs{{2rrN)rrreturnNone)r'r)r0z Matrix | None)__name__ __module__ __qualname____firstlineno____doc__ridentityrrr#r(r+propertyr.__static_attributes__rrrrsA.170AB , 7rrcX/n[U5n[U5HnURURpeU[:XaUR 5 M6U[ :XaUR5 MRU[:XaUR[U65 MvU[:XdM[!US5nUR"bUR%XsR"45 M[RSU35 M U$![a- [RSU35 UR5 GMf=f)zpDetermines the current transformation matrix (CTM) for each drawn object. Filters objects with an invalid CTM. z&malformed operands for `cm` operator: rz6skipping `Do` operator due to invalid CTM for object: )rroperatoroperandsOPERATOR_STACKr OPERATOR_POPr# OPERATOR_CMr(r TypeErrorloggerdebugr+ OPERATOR_DOstrr.r)pagerobjects_with_ctm matrix_stackinstr<r=names rget_objects_with_ctmrK[s ~.L$T*!]]DMM( ~ %     %      $ H%%fh&78  $x{#D+ ''++, LTFS-+4  H EhZPQEEGG Hs6C222D)(D)N)rFrrrr0zlist[tuple[str, Matrix]])r6 __future__rloggingr pikepdf._corerrpikepdf.models._content_streamrpikepdf.objectsr__file__rBr@rDr>r?rr7rKr:rrrRs *"&?$ 8  tn #} @@H*0):% % &%%r