PyMuPDF 1.26.6__cp310-abi3-win_amd64.whl

pymupdf/mupdf-devel/include/mupdf/pdf/clean.h

@@ -0,0 +1,68 @@
+// Copyright (C) 2004-2025 Artifex Software, Inc.
+//
+// This file is part of MuPDF.
+//
+// MuPDF is free software: you can redistribute it and/or modify it under the
+// terms of the GNU Affero General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
+// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+// details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
+//
+// Alternative licensing terms are available from the licensor.
+// For commercial licensing, see <https://www.artifex.com/> or contact
+// Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
+// CA 94129, USA, for further information.
+
+#ifndef MUPDF_PDF_CLEAN_H
+#define MUPDF_PDF_CLEAN_H
+
+#include "mupdf/pdf/document.h"
+#include "mupdf/pdf/image-rewriter.h"
+
+/**
+	Specifies whether the PDF's structure tree should be dropped or
+	kept when rearranging or subsetting its pages.
+
+	PDF_CLEAN_STRUCTURE_DROP: Remove the structure tree entirely.
+
+	PDF_CLEAN_STRUCTURE_KEEP: Preserve the structure tree. When
+	redacting a document, preserving the structure tree might leak
+	information.
+ */
+typedef enum {
+	PDF_CLEAN_STRUCTURE_DROP = 0,
+	PDF_CLEAN_STRUCTURE_KEEP = 1
+} pdf_clean_options_structure;
+
+typedef struct
+{
+	pdf_write_options write;
+	pdf_image_rewriter_options image;
+
+	int subset_fonts;
+
+	/* 0 to drop the structure tree (default).
+	 * 1 to keep it unchanged.
+	 * Future values reserved.
+	 */
+	pdf_clean_options_structure structure;
+} pdf_clean_options;
+
+/*
+	Read infile, and write selected pages to outfile with the given options.
+*/
+void pdf_clean_file(fz_context *ctx, char *infile, char *outfile, char *password, pdf_clean_options *opts, int retainlen, char *retainlist[]);
+
+/*
+	Recreate page tree to include only the pages listed in the array, in the order listed.
+*/
+void pdf_rearrange_pages(fz_context *ctx, pdf_document *doc, int count, const int *pages, pdf_clean_options_structure structure);
+
+#endif

pymupdf/mupdf-devel/include/mupdf/pdf/cmap.h

