Mercurial > hgrepos > Python2 > PyMuPDF

comparison src_classic/__init__.py @ 3:2c135c81b16c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
MERGE: upstream PyMuPDF 1.26.4 with MuPDF 1.26.7
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:44:09 +0200
parents 1d09e1dec1d9
children
comparison
equal deleted inserted replaced
0:6015a75abc2d 3:2c135c81b16c
1 # ------------------------------------------------------------------------
2 # Copyright 2020-2022, Harald Lieder, mailto:harald.lieder@outlook.com
3 # License: GNU AFFERO GPL 3.0, https://www.gnu.org/licenses/agpl-3.0.html
4 #
5 # Part of "PyMuPDF", a Python binding for "MuPDF" (http://mupdf.com), a
6 # lightweight PDF, XPS, and E-book viewer, renderer and toolkit which is
7 # maintained and developed by Artifex Software, Inc. https://artifex.com.
8 # ------------------------------------------------------------------------
9 import sys
10
11 import glob
12 import os
13 if os.path.exists( 'fitz/__init__.py'):
14 if not glob.glob( 'fitz/_fitz*'):
15 print( '#' * 40)
16 print( '# Warning: current directory appears to contain an incomplete')
17 print( '# fitz/ installation directory so "import fitz" may fail.')
18 print( '# This can happen if current directory is a PyMuPDF source tree.')
19 print( '# Suggest changing to a different current directory.')
20 print( '#' * 40)
21
22 def message(text=''):
23 print(text)
24
25 from fitz_old.fitz_old import *
26
27 # Allow this to work:
28 # import fitz_old as fitz
29 # fitz.fitz.TEXT_ALIGN_CENTER
30 #
31 fitz = fitz_old
32
33 # define the supported colorspaces for convenience
34 fitz_old.csRGB = fitz_old.Colorspace(fitz_old.CS_RGB)
35 fitz_old.csGRAY = fitz_old.Colorspace(fitz_old.CS_GRAY)
36 fitz_old.csCMYK = fitz_old.Colorspace(fitz_old.CS_CMYK)
37 csRGB = fitz_old.csRGB
38 csGRAY = fitz_old.csGRAY
39 csCMYK = fitz_old.csCMYK
40
41 # create the TOOLS object.
42 #
43 # Unfortunately it seems that this is never be destructed even if we use an
44 # atexit() handler, which makes MuPDF's Memento list it as a leak. In fitz_old.i
45 # we use Memento_startLeaking()/Memento_stopLeaking() when allocating
46 # the Tools instance so at least the leak is marked as known.
47 #
48 TOOLS = fitz_old.Tools()
49 TOOLS.thisown = True
50 fitz_old.TOOLS = TOOLS
51
52 # This atexit handler runs, but doesn't cause ~Tools() to be run.
53 #
54 import atexit
55
56
57 def cleanup_tools(TOOLS):
58 # print(f'cleanup_tools: TOOLS={TOOLS} id(TOOLS)={id(TOOLS)}')
59 # print(f'TOOLS.thisown={TOOLS.thisown}')
60 del TOOLS
61 del fitz_old.TOOLS
62
63
64 atexit.register(cleanup_tools, TOOLS)
65
66
67 # Require that MuPDF matches fitz_old.TOOLS.mupdf_version(); also allow use with
68 # next minor version (e.g. 1.21.2 => 1.22), so we can test with mupdf master.
69 #
70 def v_str_to_tuple(s):
71 return tuple(map(int, s.split('.')))
72
73 def v_tuple_to_string(t):
74 return '.'.join(map(str, t))
75
76 mupdf_version_tuple = v_str_to_tuple(fitz_old.TOOLS.mupdf_version())
77 mupdf_version_tuple_required = v_str_to_tuple(fitz_old.VersionFitz)
78 mupdf_version_tuple_required_prev = (mupdf_version_tuple_required[0], mupdf_version_tuple_required[1]-1)
79 mupdf_version_tuple_required_next = (mupdf_version_tuple_required[0], mupdf_version_tuple_required[1]+1)
80
81 # copy functions in 'utils' to their respective fitz classes
82 import fitz_old.utils
83 from .table import find_tables
84
85 # ------------------------------------------------------------------------------
86 # General
87 # ------------------------------------------------------------------------------
88 fitz_old.recover_quad = fitz_old.utils.recover_quad
89 fitz_old.recover_bbox_quad = fitz_old.utils.recover_bbox_quad
90 fitz_old.recover_line_quad = fitz_old.utils.recover_line_quad
91 fitz_old.recover_span_quad = fitz_old.utils.recover_span_quad
92 fitz_old.recover_char_quad = fitz_old.utils.recover_char_quad
93
94 # ------------------------------------------------------------------------------
95 # Document
96 # ------------------------------------------------------------------------------
97 fitz_old.open = fitz_old.Document
98 fitz_old.Document._do_links = fitz_old.utils.do_links
99 fitz_old.Document.del_toc_item = fitz_old.utils.del_toc_item
100 fitz_old.Document.get_char_widths = fitz_old.utils.get_char_widths
101 fitz_old.Document.get_ocmd = fitz_old.utils.get_ocmd
102 fitz_old.Document.get_page_labels = fitz_old.utils.get_page_labels
103 fitz_old.Document.get_page_numbers = fitz_old.utils.get_page_numbers
104 fitz_old.Document.get_page_pixmap = fitz_old.utils.get_page_pixmap
105 fitz_old.Document.get_page_text = fitz_old.utils.get_page_text
106 fitz_old.Document.get_toc = fitz_old.utils.get_toc
107 fitz_old.Document.has_annots = fitz_old.utils.has_annots
108 fitz_old.Document.has_links = fitz_old.utils.has_links
109 fitz_old.Document.insert_page = fitz_old.utils.insert_page
110 fitz_old.Document.new_page = fitz_old.utils.new_page
111 fitz_old.Document.scrub = fitz_old.utils.scrub
112 fitz_old.Document.search_page_for = fitz_old.utils.search_page_for
113 fitz_old.Document.set_metadata = fitz_old.utils.set_metadata
114 fitz_old.Document.set_ocmd = fitz_old.utils.set_ocmd
115 fitz_old.Document.set_page_labels = fitz_old.utils.set_page_labels
116 fitz_old.Document.set_toc = fitz_old.utils.set_toc
117 fitz_old.Document.set_toc_item = fitz_old.utils.set_toc_item
118 fitz_old.Document.tobytes = fitz_old.Document.write
119 fitz_old.Document.subset_fonts = fitz_old.utils.subset_fonts
120 fitz_old.Document.get_oc = fitz_old.utils.get_oc
121 fitz_old.Document.set_oc = fitz_old.utils.set_oc
122 fitz_old.Document.xref_copy = fitz_old.utils.xref_copy
123
124
125 # ------------------------------------------------------------------------------
126 # Page
127 # ------------------------------------------------------------------------------
128 fitz_old.Page.apply_redactions = fitz_old.utils.apply_redactions
129 fitz_old.Page.delete_widget = fitz_old.utils.delete_widget
130 fitz_old.Page.draw_bezier = fitz_old.utils.draw_bezier
131 fitz_old.Page.draw_circle = fitz_old.utils.draw_circle
132 fitz_old.Page.draw_curve = fitz_old.utils.draw_curve
133 fitz_old.Page.draw_line = fitz_old.utils.draw_line
134 fitz_old.Page.draw_oval = fitz_old.utils.draw_oval
135 fitz_old.Page.draw_polyline = fitz_old.utils.draw_polyline
136 fitz_old.Page.draw_quad = fitz_old.utils.draw_quad
137 fitz_old.Page.draw_rect = fitz_old.utils.draw_rect
138 fitz_old.Page.draw_sector = fitz_old.utils.draw_sector
139 fitz_old.Page.draw_squiggle = fitz_old.utils.draw_squiggle
140 fitz_old.Page.draw_zigzag = fitz_old.utils.draw_zigzag
141 fitz_old.Page.get_links = fitz_old.utils.get_links
142 fitz_old.Page.get_pixmap = fitz_old.utils.get_pixmap
143 fitz_old.Page.get_text = fitz_old.utils.get_text
144 fitz_old.Page.get_image_info = fitz_old.utils.get_image_info
145 fitz_old.Page.get_text_blocks = fitz_old.utils.get_text_blocks
146 fitz_old.Page.get_text_selection = fitz_old.utils.get_text_selection
147 fitz_old.Page.get_text_words = fitz_old.utils.get_text_words
148 fitz_old.Page.get_textbox = fitz_old.utils.get_textbox
149 fitz_old.Page.insert_image = fitz_old.utils.insert_image
150 fitz_old.Page.insert_link = fitz_old.utils.insert_link
151 fitz_old.Page.insert_text = fitz_old.utils.insert_text
152 fitz_old.Page.insert_textbox = fitz_old.utils.insert_textbox
153 fitz_old.Page.new_shape = lambda x: fitz_old.utils.Shape(x)
154 fitz_old.Page.search_for = fitz_old.utils.search_for
155 fitz_old.Page.show_pdf_page = fitz_old.utils.show_pdf_page
156 fitz_old.Page.update_link = fitz_old.utils.update_link
157 fitz_old.Page.write_text = fitz_old.utils.write_text
158 fitz_old.Page.get_label = fitz_old.utils.get_label
159 fitz_old.Page.get_image_rects = fitz_old.utils.get_image_rects
160 fitz_old.Page.get_textpage_ocr = fitz_old.utils.get_textpage_ocr
161 fitz_old.Page.delete_image = fitz_old.utils.delete_image
162 fitz_old.Page.replace_image = fitz_old.utils.replace_image
163 fitz_old.Page.find_tables = find_tables
164 # ------------------------------------------------------------------------
165 # Annot
166 # ------------------------------------------------------------------------
167 fitz_old.Annot.get_text = fitz_old.utils.get_text
168 fitz_old.Annot.get_textbox = fitz_old.utils.get_textbox
169
170 # ------------------------------------------------------------------------
171 # Rect and IRect
172 # ------------------------------------------------------------------------
173 fitz_old.Rect.get_area = fitz_old.utils.get_area
174 fitz_old.IRect.get_area = fitz_old.utils.get_area
175
176 # ------------------------------------------------------------------------
177 # TextWriter
178 # ------------------------------------------------------------------------
179 fitz_old.TextWriter.fill_textbox = fitz_old.utils.fill_textbox
180
181
182 class FitzDeprecation(DeprecationWarning):
183 pass
184
185
186 def restore_aliases():
187 import warnings
188
189 warnings.filterwarnings(
190 "once",
191 category=FitzDeprecation,
192 )
193
194 def showthis(msg, cat, filename, lineno, file=None, line=None):
195 text = warnings.formatwarning(msg, cat, filename, lineno, line=line)
196 s = text.find("FitzDeprecation")
197 if s < 0:
198 print(text, file=sys.stderr)
199 return
200 text = text[s:].splitlines()[0][4:]
201 print(text, file=sys.stderr)
202
203 warnings.showwarning = showthis
204
205 def _alias(fitz_class, old, new):
206 fname = getattr(fitz_class, new)
207 r = str(fitz_class)[1:-1]
208 objname = " ".join(r.split()[:2])
209 objname = objname.replace("fitz_old.fitz_old.", "")
210 objname = objname.replace("fitz_old.utils.", "")
211 if callable(fname):
212
213 def deprecated_function(*args, **kw):
214 msg = "'%s' removed from %s after v1.19 - use '%s'." % (
215 old,
216 objname,
217 new,
218 )
219 if not VersionBind.startswith("1.18"):
220 warnings.warn(msg, category=FitzDeprecation)
221 return fname(*args, **kw)
222
223 setattr(fitz_class, old, deprecated_function)
224 else:
225 if type(fname) is property:
226 setattr(fitz_class, old, property(fname.fget))
227 else:
228 setattr(fitz_class, old, fname)
229
230 eigen = getattr(fitz_class, old)
231 x = fname.__doc__
232 if not x:
233 x = ""
234 try:
235 if callable(fname) or type(fname) is property:
236 eigen.__doc__ = (
237 "*** Deprecated and removed after v1.19 - use '%s'. ***\n" % new + x
238 )
239 except:
240 pass
241
242 # deprecated Document aliases
243 _alias(fitz_old.Document, "chapterCount", "chapter_count")
244 _alias(fitz_old.Document, "chapterPageCount", "chapter_page_count")
245 _alias(fitz_old.Document, "convertToPDF", "convert_to_pdf")
246 _alias(fitz_old.Document, "copyPage", "copy_page")
247 _alias(fitz_old.Document, "deletePage", "delete_page")
248 _alias(fitz_old.Document, "deletePageRange", "delete_pages")
249 _alias(fitz_old.Document, "embeddedFileAdd", "embfile_add")
250 _alias(fitz_old.Document, "embeddedFileCount", "embfile_count")
251 _alias(fitz_old.Document, "embeddedFileDel", "embfile_del")
252 _alias(fitz_old.Document, "embeddedFileGet", "embfile_get")
253 _alias(fitz_old.Document, "embeddedFileInfo", "embfile_info")
254 _alias(fitz_old.Document, "embeddedFileNames", "embfile_names")
255 _alias(fitz_old.Document, "embeddedFileUpd", "embfile_upd")
256 _alias(fitz_old.Document, "extractFont", "extract_font")
257 _alias(fitz_old.Document, "extractImage", "extract_image")
258 _alias(fitz_old.Document, "findBookmark", "find_bookmark")
259 _alias(fitz_old.Document, "fullcopyPage", "fullcopy_page")
260 _alias(fitz_old.Document, "getCharWidths", "get_char_widths")
261 _alias(fitz_old.Document, "getOCGs", "get_ocgs")
262 _alias(fitz_old.Document, "getPageFontList", "get_page_fonts")
263 _alias(fitz_old.Document, "getPageImageList", "get_page_images")
264 _alias(fitz_old.Document, "getPagePixmap", "get_page_pixmap")
265 _alias(fitz_old.Document, "getPageText", "get_page_text")
266 _alias(fitz_old.Document, "getPageXObjectList", "get_page_xobjects")
267 _alias(fitz_old.Document, "getSigFlags", "get_sigflags")
268 _alias(fitz_old.Document, "getToC", "get_toc")
269 _alias(fitz_old.Document, "getXmlMetadata", "get_xml_metadata")
270 _alias(fitz_old.Document, "insertPage", "insert_page")
271 _alias(fitz_old.Document, "insertPDF", "insert_pdf")
272 _alias(fitz_old.Document, "isDirty", "is_dirty")
273 _alias(fitz_old.Document, "isFormPDF", "is_form_pdf")
274 _alias(fitz_old.Document, "isPDF", "is_pdf")
275 _alias(fitz_old.Document, "isReflowable", "is_reflowable")
276 _alias(fitz_old.Document, "isRepaired", "is_repaired")
277 _alias(fitz_old.Document, "isStream", "xref_is_stream")
278 _alias(fitz_old.Document, "is_stream", "xref_is_stream")
279 _alias(fitz_old.Document, "lastLocation", "last_location")
280 _alias(fitz_old.Document, "loadPage", "load_page")
281 _alias(fitz_old.Document, "makeBookmark", "make_bookmark")
282 _alias(fitz_old.Document, "metadataXML", "xref_xml_metadata")
283 _alias(fitz_old.Document, "movePage", "move_page")
284 _alias(fitz_old.Document, "needsPass", "needs_pass")
285 _alias(fitz_old.Document, "newPage", "new_page")
286 _alias(fitz_old.Document, "nextLocation", "next_location")
287 _alias(fitz_old.Document, "pageCount", "page_count")
288 _alias(fitz_old.Document, "pageCropBox", "page_cropbox")
289 _alias(fitz_old.Document, "pageXref", "page_xref")
290 _alias(fitz_old.Document, "PDFCatalog", "pdf_catalog")
291 _alias(fitz_old.Document, "PDFTrailer", "pdf_trailer")
292 _alias(fitz_old.Document, "previousLocation", "prev_location")
293 _alias(fitz_old.Document, "resolveLink", "resolve_link")
294 _alias(fitz_old.Document, "searchPageFor", "search_page_for")
295 _alias(fitz_old.Document, "setLanguage", "set_language")
296 _alias(fitz_old.Document, "setMetadata", "set_metadata")
297 _alias(fitz_old.Document, "setToC", "set_toc")
298 _alias(fitz_old.Document, "setXmlMetadata", "set_xml_metadata")
299 _alias(fitz_old.Document, "updateObject", "update_object")
300 _alias(fitz_old.Document, "updateStream", "update_stream")
301 _alias(fitz_old.Document, "xrefLength", "xref_length")
302 _alias(fitz_old.Document, "xrefObject", "xref_object")
303 _alias(fitz_old.Document, "xrefStream", "xref_stream")
304 _alias(fitz_old.Document, "xrefStreamRaw", "xref_stream_raw")
305
306 # deprecated Page aliases
307 _alias(fitz_old.Page, "_isWrapped", "is_wrapped")
308 _alias(fitz_old.Page, "addCaretAnnot", "add_caret_annot")
309 _alias(fitz_old.Page, "addCircleAnnot", "add_circle_annot")
310 _alias(fitz_old.Page, "addFileAnnot", "add_file_annot")
311 _alias(fitz_old.Page, "addFreetextAnnot", "add_freetext_annot")
312 _alias(fitz_old.Page, "addHighlightAnnot", "add_highlight_annot")
313 _alias(fitz_old.Page, "addInkAnnot", "add_ink_annot")
314 _alias(fitz_old.Page, "addLineAnnot", "add_line_annot")
315 _alias(fitz_old.Page, "addPolygonAnnot", "add_polygon_annot")
316 _alias(fitz_old.Page, "addPolylineAnnot", "add_polyline_annot")
317 _alias(fitz_old.Page, "addRectAnnot", "add_rect_annot")
318 _alias(fitz_old.Page, "addRedactAnnot", "add_redact_annot")
319 _alias(fitz_old.Page, "addSquigglyAnnot", "add_squiggly_annot")
320 _alias(fitz_old.Page, "addStampAnnot", "add_stamp_annot")
321 _alias(fitz_old.Page, "addStrikeoutAnnot", "add_strikeout_annot")
322 _alias(fitz_old.Page, "addTextAnnot", "add_text_annot")
323 _alias(fitz_old.Page, "addUnderlineAnnot", "add_underline_annot")
324 _alias(fitz_old.Page, "addWidget", "add_widget")
325 _alias(fitz_old.Page, "cleanContents", "clean_contents")
326 _alias(fitz_old.Page, "CropBox", "cropbox")
327 _alias(fitz_old.Page, "CropBoxPosition", "cropbox_position")
328 _alias(fitz_old.Page, "deleteAnnot", "delete_annot")
329 _alias(fitz_old.Page, "deleteLink", "delete_link")
330 _alias(fitz_old.Page, "deleteWidget", "delete_widget")
331 _alias(fitz_old.Page, "derotationMatrix", "derotation_matrix")
332 _alias(fitz_old.Page, "drawBezier", "draw_bezier")
333 _alias(fitz_old.Page, "drawCircle", "draw_circle")
334 _alias(fitz_old.Page, "drawCurve", "draw_curve")
335 _alias(fitz_old.Page, "drawLine", "draw_line")
336 _alias(fitz_old.Page, "drawOval", "draw_oval")
337 _alias(fitz_old.Page, "drawPolyline", "draw_polyline")
338 _alias(fitz_old.Page, "drawQuad", "draw_quad")
339 _alias(fitz_old.Page, "drawRect", "draw_rect")
340 _alias(fitz_old.Page, "drawSector", "draw_sector")
341 _alias(fitz_old.Page, "drawSquiggle", "draw_squiggle")
342 _alias(fitz_old.Page, "drawZigzag", "draw_zigzag")
343 _alias(fitz_old.Page, "firstAnnot", "first_annot")
344 _alias(fitz_old.Page, "firstLink", "first_link")
345 _alias(fitz_old.Page, "firstWidget", "first_widget")
346 _alias(fitz_old.Page, "getContents", "get_contents")
347 _alias(fitz_old.Page, "getDisplayList", "get_displaylist")
348 _alias(fitz_old.Page, "getDrawings", "get_drawings")
349 _alias(fitz_old.Page, "getFontList", "get_fonts")
350 _alias(fitz_old.Page, "getImageBbox", "get_image_bbox")
351 _alias(fitz_old.Page, "getImageList", "get_images")
352 _alias(fitz_old.Page, "getLinks", "get_links")
353 _alias(fitz_old.Page, "getPixmap", "get_pixmap")
354 _alias(fitz_old.Page, "getSVGimage", "get_svg_image")
355 _alias(fitz_old.Page, "getText", "get_text")
356 _alias(fitz_old.Page, "getTextBlocks", "get_text_blocks")
357 _alias(fitz_old.Page, "getTextbox", "get_textbox")
358 _alias(fitz_old.Page, "getTextPage", "get_textpage")
359 _alias(fitz_old.Page, "getTextWords", "get_text_words")
360 _alias(fitz_old.Page, "insertFont", "insert_font")
361 _alias(fitz_old.Page, "insertImage", "insert_image")
362 _alias(fitz_old.Page, "insertLink", "insert_link")
363 _alias(fitz_old.Page, "insertText", "insert_text")
364 _alias(fitz_old.Page, "insertTextbox", "insert_textbox")
365 _alias(fitz_old.Page, "loadAnnot", "load_annot")
366 _alias(fitz_old.Page, "loadLinks", "load_links")
367 _alias(fitz_old.Page, "MediaBox", "mediabox")
368 _alias(fitz_old.Page, "MediaBoxSize", "mediabox_size")
369 _alias(fitz_old.Page, "newShape", "new_shape")
370 _alias(fitz_old.Page, "readContents", "read_contents")
371 _alias(fitz_old.Page, "rotationMatrix", "rotation_matrix")
372 _alias(fitz_old.Page, "searchFor", "search_for")
373 _alias(fitz_old.Page, "setCropBox", "set_cropbox")
374 _alias(fitz_old.Page, "setMediaBox", "set_mediabox")
375 _alias(fitz_old.Page, "setRotation", "set_rotation")
376 _alias(fitz_old.Page, "showPDFpage", "show_pdf_page")
377 _alias(fitz_old.Page, "transformationMatrix", "transformation_matrix")
378 _alias(fitz_old.Page, "updateLink", "update_link")
379 _alias(fitz_old.Page, "wrapContents", "wrap_contents")
380 _alias(fitz_old.Page, "writeText", "write_text")
381
382 # deprecated Shape aliases
383 _alias(fitz_old.utils.Shape, "drawBezier", "draw_bezier")
384 _alias(fitz_old.utils.Shape, "drawCircle", "draw_circle")
385 _alias(fitz_old.utils.Shape, "drawCurve", "draw_curve")
386 _alias(fitz_old.utils.Shape, "drawLine", "draw_line")
387 _alias(fitz_old.utils.Shape, "drawOval", "draw_oval")
388 _alias(fitz_old.utils.Shape, "drawPolyline", "draw_polyline")
389 _alias(fitz_old.utils.Shape, "drawQuad", "draw_quad")
390 _alias(fitz_old.utils.Shape, "drawRect", "draw_rect")
391 _alias(fitz_old.utils.Shape, "drawSector", "draw_sector")
392 _alias(fitz_old.utils.Shape, "drawSquiggle", "draw_squiggle")
393 _alias(fitz_old.utils.Shape, "drawZigzag", "draw_zigzag")
394 _alias(fitz_old.utils.Shape, "insertText", "insert_text")
395 _alias(fitz_old.utils.Shape, "insertTextbox", "insert_textbox")
396
397 # deprecated Annot aliases
398 _alias(fitz_old.Annot, "getText", "get_text")
399 _alias(fitz_old.Annot, "getTextbox", "get_textbox")
400 _alias(fitz_old.Annot, "fileGet", "get_file")
401 _alias(fitz_old.Annot, "fileUpd", "update_file")
402 _alias(fitz_old.Annot, "getPixmap", "get_pixmap")
403 _alias(fitz_old.Annot, "getTextPage", "get_textpage")
404 _alias(fitz_old.Annot, "lineEnds", "line_ends")
405 _alias(fitz_old.Annot, "setBlendMode", "set_blendmode")
406 _alias(fitz_old.Annot, "setBorder", "set_border")
407 _alias(fitz_old.Annot, "setColors", "set_colors")
408 _alias(fitz_old.Annot, "setFlags", "set_flags")
409 _alias(fitz_old.Annot, "setInfo", "set_info")
410 _alias(fitz_old.Annot, "setLineEnds", "set_line_ends")
411 _alias(fitz_old.Annot, "setName", "set_name")
412 _alias(fitz_old.Annot, "setOpacity", "set_opacity")
413 _alias(fitz_old.Annot, "setRect", "set_rect")
414 _alias(fitz_old.Annot, "setOC", "set_oc")
415 _alias(fitz_old.Annot, "soundGet", "get_sound")
416
417 # deprecated TextWriter aliases
418 _alias(fitz_old.TextWriter, "writeText", "write_text")
419 _alias(fitz_old.TextWriter, "fillTextbox", "fill_textbox")
420
421 # deprecated DisplayList aliases
422 _alias(fitz_old.DisplayList, "getPixmap", "get_pixmap")
423 _alias(fitz_old.DisplayList, "getTextPage", "get_textpage")
424
425 # deprecated Pixmap aliases
426 _alias(fitz_old.Pixmap, "setAlpha", "set_alpha")
427 _alias(fitz_old.Pixmap, "gammaWith", "gamma_with")
428 _alias(fitz_old.Pixmap, "tintWith", "tint_with")
429 _alias(fitz_old.Pixmap, "clearWith", "clear_with")
430 _alias(fitz_old.Pixmap, "copyPixmap", "copy")
431 _alias(fitz_old.Pixmap, "getImageData", "tobytes")
432 _alias(fitz_old.Pixmap, "getPNGData", "tobytes")
433 _alias(fitz_old.Pixmap, "getPNGdata", "tobytes")
434 _alias(fitz_old.Pixmap, "writeImage", "save")
435 _alias(fitz_old.Pixmap, "writePNG", "save")
436 _alias(fitz_old.Pixmap, "pillowWrite", "pil_save")
437 _alias(fitz_old.Pixmap, "pillowData", "pil_tobytes")
438 _alias(fitz_old.Pixmap, "invertIRect", "invert_irect")
439 _alias(fitz_old.Pixmap, "setPixel", "set_pixel")
440 _alias(fitz_old.Pixmap, "setOrigin", "set_origin")
441 _alias(fitz_old.Pixmap, "setRect", "set_rect")
442 _alias(fitz_old.Pixmap, "setResolution", "set_dpi")
443
444 # deprecated geometry aliases
445 _alias(fitz_old.Rect, "getArea", "get_area")
446 _alias(fitz_old.IRect, "getArea", "get_area")
447 _alias(fitz_old.Rect, "getRectArea", "get_area")
448 _alias(fitz_old.IRect, "getRectArea", "get_area")
449 _alias(fitz_old.Rect, "includePoint", "include_point")
450 _alias(fitz_old.IRect, "includePoint", "include_point")
451 _alias(fitz_old.Rect, "includeRect", "include_rect")
452 _alias(fitz_old.IRect, "includeRect", "include_rect")
453 _alias(fitz_old.Rect, "isInfinite", "is_infinite")
454 _alias(fitz_old.IRect, "isInfinite", "is_infinite")
455 _alias(fitz_old.Rect, "isEmpty", "is_empty")
456 _alias(fitz_old.IRect, "isEmpty", "is_empty")
457 _alias(fitz_old.Quad, "isEmpty", "is_empty")
458 _alias(fitz_old.Quad, "isRectangular", "is_rectangular")
459 _alias(fitz_old.Quad, "isConvex", "is_convex")
460 _alias(fitz_old.Matrix, "isRectilinear", "is_rectilinear")
461 _alias(fitz_old.Matrix, "preRotate", "prerotate")
462 _alias(fitz_old.Matrix, "preScale", "prescale")
463 _alias(fitz_old.Matrix, "preShear", "preshear")
464 _alias(fitz_old.Matrix, "preTranslate", "pretranslate")
465
466 # deprecated other aliases
467 _alias(fitz_old.Outline, "isExternal", "is_external")
468 _alias(fitz_old.Outline, "isOpen", "is_open")
469 _alias(fitz_old.Link, "isExternal", "is_external")
470 _alias(fitz_old.Link, "setBorder", "set_border")
471 _alias(fitz_old.Link, "setColors", "set_colors")
472 _alias(fitz, "getPDFstr", "get_pdf_str")
473 _alias(fitz, "getPDFnow", "get_pdf_now")
474 _alias(fitz, "PaperSize", "paper_size")
475 _alias(fitz, "PaperRect", "paper_rect")
476 _alias(fitz, "paperSizes", "paper_sizes")
477 _alias(fitz, "ImageProperties", "image_profile")
478 _alias(fitz, "planishLine", "planish_line")
479 _alias(fitz, "getTextLength", "get_text_length")
480 _alias(fitz, "getTextlength", "get_text_length")
481
482
483 fitz_old.__doc__ = """
484 PyMuPDF %s: Python bindings for the MuPDF %s library.
485 Version date: %s.
486 Built for Python %i.%i on %s (%i-bit).
487 """ % (
488 fitz_old.VersionBind,
489 fitz_old.VersionFitz,
490 fitz_old.VersionDate,
491 sys.version_info[0],
492 sys.version_info[1],
493 sys.platform,
494 64 if sys.maxsize > 2**32 else 32,
495 )
496
497 if VersionBind.startswith("1.19"): # don't generate aliases after v1.19.*
498 restore_aliases()
499
500 pdfcolor = dict(
501 [
502 (k, (r / 255, g / 255, b / 255))
503 for k, (r, g, b) in fitz_old.utils.getColorInfoDict().items()
504 ]
505 )
506 __version__ = fitz_old.VersionBind