o Zh R@sXdZddlmZmZmZmZddlmZmZGddde eZ GdddZ Gdd d Z Gd d d Z Gd d d ZGdddeZGdddZGdddZGdddZGdddZGdddZGdddZeGddde ZGdddZGd d!d!ZGd"d#d#ZGd$d%d%ZGd&d'd'ZGd(d)d)ZGd*d+d+ZGd,d-d-ZGd.d/d/ZGd0d1d1Z Gd2d3d3Z!Gd4d5d5Z"Gd6d7d7eZ#Gd8d9d9Z$Gd:d;d;Z%Gdd?d?Z'Gd@dAdAeZ(GdBdCdCZ)GdDdEdEeZ*ee e'ee"ee e$ee!eeeee&ee eee%eeee eefZ+GdFdGdGeZ,dHS)Iz7Various constants, enums, and flags to aid readability.)EnumIntFlagautounique)DictTuplec@seZdZdefddZdS)StrEnumreturncCs t|jS)N)strvalue)selfr F/var/www/html/lang_env/lib/python3.10/site-packages/pypdf/constants.py__str__s zStrEnum.__str__N)__name__ __module__ __qualname__r rr r r rrsrc@$eZdZdZdZdZdZdZdZdS)Corez/Keywords that don't quite belong anywhere else. /Outlines/Threadsz/Page/Pagesz/CatalogN) rrr__doc__OUTLINESTHREADSZPAGEPAGESZCATALOGr r r rr src@r) TrailerKeysz/Sizez/Prevz/Rootz/Encryptz/Info/IDN) rrrZSIZEZPREVROOTZENCRYPTINFOIDr r r rrsrc@seZdZdZdZdS)CatalogAttributes/Names/DestsN)rrrNAMESDESTSr r r rr!sr!c@r)EncryptionDictAttributesz Additional encryption dictionary entries for the standard security handler. Table 3.19, Page 122. Table 21 of the 2.0 manual. /Rz/Oz/U/Pz/EncryptMetadataN) rrrrROUPZENCRYPT_METADATAr r r rr&$sr&c@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#e$d"e%d#e&fd$d%Z'e$d"e%d#e&fd&d'Z(d#e)e%e&ffd(d)Z*e$d*e)e%e&fd#dfd+d,Z+e$d0d-d.Z,d/S)1UserAccessPermissionszM Table 3.20 User access permissions. Table 22 of the 2.0 manual.  @ii @ @iii i@lnamer cCs|do |ddS)z=Check if the given name corresponds to a reserved flag entry.r)r.N) startswithisdigitclsrGr r r _is_reservedZsz"UserAccessPermissions._is_reservedcCs|dvS)z8Check if the given reserved name defaults to 1 = active.>R2R1r rJr r r _is_active_sz UserAccessPermissions._is_activecCs<i}tjD]\}}t|rq||@|k||<q|S)zEConvert the given flag value to a corresponding verbose name mapping.)r- __members__itemsrLlower)r resultrGflagr r rto_dictds  zUserAccessPermissions.to_dictr cCst|}|d}|jD]!\}}||r ||r||O}q ||d}|r.||O}q |r8td||S)zAConvert the verbose name mapping to the corresponding flag value.rFzUnknown dictionary keys: )copyrPrQrLrOpoprR ValueError)rKr Z value_copyrSrGrTZ is_activer r r from_dictms  zUserAccessPermissions.from_dictcCs|d|j|jS)Nl)rNrMrKr r rallszUserAccessPermissions.allN)r r-)-rrrrrNrMPRINTZMODIFYZEXTRACTZ ADD_OR_MODIFYZR7ZR8ZFILL_FORM_FIELDSZEXTRACT_TEXT_AND_GRAPHICSZ ASSEMBLE_DOCZPRINT_TO_REPRESENTATIONZR13ZR14ZR15ZR16ZR17ZR18ZR19ZR20ZR21ZR22ZR23ZR24ZR25ZR26ZR27ZR28ZR29ZR30ZR31ZR32 classmethodr boolrLrOrrUrYr[r r r rr-3sV r-c@0eZdZdZdZdZdZdZdZdZ dZ d Z d S) ResourceszY Table 3.30 Entries in a resource dictionary. Table 34 in the 2.0 reference. z /ExtGState /ColorSpacez/Patternz/Shadingz/XObject/Fontz/ProcSetz /PropertiesN) rrrrZ EXT_G_STATE COLOR_SPACEZPATTERNZSHADINGZXOBJECTFONTZPROC_SETZ PROPERTIESr r r rr`r`c@seZdZdZdS) RessourceszE Use :class: `Resources` instead. .. deprecated:: 5.0.0 N)rrrrr r r rrfsrfc@ eZdZdZdZdZdZdZdS)PagesAttributesu'§7.7.3.2 of the 1.7 and 2.0 reference./Type/Parent/Kidsz/CountN)rrrrTYPEPARENTZKIDSZCOUNTr r r rrh rhc@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#d"Z$d#S)$PageAttributesu'§7.7.3.3 of the 1.7 and 2.0 reference.rirjz /LastModifiedz /Resourcesz /MediaBoxz/CropBoxz /BleedBoxz/TrimBoxz/ArtBoxz /BoxColorInfo /Contentsz/Rotatez/Groupz/Thumbz/Bz/Durz/Transz/Annots/AA /Metadata /PieceInfoz/StructParentsrz/PZz/SeparationInfoz/Tabsz/TemplateInstantiatedz /PresStepsz /UserUnitz/VP/AF/OutputIntentsz/DPartN)%rrrrrlrmZ LAST_MODIFIEDZ RESOURCESZMEDIABOXZCROPBOXZBLEEDBOXZTRIMBOXZARTBOXZBOX_COLOR_INFOZCONTENTSZROTATEZGROUPZTHUMBBZDURZTRANSZANNOTSAAMETADATA PIECE_INFOZSTRUCT_PARENTSr ZPZZSEPARATION_INFOZTABSZTEMPLATE_INSTANTIATEDZ PRES_STEPSZ USER_UNITZVPAFOUTPUT_INTENTSZD_PARTr r r rrosHroc@DeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdS)"FileSpecificationDictionaryEntriesz6Table 3.41 Entries in a file specification dictionary.riz/FS/Fz/UFz/DOSz/Macz/Unixr/Vz/EFz/RFz/Descz/ClN)rrrrTypeZFSFZUFZDOSZMacUnixr VZEFZRFZDESCZClr r r rr}r}c@eZdZdZdZdZdZdS)StreamAttributesz6 Table 4.2. Table 5 in the 2.0 reference. z/Lengthz/Filterz /DecodeParmsN)rrrrZLENGTHZFILTERZ DECODE_PARMSr r r rrs rc@r_) FilterTypesu$§7.4 of the 1.7 and 2.0 references.z/ASCIIHexDecodez/ASCII85Decodez /LZWDecodez /FlateDecodez/RunLengthDecodez/CCITTFaxDecodez /DCTDecodez /JPXDecodeN) rrrrZASCII_HEX_DECODEZASCII_85_DECODEZ LZW_DECODEZ FLATE_DECODEZRUN_LENGTH_DECODEZCCITT_FAX_DECODEZ DCT_DECODEZ JPX_DECODEr r r rrsrc@,eZdZdZdZdZdZdZdZdZ dZ d S) FilterTypeAbbreviationsu&§8.9.7 of the 1.7 and 2.0 references.z/AHxz/A85z/LZWz/Flz/RLz/CCFz/DCTN) rrrrZAHxZA85ZLZWFLZRLZCCFZDCTr r r rrsrc@r)LzwFilterParametersz6 Table 4.4. Table 8 in the 2.0 reference. z /Predictorz/Colors/BitsPerComponent/Columnsz /EarlyChangeN) rrrrZ PREDICTORZCOLORSBITS_PER_COMPONENTCOLUMNSZ EARLY_CHANGEr r r rrrc@r_) CcittFaxDecodeParametersz7 Table 4.5. Table 11 in the 2.0 reference. z/Kz /EndOfLinez/EncodedByteAlignrz/Rowsz /EndOfBlockz /BlackIs1z/DamagedRowsBeforeErrorN) rrrrKZ END_OF_LINEZENCODED_BYTE_ALIGNrZROWSZ END_OF_BLOCKZ BLACK_IS_1ZDAMAGED_ROWS_BEFORE_ERRORr r r rrrerc@r|)ImageAttributesu'§11.6.5 of the 1.7 and 2.0 references.ri/Subtypez/Namez/Widthz/Heightrraz/Decodez/Intentz /Interpolatez /ImageMaskz/Mask/SMaskN)rrrrrlZSUBTYPENAMEZWIDTHZHEIGHTrrcZDECODEZINTENTZ INTERPOLATEZ IMAGE_MASKMASKS_MASKr r r rr#rrc@eZdZdZdZdZdS) ColorSpacesz /DeviceRGBz /DeviceCMYKz /DeviceGrayN)rrrZ DEVICE_RGBZ DEVICE_CMYKZ DEVICE_GRAYr r r rr5rc@rg) TypArguments#Table 8.2 of the PDF 1.7 reference.z/Leftz/Rightz/Bottomz/TopN)rrrrZLEFTZRIGHTZBOTTOMZTOPr r r rr;rnrc@r_) TypFitArgumentsrz/XYZz/Fitz/FitHz/FitVz/FitRz/FitBz/FitBHz/FitBVN) rrrrZXYZZFITZFIT_HZFIT_VZFIT_RZFIT_BZFIT_BHZFIT_BVr r r rrDsrc@r)GoToActionArgumentsz/S/Dz/SDN)rrrSDZSDr r r rrQrrc@sLeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdS)AnnotationDictionaryAttributesz9Table 8.15 Entries common to all annotation dictionaries.rirz/Rectrpr(z/NMz/Mr~z/APz/AS/DAz/Borderz/Cz /StructParentz/OCN)rrrrrZSubtypeZRectZContentsr,ZNMMrZAPZASDAZBorderCZ StructParentZOCr r r rrWs"rc@r) InteractiveFormDictEntriesz/Fieldsz/NeedAppearancesz /SigFlagsz/COz/DRrz/Qz/XFAN) rrrZFieldsZNeedAppearancesZSigFlagsZCOZDRrQZXFAr r r rrksrc@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d ZGd ddeZedeedffddZedeeeffddZdS)FieldDictionaryAttributesz Entries common to all field dictionaries (Table 8.69 PDF 1.7 reference) (*very partially documented here*). FFBits provides the constants used for `/Ff` from Table 8.70/8.75/8.77/8.79 z/FTrjrkz/Tz/TUz/TMz/Ffrz/DVrq/Optc@seZdZdZdZ dZ dZ dZ dZ dZ dZ d Z d Z d Z d Z d Z dZ dZ dZ dZ dZ dZ dZdS)z FieldDictionaryAttributes.FfBitsz Ease building /Ff flags Some entries may be specific to: * Text (Tx) (Table 8.75 PDF 1.7 reference) * Buttons (Btn) (Table 8.77 PDF 1.7 reference) * Choice (Ch) (Table 8.79 PDF 1.7 reference) r.r/r0r8r9r:r;r<r=r>r?r@rArBrCrDrErFN)rrrrReadOnlyRequiredZNoExport MultilineZPasswordZ NoToggleToOffZRadioZ PushbuttonZComboZEditZSortZ FileSelectZ MultiSelectZDoNotSpellCheckZ DoNotScrollZCombZRadiosInUnisonZRichTextZCommitOnSelChanger r r rFfBitssP rr .c Cs,|j|j|j|j|j|j|j|j|j|j f S)a Get a tuple of all the attributes present in a Field Dictionary. This method returns a tuple of all the attribute constants defined in the FieldDictionaryAttributes class. These attributes correspond to the entries that are common to all field dictionaries as specified in the PDF 1.7 reference. Returns: A tuple containing all the attribute constants. ) TMTFTParentTUFfrDVKidsrwrZr r r attributessz$FieldDictionaryAttributes.attributescCs4|jd|jd|jd|jd|jd|jd|jd|jdiS) a Get a dictionary of attribute keys and their human-readable names. This method returns a dictionary where the keys are the attribute constants defined in the FieldDictionaryAttributes class and the values are their corresponding human-readable names. These attributes correspond to the entries that are common to all field dictionaries as specified in the PDF 1.7 reference. Returns: A dictionary containing attribute keys and their names. z Field Typerz Field NamezAlternate Field Namez Mapping Namez Field FlagsValuez Default Value)rrrrrrrrrZr r rattributes_dictsz)FieldDictionaryAttributes.attributes_dictN)rrrrrrrrrrrrrrwOptrrr]rr rrrr r r rrvs$:rc@sHeZdZdZdZedeedffddZede eeffddZ d S) CheckboxRadioButtonAttributesz1Table 8.76 Field flags common to all field types.rr .cCs|jfS)a Get a tuple of all the attributes present in a Field Dictionary. This method returns a tuple of all the attribute constants defined in the CheckboxRadioButtonAttributes class. These attributes correspond to the entries that are common to all field dictionaries as specified in the PDF 1.7 reference. Returns: A tuple containing all the attribute constants. rrZr r rrsz(CheckboxRadioButtonAttributes.attributescCs |jdiS)a  Get a dictionary of attribute keys and their human-readable names. This method returns a dictionary where the keys are the attribute constants defined in the CheckboxRadioButtonAttributes class and the values are their corresponding human-readable names. These attributes correspond to the entries that are common to all field dictionaries as specified in the PDF 1.7 reference. Returns: A dictionary containing attribute keys and their names. OptionsrrZr r rrsz-CheckboxRadioButtonAttributes.attributes_dictN) rrrrrr]rr rrrr r r rrsrc@r) FieldFlagz1Table 8.70 Field flags common to all field types.r.r/r0N)rrrr READ_ONLYZREQUIREDZ NO_EXPORTr r r rr#s rc@s4eZdZdZdZdZdZdZdZdZ dZ d Z d Z d S) DocumentInformationAttributesz:Table 10.2 Entries in the document information dictionary.z/Titlez/Authorz/Subjectz /Keywordsz/Creatorz /Producerz /CreationDatez/ModDatez/TrappedN) rrrrZTITLEZAUTHORZSUBJECTKEYWORDSZCREATORZPRODUCERZ CREATION_DATEZMOD_DATEZTRAPPEDr r r rr+src@s(eZdZdZdZdZdZdZdZdZ dS) PageLayoutszF Page 84, PDF 1.4 reference. Page 115, PDF 2.0 reference. z /SinglePagez /OneColumnz/TwoColumnLeftz/TwoColumnRightz /TwoPageLeftz /TwoPageRightN) rrrrZ SINGLE_PAGEZ ONE_COLUMNZTWO_COLUMN_LEFTZTWO_COLUMN_RIGHTZ TWO_PAGE_LEFTZTWO_PAGE_RIGHTr r r rr9src@s|eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdS)GraphicsStateParametersu=Table 58 – Entries in a Graphics State Parameter Dictionaryriz/LWz/LCz/LJz/MLrz/RIz/OPz/opz/OPMrbz/BGz/BG2z/UCRz/UCR2z/TRz/TR2z/HTz/FLz/SMz/SAz/BMrz/CAz/caz/AISz/TKN)rrrrrlZLWZLCZLJZMLrZRIOPopZOPMrdZBGZBG2ZUCRZUCR2ZTRZTR2ZHTrZSMZSAZBMrCAcaZAISZTKr r r rrGs:rc@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#d"S)#CatalogDictionaryu&§7.7.2 of the 1.7 and 2.0 references.riz/Versionz /Extensionsrz /PageLabelsr"r#z/ViewerPreferencesz /PageLayoutz /PageModerrz /OpenActionrqz/URIz /AcroFormrrz/StructTreeRootz /MarkInfoz/Langz /SpiderInforursz /OCPropertiesz/Permsz/Legalz /Requirementsz /Collectionz/NeedsRenderingz/DSSrtz /DPartRootN)$rrrrrlVERSIONZ EXTENSIONSrZ PAGE_LABELSr$r%ZVIEWER_PREFERENCESZ PAGE_LAYOUTZ PAGE_MODErrZ OPEN_ACTIONrwURIZ ACRO_FORMrxZSTRUCT_TREE_ROOTZ MARK_INFOLANGZ SPIDER_INFOr{ryZ OC_PROPERTIESZPERMSZLEGALZ REQUIREMENTSZ COLLECTIONZNEEDS_RENDERINGZDSSrzZ D_PART_ROOTr r r rrgsDrc@r)OutlineFontFlagzBA class used as an enumerable flag for formatting an outline font.r.r/N)rrrritalicboldr r r rrsrc@r)PageLabelStylezN Table 8.10 in the 1.7 reference. Table 161 in the 2.0 reference. rr'z/rz/Az/aN) rrrrZDECIMALZUPPERCASE_ROMANZLOWERCASE_ROMANZUPPERCASE_LETTERZLOWERCASE_LETTERr r r rrrrc@s8eZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d S) AnnotationFlagu See §12.5.3 "Annotation Flags".r.r/r0r1r2r3r4r5r6r7N)rrrrZ INVISIBLEZHIDDENr\ZNO_ZOOMZ NO_ROTATEZNO_VIEWrLOCKEDZTOGGLE_NO_VIEWZLOCKED_CONTENTSr r r rrsrc@s2eZdZdZeZeZeZeeBeBZeZ dS) ImageTyperN) rrrNONErZXOBJECT_IMAGESZ INLINE_IMAGESZDRAWING_IMAGESZALLZIMAGESr r r rrs rN)-renumrrrrtypingrrr rrrr!r&r-r`rfrhror}rrrrrrrrrrrrrrrrrrrrrrZPDF_KEYSrr r r rs  Q (       ) %