@@ -0,0 +1,145 @@
+// Copyright (C) 2004-2025 Artifex Software, Inc.
+//
+// This file is part of MuPDF.
+//
+// MuPDF is free software: you can redistribute it and/or modify it under the
+// terms of the GNU Affero General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
+// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+// details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
+//
+// Alternative licensing terms are available from the licensor.
+// For commercial licensing, see <https://www.artifex.com/> or contact
+// Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
+// CA 94129, USA, for further information.
+
+#ifndef MUPDF_PDF_CMAP_H
+#define MUPDF_PDF_CMAP_H
+
+#include "mupdf/fitz/store.h"
+#include "mupdf/pdf/document.h"
+
+#define PDF_MRANGE_CAP 32
+
+typedef struct
+{
+	unsigned short low, high, out;
+} pdf_range;
+
+typedef struct
+{
+	unsigned int low, high, out;
+} pdf_xrange;
+
+typedef struct
+{
+	unsigned int low, out;
+} pdf_mrange;
+
+typedef struct cmap_splay cmap_splay;
+
+typedef struct pdf_cmap
+{
+	fz_storable storable;
+	char cmap_name[32];
+
+	char usecmap_name[32];
+	struct pdf_cmap *usecmap;
+
+	int wmode;
+
+	int codespace_len;
+	struct
+	{
+		int n;
+		unsigned int low;
+		unsigned int high;
+	} codespace[40];
+
+	int rlen, rcap;
+	pdf_range *ranges;
+
+	int xlen, xcap;
+	pdf_xrange *xranges;
+
+	int mlen, mcap;
+	pdf_mrange *mranges;
+
+	int dlen, dcap;
+	int *dict;
+
+	int tlen, tcap, ttop;
+	cmap_splay *tree;
+} pdf_cmap;
+
+pdf_cmap *pdf_new_cmap(fz_context *ctx);
+pdf_cmap *pdf_keep_cmap(fz_context *ctx, pdf_cmap *cmap);
+void pdf_drop_cmap(fz_context *ctx, pdf_cmap *cmap);
+void pdf_drop_cmap_imp(fz_context *ctx, fz_storable *cmap);
+size_t pdf_cmap_size(fz_context *ctx, pdf_cmap *cmap);
+
+int pdf_cmap_wmode(fz_context *ctx, pdf_cmap *cmap);
+void pdf_set_cmap_wmode(fz_context *ctx, pdf_cmap *cmap, int wmode);
+void pdf_set_usecmap(fz_context *ctx, pdf_cmap *cmap, pdf_cmap *usecmap);
+
+/*
+	Add a codespacerange section.
+	These ranges are used by pdf_decode_cmap to decode
+	multi-byte encoded strings.
+*/
+void pdf_add_codespace(fz_context *ctx, pdf_cmap *cmap, unsigned int low, unsigned int high, size_t n);
+
+/*
+	Add a range of contiguous one-to-one mappings (i.e. 1..5 maps to 21..25)
+*/
+void pdf_map_range_to_range(fz_context *ctx, pdf_cmap *cmap, unsigned int srclo, unsigned int srchi, int dstlo);
+
+/*
+	Add a single one-to-many mapping.
+
+	len <= 256.
+*/
+void pdf_map_one_to_many(fz_context *ctx, pdf_cmap *cmap, unsigned int one, int *many, size_t len);
+void pdf_sort_cmap(fz_context *ctx, pdf_cmap *cmap);
+
+/*
+	Lookup the mapping of a codepoint.
+*/
+int pdf_lookup_cmap(pdf_cmap *cmap, unsigned int cpt);
+int pdf_lookup_cmap_full(pdf_cmap *cmap, unsigned int cpt, int *out);
+
+/*
+	Use the codespace ranges to extract a codepoint from a
+	multi-byte encoded string.
+*/
+int pdf_decode_cmap(pdf_cmap *cmap, unsigned char *s, unsigned char *e, unsigned int *cpt);
+
+/*
+	Create an Identity-* CMap (for both 1 and 2-byte encodings)
+*/
+pdf_cmap *pdf_new_identity_cmap(fz_context *ctx, int wmode, int bytes);
+pdf_cmap *pdf_load_cmap(fz_context *ctx, fz_stream *file);
+
+/*
+	Load predefined CMap from system.
+*/
+pdf_cmap *pdf_load_system_cmap(fz_context *ctx, const char *name);
+
+/*
+	Load built-in CMap resource.
+*/
+pdf_cmap *pdf_load_builtin_cmap(fz_context *ctx, const char *name);
+
+/*
+	Load CMap stream in PDF file
+*/
+pdf_cmap *pdf_load_embedded_cmap(fz_context *ctx, pdf_document *doc, pdf_obj *ref);
+
+#endif

pymupdf/mupdf-devel/include/mupdf/pdf/crypt.h

