pdfspine
API reference

Constants

The 247 PyMuPDF-compatible module-level constants re-exported by pdfspine, grouped by family with names and values.

Full API for pdfspine.constants — methods, signatures, and docstrings — is generated from source. See the pdfspine API reference or your editor's autocomplete.

The 247 PyMuPDF-compatible module-level constants below are re-exported at the top level of pdfspine (e.g. pdfspine.PDF_ENCRYPT_AES_256) and match PyMuPDF 1.27 exactly. They are also reachable via the pdfspine.constants submodule.

Colorspace (CS_*)

NameValue
CS_CMYK3
CS_GRAY2
CS_RGB1

Annotation types (PDF_ANNOT_*)

NameValue
PDF_ANNOT_3D26
PDF_ANNOT_CARET14
PDF_ANNOT_CIRCLE5
PDF_ANNOT_FILE_ATTACHMENT17
PDF_ANNOT_FREE_TEXT2
PDF_ANNOT_HIGHLIGHT8
PDF_ANNOT_INK15
PDF_ANNOT_LINE3
PDF_ANNOT_LINK1
PDF_ANNOT_MOVIE19
PDF_ANNOT_POLYGON6
PDF_ANNOT_POLY_LINE7
PDF_ANNOT_POPUP16
PDF_ANNOT_PRINTER_MARK23
PDF_ANNOT_PROJECTION27
PDF_ANNOT_REDACT12
PDF_ANNOT_RICH_MEDIA20
PDF_ANNOT_SCREEN22
PDF_ANNOT_SOUND18
PDF_ANNOT_SQUARE4
PDF_ANNOT_SQUIGGLY10
PDF_ANNOT_STAMP13
PDF_ANNOT_STRIKE_OUT11
PDF_ANNOT_TEXT0
PDF_ANNOT_TRAP_NET24
PDF_ANNOT_UNDERLINE9
PDF_ANNOT_UNKNOWN-1
PDF_ANNOT_WATERMARK25
PDF_ANNOT_WIDGET21

Annotation flags (PDF_ANNOT_IS_* / PDF_ANNOT_Q_*)

NameValue
PDF_ANNOT_IS_HIDDEN2
PDF_ANNOT_IS_INVISIBLE1
PDF_ANNOT_IS_LOCKED128
PDF_ANNOT_IS_LOCKED_CONTENTS512
PDF_ANNOT_IS_NO_ROTATE16
PDF_ANNOT_IS_NO_VIEW32
PDF_ANNOT_IS_NO_ZOOM8
PDF_ANNOT_IS_PRINT4
PDF_ANNOT_IS_READ_ONLY64
PDF_ANNOT_IS_TOGGLE_NO_VIEW256
PDF_ANNOT_Q_CENTER1
PDF_ANNOT_Q_LEFT0
PDF_ANNOT_Q_RIGHT2

Annotation intents (PDF_ANNOT_IT_*)

NameValue
PDF_ANNOT_IT_DEFAULT0
PDF_ANNOT_IT_FREETEXT_CALLOUT1
PDF_ANNOT_IT_FREETEXT_TYPEWRITER2
PDF_ANNOT_IT_LINE_ARROW3
PDF_ANNOT_IT_LINE_DIMENSION4
PDF_ANNOT_IT_POLYGON_CLOUD6
PDF_ANNOT_IT_POLYGON_DIMENSION7
PDF_ANNOT_IT_POLYLINE_DIMENSION5
PDF_ANNOT_IT_STAMP_IMAGE8
PDF_ANNOT_IT_STAMP_SNAPSHOT9
PDF_ANNOT_IT_UNKNOWN255

Line endings (PDF_ANNOT_LE_*)

NameValue
PDF_ANNOT_LE_BUTT6
PDF_ANNOT_LE_CIRCLE2
PDF_ANNOT_LE_CLOSED_ARROW5
PDF_ANNOT_LE_DIAMOND3
PDF_ANNOT_LE_NONE0
PDF_ANNOT_LE_OPEN_ARROW4
PDF_ANNOT_LE_R_CLOSED_ARROW8
PDF_ANNOT_LE_R_OPEN_ARROW7
PDF_ANNOT_LE_SLASH9
PDF_ANNOT_LE_SQUARE1

Blend modes (PDF_BM_*)

NameValue
PDF_BM_Color'Color'
PDF_BM_ColorBurn'ColorBurn'
PDF_BM_ColorDodge'ColorDodge'
PDF_BM_Darken'Darken'
PDF_BM_Difference'Difference'
PDF_BM_Exclusion'Exclusion'
PDF_BM_HardLight'HardLight'
PDF_BM_Hue'Hue'
PDF_BM_Lighten'Lighten'
PDF_BM_Luminosity'Luminosity'
PDF_BM_Multiply'Multiply'
PDF_BM_Normal'Normal'
PDF_BM_Overlay'Overlay'
PDF_BM_Saturation'Saturation'
PDF_BM_Screen'Screen'
PDF_BM_SoftLight'Softlight'