@@ -0,0 +1,108 @@
+// Copyright (C) 2004-2023 Artifex Software, Inc.
+//
+// This file is part of MuPDF.
+//
+// MuPDF is free software: you can redistribute it and/or modify it under the
+// terms of the GNU Affero General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// MuPDF is distributed in the hope that it will be useful, but WITHOUT ANY
+// WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+// FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+// details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with MuPDF. If not, see <https://www.gnu.org/licenses/agpl-3.0.en.html>
+//
+// Alternative licensing terms are available from the licensor.
+// For commercial licensing, see <https://www.artifex.com/> or contact
+// Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
+// CA 94129, USA, for further information.
+
+#ifndef MUPDF_PDF_CRYPT_H
+#define MUPDF_PDF_CRYPT_H
+
+#include "mupdf/pdf/document.h"
+#include "mupdf/pdf/object.h"
+
+enum
+{
+	PDF_ENCRYPT_KEEP,
+	PDF_ENCRYPT_NONE,
+	PDF_ENCRYPT_RC4_40,
+	PDF_ENCRYPT_RC4_128,
+	PDF_ENCRYPT_AES_128,
+	PDF_ENCRYPT_AES_256,
+	PDF_ENCRYPT_UNKNOWN
+};
+
+/*
+	Create crypt object for decrypting strings and streams
+	given the Encryption and ID objects.
+*/
+pdf_crypt *pdf_new_crypt(fz_context *ctx, pdf_obj *enc, pdf_obj *id);
+pdf_crypt *pdf_new_encrypt(fz_context *ctx, const char *opwd_utf8, const char *upwd_utf8, pdf_obj *id, int permissions, int algorithm);
+void pdf_drop_crypt(fz_context *ctx, pdf_crypt *crypt);
+
+void pdf_crypt_obj(fz_context *ctx, pdf_crypt *crypt, pdf_obj *obj, int num, int gen);
+fz_stream *pdf_open_crypt(fz_context *ctx, fz_stream *chain, pdf_crypt *crypt, int num, int gen);
+fz_stream *pdf_open_crypt_with_filter(fz_context *ctx, fz_stream *chain, pdf_crypt *crypt, pdf_obj *name, int num, int gen);
+
+int pdf_crypt_version(fz_context *ctx, pdf_crypt *crypt);
+int pdf_crypt_revision(fz_context *ctx, pdf_crypt *crypt);
+const char *pdf_crypt_method(fz_context *ctx, pdf_crypt *crypt);
+const char *pdf_crypt_string_method(fz_context *ctx, pdf_crypt *crypt);
+const char *pdf_crypt_stream_method(fz_context *ctx, pdf_crypt *crypt);
+int pdf_crypt_length(fz_context *ctx, pdf_crypt *crypt);
+int pdf_crypt_permissions(fz_context *ctx, pdf_crypt *crypt);
+int pdf_crypt_encrypt_metadata(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_owner_password(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_user_password(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_owner_encryption(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_user_encryption(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_permissions_encryption(fz_context *ctx, pdf_crypt *crypt);
+unsigned char *pdf_crypt_key(fz_context *ctx, pdf_crypt *crypt);
+
+void pdf_print_crypt(fz_context *ctx, fz_output *out, pdf_crypt *crypt);
+
+void pdf_write_digest(fz_context *ctx, fz_output *out, pdf_obj *byte_range, pdf_obj *field, size_t digest_offset, size_t digest_length, pdf_pkcs7_signer *signer);
+
+/*
+	User access permissions from PDF reference.
+*/
+enum
+{
+	PDF_PERM_PRINT = 1 << 2,
+	PDF_PERM_MODIFY = 1 << 3,
+	PDF_PERM_COPY = 1 << 4,
+	PDF_PERM_ANNOTATE = 1 << 5,
+	PDF_PERM_FORM = 1 << 8,
+	PDF_PERM_ACCESSIBILITY = 1 << 9, /* deprecated in pdf 2.0 (this permission is always granted) */
+	PDF_PERM_ASSEMBLE = 1 << 10,
+	PDF_PERM_PRINT_HQ = 1 << 11,
+};
+
+int pdf_document_permissions(fz_context *ctx, pdf_document *doc);
+
+int pdf_signature_byte_range(fz_context *ctx, pdf_document *doc, pdf_obj *signature, fz_range *byte_range);
+
+/*
+	retrieve an fz_stream to read the bytes hashed for the signature
+*/
+fz_stream *pdf_signature_hash_bytes(fz_context *ctx, pdf_document *doc, pdf_obj *signature);
+
+int pdf_signature_incremental_change_since_signing(fz_context *ctx, pdf_document *doc, pdf_obj *signature);
+int pdf_incremental_change_since_signing_widget(fz_context *ctx, pdf_annot *widget);
+
+/*
+	Retrieve the contents of a signature as a counted allocated
+	block that must be freed by the caller.
+*/
+size_t pdf_signature_contents(fz_context *ctx, pdf_document *doc, pdf_obj *signature, char **contents);
+
+void pdf_encrypt_data(fz_context *ctx, pdf_crypt *crypt, int num, int gen, void (*fmt_str_out)(fz_context *, void *, const unsigned char *, size_t), void *arg, const unsigned char *s, size_t n);
+
+size_t pdf_encrypted_len(fz_context *ctx, pdf_crypt *crypt, int num, int gen, size_t len);
+
+#endif