Border styles (PDF_BORDER_STYLE_*)

NameValue
PDF_BORDER_STYLE_BEVELED2
PDF_BORDER_STYLE_DASHED1
PDF_BORDER_STYLE_INSET3
PDF_BORDER_STYLE_SOLID0
PDF_BORDER_STYLE_UNDERLINE4

Encryption (PDF_ENCRYPT_*)

NameValue
PDF_ENCRYPT_AES_1284
PDF_ENCRYPT_AES_2565
PDF_ENCRYPT_KEEP0
PDF_ENCRYPT_NONE1
PDF_ENCRYPT_RC4_1283
PDF_ENCRYPT_RC4_402
PDF_ENCRYPT_UNKNOWN6

Form-field flags (PDF_FIELD_*)

NameValue
PDF_FIELD_IS_NO_EXPORT4
PDF_FIELD_IS_READ_ONLY1
PDF_FIELD_IS_REQUIRED2

Page labels (PDF_PAGE_LABEL_*)

NameValue
PDF_PAGE_LABEL_ALPHA_LC'a'
PDF_PAGE_LABEL_ALPHA_UC'A'
PDF_PAGE_LABEL_DECIMAL'D'
PDF_PAGE_LABEL_NONE0
PDF_PAGE_LABEL_ROMAN_LC'r'
PDF_PAGE_LABEL_ROMAN_UC'R'

Permissions (PDF_PERM_*)

NameValue
PDF_PERM_ACCESSIBILITY512
PDF_PERM_ANNOTATE32
PDF_PERM_ASSEMBLE1024
PDF_PERM_COPY16
PDF_PERM_FORM256
PDF_PERM_MODIFY8
PDF_PERM_PRINT4
PDF_PERM_PRINT_HQ2048

Redaction (PDF_REDACT_*)

NameValue
PDF_REDACT_IMAGE_NONE0
PDF_REDACT_IMAGE_PIXELS2
PDF_REDACT_IMAGE_REMOVE1
PDF_REDACT_IMAGE_REMOVE_UNLESS_INVISIBLE3
PDF_REDACT_LINE_ART_NONE0
PDF_REDACT_LINE_ART_REMOVE_IF_COVERED1
PDF_REDACT_LINE_ART_REMOVE_IF_TOUCHED2
PDF_REDACT_TEXT_NONE1
PDF_REDACT_TEXT_REMOVE0
PDF_REDACT_TEXT_REMOVE_INVISIBLE2

Signatures (PDF_SIGNATURE_*)

NameValue
PDF_SIGNATURE_DEFAULT_APPEARANCE63
PDF_SIGNATURE_ERROR_DIGEST_FAILURE3
PDF_SIGNATURE_ERROR_NOT_SIGNED7
PDF_SIGNATURE_ERROR_NOT_TRUSTED6
PDF_SIGNATURE_ERROR_NO_CERTIFICATE2
PDF_SIGNATURE_ERROR_NO_SIGNATURES1
PDF_SIGNATURE_ERROR_OKAY0
PDF_SIGNATURE_ERROR_SELF_SIGNED4
PDF_SIGNATURE_ERROR_SELF_SIGNED_IN_CHAIN5
PDF_SIGNATURE_ERROR_UNKNOWN8
PDF_SIGNATURE_SHOW_DATE4
PDF_SIGNATURE_SHOW_DN2
PDF_SIGNATURE_SHOW_GRAPHIC_NAME16
PDF_SIGNATURE_SHOW_LABELS1
PDF_SIGNATURE_SHOW_LOGO32
PDF_SIGNATURE_SHOW_TEXT_NAME8

Tokenizer (PDF_TOK_*)

NameValue
PDF_TOK_CLOSE_ARRAY3
PDF_TOK_CLOSE_BRACE7
PDF_TOK_CLOSE_DICT5
PDF_TOK_ENDOBJ18
PDF_TOK_ENDSTREAM20
PDF_TOK_EOF1
PDF_TOK_ERROR0
PDF_TOK_FALSE15
PDF_TOK_INT9
PDF_TOK_KEYWORD12
PDF_TOK_NAME8
PDF_TOK_NEWOBJ24
PDF_TOK_NULL16
PDF_TOK_OBJ17
PDF_TOK_OPEN_ARRAY2
PDF_TOK_OPEN_BRACE6
PDF_TOK_OPEN_DICT4
PDF_TOK_R13
PDF_TOK_REAL10
PDF_TOK_STARTXREF23
PDF_TOK_STREAM19
PDF_TOK_STRING11
PDF_TOK_TRAILER22
PDF_TOK_TRUE14
PDF_TOK_XREF21

Widget text formats (PDF_WIDGET_TX_FORMAT_*)

NameValue
PDF_WIDGET_TX_FORMAT_DATE3
PDF_WIDGET_TX_FORMAT_NONE0
PDF_WIDGET_TX_FORMAT_NUMBER1
PDF_WIDGET_TX_FORMAT_SPECIAL2
PDF_WIDGET_TX_FORMAT_TIME4

Widget types (PDF_WIDGET_TYPE_*)

NameValue
PDF_WIDGET_TYPE_BUTTON1
PDF_WIDGET_TYPE_CHECKBOX2
PDF_WIDGET_TYPE_COMBOBOX3
PDF_WIDGET_TYPE_LISTBOX4
PDF_WIDGET_TYPE_RADIOBUTTON5
PDF_WIDGET_TYPE_SIGNATURE6
PDF_WIDGET_TYPE_TEXT7
PDF_WIDGET_TYPE_UNKNOWN0

Stamps (STAMP_*)

NameValue
STAMP_Approved0
STAMP_AsIs1
STAMP_Confidential2
STAMP_Departmental3
STAMP_Draft13
STAMP_Experimental4
STAMP_Expired5
STAMP_Final6
STAMP_ForComment7
STAMP_ForPublicRelease8
STAMP_NotApproved9
STAMP_NotForPublicRelease10
STAMP_Sold11
STAMP_TopSecret12

Signature flags (SigFlag_*)

NameValue
SigFlag_AppendOnly2
SigFlag_SignaturesExist1

Text extraction presets (TEXTFLAGS_*)

NameValue
TEXTFLAGS_BLOCKS195
TEXTFLAGS_DICT199
TEXTFLAGS_HTML199
TEXTFLAGS_RAWDICT199
TEXTFLAGS_SEARCH210
TEXTFLAGS_TEXT195
TEXTFLAGS_WORDS195
TEXTFLAGS_XHTML199
TEXTFLAGS_XML195

Text alignment (TEXT_ALIGN_*)

NameValue
TEXT_ALIGN_CENTER1
TEXT_ALIGN_JUSTIFY3
TEXT_ALIGN_LEFT0
TEXT_ALIGN_RIGHT2

Text encodings (TEXT_ENCODING_*)

NameValue
TEXT_ENCODING_CYRILLIC2
TEXT_ENCODING_GREEK1
TEXT_ENCODING_LATIN0

Font flags (TEXT_FONT_*)

NameValue
TEXT_FONT_BOLD16
TEXT_FONT_ITALIC2
TEXT_FONT_MONOSPACED8
TEXT_FONT_SERIFED4
TEXT_FONT_SUPERSCRIPT1

Text output formats (TEXT_OUTPUT_*)

NameValue
TEXT_OUTPUT_HTML1
TEXT_OUTPUT_JSON2
TEXT_OUTPUT_TEXT0
TEXT_OUTPUT_XHTML4
TEXT_OUTPUT_XML3

Text extraction flags (TEXT_*)

NameValue
TEXT_ACCURATE_ASCENDERS262144
TEXT_ACCURATE_BBOXES512
TEXT_ACCURATE_SIDE_BEARINGS524288
TEXT_CID_FOR_UNKNOWN_UNICODE128
TEXT_CLIP64
TEXT_CLIP_RECT131072
TEXT_COLLECT_STRUCTURE256
TEXT_COLLECT_STYLES32768
TEXT_COLLECT_VECTORS1024
TEXT_DEHYPHENATE16
TEXT_FUZZY_VECTORS2097152
TEXT_IGNORE_ACTUALTEXT2048
TEXT_INHIBIT_SPACES8
TEXT_LAZY_VECTORS1048576
TEXT_MEDIABOX_CLIP64
TEXT_PARAGRAPH_BREAK8192
TEXT_PRESERVE_IMAGES4
TEXT_PRESERVE_LIGATURES1
TEXT_PRESERVE_SPANS32
TEXT_PRESERVE_WHITESPACE2
TEXT_SEGMENT4096
TEXT_STEXT_SEGMENT4096
TEXT_TABLE_HUNT16384
TEXT_USE_CID_FOR_UNKNOWN_UNICODE128
TEXT_USE_GID_FOR_UNKNOWN_UNICODE65536

Version

NameValue
VersionBind'0.0.0'
VersionDateNone
VersionFitz'0.0.0'
version('0.0.0', '0.0.0', None)
version_info('0.0.0', '0.0.0', None)

Colorspace singletons & font tables

These pre-built objects are re-exported at the top level for PyMuPDF compatibility:

NameTypeDescription
csGRAYColorspaceThe DeviceGray colorspace singleton.
csRGBColorspaceThe DeviceRGB colorspace singleton.
csCMYKColorspaceThe DeviceCMYK colorspace singleton.
TOOLSToolsThe shared Tools helper instance (PyMuPDF fitz.TOOLS).
Base14_fontnamestuple[str, ...]Names of the 14 standard PDF fonts.
Base14_fontdictdict[str, str]Alias → canonical Base-14 font name.
__version__strThe installed pdfspine version string.

On this page